@402flow/sdk 0.1.0-alpha.13 → 0.1.0-alpha.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,10 @@
1
+ /**
2
+ * Public wire-contract schemas for @402flow/sdk.
3
+ *
4
+ * These schemas serve two roles:
5
+ * 1. validate control-plane and merchant-facing data at runtime
6
+ * 2. define the exported TypeScript shapes the SDK exposes to callers
7
+ */
1
8
  import { z } from 'zod';
2
9
  export declare const receiptAuthorizationOutcomeSchema: z.ZodEnum<["allowed"]>;
3
10
  export type ReceiptAuthorizationOutcome = z.infer<typeof receiptAuthorizationOutcomeSchema>;
@@ -30,7 +37,13 @@ export declare const externalIdSchema: z.ZodString;
30
37
  export declare const monetaryAmountSchema: z.ZodString;
31
38
  export declare const currencyCodeSchema: z.ZodString;
32
39
  export declare const moneyUnitSchema: z.ZodLiteral<"minor">;
40
+ /**
41
+ * Convert a decimal amount into minor units using the declared precision.
42
+ * The SDK uses this when a merchant expresses payment terms in decimal form but
43
+ * downstream contracts require canonical minor-unit amounts.
44
+ */
33
45
  export declare function monetaryAmountToMinorUnits(amount: string, precision: number): string;
46
+ /** Canonical normalized money shape used on receipts and payment requirements. */
34
47
  export declare const normalizedMoneySchema: z.ZodEffects<z.ZodObject<{
35
48
  asset: z.ZodString;
36
49
  amount: z.ZodString;
@@ -63,6 +76,7 @@ export declare const normalizedMoneySchema: z.ZodEffects<z.ZodObject<{
63
76
  unit: "minor";
64
77
  }>;
65
78
  export type NormalizedMoney = z.infer<typeof normalizedMoneySchema>;
79
+ /** Request-scoped context the control plane uses for policy, audit, and identity. */
66
80
  export declare const paidRequestContextSchema: z.ZodObject<{
67
81
  organization: z.ZodString;
68
82
  agent: z.ZodString;
@@ -80,6 +94,7 @@ export declare const paidRequestContextSchema: z.ZodObject<{
80
94
  metadata?: Record<string, unknown> | undefined;
81
95
  }>;
82
96
  export type PaidRequestContext = z.infer<typeof paidRequestContextSchema>;
97
+ /** Exact HTTP request shape that gets prepared, hashed, and later executed. */
83
98
  export declare const paidRequestHttpRequestSchema: z.ZodObject<{
84
99
  url: z.ZodString;
85
100
  method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
@@ -100,6 +115,7 @@ export declare const paidRequestHttpRequestSchema: z.ZodObject<{
100
115
  bodyHash?: string | undefined;
101
116
  }>;
102
117
  export type PaidRequestHttpRequest = z.infer<typeof paidRequestHttpRequestSchema>;
118
+ /** Merchant challenge evidence captured during prepare or fetchPaid flows. */
103
119
  export declare const paidRequestChallengeSchema: z.ZodObject<{
104
120
  protocol: z.ZodEnum<["x402", "l402"]>;
105
121
  headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -114,6 +130,3646 @@ export declare const paidRequestChallengeSchema: z.ZodObject<{
114
130
  body?: unknown;
115
131
  }>;
116
132
  export type PaidRequestChallenge = z.infer<typeof paidRequestChallengeSchema>;
133
+ export declare const sdkPreparationSourceSchema: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
134
+ export type SdkPreparationSource = z.infer<typeof sdkPreparationSourceSchema>;
135
+ export declare const sdkPreparationAuthoritySchema: z.ZodEnum<["authoritative", "advisory"]>;
136
+ export type SdkPreparationAuthority = z.infer<typeof sdkPreparationAuthoritySchema>;
137
+ export declare const sdkPreparationAttributionSchema: z.ZodObject<{
138
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
139
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
140
+ note: z.ZodOptional<z.ZodString>;
141
+ }, "strip", z.ZodTypeAny, {
142
+ source: "merchant_challenge" | "external_metadata";
143
+ authority: "authoritative" | "advisory";
144
+ note?: string | undefined;
145
+ }, {
146
+ source: "merchant_challenge" | "external_metadata";
147
+ authority: "authoritative" | "advisory";
148
+ note?: string | undefined;
149
+ }>;
150
+ export type SdkPreparationAttribution = z.infer<typeof sdkPreparationAttributionSchema>;
151
+ export declare const sdkPreparationFieldSchema: z.ZodObject<{
152
+ name: z.ZodString;
153
+ type: z.ZodOptional<z.ZodString>;
154
+ description: z.ZodOptional<z.ZodString>;
155
+ required: z.ZodOptional<z.ZodBoolean>;
156
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
157
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
158
+ }, "strip", z.ZodTypeAny, {
159
+ name: string;
160
+ type?: string | undefined;
161
+ required?: boolean | undefined;
162
+ description?: string | undefined;
163
+ defaultValue?: unknown;
164
+ enumValues?: string[] | undefined;
165
+ }, {
166
+ name: string;
167
+ type?: string | undefined;
168
+ required?: boolean | undefined;
169
+ description?: string | undefined;
170
+ defaultValue?: unknown;
171
+ enumValues?: string[] | undefined;
172
+ }>;
173
+ export type SdkPreparationField = z.infer<typeof sdkPreparationFieldSchema>;
174
+ /** Optional caller-supplied metadata used to enrich preparation hints. */
175
+ export declare const sdkExternalMetadataSchema: z.ZodObject<{
176
+ description: z.ZodOptional<z.ZodString>;
177
+ requestBodyType: z.ZodOptional<z.ZodString>;
178
+ requestBodyExample: z.ZodOptional<z.ZodString>;
179
+ requestBodyFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
180
+ name: z.ZodString;
181
+ type: z.ZodOptional<z.ZodString>;
182
+ description: z.ZodOptional<z.ZodString>;
183
+ required: z.ZodOptional<z.ZodBoolean>;
184
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
185
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
186
+ }, "strip", z.ZodTypeAny, {
187
+ name: string;
188
+ type?: string | undefined;
189
+ required?: boolean | undefined;
190
+ description?: string | undefined;
191
+ defaultValue?: unknown;
192
+ enumValues?: string[] | undefined;
193
+ }, {
194
+ name: string;
195
+ type?: string | undefined;
196
+ required?: boolean | undefined;
197
+ description?: string | undefined;
198
+ defaultValue?: unknown;
199
+ enumValues?: string[] | undefined;
200
+ }>, "many">>;
201
+ requestQueryParams: z.ZodOptional<z.ZodArray<z.ZodObject<{
202
+ name: z.ZodString;
203
+ type: z.ZodOptional<z.ZodString>;
204
+ description: z.ZodOptional<z.ZodString>;
205
+ required: z.ZodOptional<z.ZodBoolean>;
206
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
207
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
208
+ }, "strip", z.ZodTypeAny, {
209
+ name: string;
210
+ type?: string | undefined;
211
+ required?: boolean | undefined;
212
+ description?: string | undefined;
213
+ defaultValue?: unknown;
214
+ enumValues?: string[] | undefined;
215
+ }, {
216
+ name: string;
217
+ type?: string | undefined;
218
+ required?: boolean | undefined;
219
+ description?: string | undefined;
220
+ defaultValue?: unknown;
221
+ enumValues?: string[] | undefined;
222
+ }>, "many">>;
223
+ requestPathParams: z.ZodOptional<z.ZodArray<z.ZodObject<{
224
+ name: z.ZodString;
225
+ type: z.ZodOptional<z.ZodString>;
226
+ description: z.ZodOptional<z.ZodString>;
227
+ required: z.ZodOptional<z.ZodBoolean>;
228
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
229
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
230
+ }, "strip", z.ZodTypeAny, {
231
+ name: string;
232
+ type?: string | undefined;
233
+ required?: boolean | undefined;
234
+ description?: string | undefined;
235
+ defaultValue?: unknown;
236
+ enumValues?: string[] | undefined;
237
+ }, {
238
+ name: string;
239
+ type?: string | undefined;
240
+ required?: boolean | undefined;
241
+ description?: string | undefined;
242
+ defaultValue?: unknown;
243
+ enumValues?: string[] | undefined;
244
+ }>, "many">>;
245
+ notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
246
+ }, "strip", z.ZodTypeAny, {
247
+ description?: string | undefined;
248
+ requestBodyType?: string | undefined;
249
+ requestBodyExample?: string | undefined;
250
+ requestBodyFields?: {
251
+ name: string;
252
+ type?: string | undefined;
253
+ required?: boolean | undefined;
254
+ description?: string | undefined;
255
+ defaultValue?: unknown;
256
+ enumValues?: string[] | undefined;
257
+ }[] | undefined;
258
+ requestQueryParams?: {
259
+ name: string;
260
+ type?: string | undefined;
261
+ required?: boolean | undefined;
262
+ description?: string | undefined;
263
+ defaultValue?: unknown;
264
+ enumValues?: string[] | undefined;
265
+ }[] | undefined;
266
+ requestPathParams?: {
267
+ name: string;
268
+ type?: string | undefined;
269
+ required?: boolean | undefined;
270
+ description?: string | undefined;
271
+ defaultValue?: unknown;
272
+ enumValues?: string[] | undefined;
273
+ }[] | undefined;
274
+ notes?: string[] | undefined;
275
+ }, {
276
+ description?: string | undefined;
277
+ requestBodyType?: string | undefined;
278
+ requestBodyExample?: string | undefined;
279
+ requestBodyFields?: {
280
+ name: string;
281
+ type?: string | undefined;
282
+ required?: boolean | undefined;
283
+ description?: string | undefined;
284
+ defaultValue?: unknown;
285
+ enumValues?: string[] | undefined;
286
+ }[] | undefined;
287
+ requestQueryParams?: {
288
+ name: string;
289
+ type?: string | undefined;
290
+ required?: boolean | undefined;
291
+ description?: string | undefined;
292
+ defaultValue?: unknown;
293
+ enumValues?: string[] | undefined;
294
+ }[] | undefined;
295
+ requestPathParams?: {
296
+ name: string;
297
+ type?: string | undefined;
298
+ required?: boolean | undefined;
299
+ description?: string | undefined;
300
+ defaultValue?: unknown;
301
+ enumValues?: string[] | undefined;
302
+ }[] | undefined;
303
+ notes?: string[] | undefined;
304
+ }>;
305
+ export type SdkExternalMetadata = z.infer<typeof sdkExternalMetadataSchema>;
306
+ export declare const sdkPreparedHintValueSchema: z.ZodObject<{
307
+ value: z.ZodString;
308
+ attribution: z.ZodObject<{
309
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
310
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
311
+ note: z.ZodOptional<z.ZodString>;
312
+ }, "strip", z.ZodTypeAny, {
313
+ source: "merchant_challenge" | "external_metadata";
314
+ authority: "authoritative" | "advisory";
315
+ note?: string | undefined;
316
+ }, {
317
+ source: "merchant_challenge" | "external_metadata";
318
+ authority: "authoritative" | "advisory";
319
+ note?: string | undefined;
320
+ }>;
321
+ }, "strip", z.ZodTypeAny, {
322
+ value: string;
323
+ attribution: {
324
+ source: "merchant_challenge" | "external_metadata";
325
+ authority: "authoritative" | "advisory";
326
+ note?: string | undefined;
327
+ };
328
+ }, {
329
+ value: string;
330
+ attribution: {
331
+ source: "merchant_challenge" | "external_metadata";
332
+ authority: "authoritative" | "advisory";
333
+ note?: string | undefined;
334
+ };
335
+ }>;
336
+ export type SdkPreparedHintValue = z.infer<typeof sdkPreparedHintValueSchema>;
337
+ export declare const sdkPreparedHintFieldSchema: z.ZodObject<{
338
+ name: z.ZodString;
339
+ type: z.ZodOptional<z.ZodString>;
340
+ description: z.ZodOptional<z.ZodString>;
341
+ required: z.ZodOptional<z.ZodBoolean>;
342
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
343
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
344
+ } & {
345
+ attribution: z.ZodObject<{
346
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
347
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
348
+ note: z.ZodOptional<z.ZodString>;
349
+ }, "strip", z.ZodTypeAny, {
350
+ source: "merchant_challenge" | "external_metadata";
351
+ authority: "authoritative" | "advisory";
352
+ note?: string | undefined;
353
+ }, {
354
+ source: "merchant_challenge" | "external_metadata";
355
+ authority: "authoritative" | "advisory";
356
+ note?: string | undefined;
357
+ }>;
358
+ }, "strip", z.ZodTypeAny, {
359
+ name: string;
360
+ attribution: {
361
+ source: "merchant_challenge" | "external_metadata";
362
+ authority: "authoritative" | "advisory";
363
+ note?: string | undefined;
364
+ };
365
+ type?: string | undefined;
366
+ required?: boolean | undefined;
367
+ description?: string | undefined;
368
+ defaultValue?: unknown;
369
+ enumValues?: string[] | undefined;
370
+ }, {
371
+ name: string;
372
+ attribution: {
373
+ source: "merchant_challenge" | "external_metadata";
374
+ authority: "authoritative" | "advisory";
375
+ note?: string | undefined;
376
+ };
377
+ type?: string | undefined;
378
+ required?: boolean | undefined;
379
+ description?: string | undefined;
380
+ defaultValue?: unknown;
381
+ enumValues?: string[] | undefined;
382
+ }>;
383
+ export type SdkPreparedHintField = z.infer<typeof sdkPreparedHintFieldSchema>;
384
+ /**
385
+ * Consolidated request-shape hints returned by preparePaidRequest(). Every hint
386
+ * carries attribution so callers can distinguish advisory metadata from live
387
+ * merchant-authoritative evidence.
388
+ */
389
+ export declare const sdkPreparedRequestHintsSchema: z.ZodObject<{
390
+ description: z.ZodOptional<z.ZodObject<{
391
+ value: z.ZodString;
392
+ attribution: z.ZodObject<{
393
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
394
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
395
+ note: z.ZodOptional<z.ZodString>;
396
+ }, "strip", z.ZodTypeAny, {
397
+ source: "merchant_challenge" | "external_metadata";
398
+ authority: "authoritative" | "advisory";
399
+ note?: string | undefined;
400
+ }, {
401
+ source: "merchant_challenge" | "external_metadata";
402
+ authority: "authoritative" | "advisory";
403
+ note?: string | undefined;
404
+ }>;
405
+ }, "strip", z.ZodTypeAny, {
406
+ value: string;
407
+ attribution: {
408
+ source: "merchant_challenge" | "external_metadata";
409
+ authority: "authoritative" | "advisory";
410
+ note?: string | undefined;
411
+ };
412
+ }, {
413
+ value: string;
414
+ attribution: {
415
+ source: "merchant_challenge" | "external_metadata";
416
+ authority: "authoritative" | "advisory";
417
+ note?: string | undefined;
418
+ };
419
+ }>>;
420
+ requestBodyType: z.ZodOptional<z.ZodObject<{
421
+ value: z.ZodString;
422
+ attribution: z.ZodObject<{
423
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
424
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
425
+ note: z.ZodOptional<z.ZodString>;
426
+ }, "strip", z.ZodTypeAny, {
427
+ source: "merchant_challenge" | "external_metadata";
428
+ authority: "authoritative" | "advisory";
429
+ note?: string | undefined;
430
+ }, {
431
+ source: "merchant_challenge" | "external_metadata";
432
+ authority: "authoritative" | "advisory";
433
+ note?: string | undefined;
434
+ }>;
435
+ }, "strip", z.ZodTypeAny, {
436
+ value: string;
437
+ attribution: {
438
+ source: "merchant_challenge" | "external_metadata";
439
+ authority: "authoritative" | "advisory";
440
+ note?: string | undefined;
441
+ };
442
+ }, {
443
+ value: string;
444
+ attribution: {
445
+ source: "merchant_challenge" | "external_metadata";
446
+ authority: "authoritative" | "advisory";
447
+ note?: string | undefined;
448
+ };
449
+ }>>;
450
+ requestBodyExample: z.ZodOptional<z.ZodObject<{
451
+ value: z.ZodString;
452
+ attribution: z.ZodObject<{
453
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
454
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
455
+ note: z.ZodOptional<z.ZodString>;
456
+ }, "strip", z.ZodTypeAny, {
457
+ source: "merchant_challenge" | "external_metadata";
458
+ authority: "authoritative" | "advisory";
459
+ note?: string | undefined;
460
+ }, {
461
+ source: "merchant_challenge" | "external_metadata";
462
+ authority: "authoritative" | "advisory";
463
+ note?: string | undefined;
464
+ }>;
465
+ }, "strip", z.ZodTypeAny, {
466
+ value: string;
467
+ attribution: {
468
+ source: "merchant_challenge" | "external_metadata";
469
+ authority: "authoritative" | "advisory";
470
+ note?: string | undefined;
471
+ };
472
+ }, {
473
+ value: string;
474
+ attribution: {
475
+ source: "merchant_challenge" | "external_metadata";
476
+ authority: "authoritative" | "advisory";
477
+ note?: string | undefined;
478
+ };
479
+ }>>;
480
+ requestBodyFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
481
+ name: z.ZodString;
482
+ type: z.ZodOptional<z.ZodString>;
483
+ description: z.ZodOptional<z.ZodString>;
484
+ required: z.ZodOptional<z.ZodBoolean>;
485
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
486
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
487
+ } & {
488
+ attribution: z.ZodObject<{
489
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
490
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
491
+ note: z.ZodOptional<z.ZodString>;
492
+ }, "strip", z.ZodTypeAny, {
493
+ source: "merchant_challenge" | "external_metadata";
494
+ authority: "authoritative" | "advisory";
495
+ note?: string | undefined;
496
+ }, {
497
+ source: "merchant_challenge" | "external_metadata";
498
+ authority: "authoritative" | "advisory";
499
+ note?: string | undefined;
500
+ }>;
501
+ }, "strip", z.ZodTypeAny, {
502
+ name: string;
503
+ attribution: {
504
+ source: "merchant_challenge" | "external_metadata";
505
+ authority: "authoritative" | "advisory";
506
+ note?: string | undefined;
507
+ };
508
+ type?: string | undefined;
509
+ required?: boolean | undefined;
510
+ description?: string | undefined;
511
+ defaultValue?: unknown;
512
+ enumValues?: string[] | undefined;
513
+ }, {
514
+ name: string;
515
+ attribution: {
516
+ source: "merchant_challenge" | "external_metadata";
517
+ authority: "authoritative" | "advisory";
518
+ note?: string | undefined;
519
+ };
520
+ type?: string | undefined;
521
+ required?: boolean | undefined;
522
+ description?: string | undefined;
523
+ defaultValue?: unknown;
524
+ enumValues?: string[] | undefined;
525
+ }>, "many">>;
526
+ requestQueryParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
527
+ name: z.ZodString;
528
+ type: z.ZodOptional<z.ZodString>;
529
+ description: z.ZodOptional<z.ZodString>;
530
+ required: z.ZodOptional<z.ZodBoolean>;
531
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
532
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
533
+ } & {
534
+ attribution: z.ZodObject<{
535
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
536
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
537
+ note: z.ZodOptional<z.ZodString>;
538
+ }, "strip", z.ZodTypeAny, {
539
+ source: "merchant_challenge" | "external_metadata";
540
+ authority: "authoritative" | "advisory";
541
+ note?: string | undefined;
542
+ }, {
543
+ source: "merchant_challenge" | "external_metadata";
544
+ authority: "authoritative" | "advisory";
545
+ note?: string | undefined;
546
+ }>;
547
+ }, "strip", z.ZodTypeAny, {
548
+ name: string;
549
+ attribution: {
550
+ source: "merchant_challenge" | "external_metadata";
551
+ authority: "authoritative" | "advisory";
552
+ note?: string | undefined;
553
+ };
554
+ type?: string | undefined;
555
+ required?: boolean | undefined;
556
+ description?: string | undefined;
557
+ defaultValue?: unknown;
558
+ enumValues?: string[] | undefined;
559
+ }, {
560
+ name: string;
561
+ attribution: {
562
+ source: "merchant_challenge" | "external_metadata";
563
+ authority: "authoritative" | "advisory";
564
+ note?: string | undefined;
565
+ };
566
+ type?: string | undefined;
567
+ required?: boolean | undefined;
568
+ description?: string | undefined;
569
+ defaultValue?: unknown;
570
+ enumValues?: string[] | undefined;
571
+ }>, "many">>;
572
+ requestPathParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
573
+ name: z.ZodString;
574
+ type: z.ZodOptional<z.ZodString>;
575
+ description: z.ZodOptional<z.ZodString>;
576
+ required: z.ZodOptional<z.ZodBoolean>;
577
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
578
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
579
+ } & {
580
+ attribution: z.ZodObject<{
581
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
582
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
583
+ note: z.ZodOptional<z.ZodString>;
584
+ }, "strip", z.ZodTypeAny, {
585
+ source: "merchant_challenge" | "external_metadata";
586
+ authority: "authoritative" | "advisory";
587
+ note?: string | undefined;
588
+ }, {
589
+ source: "merchant_challenge" | "external_metadata";
590
+ authority: "authoritative" | "advisory";
591
+ note?: string | undefined;
592
+ }>;
593
+ }, "strip", z.ZodTypeAny, {
594
+ name: string;
595
+ attribution: {
596
+ source: "merchant_challenge" | "external_metadata";
597
+ authority: "authoritative" | "advisory";
598
+ note?: string | undefined;
599
+ };
600
+ type?: string | undefined;
601
+ required?: boolean | undefined;
602
+ description?: string | undefined;
603
+ defaultValue?: unknown;
604
+ enumValues?: string[] | undefined;
605
+ }, {
606
+ name: string;
607
+ attribution: {
608
+ source: "merchant_challenge" | "external_metadata";
609
+ authority: "authoritative" | "advisory";
610
+ note?: string | undefined;
611
+ };
612
+ type?: string | undefined;
613
+ required?: boolean | undefined;
614
+ description?: string | undefined;
615
+ defaultValue?: unknown;
616
+ enumValues?: string[] | undefined;
617
+ }>, "many">>;
618
+ notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
619
+ value: z.ZodString;
620
+ attribution: z.ZodObject<{
621
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
622
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
623
+ note: z.ZodOptional<z.ZodString>;
624
+ }, "strip", z.ZodTypeAny, {
625
+ source: "merchant_challenge" | "external_metadata";
626
+ authority: "authoritative" | "advisory";
627
+ note?: string | undefined;
628
+ }, {
629
+ source: "merchant_challenge" | "external_metadata";
630
+ authority: "authoritative" | "advisory";
631
+ note?: string | undefined;
632
+ }>;
633
+ }, "strip", z.ZodTypeAny, {
634
+ value: string;
635
+ attribution: {
636
+ source: "merchant_challenge" | "external_metadata";
637
+ authority: "authoritative" | "advisory";
638
+ note?: string | undefined;
639
+ };
640
+ }, {
641
+ value: string;
642
+ attribution: {
643
+ source: "merchant_challenge" | "external_metadata";
644
+ authority: "authoritative" | "advisory";
645
+ note?: string | undefined;
646
+ };
647
+ }>, "many">>;
648
+ }, "strip", z.ZodTypeAny, {
649
+ requestBodyFields: {
650
+ name: string;
651
+ attribution: {
652
+ source: "merchant_challenge" | "external_metadata";
653
+ authority: "authoritative" | "advisory";
654
+ note?: string | undefined;
655
+ };
656
+ type?: string | undefined;
657
+ required?: boolean | undefined;
658
+ description?: string | undefined;
659
+ defaultValue?: unknown;
660
+ enumValues?: string[] | undefined;
661
+ }[];
662
+ requestQueryParams: {
663
+ name: string;
664
+ attribution: {
665
+ source: "merchant_challenge" | "external_metadata";
666
+ authority: "authoritative" | "advisory";
667
+ note?: string | undefined;
668
+ };
669
+ type?: string | undefined;
670
+ required?: boolean | undefined;
671
+ description?: string | undefined;
672
+ defaultValue?: unknown;
673
+ enumValues?: string[] | undefined;
674
+ }[];
675
+ requestPathParams: {
676
+ name: string;
677
+ attribution: {
678
+ source: "merchant_challenge" | "external_metadata";
679
+ authority: "authoritative" | "advisory";
680
+ note?: string | undefined;
681
+ };
682
+ type?: string | undefined;
683
+ required?: boolean | undefined;
684
+ description?: string | undefined;
685
+ defaultValue?: unknown;
686
+ enumValues?: string[] | undefined;
687
+ }[];
688
+ notes: {
689
+ value: string;
690
+ attribution: {
691
+ source: "merchant_challenge" | "external_metadata";
692
+ authority: "authoritative" | "advisory";
693
+ note?: string | undefined;
694
+ };
695
+ }[];
696
+ description?: {
697
+ value: string;
698
+ attribution: {
699
+ source: "merchant_challenge" | "external_metadata";
700
+ authority: "authoritative" | "advisory";
701
+ note?: string | undefined;
702
+ };
703
+ } | undefined;
704
+ requestBodyType?: {
705
+ value: string;
706
+ attribution: {
707
+ source: "merchant_challenge" | "external_metadata";
708
+ authority: "authoritative" | "advisory";
709
+ note?: string | undefined;
710
+ };
711
+ } | undefined;
712
+ requestBodyExample?: {
713
+ value: string;
714
+ attribution: {
715
+ source: "merchant_challenge" | "external_metadata";
716
+ authority: "authoritative" | "advisory";
717
+ note?: string | undefined;
718
+ };
719
+ } | undefined;
720
+ }, {
721
+ description?: {
722
+ value: string;
723
+ attribution: {
724
+ source: "merchant_challenge" | "external_metadata";
725
+ authority: "authoritative" | "advisory";
726
+ note?: string | undefined;
727
+ };
728
+ } | undefined;
729
+ requestBodyType?: {
730
+ value: string;
731
+ attribution: {
732
+ source: "merchant_challenge" | "external_metadata";
733
+ authority: "authoritative" | "advisory";
734
+ note?: string | undefined;
735
+ };
736
+ } | undefined;
737
+ requestBodyExample?: {
738
+ value: string;
739
+ attribution: {
740
+ source: "merchant_challenge" | "external_metadata";
741
+ authority: "authoritative" | "advisory";
742
+ note?: string | undefined;
743
+ };
744
+ } | undefined;
745
+ requestBodyFields?: {
746
+ name: string;
747
+ attribution: {
748
+ source: "merchant_challenge" | "external_metadata";
749
+ authority: "authoritative" | "advisory";
750
+ note?: string | undefined;
751
+ };
752
+ type?: string | undefined;
753
+ required?: boolean | undefined;
754
+ description?: string | undefined;
755
+ defaultValue?: unknown;
756
+ enumValues?: string[] | undefined;
757
+ }[] | undefined;
758
+ requestQueryParams?: {
759
+ name: string;
760
+ attribution: {
761
+ source: "merchant_challenge" | "external_metadata";
762
+ authority: "authoritative" | "advisory";
763
+ note?: string | undefined;
764
+ };
765
+ type?: string | undefined;
766
+ required?: boolean | undefined;
767
+ description?: string | undefined;
768
+ defaultValue?: unknown;
769
+ enumValues?: string[] | undefined;
770
+ }[] | undefined;
771
+ requestPathParams?: {
772
+ name: string;
773
+ attribution: {
774
+ source: "merchant_challenge" | "external_metadata";
775
+ authority: "authoritative" | "advisory";
776
+ note?: string | undefined;
777
+ };
778
+ type?: string | undefined;
779
+ required?: boolean | undefined;
780
+ description?: string | undefined;
781
+ defaultValue?: unknown;
782
+ enumValues?: string[] | undefined;
783
+ }[] | undefined;
784
+ notes?: {
785
+ value: string;
786
+ attribution: {
787
+ source: "merchant_challenge" | "external_metadata";
788
+ authority: "authoritative" | "advisory";
789
+ note?: string | undefined;
790
+ };
791
+ }[] | undefined;
792
+ }>;
793
+ export type SdkPreparedRequestHints = z.infer<typeof sdkPreparedRequestHintsSchema>;
794
+ export declare const sdkPreparedPaymentRequirementAmountTypeSchema: z.ZodEnum<["exact", "max"]>;
795
+ export type SdkPreparedPaymentRequirementAmountType = z.infer<typeof sdkPreparedPaymentRequirementAmountTypeSchema>;
796
+ /** Normalized payment terms extracted from a merchant challenge when available. */
797
+ export declare const sdkPreparedPaymentRequirementSchema: z.ZodObject<{
798
+ protocol: z.ZodEnum<["x402", "l402"]>;
799
+ description: z.ZodOptional<z.ZodString>;
800
+ asset: z.ZodOptional<z.ZodString>;
801
+ network: z.ZodOptional<z.ZodString>;
802
+ payee: z.ZodOptional<z.ZodString>;
803
+ amountType: z.ZodOptional<z.ZodEnum<["exact", "max"]>>;
804
+ amount: z.ZodOptional<z.ZodString>;
805
+ amountMinor: z.ZodOptional<z.ZodString>;
806
+ precision: z.ZodOptional<z.ZodNumber>;
807
+ provenance: z.ZodObject<{
808
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
809
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
810
+ note: z.ZodOptional<z.ZodString>;
811
+ }, "strip", z.ZodTypeAny, {
812
+ source: "merchant_challenge" | "external_metadata";
813
+ authority: "authoritative" | "advisory";
814
+ note?: string | undefined;
815
+ }, {
816
+ source: "merchant_challenge" | "external_metadata";
817
+ authority: "authoritative" | "advisory";
818
+ note?: string | undefined;
819
+ }>;
820
+ }, "strip", z.ZodTypeAny, {
821
+ protocol: "x402" | "l402";
822
+ provenance: {
823
+ source: "merchant_challenge" | "external_metadata";
824
+ authority: "authoritative" | "advisory";
825
+ note?: string | undefined;
826
+ };
827
+ asset?: string | undefined;
828
+ amount?: string | undefined;
829
+ amountMinor?: string | undefined;
830
+ precision?: number | undefined;
831
+ description?: string | undefined;
832
+ network?: string | undefined;
833
+ payee?: string | undefined;
834
+ amountType?: "exact" | "max" | undefined;
835
+ }, {
836
+ protocol: "x402" | "l402";
837
+ provenance: {
838
+ source: "merchant_challenge" | "external_metadata";
839
+ authority: "authoritative" | "advisory";
840
+ note?: string | undefined;
841
+ };
842
+ asset?: string | undefined;
843
+ amount?: string | undefined;
844
+ amountMinor?: string | undefined;
845
+ precision?: number | undefined;
846
+ description?: string | undefined;
847
+ network?: string | undefined;
848
+ payee?: string | undefined;
849
+ amountType?: "exact" | "max" | undefined;
850
+ }>;
851
+ export type SdkPreparedPaymentRequirement = z.infer<typeof sdkPreparedPaymentRequirementSchema>;
852
+ /** Evidence that the SDK performed an unpaid live probe before preparation. */
853
+ export declare const sdkPreparedProbeResultSchema: z.ZodObject<{
854
+ responseStatus: z.ZodNumber;
855
+ confirmedAt: z.ZodString;
856
+ }, "strip", z.ZodTypeAny, {
857
+ responseStatus: number;
858
+ confirmedAt: string;
859
+ }, {
860
+ responseStatus: number;
861
+ confirmedAt: string;
862
+ }>;
863
+ export type SdkPreparedProbeResult = z.infer<typeof sdkPreparedProbeResultSchema>;
864
+ export declare const sdkPreparedValidationIssueLocationSchema: z.ZodEnum<["body", "query", "path", "headers"]>;
865
+ export type SdkPreparedValidationIssueLocation = z.infer<typeof sdkPreparedValidationIssueLocationSchema>;
866
+ export declare const sdkPreparedValidationSeveritySchema: z.ZodEnum<["error", "warning"]>;
867
+ export type SdkPreparedValidationSeverity = z.infer<typeof sdkPreparedValidationSeveritySchema>;
868
+ /** Structured remediation guidance derived from hints and the candidate request. */
869
+ export declare const sdkPreparedValidationIssueSchema: z.ZodObject<{
870
+ location: z.ZodEnum<["body", "query", "path", "headers"]>;
871
+ field: z.ZodString;
872
+ code: z.ZodString;
873
+ message: z.ZodString;
874
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
875
+ blocking: z.ZodBoolean;
876
+ severity: z.ZodEnum<["error", "warning"]>;
877
+ suggestedFix: z.ZodOptional<z.ZodString>;
878
+ }, "strip", z.ZodTypeAny, {
879
+ code: string;
880
+ message: string;
881
+ source: "merchant_challenge" | "external_metadata";
882
+ location: "path" | "headers" | "body" | "query";
883
+ field: string;
884
+ blocking: boolean;
885
+ severity: "error" | "warning";
886
+ suggestedFix?: string | undefined;
887
+ }, {
888
+ code: string;
889
+ message: string;
890
+ source: "merchant_challenge" | "external_metadata";
891
+ location: "path" | "headers" | "body" | "query";
892
+ field: string;
893
+ blocking: boolean;
894
+ severity: "error" | "warning";
895
+ suggestedFix?: string | undefined;
896
+ }>;
897
+ export type SdkPreparedValidationIssue = z.infer<typeof sdkPreparedValidationIssueSchema>;
898
+ /** Narrow action summary the caller should take after preparation. */
899
+ export declare const sdkPreparedNextActionSchema: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough", "manual_review"]>;
900
+ export type SdkPreparedNextAction = z.infer<typeof sdkPreparedNextActionSchema>;
901
+ /** Preparation result when this exact request does not currently require payment. */
902
+ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
903
+ kind: z.ZodLiteral<"passthrough">;
904
+ protocol: z.ZodLiteral<"none">;
905
+ request: z.ZodObject<{
906
+ url: z.ZodString;
907
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
908
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
909
+ body: z.ZodOptional<z.ZodString>;
910
+ bodyHash: z.ZodOptional<z.ZodString>;
911
+ }, "strip", z.ZodTypeAny, {
912
+ url: string;
913
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
914
+ headers?: Record<string, string> | undefined;
915
+ body?: string | undefined;
916
+ bodyHash?: string | undefined;
917
+ }, {
918
+ url: string;
919
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
920
+ headers?: Record<string, string> | undefined;
921
+ body?: string | undefined;
922
+ bodyHash?: string | undefined;
923
+ }>;
924
+ hints: z.ZodObject<{
925
+ description: z.ZodOptional<z.ZodObject<{
926
+ value: z.ZodString;
927
+ attribution: z.ZodObject<{
928
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
929
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
930
+ note: z.ZodOptional<z.ZodString>;
931
+ }, "strip", z.ZodTypeAny, {
932
+ source: "merchant_challenge" | "external_metadata";
933
+ authority: "authoritative" | "advisory";
934
+ note?: string | undefined;
935
+ }, {
936
+ source: "merchant_challenge" | "external_metadata";
937
+ authority: "authoritative" | "advisory";
938
+ note?: string | undefined;
939
+ }>;
940
+ }, "strip", z.ZodTypeAny, {
941
+ value: string;
942
+ attribution: {
943
+ source: "merchant_challenge" | "external_metadata";
944
+ authority: "authoritative" | "advisory";
945
+ note?: string | undefined;
946
+ };
947
+ }, {
948
+ value: string;
949
+ attribution: {
950
+ source: "merchant_challenge" | "external_metadata";
951
+ authority: "authoritative" | "advisory";
952
+ note?: string | undefined;
953
+ };
954
+ }>>;
955
+ requestBodyType: z.ZodOptional<z.ZodObject<{
956
+ value: z.ZodString;
957
+ attribution: z.ZodObject<{
958
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
959
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
960
+ note: z.ZodOptional<z.ZodString>;
961
+ }, "strip", z.ZodTypeAny, {
962
+ source: "merchant_challenge" | "external_metadata";
963
+ authority: "authoritative" | "advisory";
964
+ note?: string | undefined;
965
+ }, {
966
+ source: "merchant_challenge" | "external_metadata";
967
+ authority: "authoritative" | "advisory";
968
+ note?: string | undefined;
969
+ }>;
970
+ }, "strip", z.ZodTypeAny, {
971
+ value: string;
972
+ attribution: {
973
+ source: "merchant_challenge" | "external_metadata";
974
+ authority: "authoritative" | "advisory";
975
+ note?: string | undefined;
976
+ };
977
+ }, {
978
+ value: string;
979
+ attribution: {
980
+ source: "merchant_challenge" | "external_metadata";
981
+ authority: "authoritative" | "advisory";
982
+ note?: string | undefined;
983
+ };
984
+ }>>;
985
+ requestBodyExample: z.ZodOptional<z.ZodObject<{
986
+ value: z.ZodString;
987
+ attribution: z.ZodObject<{
988
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
989
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
990
+ note: z.ZodOptional<z.ZodString>;
991
+ }, "strip", z.ZodTypeAny, {
992
+ source: "merchant_challenge" | "external_metadata";
993
+ authority: "authoritative" | "advisory";
994
+ note?: string | undefined;
995
+ }, {
996
+ source: "merchant_challenge" | "external_metadata";
997
+ authority: "authoritative" | "advisory";
998
+ note?: string | undefined;
999
+ }>;
1000
+ }, "strip", z.ZodTypeAny, {
1001
+ value: string;
1002
+ attribution: {
1003
+ source: "merchant_challenge" | "external_metadata";
1004
+ authority: "authoritative" | "advisory";
1005
+ note?: string | undefined;
1006
+ };
1007
+ }, {
1008
+ value: string;
1009
+ attribution: {
1010
+ source: "merchant_challenge" | "external_metadata";
1011
+ authority: "authoritative" | "advisory";
1012
+ note?: string | undefined;
1013
+ };
1014
+ }>>;
1015
+ requestBodyFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
1016
+ name: z.ZodString;
1017
+ type: z.ZodOptional<z.ZodString>;
1018
+ description: z.ZodOptional<z.ZodString>;
1019
+ required: z.ZodOptional<z.ZodBoolean>;
1020
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
1021
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1022
+ } & {
1023
+ attribution: z.ZodObject<{
1024
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1025
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1026
+ note: z.ZodOptional<z.ZodString>;
1027
+ }, "strip", z.ZodTypeAny, {
1028
+ source: "merchant_challenge" | "external_metadata";
1029
+ authority: "authoritative" | "advisory";
1030
+ note?: string | undefined;
1031
+ }, {
1032
+ source: "merchant_challenge" | "external_metadata";
1033
+ authority: "authoritative" | "advisory";
1034
+ note?: string | undefined;
1035
+ }>;
1036
+ }, "strip", z.ZodTypeAny, {
1037
+ name: string;
1038
+ attribution: {
1039
+ source: "merchant_challenge" | "external_metadata";
1040
+ authority: "authoritative" | "advisory";
1041
+ note?: string | undefined;
1042
+ };
1043
+ type?: string | undefined;
1044
+ required?: boolean | undefined;
1045
+ description?: string | undefined;
1046
+ defaultValue?: unknown;
1047
+ enumValues?: string[] | undefined;
1048
+ }, {
1049
+ name: string;
1050
+ attribution: {
1051
+ source: "merchant_challenge" | "external_metadata";
1052
+ authority: "authoritative" | "advisory";
1053
+ note?: string | undefined;
1054
+ };
1055
+ type?: string | undefined;
1056
+ required?: boolean | undefined;
1057
+ description?: string | undefined;
1058
+ defaultValue?: unknown;
1059
+ enumValues?: string[] | undefined;
1060
+ }>, "many">>;
1061
+ requestQueryParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
1062
+ name: z.ZodString;
1063
+ type: z.ZodOptional<z.ZodString>;
1064
+ description: z.ZodOptional<z.ZodString>;
1065
+ required: z.ZodOptional<z.ZodBoolean>;
1066
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
1067
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1068
+ } & {
1069
+ attribution: z.ZodObject<{
1070
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1071
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1072
+ note: z.ZodOptional<z.ZodString>;
1073
+ }, "strip", z.ZodTypeAny, {
1074
+ source: "merchant_challenge" | "external_metadata";
1075
+ authority: "authoritative" | "advisory";
1076
+ note?: string | undefined;
1077
+ }, {
1078
+ source: "merchant_challenge" | "external_metadata";
1079
+ authority: "authoritative" | "advisory";
1080
+ note?: string | undefined;
1081
+ }>;
1082
+ }, "strip", z.ZodTypeAny, {
1083
+ name: string;
1084
+ attribution: {
1085
+ source: "merchant_challenge" | "external_metadata";
1086
+ authority: "authoritative" | "advisory";
1087
+ note?: string | undefined;
1088
+ };
1089
+ type?: string | undefined;
1090
+ required?: boolean | undefined;
1091
+ description?: string | undefined;
1092
+ defaultValue?: unknown;
1093
+ enumValues?: string[] | undefined;
1094
+ }, {
1095
+ name: string;
1096
+ attribution: {
1097
+ source: "merchant_challenge" | "external_metadata";
1098
+ authority: "authoritative" | "advisory";
1099
+ note?: string | undefined;
1100
+ };
1101
+ type?: string | undefined;
1102
+ required?: boolean | undefined;
1103
+ description?: string | undefined;
1104
+ defaultValue?: unknown;
1105
+ enumValues?: string[] | undefined;
1106
+ }>, "many">>;
1107
+ requestPathParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
1108
+ name: z.ZodString;
1109
+ type: z.ZodOptional<z.ZodString>;
1110
+ description: z.ZodOptional<z.ZodString>;
1111
+ required: z.ZodOptional<z.ZodBoolean>;
1112
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
1113
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1114
+ } & {
1115
+ attribution: z.ZodObject<{
1116
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1117
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1118
+ note: z.ZodOptional<z.ZodString>;
1119
+ }, "strip", z.ZodTypeAny, {
1120
+ source: "merchant_challenge" | "external_metadata";
1121
+ authority: "authoritative" | "advisory";
1122
+ note?: string | undefined;
1123
+ }, {
1124
+ source: "merchant_challenge" | "external_metadata";
1125
+ authority: "authoritative" | "advisory";
1126
+ note?: string | undefined;
1127
+ }>;
1128
+ }, "strip", z.ZodTypeAny, {
1129
+ name: string;
1130
+ attribution: {
1131
+ source: "merchant_challenge" | "external_metadata";
1132
+ authority: "authoritative" | "advisory";
1133
+ note?: string | undefined;
1134
+ };
1135
+ type?: string | undefined;
1136
+ required?: boolean | undefined;
1137
+ description?: string | undefined;
1138
+ defaultValue?: unknown;
1139
+ enumValues?: string[] | undefined;
1140
+ }, {
1141
+ name: string;
1142
+ attribution: {
1143
+ source: "merchant_challenge" | "external_metadata";
1144
+ authority: "authoritative" | "advisory";
1145
+ note?: string | undefined;
1146
+ };
1147
+ type?: string | undefined;
1148
+ required?: boolean | undefined;
1149
+ description?: string | undefined;
1150
+ defaultValue?: unknown;
1151
+ enumValues?: string[] | undefined;
1152
+ }>, "many">>;
1153
+ notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
1154
+ value: z.ZodString;
1155
+ attribution: z.ZodObject<{
1156
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1157
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1158
+ note: z.ZodOptional<z.ZodString>;
1159
+ }, "strip", z.ZodTypeAny, {
1160
+ source: "merchant_challenge" | "external_metadata";
1161
+ authority: "authoritative" | "advisory";
1162
+ note?: string | undefined;
1163
+ }, {
1164
+ source: "merchant_challenge" | "external_metadata";
1165
+ authority: "authoritative" | "advisory";
1166
+ note?: string | undefined;
1167
+ }>;
1168
+ }, "strip", z.ZodTypeAny, {
1169
+ value: string;
1170
+ attribution: {
1171
+ source: "merchant_challenge" | "external_metadata";
1172
+ authority: "authoritative" | "advisory";
1173
+ note?: string | undefined;
1174
+ };
1175
+ }, {
1176
+ value: string;
1177
+ attribution: {
1178
+ source: "merchant_challenge" | "external_metadata";
1179
+ authority: "authoritative" | "advisory";
1180
+ note?: string | undefined;
1181
+ };
1182
+ }>, "many">>;
1183
+ }, "strip", z.ZodTypeAny, {
1184
+ requestBodyFields: {
1185
+ name: string;
1186
+ attribution: {
1187
+ source: "merchant_challenge" | "external_metadata";
1188
+ authority: "authoritative" | "advisory";
1189
+ note?: string | undefined;
1190
+ };
1191
+ type?: string | undefined;
1192
+ required?: boolean | undefined;
1193
+ description?: string | undefined;
1194
+ defaultValue?: unknown;
1195
+ enumValues?: string[] | undefined;
1196
+ }[];
1197
+ requestQueryParams: {
1198
+ name: string;
1199
+ attribution: {
1200
+ source: "merchant_challenge" | "external_metadata";
1201
+ authority: "authoritative" | "advisory";
1202
+ note?: string | undefined;
1203
+ };
1204
+ type?: string | undefined;
1205
+ required?: boolean | undefined;
1206
+ description?: string | undefined;
1207
+ defaultValue?: unknown;
1208
+ enumValues?: string[] | undefined;
1209
+ }[];
1210
+ requestPathParams: {
1211
+ name: string;
1212
+ attribution: {
1213
+ source: "merchant_challenge" | "external_metadata";
1214
+ authority: "authoritative" | "advisory";
1215
+ note?: string | undefined;
1216
+ };
1217
+ type?: string | undefined;
1218
+ required?: boolean | undefined;
1219
+ description?: string | undefined;
1220
+ defaultValue?: unknown;
1221
+ enumValues?: string[] | undefined;
1222
+ }[];
1223
+ notes: {
1224
+ value: string;
1225
+ attribution: {
1226
+ source: "merchant_challenge" | "external_metadata";
1227
+ authority: "authoritative" | "advisory";
1228
+ note?: string | undefined;
1229
+ };
1230
+ }[];
1231
+ description?: {
1232
+ value: string;
1233
+ attribution: {
1234
+ source: "merchant_challenge" | "external_metadata";
1235
+ authority: "authoritative" | "advisory";
1236
+ note?: string | undefined;
1237
+ };
1238
+ } | undefined;
1239
+ requestBodyType?: {
1240
+ value: string;
1241
+ attribution: {
1242
+ source: "merchant_challenge" | "external_metadata";
1243
+ authority: "authoritative" | "advisory";
1244
+ note?: string | undefined;
1245
+ };
1246
+ } | undefined;
1247
+ requestBodyExample?: {
1248
+ value: string;
1249
+ attribution: {
1250
+ source: "merchant_challenge" | "external_metadata";
1251
+ authority: "authoritative" | "advisory";
1252
+ note?: string | undefined;
1253
+ };
1254
+ } | undefined;
1255
+ }, {
1256
+ description?: {
1257
+ value: string;
1258
+ attribution: {
1259
+ source: "merchant_challenge" | "external_metadata";
1260
+ authority: "authoritative" | "advisory";
1261
+ note?: string | undefined;
1262
+ };
1263
+ } | undefined;
1264
+ requestBodyType?: {
1265
+ value: string;
1266
+ attribution: {
1267
+ source: "merchant_challenge" | "external_metadata";
1268
+ authority: "authoritative" | "advisory";
1269
+ note?: string | undefined;
1270
+ };
1271
+ } | undefined;
1272
+ requestBodyExample?: {
1273
+ value: string;
1274
+ attribution: {
1275
+ source: "merchant_challenge" | "external_metadata";
1276
+ authority: "authoritative" | "advisory";
1277
+ note?: string | undefined;
1278
+ };
1279
+ } | undefined;
1280
+ requestBodyFields?: {
1281
+ name: string;
1282
+ attribution: {
1283
+ source: "merchant_challenge" | "external_metadata";
1284
+ authority: "authoritative" | "advisory";
1285
+ note?: string | undefined;
1286
+ };
1287
+ type?: string | undefined;
1288
+ required?: boolean | undefined;
1289
+ description?: string | undefined;
1290
+ defaultValue?: unknown;
1291
+ enumValues?: string[] | undefined;
1292
+ }[] | undefined;
1293
+ requestQueryParams?: {
1294
+ name: string;
1295
+ attribution: {
1296
+ source: "merchant_challenge" | "external_metadata";
1297
+ authority: "authoritative" | "advisory";
1298
+ note?: string | undefined;
1299
+ };
1300
+ type?: string | undefined;
1301
+ required?: boolean | undefined;
1302
+ description?: string | undefined;
1303
+ defaultValue?: unknown;
1304
+ enumValues?: string[] | undefined;
1305
+ }[] | undefined;
1306
+ requestPathParams?: {
1307
+ name: string;
1308
+ attribution: {
1309
+ source: "merchant_challenge" | "external_metadata";
1310
+ authority: "authoritative" | "advisory";
1311
+ note?: string | undefined;
1312
+ };
1313
+ type?: string | undefined;
1314
+ required?: boolean | undefined;
1315
+ description?: string | undefined;
1316
+ defaultValue?: unknown;
1317
+ enumValues?: string[] | undefined;
1318
+ }[] | undefined;
1319
+ notes?: {
1320
+ value: string;
1321
+ attribution: {
1322
+ source: "merchant_challenge" | "external_metadata";
1323
+ authority: "authoritative" | "advisory";
1324
+ note?: string | undefined;
1325
+ };
1326
+ }[] | undefined;
1327
+ }>;
1328
+ probe: z.ZodOptional<z.ZodObject<{
1329
+ responseStatus: z.ZodNumber;
1330
+ confirmedAt: z.ZodString;
1331
+ }, "strip", z.ZodTypeAny, {
1332
+ responseStatus: number;
1333
+ confirmedAt: string;
1334
+ }, {
1335
+ responseStatus: number;
1336
+ confirmedAt: string;
1337
+ }>>;
1338
+ validationIssues: z.ZodDefault<z.ZodArray<z.ZodObject<{
1339
+ location: z.ZodEnum<["body", "query", "path", "headers"]>;
1340
+ field: z.ZodString;
1341
+ code: z.ZodString;
1342
+ message: z.ZodString;
1343
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1344
+ blocking: z.ZodBoolean;
1345
+ severity: z.ZodEnum<["error", "warning"]>;
1346
+ suggestedFix: z.ZodOptional<z.ZodString>;
1347
+ }, "strip", z.ZodTypeAny, {
1348
+ code: string;
1349
+ message: string;
1350
+ source: "merchant_challenge" | "external_metadata";
1351
+ location: "path" | "headers" | "body" | "query";
1352
+ field: string;
1353
+ blocking: boolean;
1354
+ severity: "error" | "warning";
1355
+ suggestedFix?: string | undefined;
1356
+ }, {
1357
+ code: string;
1358
+ message: string;
1359
+ source: "merchant_challenge" | "external_metadata";
1360
+ location: "path" | "headers" | "body" | "query";
1361
+ field: string;
1362
+ blocking: boolean;
1363
+ severity: "error" | "warning";
1364
+ suggestedFix?: string | undefined;
1365
+ }>, "many">>;
1366
+ nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough", "manual_review"]>;
1367
+ }, "strip", z.ZodTypeAny, {
1368
+ protocol: "none";
1369
+ kind: "passthrough";
1370
+ request: {
1371
+ url: string;
1372
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1373
+ headers?: Record<string, string> | undefined;
1374
+ body?: string | undefined;
1375
+ bodyHash?: string | undefined;
1376
+ };
1377
+ hints: {
1378
+ requestBodyFields: {
1379
+ name: string;
1380
+ attribution: {
1381
+ source: "merchant_challenge" | "external_metadata";
1382
+ authority: "authoritative" | "advisory";
1383
+ note?: string | undefined;
1384
+ };
1385
+ type?: string | undefined;
1386
+ required?: boolean | undefined;
1387
+ description?: string | undefined;
1388
+ defaultValue?: unknown;
1389
+ enumValues?: string[] | undefined;
1390
+ }[];
1391
+ requestQueryParams: {
1392
+ name: string;
1393
+ attribution: {
1394
+ source: "merchant_challenge" | "external_metadata";
1395
+ authority: "authoritative" | "advisory";
1396
+ note?: string | undefined;
1397
+ };
1398
+ type?: string | undefined;
1399
+ required?: boolean | undefined;
1400
+ description?: string | undefined;
1401
+ defaultValue?: unknown;
1402
+ enumValues?: string[] | undefined;
1403
+ }[];
1404
+ requestPathParams: {
1405
+ name: string;
1406
+ attribution: {
1407
+ source: "merchant_challenge" | "external_metadata";
1408
+ authority: "authoritative" | "advisory";
1409
+ note?: string | undefined;
1410
+ };
1411
+ type?: string | undefined;
1412
+ required?: boolean | undefined;
1413
+ description?: string | undefined;
1414
+ defaultValue?: unknown;
1415
+ enumValues?: string[] | undefined;
1416
+ }[];
1417
+ notes: {
1418
+ value: string;
1419
+ attribution: {
1420
+ source: "merchant_challenge" | "external_metadata";
1421
+ authority: "authoritative" | "advisory";
1422
+ note?: string | undefined;
1423
+ };
1424
+ }[];
1425
+ description?: {
1426
+ value: string;
1427
+ attribution: {
1428
+ source: "merchant_challenge" | "external_metadata";
1429
+ authority: "authoritative" | "advisory";
1430
+ note?: string | undefined;
1431
+ };
1432
+ } | undefined;
1433
+ requestBodyType?: {
1434
+ value: string;
1435
+ attribution: {
1436
+ source: "merchant_challenge" | "external_metadata";
1437
+ authority: "authoritative" | "advisory";
1438
+ note?: string | undefined;
1439
+ };
1440
+ } | undefined;
1441
+ requestBodyExample?: {
1442
+ value: string;
1443
+ attribution: {
1444
+ source: "merchant_challenge" | "external_metadata";
1445
+ authority: "authoritative" | "advisory";
1446
+ note?: string | undefined;
1447
+ };
1448
+ } | undefined;
1449
+ };
1450
+ validationIssues: {
1451
+ code: string;
1452
+ message: string;
1453
+ source: "merchant_challenge" | "external_metadata";
1454
+ location: "path" | "headers" | "body" | "query";
1455
+ field: string;
1456
+ blocking: boolean;
1457
+ severity: "error" | "warning";
1458
+ suggestedFix?: string | undefined;
1459
+ }[];
1460
+ nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
1461
+ probe?: {
1462
+ responseStatus: number;
1463
+ confirmedAt: string;
1464
+ } | undefined;
1465
+ }, {
1466
+ protocol: "none";
1467
+ kind: "passthrough";
1468
+ request: {
1469
+ url: string;
1470
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1471
+ headers?: Record<string, string> | undefined;
1472
+ body?: string | undefined;
1473
+ bodyHash?: string | undefined;
1474
+ };
1475
+ hints: {
1476
+ description?: {
1477
+ value: string;
1478
+ attribution: {
1479
+ source: "merchant_challenge" | "external_metadata";
1480
+ authority: "authoritative" | "advisory";
1481
+ note?: string | undefined;
1482
+ };
1483
+ } | undefined;
1484
+ requestBodyType?: {
1485
+ value: string;
1486
+ attribution: {
1487
+ source: "merchant_challenge" | "external_metadata";
1488
+ authority: "authoritative" | "advisory";
1489
+ note?: string | undefined;
1490
+ };
1491
+ } | undefined;
1492
+ requestBodyExample?: {
1493
+ value: string;
1494
+ attribution: {
1495
+ source: "merchant_challenge" | "external_metadata";
1496
+ authority: "authoritative" | "advisory";
1497
+ note?: string | undefined;
1498
+ };
1499
+ } | undefined;
1500
+ requestBodyFields?: {
1501
+ name: string;
1502
+ attribution: {
1503
+ source: "merchant_challenge" | "external_metadata";
1504
+ authority: "authoritative" | "advisory";
1505
+ note?: string | undefined;
1506
+ };
1507
+ type?: string | undefined;
1508
+ required?: boolean | undefined;
1509
+ description?: string | undefined;
1510
+ defaultValue?: unknown;
1511
+ enumValues?: string[] | undefined;
1512
+ }[] | undefined;
1513
+ requestQueryParams?: {
1514
+ name: string;
1515
+ attribution: {
1516
+ source: "merchant_challenge" | "external_metadata";
1517
+ authority: "authoritative" | "advisory";
1518
+ note?: string | undefined;
1519
+ };
1520
+ type?: string | undefined;
1521
+ required?: boolean | undefined;
1522
+ description?: string | undefined;
1523
+ defaultValue?: unknown;
1524
+ enumValues?: string[] | undefined;
1525
+ }[] | undefined;
1526
+ requestPathParams?: {
1527
+ name: string;
1528
+ attribution: {
1529
+ source: "merchant_challenge" | "external_metadata";
1530
+ authority: "authoritative" | "advisory";
1531
+ note?: string | undefined;
1532
+ };
1533
+ type?: string | undefined;
1534
+ required?: boolean | undefined;
1535
+ description?: string | undefined;
1536
+ defaultValue?: unknown;
1537
+ enumValues?: string[] | undefined;
1538
+ }[] | undefined;
1539
+ notes?: {
1540
+ value: string;
1541
+ attribution: {
1542
+ source: "merchant_challenge" | "external_metadata";
1543
+ authority: "authoritative" | "advisory";
1544
+ note?: string | undefined;
1545
+ };
1546
+ }[] | undefined;
1547
+ };
1548
+ nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
1549
+ probe?: {
1550
+ responseStatus: number;
1551
+ confirmedAt: string;
1552
+ } | undefined;
1553
+ validationIssues?: {
1554
+ code: string;
1555
+ message: string;
1556
+ source: "merchant_challenge" | "external_metadata";
1557
+ location: "path" | "headers" | "body" | "query";
1558
+ field: string;
1559
+ blocking: boolean;
1560
+ severity: "error" | "warning";
1561
+ suggestedFix?: string | undefined;
1562
+ }[] | undefined;
1563
+ }>;
1564
+ export type SdkPreparedPaidRequestPassthrough = z.infer<typeof sdkPreparedPaidRequestPassthroughSchema>;
1565
+ /** Preparation result when this exact request is payable and executable. */
1566
+ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
1567
+ kind: z.ZodLiteral<"ready">;
1568
+ protocol: z.ZodEnum<["x402", "l402"]>;
1569
+ request: z.ZodObject<{
1570
+ url: z.ZodString;
1571
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
1572
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
1573
+ body: z.ZodOptional<z.ZodString>;
1574
+ bodyHash: z.ZodOptional<z.ZodString>;
1575
+ }, "strip", z.ZodTypeAny, {
1576
+ url: string;
1577
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1578
+ headers?: Record<string, string> | undefined;
1579
+ body?: string | undefined;
1580
+ bodyHash?: string | undefined;
1581
+ }, {
1582
+ url: string;
1583
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1584
+ headers?: Record<string, string> | undefined;
1585
+ body?: string | undefined;
1586
+ bodyHash?: string | undefined;
1587
+ }>;
1588
+ challenge: z.ZodObject<{
1589
+ protocol: z.ZodEnum<["x402", "l402"]>;
1590
+ headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
1591
+ body: z.ZodOptional<z.ZodUnknown>;
1592
+ }, "strip", z.ZodTypeAny, {
1593
+ headers: Record<string, string>;
1594
+ protocol: "x402" | "l402";
1595
+ body?: unknown;
1596
+ }, {
1597
+ protocol: "x402" | "l402";
1598
+ headers?: Record<string, string> | undefined;
1599
+ body?: unknown;
1600
+ }>;
1601
+ paymentRequirement: z.ZodOptional<z.ZodObject<{
1602
+ protocol: z.ZodEnum<["x402", "l402"]>;
1603
+ description: z.ZodOptional<z.ZodString>;
1604
+ asset: z.ZodOptional<z.ZodString>;
1605
+ network: z.ZodOptional<z.ZodString>;
1606
+ payee: z.ZodOptional<z.ZodString>;
1607
+ amountType: z.ZodOptional<z.ZodEnum<["exact", "max"]>>;
1608
+ amount: z.ZodOptional<z.ZodString>;
1609
+ amountMinor: z.ZodOptional<z.ZodString>;
1610
+ precision: z.ZodOptional<z.ZodNumber>;
1611
+ provenance: z.ZodObject<{
1612
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1613
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1614
+ note: z.ZodOptional<z.ZodString>;
1615
+ }, "strip", z.ZodTypeAny, {
1616
+ source: "merchant_challenge" | "external_metadata";
1617
+ authority: "authoritative" | "advisory";
1618
+ note?: string | undefined;
1619
+ }, {
1620
+ source: "merchant_challenge" | "external_metadata";
1621
+ authority: "authoritative" | "advisory";
1622
+ note?: string | undefined;
1623
+ }>;
1624
+ }, "strip", z.ZodTypeAny, {
1625
+ protocol: "x402" | "l402";
1626
+ provenance: {
1627
+ source: "merchant_challenge" | "external_metadata";
1628
+ authority: "authoritative" | "advisory";
1629
+ note?: string | undefined;
1630
+ };
1631
+ asset?: string | undefined;
1632
+ amount?: string | undefined;
1633
+ amountMinor?: string | undefined;
1634
+ precision?: number | undefined;
1635
+ description?: string | undefined;
1636
+ network?: string | undefined;
1637
+ payee?: string | undefined;
1638
+ amountType?: "exact" | "max" | undefined;
1639
+ }, {
1640
+ protocol: "x402" | "l402";
1641
+ provenance: {
1642
+ source: "merchant_challenge" | "external_metadata";
1643
+ authority: "authoritative" | "advisory";
1644
+ note?: string | undefined;
1645
+ };
1646
+ asset?: string | undefined;
1647
+ amount?: string | undefined;
1648
+ amountMinor?: string | undefined;
1649
+ precision?: number | undefined;
1650
+ description?: string | undefined;
1651
+ network?: string | undefined;
1652
+ payee?: string | undefined;
1653
+ amountType?: "exact" | "max" | undefined;
1654
+ }>>;
1655
+ hints: z.ZodObject<{
1656
+ description: z.ZodOptional<z.ZodObject<{
1657
+ value: z.ZodString;
1658
+ attribution: z.ZodObject<{
1659
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1660
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1661
+ note: z.ZodOptional<z.ZodString>;
1662
+ }, "strip", z.ZodTypeAny, {
1663
+ source: "merchant_challenge" | "external_metadata";
1664
+ authority: "authoritative" | "advisory";
1665
+ note?: string | undefined;
1666
+ }, {
1667
+ source: "merchant_challenge" | "external_metadata";
1668
+ authority: "authoritative" | "advisory";
1669
+ note?: string | undefined;
1670
+ }>;
1671
+ }, "strip", z.ZodTypeAny, {
1672
+ value: string;
1673
+ attribution: {
1674
+ source: "merchant_challenge" | "external_metadata";
1675
+ authority: "authoritative" | "advisory";
1676
+ note?: string | undefined;
1677
+ };
1678
+ }, {
1679
+ value: string;
1680
+ attribution: {
1681
+ source: "merchant_challenge" | "external_metadata";
1682
+ authority: "authoritative" | "advisory";
1683
+ note?: string | undefined;
1684
+ };
1685
+ }>>;
1686
+ requestBodyType: z.ZodOptional<z.ZodObject<{
1687
+ value: z.ZodString;
1688
+ attribution: z.ZodObject<{
1689
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1690
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1691
+ note: z.ZodOptional<z.ZodString>;
1692
+ }, "strip", z.ZodTypeAny, {
1693
+ source: "merchant_challenge" | "external_metadata";
1694
+ authority: "authoritative" | "advisory";
1695
+ note?: string | undefined;
1696
+ }, {
1697
+ source: "merchant_challenge" | "external_metadata";
1698
+ authority: "authoritative" | "advisory";
1699
+ note?: string | undefined;
1700
+ }>;
1701
+ }, "strip", z.ZodTypeAny, {
1702
+ value: string;
1703
+ attribution: {
1704
+ source: "merchant_challenge" | "external_metadata";
1705
+ authority: "authoritative" | "advisory";
1706
+ note?: string | undefined;
1707
+ };
1708
+ }, {
1709
+ value: string;
1710
+ attribution: {
1711
+ source: "merchant_challenge" | "external_metadata";
1712
+ authority: "authoritative" | "advisory";
1713
+ note?: string | undefined;
1714
+ };
1715
+ }>>;
1716
+ requestBodyExample: z.ZodOptional<z.ZodObject<{
1717
+ value: z.ZodString;
1718
+ attribution: z.ZodObject<{
1719
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1720
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1721
+ note: z.ZodOptional<z.ZodString>;
1722
+ }, "strip", z.ZodTypeAny, {
1723
+ source: "merchant_challenge" | "external_metadata";
1724
+ authority: "authoritative" | "advisory";
1725
+ note?: string | undefined;
1726
+ }, {
1727
+ source: "merchant_challenge" | "external_metadata";
1728
+ authority: "authoritative" | "advisory";
1729
+ note?: string | undefined;
1730
+ }>;
1731
+ }, "strip", z.ZodTypeAny, {
1732
+ value: string;
1733
+ attribution: {
1734
+ source: "merchant_challenge" | "external_metadata";
1735
+ authority: "authoritative" | "advisory";
1736
+ note?: string | undefined;
1737
+ };
1738
+ }, {
1739
+ value: string;
1740
+ attribution: {
1741
+ source: "merchant_challenge" | "external_metadata";
1742
+ authority: "authoritative" | "advisory";
1743
+ note?: string | undefined;
1744
+ };
1745
+ }>>;
1746
+ requestBodyFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
1747
+ name: z.ZodString;
1748
+ type: z.ZodOptional<z.ZodString>;
1749
+ description: z.ZodOptional<z.ZodString>;
1750
+ required: z.ZodOptional<z.ZodBoolean>;
1751
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
1752
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1753
+ } & {
1754
+ attribution: z.ZodObject<{
1755
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1756
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1757
+ note: z.ZodOptional<z.ZodString>;
1758
+ }, "strip", z.ZodTypeAny, {
1759
+ source: "merchant_challenge" | "external_metadata";
1760
+ authority: "authoritative" | "advisory";
1761
+ note?: string | undefined;
1762
+ }, {
1763
+ source: "merchant_challenge" | "external_metadata";
1764
+ authority: "authoritative" | "advisory";
1765
+ note?: string | undefined;
1766
+ }>;
1767
+ }, "strip", z.ZodTypeAny, {
1768
+ name: string;
1769
+ attribution: {
1770
+ source: "merchant_challenge" | "external_metadata";
1771
+ authority: "authoritative" | "advisory";
1772
+ note?: string | undefined;
1773
+ };
1774
+ type?: string | undefined;
1775
+ required?: boolean | undefined;
1776
+ description?: string | undefined;
1777
+ defaultValue?: unknown;
1778
+ enumValues?: string[] | undefined;
1779
+ }, {
1780
+ name: string;
1781
+ attribution: {
1782
+ source: "merchant_challenge" | "external_metadata";
1783
+ authority: "authoritative" | "advisory";
1784
+ note?: string | undefined;
1785
+ };
1786
+ type?: string | undefined;
1787
+ required?: boolean | undefined;
1788
+ description?: string | undefined;
1789
+ defaultValue?: unknown;
1790
+ enumValues?: string[] | undefined;
1791
+ }>, "many">>;
1792
+ requestQueryParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
1793
+ name: z.ZodString;
1794
+ type: z.ZodOptional<z.ZodString>;
1795
+ description: z.ZodOptional<z.ZodString>;
1796
+ required: z.ZodOptional<z.ZodBoolean>;
1797
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
1798
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1799
+ } & {
1800
+ attribution: z.ZodObject<{
1801
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1802
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1803
+ note: z.ZodOptional<z.ZodString>;
1804
+ }, "strip", z.ZodTypeAny, {
1805
+ source: "merchant_challenge" | "external_metadata";
1806
+ authority: "authoritative" | "advisory";
1807
+ note?: string | undefined;
1808
+ }, {
1809
+ source: "merchant_challenge" | "external_metadata";
1810
+ authority: "authoritative" | "advisory";
1811
+ note?: string | undefined;
1812
+ }>;
1813
+ }, "strip", z.ZodTypeAny, {
1814
+ name: string;
1815
+ attribution: {
1816
+ source: "merchant_challenge" | "external_metadata";
1817
+ authority: "authoritative" | "advisory";
1818
+ note?: string | undefined;
1819
+ };
1820
+ type?: string | undefined;
1821
+ required?: boolean | undefined;
1822
+ description?: string | undefined;
1823
+ defaultValue?: unknown;
1824
+ enumValues?: string[] | undefined;
1825
+ }, {
1826
+ name: string;
1827
+ attribution: {
1828
+ source: "merchant_challenge" | "external_metadata";
1829
+ authority: "authoritative" | "advisory";
1830
+ note?: string | undefined;
1831
+ };
1832
+ type?: string | undefined;
1833
+ required?: boolean | undefined;
1834
+ description?: string | undefined;
1835
+ defaultValue?: unknown;
1836
+ enumValues?: string[] | undefined;
1837
+ }>, "many">>;
1838
+ requestPathParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
1839
+ name: z.ZodString;
1840
+ type: z.ZodOptional<z.ZodString>;
1841
+ description: z.ZodOptional<z.ZodString>;
1842
+ required: z.ZodOptional<z.ZodBoolean>;
1843
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
1844
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1845
+ } & {
1846
+ attribution: z.ZodObject<{
1847
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1848
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1849
+ note: z.ZodOptional<z.ZodString>;
1850
+ }, "strip", z.ZodTypeAny, {
1851
+ source: "merchant_challenge" | "external_metadata";
1852
+ authority: "authoritative" | "advisory";
1853
+ note?: string | undefined;
1854
+ }, {
1855
+ source: "merchant_challenge" | "external_metadata";
1856
+ authority: "authoritative" | "advisory";
1857
+ note?: string | undefined;
1858
+ }>;
1859
+ }, "strip", z.ZodTypeAny, {
1860
+ name: string;
1861
+ attribution: {
1862
+ source: "merchant_challenge" | "external_metadata";
1863
+ authority: "authoritative" | "advisory";
1864
+ note?: string | undefined;
1865
+ };
1866
+ type?: string | undefined;
1867
+ required?: boolean | undefined;
1868
+ description?: string | undefined;
1869
+ defaultValue?: unknown;
1870
+ enumValues?: string[] | undefined;
1871
+ }, {
1872
+ name: string;
1873
+ attribution: {
1874
+ source: "merchant_challenge" | "external_metadata";
1875
+ authority: "authoritative" | "advisory";
1876
+ note?: string | undefined;
1877
+ };
1878
+ type?: string | undefined;
1879
+ required?: boolean | undefined;
1880
+ description?: string | undefined;
1881
+ defaultValue?: unknown;
1882
+ enumValues?: string[] | undefined;
1883
+ }>, "many">>;
1884
+ notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
1885
+ value: z.ZodString;
1886
+ attribution: z.ZodObject<{
1887
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
1888
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
1889
+ note: z.ZodOptional<z.ZodString>;
1890
+ }, "strip", z.ZodTypeAny, {
1891
+ source: "merchant_challenge" | "external_metadata";
1892
+ authority: "authoritative" | "advisory";
1893
+ note?: string | undefined;
1894
+ }, {
1895
+ source: "merchant_challenge" | "external_metadata";
1896
+ authority: "authoritative" | "advisory";
1897
+ note?: string | undefined;
1898
+ }>;
1899
+ }, "strip", z.ZodTypeAny, {
1900
+ value: string;
1901
+ attribution: {
1902
+ source: "merchant_challenge" | "external_metadata";
1903
+ authority: "authoritative" | "advisory";
1904
+ note?: string | undefined;
1905
+ };
1906
+ }, {
1907
+ value: string;
1908
+ attribution: {
1909
+ source: "merchant_challenge" | "external_metadata";
1910
+ authority: "authoritative" | "advisory";
1911
+ note?: string | undefined;
1912
+ };
1913
+ }>, "many">>;
1914
+ }, "strip", z.ZodTypeAny, {
1915
+ requestBodyFields: {
1916
+ name: string;
1917
+ attribution: {
1918
+ source: "merchant_challenge" | "external_metadata";
1919
+ authority: "authoritative" | "advisory";
1920
+ note?: string | undefined;
1921
+ };
1922
+ type?: string | undefined;
1923
+ required?: boolean | undefined;
1924
+ description?: string | undefined;
1925
+ defaultValue?: unknown;
1926
+ enumValues?: string[] | undefined;
1927
+ }[];
1928
+ requestQueryParams: {
1929
+ name: string;
1930
+ attribution: {
1931
+ source: "merchant_challenge" | "external_metadata";
1932
+ authority: "authoritative" | "advisory";
1933
+ note?: string | undefined;
1934
+ };
1935
+ type?: string | undefined;
1936
+ required?: boolean | undefined;
1937
+ description?: string | undefined;
1938
+ defaultValue?: unknown;
1939
+ enumValues?: string[] | undefined;
1940
+ }[];
1941
+ requestPathParams: {
1942
+ name: string;
1943
+ attribution: {
1944
+ source: "merchant_challenge" | "external_metadata";
1945
+ authority: "authoritative" | "advisory";
1946
+ note?: string | undefined;
1947
+ };
1948
+ type?: string | undefined;
1949
+ required?: boolean | undefined;
1950
+ description?: string | undefined;
1951
+ defaultValue?: unknown;
1952
+ enumValues?: string[] | undefined;
1953
+ }[];
1954
+ notes: {
1955
+ value: string;
1956
+ attribution: {
1957
+ source: "merchant_challenge" | "external_metadata";
1958
+ authority: "authoritative" | "advisory";
1959
+ note?: string | undefined;
1960
+ };
1961
+ }[];
1962
+ description?: {
1963
+ value: string;
1964
+ attribution: {
1965
+ source: "merchant_challenge" | "external_metadata";
1966
+ authority: "authoritative" | "advisory";
1967
+ note?: string | undefined;
1968
+ };
1969
+ } | undefined;
1970
+ requestBodyType?: {
1971
+ value: string;
1972
+ attribution: {
1973
+ source: "merchant_challenge" | "external_metadata";
1974
+ authority: "authoritative" | "advisory";
1975
+ note?: string | undefined;
1976
+ };
1977
+ } | undefined;
1978
+ requestBodyExample?: {
1979
+ value: string;
1980
+ attribution: {
1981
+ source: "merchant_challenge" | "external_metadata";
1982
+ authority: "authoritative" | "advisory";
1983
+ note?: string | undefined;
1984
+ };
1985
+ } | undefined;
1986
+ }, {
1987
+ description?: {
1988
+ value: string;
1989
+ attribution: {
1990
+ source: "merchant_challenge" | "external_metadata";
1991
+ authority: "authoritative" | "advisory";
1992
+ note?: string | undefined;
1993
+ };
1994
+ } | undefined;
1995
+ requestBodyType?: {
1996
+ value: string;
1997
+ attribution: {
1998
+ source: "merchant_challenge" | "external_metadata";
1999
+ authority: "authoritative" | "advisory";
2000
+ note?: string | undefined;
2001
+ };
2002
+ } | undefined;
2003
+ requestBodyExample?: {
2004
+ value: string;
2005
+ attribution: {
2006
+ source: "merchant_challenge" | "external_metadata";
2007
+ authority: "authoritative" | "advisory";
2008
+ note?: string | undefined;
2009
+ };
2010
+ } | undefined;
2011
+ requestBodyFields?: {
2012
+ name: string;
2013
+ attribution: {
2014
+ source: "merchant_challenge" | "external_metadata";
2015
+ authority: "authoritative" | "advisory";
2016
+ note?: string | undefined;
2017
+ };
2018
+ type?: string | undefined;
2019
+ required?: boolean | undefined;
2020
+ description?: string | undefined;
2021
+ defaultValue?: unknown;
2022
+ enumValues?: string[] | undefined;
2023
+ }[] | undefined;
2024
+ requestQueryParams?: {
2025
+ name: string;
2026
+ attribution: {
2027
+ source: "merchant_challenge" | "external_metadata";
2028
+ authority: "authoritative" | "advisory";
2029
+ note?: string | undefined;
2030
+ };
2031
+ type?: string | undefined;
2032
+ required?: boolean | undefined;
2033
+ description?: string | undefined;
2034
+ defaultValue?: unknown;
2035
+ enumValues?: string[] | undefined;
2036
+ }[] | undefined;
2037
+ requestPathParams?: {
2038
+ name: string;
2039
+ attribution: {
2040
+ source: "merchant_challenge" | "external_metadata";
2041
+ authority: "authoritative" | "advisory";
2042
+ note?: string | undefined;
2043
+ };
2044
+ type?: string | undefined;
2045
+ required?: boolean | undefined;
2046
+ description?: string | undefined;
2047
+ defaultValue?: unknown;
2048
+ enumValues?: string[] | undefined;
2049
+ }[] | undefined;
2050
+ notes?: {
2051
+ value: string;
2052
+ attribution: {
2053
+ source: "merchant_challenge" | "external_metadata";
2054
+ authority: "authoritative" | "advisory";
2055
+ note?: string | undefined;
2056
+ };
2057
+ }[] | undefined;
2058
+ }>;
2059
+ probe: z.ZodOptional<z.ZodObject<{
2060
+ responseStatus: z.ZodNumber;
2061
+ confirmedAt: z.ZodString;
2062
+ }, "strip", z.ZodTypeAny, {
2063
+ responseStatus: number;
2064
+ confirmedAt: string;
2065
+ }, {
2066
+ responseStatus: number;
2067
+ confirmedAt: string;
2068
+ }>>;
2069
+ validationIssues: z.ZodDefault<z.ZodArray<z.ZodObject<{
2070
+ location: z.ZodEnum<["body", "query", "path", "headers"]>;
2071
+ field: z.ZodString;
2072
+ code: z.ZodString;
2073
+ message: z.ZodString;
2074
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
2075
+ blocking: z.ZodBoolean;
2076
+ severity: z.ZodEnum<["error", "warning"]>;
2077
+ suggestedFix: z.ZodOptional<z.ZodString>;
2078
+ }, "strip", z.ZodTypeAny, {
2079
+ code: string;
2080
+ message: string;
2081
+ source: "merchant_challenge" | "external_metadata";
2082
+ location: "path" | "headers" | "body" | "query";
2083
+ field: string;
2084
+ blocking: boolean;
2085
+ severity: "error" | "warning";
2086
+ suggestedFix?: string | undefined;
2087
+ }, {
2088
+ code: string;
2089
+ message: string;
2090
+ source: "merchant_challenge" | "external_metadata";
2091
+ location: "path" | "headers" | "body" | "query";
2092
+ field: string;
2093
+ blocking: boolean;
2094
+ severity: "error" | "warning";
2095
+ suggestedFix?: string | undefined;
2096
+ }>, "many">>;
2097
+ nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough", "manual_review"]>;
2098
+ }, "strip", z.ZodTypeAny, {
2099
+ protocol: "x402" | "l402";
2100
+ kind: "ready";
2101
+ request: {
2102
+ url: string;
2103
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
2104
+ headers?: Record<string, string> | undefined;
2105
+ body?: string | undefined;
2106
+ bodyHash?: string | undefined;
2107
+ };
2108
+ hints: {
2109
+ requestBodyFields: {
2110
+ name: string;
2111
+ attribution: {
2112
+ source: "merchant_challenge" | "external_metadata";
2113
+ authority: "authoritative" | "advisory";
2114
+ note?: string | undefined;
2115
+ };
2116
+ type?: string | undefined;
2117
+ required?: boolean | undefined;
2118
+ description?: string | undefined;
2119
+ defaultValue?: unknown;
2120
+ enumValues?: string[] | undefined;
2121
+ }[];
2122
+ requestQueryParams: {
2123
+ name: string;
2124
+ attribution: {
2125
+ source: "merchant_challenge" | "external_metadata";
2126
+ authority: "authoritative" | "advisory";
2127
+ note?: string | undefined;
2128
+ };
2129
+ type?: string | undefined;
2130
+ required?: boolean | undefined;
2131
+ description?: string | undefined;
2132
+ defaultValue?: unknown;
2133
+ enumValues?: string[] | undefined;
2134
+ }[];
2135
+ requestPathParams: {
2136
+ name: string;
2137
+ attribution: {
2138
+ source: "merchant_challenge" | "external_metadata";
2139
+ authority: "authoritative" | "advisory";
2140
+ note?: string | undefined;
2141
+ };
2142
+ type?: string | undefined;
2143
+ required?: boolean | undefined;
2144
+ description?: string | undefined;
2145
+ defaultValue?: unknown;
2146
+ enumValues?: string[] | undefined;
2147
+ }[];
2148
+ notes: {
2149
+ value: string;
2150
+ attribution: {
2151
+ source: "merchant_challenge" | "external_metadata";
2152
+ authority: "authoritative" | "advisory";
2153
+ note?: string | undefined;
2154
+ };
2155
+ }[];
2156
+ description?: {
2157
+ value: string;
2158
+ attribution: {
2159
+ source: "merchant_challenge" | "external_metadata";
2160
+ authority: "authoritative" | "advisory";
2161
+ note?: string | undefined;
2162
+ };
2163
+ } | undefined;
2164
+ requestBodyType?: {
2165
+ value: string;
2166
+ attribution: {
2167
+ source: "merchant_challenge" | "external_metadata";
2168
+ authority: "authoritative" | "advisory";
2169
+ note?: string | undefined;
2170
+ };
2171
+ } | undefined;
2172
+ requestBodyExample?: {
2173
+ value: string;
2174
+ attribution: {
2175
+ source: "merchant_challenge" | "external_metadata";
2176
+ authority: "authoritative" | "advisory";
2177
+ note?: string | undefined;
2178
+ };
2179
+ } | undefined;
2180
+ };
2181
+ validationIssues: {
2182
+ code: string;
2183
+ message: string;
2184
+ source: "merchant_challenge" | "external_metadata";
2185
+ location: "path" | "headers" | "body" | "query";
2186
+ field: string;
2187
+ blocking: boolean;
2188
+ severity: "error" | "warning";
2189
+ suggestedFix?: string | undefined;
2190
+ }[];
2191
+ nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
2192
+ challenge: {
2193
+ headers: Record<string, string>;
2194
+ protocol: "x402" | "l402";
2195
+ body?: unknown;
2196
+ };
2197
+ probe?: {
2198
+ responseStatus: number;
2199
+ confirmedAt: string;
2200
+ } | undefined;
2201
+ paymentRequirement?: {
2202
+ protocol: "x402" | "l402";
2203
+ provenance: {
2204
+ source: "merchant_challenge" | "external_metadata";
2205
+ authority: "authoritative" | "advisory";
2206
+ note?: string | undefined;
2207
+ };
2208
+ asset?: string | undefined;
2209
+ amount?: string | undefined;
2210
+ amountMinor?: string | undefined;
2211
+ precision?: number | undefined;
2212
+ description?: string | undefined;
2213
+ network?: string | undefined;
2214
+ payee?: string | undefined;
2215
+ amountType?: "exact" | "max" | undefined;
2216
+ } | undefined;
2217
+ }, {
2218
+ protocol: "x402" | "l402";
2219
+ kind: "ready";
2220
+ request: {
2221
+ url: string;
2222
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
2223
+ headers?: Record<string, string> | undefined;
2224
+ body?: string | undefined;
2225
+ bodyHash?: string | undefined;
2226
+ };
2227
+ hints: {
2228
+ description?: {
2229
+ value: string;
2230
+ attribution: {
2231
+ source: "merchant_challenge" | "external_metadata";
2232
+ authority: "authoritative" | "advisory";
2233
+ note?: string | undefined;
2234
+ };
2235
+ } | undefined;
2236
+ requestBodyType?: {
2237
+ value: string;
2238
+ attribution: {
2239
+ source: "merchant_challenge" | "external_metadata";
2240
+ authority: "authoritative" | "advisory";
2241
+ note?: string | undefined;
2242
+ };
2243
+ } | undefined;
2244
+ requestBodyExample?: {
2245
+ value: string;
2246
+ attribution: {
2247
+ source: "merchant_challenge" | "external_metadata";
2248
+ authority: "authoritative" | "advisory";
2249
+ note?: string | undefined;
2250
+ };
2251
+ } | undefined;
2252
+ requestBodyFields?: {
2253
+ name: string;
2254
+ attribution: {
2255
+ source: "merchant_challenge" | "external_metadata";
2256
+ authority: "authoritative" | "advisory";
2257
+ note?: string | undefined;
2258
+ };
2259
+ type?: string | undefined;
2260
+ required?: boolean | undefined;
2261
+ description?: string | undefined;
2262
+ defaultValue?: unknown;
2263
+ enumValues?: string[] | undefined;
2264
+ }[] | undefined;
2265
+ requestQueryParams?: {
2266
+ name: string;
2267
+ attribution: {
2268
+ source: "merchant_challenge" | "external_metadata";
2269
+ authority: "authoritative" | "advisory";
2270
+ note?: string | undefined;
2271
+ };
2272
+ type?: string | undefined;
2273
+ required?: boolean | undefined;
2274
+ description?: string | undefined;
2275
+ defaultValue?: unknown;
2276
+ enumValues?: string[] | undefined;
2277
+ }[] | undefined;
2278
+ requestPathParams?: {
2279
+ name: string;
2280
+ attribution: {
2281
+ source: "merchant_challenge" | "external_metadata";
2282
+ authority: "authoritative" | "advisory";
2283
+ note?: string | undefined;
2284
+ };
2285
+ type?: string | undefined;
2286
+ required?: boolean | undefined;
2287
+ description?: string | undefined;
2288
+ defaultValue?: unknown;
2289
+ enumValues?: string[] | undefined;
2290
+ }[] | undefined;
2291
+ notes?: {
2292
+ value: string;
2293
+ attribution: {
2294
+ source: "merchant_challenge" | "external_metadata";
2295
+ authority: "authoritative" | "advisory";
2296
+ note?: string | undefined;
2297
+ };
2298
+ }[] | undefined;
2299
+ };
2300
+ nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
2301
+ challenge: {
2302
+ protocol: "x402" | "l402";
2303
+ headers?: Record<string, string> | undefined;
2304
+ body?: unknown;
2305
+ };
2306
+ probe?: {
2307
+ responseStatus: number;
2308
+ confirmedAt: string;
2309
+ } | undefined;
2310
+ validationIssues?: {
2311
+ code: string;
2312
+ message: string;
2313
+ source: "merchant_challenge" | "external_metadata";
2314
+ location: "path" | "headers" | "body" | "query";
2315
+ field: string;
2316
+ blocking: boolean;
2317
+ severity: "error" | "warning";
2318
+ suggestedFix?: string | undefined;
2319
+ }[] | undefined;
2320
+ paymentRequirement?: {
2321
+ protocol: "x402" | "l402";
2322
+ provenance: {
2323
+ source: "merchant_challenge" | "external_metadata";
2324
+ authority: "authoritative" | "advisory";
2325
+ note?: string | undefined;
2326
+ };
2327
+ asset?: string | undefined;
2328
+ amount?: string | undefined;
2329
+ amountMinor?: string | undefined;
2330
+ precision?: number | undefined;
2331
+ description?: string | undefined;
2332
+ network?: string | undefined;
2333
+ payee?: string | undefined;
2334
+ amountType?: "exact" | "max" | undefined;
2335
+ } | undefined;
2336
+ }>;
2337
+ export type SdkPreparedPaidRequestReady = z.infer<typeof sdkPreparedPaidRequestReadySchema>;
2338
+ /** Discriminated union returned by AgentPayClient.preparePaidRequest(). */
2339
+ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
2340
+ kind: z.ZodLiteral<"passthrough">;
2341
+ protocol: z.ZodLiteral<"none">;
2342
+ request: z.ZodObject<{
2343
+ url: z.ZodString;
2344
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
2345
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
2346
+ body: z.ZodOptional<z.ZodString>;
2347
+ bodyHash: z.ZodOptional<z.ZodString>;
2348
+ }, "strip", z.ZodTypeAny, {
2349
+ url: string;
2350
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
2351
+ headers?: Record<string, string> | undefined;
2352
+ body?: string | undefined;
2353
+ bodyHash?: string | undefined;
2354
+ }, {
2355
+ url: string;
2356
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
2357
+ headers?: Record<string, string> | undefined;
2358
+ body?: string | undefined;
2359
+ bodyHash?: string | undefined;
2360
+ }>;
2361
+ hints: z.ZodObject<{
2362
+ description: z.ZodOptional<z.ZodObject<{
2363
+ value: z.ZodString;
2364
+ attribution: z.ZodObject<{
2365
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
2366
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
2367
+ note: z.ZodOptional<z.ZodString>;
2368
+ }, "strip", z.ZodTypeAny, {
2369
+ source: "merchant_challenge" | "external_metadata";
2370
+ authority: "authoritative" | "advisory";
2371
+ note?: string | undefined;
2372
+ }, {
2373
+ source: "merchant_challenge" | "external_metadata";
2374
+ authority: "authoritative" | "advisory";
2375
+ note?: string | undefined;
2376
+ }>;
2377
+ }, "strip", z.ZodTypeAny, {
2378
+ value: string;
2379
+ attribution: {
2380
+ source: "merchant_challenge" | "external_metadata";
2381
+ authority: "authoritative" | "advisory";
2382
+ note?: string | undefined;
2383
+ };
2384
+ }, {
2385
+ value: string;
2386
+ attribution: {
2387
+ source: "merchant_challenge" | "external_metadata";
2388
+ authority: "authoritative" | "advisory";
2389
+ note?: string | undefined;
2390
+ };
2391
+ }>>;
2392
+ requestBodyType: z.ZodOptional<z.ZodObject<{
2393
+ value: z.ZodString;
2394
+ attribution: z.ZodObject<{
2395
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
2396
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
2397
+ note: z.ZodOptional<z.ZodString>;
2398
+ }, "strip", z.ZodTypeAny, {
2399
+ source: "merchant_challenge" | "external_metadata";
2400
+ authority: "authoritative" | "advisory";
2401
+ note?: string | undefined;
2402
+ }, {
2403
+ source: "merchant_challenge" | "external_metadata";
2404
+ authority: "authoritative" | "advisory";
2405
+ note?: string | undefined;
2406
+ }>;
2407
+ }, "strip", z.ZodTypeAny, {
2408
+ value: string;
2409
+ attribution: {
2410
+ source: "merchant_challenge" | "external_metadata";
2411
+ authority: "authoritative" | "advisory";
2412
+ note?: string | undefined;
2413
+ };
2414
+ }, {
2415
+ value: string;
2416
+ attribution: {
2417
+ source: "merchant_challenge" | "external_metadata";
2418
+ authority: "authoritative" | "advisory";
2419
+ note?: string | undefined;
2420
+ };
2421
+ }>>;
2422
+ requestBodyExample: z.ZodOptional<z.ZodObject<{
2423
+ value: z.ZodString;
2424
+ attribution: z.ZodObject<{
2425
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
2426
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
2427
+ note: z.ZodOptional<z.ZodString>;
2428
+ }, "strip", z.ZodTypeAny, {
2429
+ source: "merchant_challenge" | "external_metadata";
2430
+ authority: "authoritative" | "advisory";
2431
+ note?: string | undefined;
2432
+ }, {
2433
+ source: "merchant_challenge" | "external_metadata";
2434
+ authority: "authoritative" | "advisory";
2435
+ note?: string | undefined;
2436
+ }>;
2437
+ }, "strip", z.ZodTypeAny, {
2438
+ value: string;
2439
+ attribution: {
2440
+ source: "merchant_challenge" | "external_metadata";
2441
+ authority: "authoritative" | "advisory";
2442
+ note?: string | undefined;
2443
+ };
2444
+ }, {
2445
+ value: string;
2446
+ attribution: {
2447
+ source: "merchant_challenge" | "external_metadata";
2448
+ authority: "authoritative" | "advisory";
2449
+ note?: string | undefined;
2450
+ };
2451
+ }>>;
2452
+ requestBodyFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
2453
+ name: z.ZodString;
2454
+ type: z.ZodOptional<z.ZodString>;
2455
+ description: z.ZodOptional<z.ZodString>;
2456
+ required: z.ZodOptional<z.ZodBoolean>;
2457
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
2458
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2459
+ } & {
2460
+ attribution: z.ZodObject<{
2461
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
2462
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
2463
+ note: z.ZodOptional<z.ZodString>;
2464
+ }, "strip", z.ZodTypeAny, {
2465
+ source: "merchant_challenge" | "external_metadata";
2466
+ authority: "authoritative" | "advisory";
2467
+ note?: string | undefined;
2468
+ }, {
2469
+ source: "merchant_challenge" | "external_metadata";
2470
+ authority: "authoritative" | "advisory";
2471
+ note?: string | undefined;
2472
+ }>;
2473
+ }, "strip", z.ZodTypeAny, {
2474
+ name: string;
2475
+ attribution: {
2476
+ source: "merchant_challenge" | "external_metadata";
2477
+ authority: "authoritative" | "advisory";
2478
+ note?: string | undefined;
2479
+ };
2480
+ type?: string | undefined;
2481
+ required?: boolean | undefined;
2482
+ description?: string | undefined;
2483
+ defaultValue?: unknown;
2484
+ enumValues?: string[] | undefined;
2485
+ }, {
2486
+ name: string;
2487
+ attribution: {
2488
+ source: "merchant_challenge" | "external_metadata";
2489
+ authority: "authoritative" | "advisory";
2490
+ note?: string | undefined;
2491
+ };
2492
+ type?: string | undefined;
2493
+ required?: boolean | undefined;
2494
+ description?: string | undefined;
2495
+ defaultValue?: unknown;
2496
+ enumValues?: string[] | undefined;
2497
+ }>, "many">>;
2498
+ requestQueryParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
2499
+ name: z.ZodString;
2500
+ type: z.ZodOptional<z.ZodString>;
2501
+ description: z.ZodOptional<z.ZodString>;
2502
+ required: z.ZodOptional<z.ZodBoolean>;
2503
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
2504
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2505
+ } & {
2506
+ attribution: z.ZodObject<{
2507
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
2508
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
2509
+ note: z.ZodOptional<z.ZodString>;
2510
+ }, "strip", z.ZodTypeAny, {
2511
+ source: "merchant_challenge" | "external_metadata";
2512
+ authority: "authoritative" | "advisory";
2513
+ note?: string | undefined;
2514
+ }, {
2515
+ source: "merchant_challenge" | "external_metadata";
2516
+ authority: "authoritative" | "advisory";
2517
+ note?: string | undefined;
2518
+ }>;
2519
+ }, "strip", z.ZodTypeAny, {
2520
+ name: string;
2521
+ attribution: {
2522
+ source: "merchant_challenge" | "external_metadata";
2523
+ authority: "authoritative" | "advisory";
2524
+ note?: string | undefined;
2525
+ };
2526
+ type?: string | undefined;
2527
+ required?: boolean | undefined;
2528
+ description?: string | undefined;
2529
+ defaultValue?: unknown;
2530
+ enumValues?: string[] | undefined;
2531
+ }, {
2532
+ name: string;
2533
+ attribution: {
2534
+ source: "merchant_challenge" | "external_metadata";
2535
+ authority: "authoritative" | "advisory";
2536
+ note?: string | undefined;
2537
+ };
2538
+ type?: string | undefined;
2539
+ required?: boolean | undefined;
2540
+ description?: string | undefined;
2541
+ defaultValue?: unknown;
2542
+ enumValues?: string[] | undefined;
2543
+ }>, "many">>;
2544
+ requestPathParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
2545
+ name: z.ZodString;
2546
+ type: z.ZodOptional<z.ZodString>;
2547
+ description: z.ZodOptional<z.ZodString>;
2548
+ required: z.ZodOptional<z.ZodBoolean>;
2549
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
2550
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
2551
+ } & {
2552
+ attribution: z.ZodObject<{
2553
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
2554
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
2555
+ note: z.ZodOptional<z.ZodString>;
2556
+ }, "strip", z.ZodTypeAny, {
2557
+ source: "merchant_challenge" | "external_metadata";
2558
+ authority: "authoritative" | "advisory";
2559
+ note?: string | undefined;
2560
+ }, {
2561
+ source: "merchant_challenge" | "external_metadata";
2562
+ authority: "authoritative" | "advisory";
2563
+ note?: string | undefined;
2564
+ }>;
2565
+ }, "strip", z.ZodTypeAny, {
2566
+ name: string;
2567
+ attribution: {
2568
+ source: "merchant_challenge" | "external_metadata";
2569
+ authority: "authoritative" | "advisory";
2570
+ note?: string | undefined;
2571
+ };
2572
+ type?: string | undefined;
2573
+ required?: boolean | undefined;
2574
+ description?: string | undefined;
2575
+ defaultValue?: unknown;
2576
+ enumValues?: string[] | undefined;
2577
+ }, {
2578
+ name: string;
2579
+ attribution: {
2580
+ source: "merchant_challenge" | "external_metadata";
2581
+ authority: "authoritative" | "advisory";
2582
+ note?: string | undefined;
2583
+ };
2584
+ type?: string | undefined;
2585
+ required?: boolean | undefined;
2586
+ description?: string | undefined;
2587
+ defaultValue?: unknown;
2588
+ enumValues?: string[] | undefined;
2589
+ }>, "many">>;
2590
+ notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
2591
+ value: z.ZodString;
2592
+ attribution: z.ZodObject<{
2593
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
2594
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
2595
+ note: z.ZodOptional<z.ZodString>;
2596
+ }, "strip", z.ZodTypeAny, {
2597
+ source: "merchant_challenge" | "external_metadata";
2598
+ authority: "authoritative" | "advisory";
2599
+ note?: string | undefined;
2600
+ }, {
2601
+ source: "merchant_challenge" | "external_metadata";
2602
+ authority: "authoritative" | "advisory";
2603
+ note?: string | undefined;
2604
+ }>;
2605
+ }, "strip", z.ZodTypeAny, {
2606
+ value: string;
2607
+ attribution: {
2608
+ source: "merchant_challenge" | "external_metadata";
2609
+ authority: "authoritative" | "advisory";
2610
+ note?: string | undefined;
2611
+ };
2612
+ }, {
2613
+ value: string;
2614
+ attribution: {
2615
+ source: "merchant_challenge" | "external_metadata";
2616
+ authority: "authoritative" | "advisory";
2617
+ note?: string | undefined;
2618
+ };
2619
+ }>, "many">>;
2620
+ }, "strip", z.ZodTypeAny, {
2621
+ requestBodyFields: {
2622
+ name: string;
2623
+ attribution: {
2624
+ source: "merchant_challenge" | "external_metadata";
2625
+ authority: "authoritative" | "advisory";
2626
+ note?: string | undefined;
2627
+ };
2628
+ type?: string | undefined;
2629
+ required?: boolean | undefined;
2630
+ description?: string | undefined;
2631
+ defaultValue?: unknown;
2632
+ enumValues?: string[] | undefined;
2633
+ }[];
2634
+ requestQueryParams: {
2635
+ name: string;
2636
+ attribution: {
2637
+ source: "merchant_challenge" | "external_metadata";
2638
+ authority: "authoritative" | "advisory";
2639
+ note?: string | undefined;
2640
+ };
2641
+ type?: string | undefined;
2642
+ required?: boolean | undefined;
2643
+ description?: string | undefined;
2644
+ defaultValue?: unknown;
2645
+ enumValues?: string[] | undefined;
2646
+ }[];
2647
+ requestPathParams: {
2648
+ name: string;
2649
+ attribution: {
2650
+ source: "merchant_challenge" | "external_metadata";
2651
+ authority: "authoritative" | "advisory";
2652
+ note?: string | undefined;
2653
+ };
2654
+ type?: string | undefined;
2655
+ required?: boolean | undefined;
2656
+ description?: string | undefined;
2657
+ defaultValue?: unknown;
2658
+ enumValues?: string[] | undefined;
2659
+ }[];
2660
+ notes: {
2661
+ value: string;
2662
+ attribution: {
2663
+ source: "merchant_challenge" | "external_metadata";
2664
+ authority: "authoritative" | "advisory";
2665
+ note?: string | undefined;
2666
+ };
2667
+ }[];
2668
+ description?: {
2669
+ value: string;
2670
+ attribution: {
2671
+ source: "merchant_challenge" | "external_metadata";
2672
+ authority: "authoritative" | "advisory";
2673
+ note?: string | undefined;
2674
+ };
2675
+ } | undefined;
2676
+ requestBodyType?: {
2677
+ value: string;
2678
+ attribution: {
2679
+ source: "merchant_challenge" | "external_metadata";
2680
+ authority: "authoritative" | "advisory";
2681
+ note?: string | undefined;
2682
+ };
2683
+ } | undefined;
2684
+ requestBodyExample?: {
2685
+ value: string;
2686
+ attribution: {
2687
+ source: "merchant_challenge" | "external_metadata";
2688
+ authority: "authoritative" | "advisory";
2689
+ note?: string | undefined;
2690
+ };
2691
+ } | undefined;
2692
+ }, {
2693
+ description?: {
2694
+ value: string;
2695
+ attribution: {
2696
+ source: "merchant_challenge" | "external_metadata";
2697
+ authority: "authoritative" | "advisory";
2698
+ note?: string | undefined;
2699
+ };
2700
+ } | undefined;
2701
+ requestBodyType?: {
2702
+ value: string;
2703
+ attribution: {
2704
+ source: "merchant_challenge" | "external_metadata";
2705
+ authority: "authoritative" | "advisory";
2706
+ note?: string | undefined;
2707
+ };
2708
+ } | undefined;
2709
+ requestBodyExample?: {
2710
+ value: string;
2711
+ attribution: {
2712
+ source: "merchant_challenge" | "external_metadata";
2713
+ authority: "authoritative" | "advisory";
2714
+ note?: string | undefined;
2715
+ };
2716
+ } | undefined;
2717
+ requestBodyFields?: {
2718
+ name: string;
2719
+ attribution: {
2720
+ source: "merchant_challenge" | "external_metadata";
2721
+ authority: "authoritative" | "advisory";
2722
+ note?: string | undefined;
2723
+ };
2724
+ type?: string | undefined;
2725
+ required?: boolean | undefined;
2726
+ description?: string | undefined;
2727
+ defaultValue?: unknown;
2728
+ enumValues?: string[] | undefined;
2729
+ }[] | undefined;
2730
+ requestQueryParams?: {
2731
+ name: string;
2732
+ attribution: {
2733
+ source: "merchant_challenge" | "external_metadata";
2734
+ authority: "authoritative" | "advisory";
2735
+ note?: string | undefined;
2736
+ };
2737
+ type?: string | undefined;
2738
+ required?: boolean | undefined;
2739
+ description?: string | undefined;
2740
+ defaultValue?: unknown;
2741
+ enumValues?: string[] | undefined;
2742
+ }[] | undefined;
2743
+ requestPathParams?: {
2744
+ name: string;
2745
+ attribution: {
2746
+ source: "merchant_challenge" | "external_metadata";
2747
+ authority: "authoritative" | "advisory";
2748
+ note?: string | undefined;
2749
+ };
2750
+ type?: string | undefined;
2751
+ required?: boolean | undefined;
2752
+ description?: string | undefined;
2753
+ defaultValue?: unknown;
2754
+ enumValues?: string[] | undefined;
2755
+ }[] | undefined;
2756
+ notes?: {
2757
+ value: string;
2758
+ attribution: {
2759
+ source: "merchant_challenge" | "external_metadata";
2760
+ authority: "authoritative" | "advisory";
2761
+ note?: string | undefined;
2762
+ };
2763
+ }[] | undefined;
2764
+ }>;
2765
+ probe: z.ZodOptional<z.ZodObject<{
2766
+ responseStatus: z.ZodNumber;
2767
+ confirmedAt: z.ZodString;
2768
+ }, "strip", z.ZodTypeAny, {
2769
+ responseStatus: number;
2770
+ confirmedAt: string;
2771
+ }, {
2772
+ responseStatus: number;
2773
+ confirmedAt: string;
2774
+ }>>;
2775
+ validationIssues: z.ZodDefault<z.ZodArray<z.ZodObject<{
2776
+ location: z.ZodEnum<["body", "query", "path", "headers"]>;
2777
+ field: z.ZodString;
2778
+ code: z.ZodString;
2779
+ message: z.ZodString;
2780
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
2781
+ blocking: z.ZodBoolean;
2782
+ severity: z.ZodEnum<["error", "warning"]>;
2783
+ suggestedFix: z.ZodOptional<z.ZodString>;
2784
+ }, "strip", z.ZodTypeAny, {
2785
+ code: string;
2786
+ message: string;
2787
+ source: "merchant_challenge" | "external_metadata";
2788
+ location: "path" | "headers" | "body" | "query";
2789
+ field: string;
2790
+ blocking: boolean;
2791
+ severity: "error" | "warning";
2792
+ suggestedFix?: string | undefined;
2793
+ }, {
2794
+ code: string;
2795
+ message: string;
2796
+ source: "merchant_challenge" | "external_metadata";
2797
+ location: "path" | "headers" | "body" | "query";
2798
+ field: string;
2799
+ blocking: boolean;
2800
+ severity: "error" | "warning";
2801
+ suggestedFix?: string | undefined;
2802
+ }>, "many">>;
2803
+ nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough", "manual_review"]>;
2804
+ }, "strip", z.ZodTypeAny, {
2805
+ protocol: "none";
2806
+ kind: "passthrough";
2807
+ request: {
2808
+ url: string;
2809
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
2810
+ headers?: Record<string, string> | undefined;
2811
+ body?: string | undefined;
2812
+ bodyHash?: string | undefined;
2813
+ };
2814
+ hints: {
2815
+ requestBodyFields: {
2816
+ name: string;
2817
+ attribution: {
2818
+ source: "merchant_challenge" | "external_metadata";
2819
+ authority: "authoritative" | "advisory";
2820
+ note?: string | undefined;
2821
+ };
2822
+ type?: string | undefined;
2823
+ required?: boolean | undefined;
2824
+ description?: string | undefined;
2825
+ defaultValue?: unknown;
2826
+ enumValues?: string[] | undefined;
2827
+ }[];
2828
+ requestQueryParams: {
2829
+ name: string;
2830
+ attribution: {
2831
+ source: "merchant_challenge" | "external_metadata";
2832
+ authority: "authoritative" | "advisory";
2833
+ note?: string | undefined;
2834
+ };
2835
+ type?: string | undefined;
2836
+ required?: boolean | undefined;
2837
+ description?: string | undefined;
2838
+ defaultValue?: unknown;
2839
+ enumValues?: string[] | undefined;
2840
+ }[];
2841
+ requestPathParams: {
2842
+ name: string;
2843
+ attribution: {
2844
+ source: "merchant_challenge" | "external_metadata";
2845
+ authority: "authoritative" | "advisory";
2846
+ note?: string | undefined;
2847
+ };
2848
+ type?: string | undefined;
2849
+ required?: boolean | undefined;
2850
+ description?: string | undefined;
2851
+ defaultValue?: unknown;
2852
+ enumValues?: string[] | undefined;
2853
+ }[];
2854
+ notes: {
2855
+ value: string;
2856
+ attribution: {
2857
+ source: "merchant_challenge" | "external_metadata";
2858
+ authority: "authoritative" | "advisory";
2859
+ note?: string | undefined;
2860
+ };
2861
+ }[];
2862
+ description?: {
2863
+ value: string;
2864
+ attribution: {
2865
+ source: "merchant_challenge" | "external_metadata";
2866
+ authority: "authoritative" | "advisory";
2867
+ note?: string | undefined;
2868
+ };
2869
+ } | undefined;
2870
+ requestBodyType?: {
2871
+ value: string;
2872
+ attribution: {
2873
+ source: "merchant_challenge" | "external_metadata";
2874
+ authority: "authoritative" | "advisory";
2875
+ note?: string | undefined;
2876
+ };
2877
+ } | undefined;
2878
+ requestBodyExample?: {
2879
+ value: string;
2880
+ attribution: {
2881
+ source: "merchant_challenge" | "external_metadata";
2882
+ authority: "authoritative" | "advisory";
2883
+ note?: string | undefined;
2884
+ };
2885
+ } | undefined;
2886
+ };
2887
+ validationIssues: {
2888
+ code: string;
2889
+ message: string;
2890
+ source: "merchant_challenge" | "external_metadata";
2891
+ location: "path" | "headers" | "body" | "query";
2892
+ field: string;
2893
+ blocking: boolean;
2894
+ severity: "error" | "warning";
2895
+ suggestedFix?: string | undefined;
2896
+ }[];
2897
+ nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
2898
+ probe?: {
2899
+ responseStatus: number;
2900
+ confirmedAt: string;
2901
+ } | undefined;
2902
+ }, {
2903
+ protocol: "none";
2904
+ kind: "passthrough";
2905
+ request: {
2906
+ url: string;
2907
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
2908
+ headers?: Record<string, string> | undefined;
2909
+ body?: string | undefined;
2910
+ bodyHash?: string | undefined;
2911
+ };
2912
+ hints: {
2913
+ description?: {
2914
+ value: string;
2915
+ attribution: {
2916
+ source: "merchant_challenge" | "external_metadata";
2917
+ authority: "authoritative" | "advisory";
2918
+ note?: string | undefined;
2919
+ };
2920
+ } | undefined;
2921
+ requestBodyType?: {
2922
+ value: string;
2923
+ attribution: {
2924
+ source: "merchant_challenge" | "external_metadata";
2925
+ authority: "authoritative" | "advisory";
2926
+ note?: string | undefined;
2927
+ };
2928
+ } | undefined;
2929
+ requestBodyExample?: {
2930
+ value: string;
2931
+ attribution: {
2932
+ source: "merchant_challenge" | "external_metadata";
2933
+ authority: "authoritative" | "advisory";
2934
+ note?: string | undefined;
2935
+ };
2936
+ } | undefined;
2937
+ requestBodyFields?: {
2938
+ name: string;
2939
+ attribution: {
2940
+ source: "merchant_challenge" | "external_metadata";
2941
+ authority: "authoritative" | "advisory";
2942
+ note?: string | undefined;
2943
+ };
2944
+ type?: string | undefined;
2945
+ required?: boolean | undefined;
2946
+ description?: string | undefined;
2947
+ defaultValue?: unknown;
2948
+ enumValues?: string[] | undefined;
2949
+ }[] | undefined;
2950
+ requestQueryParams?: {
2951
+ name: string;
2952
+ attribution: {
2953
+ source: "merchant_challenge" | "external_metadata";
2954
+ authority: "authoritative" | "advisory";
2955
+ note?: string | undefined;
2956
+ };
2957
+ type?: string | undefined;
2958
+ required?: boolean | undefined;
2959
+ description?: string | undefined;
2960
+ defaultValue?: unknown;
2961
+ enumValues?: string[] | undefined;
2962
+ }[] | undefined;
2963
+ requestPathParams?: {
2964
+ name: string;
2965
+ attribution: {
2966
+ source: "merchant_challenge" | "external_metadata";
2967
+ authority: "authoritative" | "advisory";
2968
+ note?: string | undefined;
2969
+ };
2970
+ type?: string | undefined;
2971
+ required?: boolean | undefined;
2972
+ description?: string | undefined;
2973
+ defaultValue?: unknown;
2974
+ enumValues?: string[] | undefined;
2975
+ }[] | undefined;
2976
+ notes?: {
2977
+ value: string;
2978
+ attribution: {
2979
+ source: "merchant_challenge" | "external_metadata";
2980
+ authority: "authoritative" | "advisory";
2981
+ note?: string | undefined;
2982
+ };
2983
+ }[] | undefined;
2984
+ };
2985
+ nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
2986
+ probe?: {
2987
+ responseStatus: number;
2988
+ confirmedAt: string;
2989
+ } | undefined;
2990
+ validationIssues?: {
2991
+ code: string;
2992
+ message: string;
2993
+ source: "merchant_challenge" | "external_metadata";
2994
+ location: "path" | "headers" | "body" | "query";
2995
+ field: string;
2996
+ blocking: boolean;
2997
+ severity: "error" | "warning";
2998
+ suggestedFix?: string | undefined;
2999
+ }[] | undefined;
3000
+ }>, z.ZodObject<{
3001
+ kind: z.ZodLiteral<"ready">;
3002
+ protocol: z.ZodEnum<["x402", "l402"]>;
3003
+ request: z.ZodObject<{
3004
+ url: z.ZodString;
3005
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
3006
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
3007
+ body: z.ZodOptional<z.ZodString>;
3008
+ bodyHash: z.ZodOptional<z.ZodString>;
3009
+ }, "strip", z.ZodTypeAny, {
3010
+ url: string;
3011
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
3012
+ headers?: Record<string, string> | undefined;
3013
+ body?: string | undefined;
3014
+ bodyHash?: string | undefined;
3015
+ }, {
3016
+ url: string;
3017
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
3018
+ headers?: Record<string, string> | undefined;
3019
+ body?: string | undefined;
3020
+ bodyHash?: string | undefined;
3021
+ }>;
3022
+ challenge: z.ZodObject<{
3023
+ protocol: z.ZodEnum<["x402", "l402"]>;
3024
+ headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
3025
+ body: z.ZodOptional<z.ZodUnknown>;
3026
+ }, "strip", z.ZodTypeAny, {
3027
+ headers: Record<string, string>;
3028
+ protocol: "x402" | "l402";
3029
+ body?: unknown;
3030
+ }, {
3031
+ protocol: "x402" | "l402";
3032
+ headers?: Record<string, string> | undefined;
3033
+ body?: unknown;
3034
+ }>;
3035
+ paymentRequirement: z.ZodOptional<z.ZodObject<{
3036
+ protocol: z.ZodEnum<["x402", "l402"]>;
3037
+ description: z.ZodOptional<z.ZodString>;
3038
+ asset: z.ZodOptional<z.ZodString>;
3039
+ network: z.ZodOptional<z.ZodString>;
3040
+ payee: z.ZodOptional<z.ZodString>;
3041
+ amountType: z.ZodOptional<z.ZodEnum<["exact", "max"]>>;
3042
+ amount: z.ZodOptional<z.ZodString>;
3043
+ amountMinor: z.ZodOptional<z.ZodString>;
3044
+ precision: z.ZodOptional<z.ZodNumber>;
3045
+ provenance: z.ZodObject<{
3046
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
3047
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
3048
+ note: z.ZodOptional<z.ZodString>;
3049
+ }, "strip", z.ZodTypeAny, {
3050
+ source: "merchant_challenge" | "external_metadata";
3051
+ authority: "authoritative" | "advisory";
3052
+ note?: string | undefined;
3053
+ }, {
3054
+ source: "merchant_challenge" | "external_metadata";
3055
+ authority: "authoritative" | "advisory";
3056
+ note?: string | undefined;
3057
+ }>;
3058
+ }, "strip", z.ZodTypeAny, {
3059
+ protocol: "x402" | "l402";
3060
+ provenance: {
3061
+ source: "merchant_challenge" | "external_metadata";
3062
+ authority: "authoritative" | "advisory";
3063
+ note?: string | undefined;
3064
+ };
3065
+ asset?: string | undefined;
3066
+ amount?: string | undefined;
3067
+ amountMinor?: string | undefined;
3068
+ precision?: number | undefined;
3069
+ description?: string | undefined;
3070
+ network?: string | undefined;
3071
+ payee?: string | undefined;
3072
+ amountType?: "exact" | "max" | undefined;
3073
+ }, {
3074
+ protocol: "x402" | "l402";
3075
+ provenance: {
3076
+ source: "merchant_challenge" | "external_metadata";
3077
+ authority: "authoritative" | "advisory";
3078
+ note?: string | undefined;
3079
+ };
3080
+ asset?: string | undefined;
3081
+ amount?: string | undefined;
3082
+ amountMinor?: string | undefined;
3083
+ precision?: number | undefined;
3084
+ description?: string | undefined;
3085
+ network?: string | undefined;
3086
+ payee?: string | undefined;
3087
+ amountType?: "exact" | "max" | undefined;
3088
+ }>>;
3089
+ hints: z.ZodObject<{
3090
+ description: z.ZodOptional<z.ZodObject<{
3091
+ value: z.ZodString;
3092
+ attribution: z.ZodObject<{
3093
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
3094
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
3095
+ note: z.ZodOptional<z.ZodString>;
3096
+ }, "strip", z.ZodTypeAny, {
3097
+ source: "merchant_challenge" | "external_metadata";
3098
+ authority: "authoritative" | "advisory";
3099
+ note?: string | undefined;
3100
+ }, {
3101
+ source: "merchant_challenge" | "external_metadata";
3102
+ authority: "authoritative" | "advisory";
3103
+ note?: string | undefined;
3104
+ }>;
3105
+ }, "strip", z.ZodTypeAny, {
3106
+ value: string;
3107
+ attribution: {
3108
+ source: "merchant_challenge" | "external_metadata";
3109
+ authority: "authoritative" | "advisory";
3110
+ note?: string | undefined;
3111
+ };
3112
+ }, {
3113
+ value: string;
3114
+ attribution: {
3115
+ source: "merchant_challenge" | "external_metadata";
3116
+ authority: "authoritative" | "advisory";
3117
+ note?: string | undefined;
3118
+ };
3119
+ }>>;
3120
+ requestBodyType: z.ZodOptional<z.ZodObject<{
3121
+ value: z.ZodString;
3122
+ attribution: z.ZodObject<{
3123
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
3124
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
3125
+ note: z.ZodOptional<z.ZodString>;
3126
+ }, "strip", z.ZodTypeAny, {
3127
+ source: "merchant_challenge" | "external_metadata";
3128
+ authority: "authoritative" | "advisory";
3129
+ note?: string | undefined;
3130
+ }, {
3131
+ source: "merchant_challenge" | "external_metadata";
3132
+ authority: "authoritative" | "advisory";
3133
+ note?: string | undefined;
3134
+ }>;
3135
+ }, "strip", z.ZodTypeAny, {
3136
+ value: string;
3137
+ attribution: {
3138
+ source: "merchant_challenge" | "external_metadata";
3139
+ authority: "authoritative" | "advisory";
3140
+ note?: string | undefined;
3141
+ };
3142
+ }, {
3143
+ value: string;
3144
+ attribution: {
3145
+ source: "merchant_challenge" | "external_metadata";
3146
+ authority: "authoritative" | "advisory";
3147
+ note?: string | undefined;
3148
+ };
3149
+ }>>;
3150
+ requestBodyExample: z.ZodOptional<z.ZodObject<{
3151
+ value: z.ZodString;
3152
+ attribution: z.ZodObject<{
3153
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
3154
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
3155
+ note: z.ZodOptional<z.ZodString>;
3156
+ }, "strip", z.ZodTypeAny, {
3157
+ source: "merchant_challenge" | "external_metadata";
3158
+ authority: "authoritative" | "advisory";
3159
+ note?: string | undefined;
3160
+ }, {
3161
+ source: "merchant_challenge" | "external_metadata";
3162
+ authority: "authoritative" | "advisory";
3163
+ note?: string | undefined;
3164
+ }>;
3165
+ }, "strip", z.ZodTypeAny, {
3166
+ value: string;
3167
+ attribution: {
3168
+ source: "merchant_challenge" | "external_metadata";
3169
+ authority: "authoritative" | "advisory";
3170
+ note?: string | undefined;
3171
+ };
3172
+ }, {
3173
+ value: string;
3174
+ attribution: {
3175
+ source: "merchant_challenge" | "external_metadata";
3176
+ authority: "authoritative" | "advisory";
3177
+ note?: string | undefined;
3178
+ };
3179
+ }>>;
3180
+ requestBodyFields: z.ZodDefault<z.ZodArray<z.ZodObject<{
3181
+ name: z.ZodString;
3182
+ type: z.ZodOptional<z.ZodString>;
3183
+ description: z.ZodOptional<z.ZodString>;
3184
+ required: z.ZodOptional<z.ZodBoolean>;
3185
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
3186
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3187
+ } & {
3188
+ attribution: z.ZodObject<{
3189
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
3190
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
3191
+ note: z.ZodOptional<z.ZodString>;
3192
+ }, "strip", z.ZodTypeAny, {
3193
+ source: "merchant_challenge" | "external_metadata";
3194
+ authority: "authoritative" | "advisory";
3195
+ note?: string | undefined;
3196
+ }, {
3197
+ source: "merchant_challenge" | "external_metadata";
3198
+ authority: "authoritative" | "advisory";
3199
+ note?: string | undefined;
3200
+ }>;
3201
+ }, "strip", z.ZodTypeAny, {
3202
+ name: string;
3203
+ attribution: {
3204
+ source: "merchant_challenge" | "external_metadata";
3205
+ authority: "authoritative" | "advisory";
3206
+ note?: string | undefined;
3207
+ };
3208
+ type?: string | undefined;
3209
+ required?: boolean | undefined;
3210
+ description?: string | undefined;
3211
+ defaultValue?: unknown;
3212
+ enumValues?: string[] | undefined;
3213
+ }, {
3214
+ name: string;
3215
+ attribution: {
3216
+ source: "merchant_challenge" | "external_metadata";
3217
+ authority: "authoritative" | "advisory";
3218
+ note?: string | undefined;
3219
+ };
3220
+ type?: string | undefined;
3221
+ required?: boolean | undefined;
3222
+ description?: string | undefined;
3223
+ defaultValue?: unknown;
3224
+ enumValues?: string[] | undefined;
3225
+ }>, "many">>;
3226
+ requestQueryParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
3227
+ name: z.ZodString;
3228
+ type: z.ZodOptional<z.ZodString>;
3229
+ description: z.ZodOptional<z.ZodString>;
3230
+ required: z.ZodOptional<z.ZodBoolean>;
3231
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
3232
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3233
+ } & {
3234
+ attribution: z.ZodObject<{
3235
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
3236
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
3237
+ note: z.ZodOptional<z.ZodString>;
3238
+ }, "strip", z.ZodTypeAny, {
3239
+ source: "merchant_challenge" | "external_metadata";
3240
+ authority: "authoritative" | "advisory";
3241
+ note?: string | undefined;
3242
+ }, {
3243
+ source: "merchant_challenge" | "external_metadata";
3244
+ authority: "authoritative" | "advisory";
3245
+ note?: string | undefined;
3246
+ }>;
3247
+ }, "strip", z.ZodTypeAny, {
3248
+ name: string;
3249
+ attribution: {
3250
+ source: "merchant_challenge" | "external_metadata";
3251
+ authority: "authoritative" | "advisory";
3252
+ note?: string | undefined;
3253
+ };
3254
+ type?: string | undefined;
3255
+ required?: boolean | undefined;
3256
+ description?: string | undefined;
3257
+ defaultValue?: unknown;
3258
+ enumValues?: string[] | undefined;
3259
+ }, {
3260
+ name: string;
3261
+ attribution: {
3262
+ source: "merchant_challenge" | "external_metadata";
3263
+ authority: "authoritative" | "advisory";
3264
+ note?: string | undefined;
3265
+ };
3266
+ type?: string | undefined;
3267
+ required?: boolean | undefined;
3268
+ description?: string | undefined;
3269
+ defaultValue?: unknown;
3270
+ enumValues?: string[] | undefined;
3271
+ }>, "many">>;
3272
+ requestPathParams: z.ZodDefault<z.ZodArray<z.ZodObject<{
3273
+ name: z.ZodString;
3274
+ type: z.ZodOptional<z.ZodString>;
3275
+ description: z.ZodOptional<z.ZodString>;
3276
+ required: z.ZodOptional<z.ZodBoolean>;
3277
+ defaultValue: z.ZodOptional<z.ZodUnknown>;
3278
+ enumValues: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
3279
+ } & {
3280
+ attribution: z.ZodObject<{
3281
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
3282
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
3283
+ note: z.ZodOptional<z.ZodString>;
3284
+ }, "strip", z.ZodTypeAny, {
3285
+ source: "merchant_challenge" | "external_metadata";
3286
+ authority: "authoritative" | "advisory";
3287
+ note?: string | undefined;
3288
+ }, {
3289
+ source: "merchant_challenge" | "external_metadata";
3290
+ authority: "authoritative" | "advisory";
3291
+ note?: string | undefined;
3292
+ }>;
3293
+ }, "strip", z.ZodTypeAny, {
3294
+ name: string;
3295
+ attribution: {
3296
+ source: "merchant_challenge" | "external_metadata";
3297
+ authority: "authoritative" | "advisory";
3298
+ note?: string | undefined;
3299
+ };
3300
+ type?: string | undefined;
3301
+ required?: boolean | undefined;
3302
+ description?: string | undefined;
3303
+ defaultValue?: unknown;
3304
+ enumValues?: string[] | undefined;
3305
+ }, {
3306
+ name: string;
3307
+ attribution: {
3308
+ source: "merchant_challenge" | "external_metadata";
3309
+ authority: "authoritative" | "advisory";
3310
+ note?: string | undefined;
3311
+ };
3312
+ type?: string | undefined;
3313
+ required?: boolean | undefined;
3314
+ description?: string | undefined;
3315
+ defaultValue?: unknown;
3316
+ enumValues?: string[] | undefined;
3317
+ }>, "many">>;
3318
+ notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
3319
+ value: z.ZodString;
3320
+ attribution: z.ZodObject<{
3321
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
3322
+ authority: z.ZodEnum<["authoritative", "advisory"]>;
3323
+ note: z.ZodOptional<z.ZodString>;
3324
+ }, "strip", z.ZodTypeAny, {
3325
+ source: "merchant_challenge" | "external_metadata";
3326
+ authority: "authoritative" | "advisory";
3327
+ note?: string | undefined;
3328
+ }, {
3329
+ source: "merchant_challenge" | "external_metadata";
3330
+ authority: "authoritative" | "advisory";
3331
+ note?: string | undefined;
3332
+ }>;
3333
+ }, "strip", z.ZodTypeAny, {
3334
+ value: string;
3335
+ attribution: {
3336
+ source: "merchant_challenge" | "external_metadata";
3337
+ authority: "authoritative" | "advisory";
3338
+ note?: string | undefined;
3339
+ };
3340
+ }, {
3341
+ value: string;
3342
+ attribution: {
3343
+ source: "merchant_challenge" | "external_metadata";
3344
+ authority: "authoritative" | "advisory";
3345
+ note?: string | undefined;
3346
+ };
3347
+ }>, "many">>;
3348
+ }, "strip", z.ZodTypeAny, {
3349
+ requestBodyFields: {
3350
+ name: string;
3351
+ attribution: {
3352
+ source: "merchant_challenge" | "external_metadata";
3353
+ authority: "authoritative" | "advisory";
3354
+ note?: string | undefined;
3355
+ };
3356
+ type?: string | undefined;
3357
+ required?: boolean | undefined;
3358
+ description?: string | undefined;
3359
+ defaultValue?: unknown;
3360
+ enumValues?: string[] | undefined;
3361
+ }[];
3362
+ requestQueryParams: {
3363
+ name: string;
3364
+ attribution: {
3365
+ source: "merchant_challenge" | "external_metadata";
3366
+ authority: "authoritative" | "advisory";
3367
+ note?: string | undefined;
3368
+ };
3369
+ type?: string | undefined;
3370
+ required?: boolean | undefined;
3371
+ description?: string | undefined;
3372
+ defaultValue?: unknown;
3373
+ enumValues?: string[] | undefined;
3374
+ }[];
3375
+ requestPathParams: {
3376
+ name: string;
3377
+ attribution: {
3378
+ source: "merchant_challenge" | "external_metadata";
3379
+ authority: "authoritative" | "advisory";
3380
+ note?: string | undefined;
3381
+ };
3382
+ type?: string | undefined;
3383
+ required?: boolean | undefined;
3384
+ description?: string | undefined;
3385
+ defaultValue?: unknown;
3386
+ enumValues?: string[] | undefined;
3387
+ }[];
3388
+ notes: {
3389
+ value: string;
3390
+ attribution: {
3391
+ source: "merchant_challenge" | "external_metadata";
3392
+ authority: "authoritative" | "advisory";
3393
+ note?: string | undefined;
3394
+ };
3395
+ }[];
3396
+ description?: {
3397
+ value: string;
3398
+ attribution: {
3399
+ source: "merchant_challenge" | "external_metadata";
3400
+ authority: "authoritative" | "advisory";
3401
+ note?: string | undefined;
3402
+ };
3403
+ } | undefined;
3404
+ requestBodyType?: {
3405
+ value: string;
3406
+ attribution: {
3407
+ source: "merchant_challenge" | "external_metadata";
3408
+ authority: "authoritative" | "advisory";
3409
+ note?: string | undefined;
3410
+ };
3411
+ } | undefined;
3412
+ requestBodyExample?: {
3413
+ value: string;
3414
+ attribution: {
3415
+ source: "merchant_challenge" | "external_metadata";
3416
+ authority: "authoritative" | "advisory";
3417
+ note?: string | undefined;
3418
+ };
3419
+ } | undefined;
3420
+ }, {
3421
+ description?: {
3422
+ value: string;
3423
+ attribution: {
3424
+ source: "merchant_challenge" | "external_metadata";
3425
+ authority: "authoritative" | "advisory";
3426
+ note?: string | undefined;
3427
+ };
3428
+ } | undefined;
3429
+ requestBodyType?: {
3430
+ value: string;
3431
+ attribution: {
3432
+ source: "merchant_challenge" | "external_metadata";
3433
+ authority: "authoritative" | "advisory";
3434
+ note?: string | undefined;
3435
+ };
3436
+ } | undefined;
3437
+ requestBodyExample?: {
3438
+ value: string;
3439
+ attribution: {
3440
+ source: "merchant_challenge" | "external_metadata";
3441
+ authority: "authoritative" | "advisory";
3442
+ note?: string | undefined;
3443
+ };
3444
+ } | undefined;
3445
+ requestBodyFields?: {
3446
+ name: string;
3447
+ attribution: {
3448
+ source: "merchant_challenge" | "external_metadata";
3449
+ authority: "authoritative" | "advisory";
3450
+ note?: string | undefined;
3451
+ };
3452
+ type?: string | undefined;
3453
+ required?: boolean | undefined;
3454
+ description?: string | undefined;
3455
+ defaultValue?: unknown;
3456
+ enumValues?: string[] | undefined;
3457
+ }[] | undefined;
3458
+ requestQueryParams?: {
3459
+ name: string;
3460
+ attribution: {
3461
+ source: "merchant_challenge" | "external_metadata";
3462
+ authority: "authoritative" | "advisory";
3463
+ note?: string | undefined;
3464
+ };
3465
+ type?: string | undefined;
3466
+ required?: boolean | undefined;
3467
+ description?: string | undefined;
3468
+ defaultValue?: unknown;
3469
+ enumValues?: string[] | undefined;
3470
+ }[] | undefined;
3471
+ requestPathParams?: {
3472
+ name: string;
3473
+ attribution: {
3474
+ source: "merchant_challenge" | "external_metadata";
3475
+ authority: "authoritative" | "advisory";
3476
+ note?: string | undefined;
3477
+ };
3478
+ type?: string | undefined;
3479
+ required?: boolean | undefined;
3480
+ description?: string | undefined;
3481
+ defaultValue?: unknown;
3482
+ enumValues?: string[] | undefined;
3483
+ }[] | undefined;
3484
+ notes?: {
3485
+ value: string;
3486
+ attribution: {
3487
+ source: "merchant_challenge" | "external_metadata";
3488
+ authority: "authoritative" | "advisory";
3489
+ note?: string | undefined;
3490
+ };
3491
+ }[] | undefined;
3492
+ }>;
3493
+ probe: z.ZodOptional<z.ZodObject<{
3494
+ responseStatus: z.ZodNumber;
3495
+ confirmedAt: z.ZodString;
3496
+ }, "strip", z.ZodTypeAny, {
3497
+ responseStatus: number;
3498
+ confirmedAt: string;
3499
+ }, {
3500
+ responseStatus: number;
3501
+ confirmedAt: string;
3502
+ }>>;
3503
+ validationIssues: z.ZodDefault<z.ZodArray<z.ZodObject<{
3504
+ location: z.ZodEnum<["body", "query", "path", "headers"]>;
3505
+ field: z.ZodString;
3506
+ code: z.ZodString;
3507
+ message: z.ZodString;
3508
+ source: z.ZodEnum<["merchant_challenge", "external_metadata"]>;
3509
+ blocking: z.ZodBoolean;
3510
+ severity: z.ZodEnum<["error", "warning"]>;
3511
+ suggestedFix: z.ZodOptional<z.ZodString>;
3512
+ }, "strip", z.ZodTypeAny, {
3513
+ code: string;
3514
+ message: string;
3515
+ source: "merchant_challenge" | "external_metadata";
3516
+ location: "path" | "headers" | "body" | "query";
3517
+ field: string;
3518
+ blocking: boolean;
3519
+ severity: "error" | "warning";
3520
+ suggestedFix?: string | undefined;
3521
+ }, {
3522
+ code: string;
3523
+ message: string;
3524
+ source: "merchant_challenge" | "external_metadata";
3525
+ location: "path" | "headers" | "body" | "query";
3526
+ field: string;
3527
+ blocking: boolean;
3528
+ severity: "error" | "warning";
3529
+ suggestedFix?: string | undefined;
3530
+ }>, "many">>;
3531
+ nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough", "manual_review"]>;
3532
+ }, "strip", z.ZodTypeAny, {
3533
+ protocol: "x402" | "l402";
3534
+ kind: "ready";
3535
+ request: {
3536
+ url: string;
3537
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
3538
+ headers?: Record<string, string> | undefined;
3539
+ body?: string | undefined;
3540
+ bodyHash?: string | undefined;
3541
+ };
3542
+ hints: {
3543
+ requestBodyFields: {
3544
+ name: string;
3545
+ attribution: {
3546
+ source: "merchant_challenge" | "external_metadata";
3547
+ authority: "authoritative" | "advisory";
3548
+ note?: string | undefined;
3549
+ };
3550
+ type?: string | undefined;
3551
+ required?: boolean | undefined;
3552
+ description?: string | undefined;
3553
+ defaultValue?: unknown;
3554
+ enumValues?: string[] | undefined;
3555
+ }[];
3556
+ requestQueryParams: {
3557
+ name: string;
3558
+ attribution: {
3559
+ source: "merchant_challenge" | "external_metadata";
3560
+ authority: "authoritative" | "advisory";
3561
+ note?: string | undefined;
3562
+ };
3563
+ type?: string | undefined;
3564
+ required?: boolean | undefined;
3565
+ description?: string | undefined;
3566
+ defaultValue?: unknown;
3567
+ enumValues?: string[] | undefined;
3568
+ }[];
3569
+ requestPathParams: {
3570
+ name: string;
3571
+ attribution: {
3572
+ source: "merchant_challenge" | "external_metadata";
3573
+ authority: "authoritative" | "advisory";
3574
+ note?: string | undefined;
3575
+ };
3576
+ type?: string | undefined;
3577
+ required?: boolean | undefined;
3578
+ description?: string | undefined;
3579
+ defaultValue?: unknown;
3580
+ enumValues?: string[] | undefined;
3581
+ }[];
3582
+ notes: {
3583
+ value: string;
3584
+ attribution: {
3585
+ source: "merchant_challenge" | "external_metadata";
3586
+ authority: "authoritative" | "advisory";
3587
+ note?: string | undefined;
3588
+ };
3589
+ }[];
3590
+ description?: {
3591
+ value: string;
3592
+ attribution: {
3593
+ source: "merchant_challenge" | "external_metadata";
3594
+ authority: "authoritative" | "advisory";
3595
+ note?: string | undefined;
3596
+ };
3597
+ } | undefined;
3598
+ requestBodyType?: {
3599
+ value: string;
3600
+ attribution: {
3601
+ source: "merchant_challenge" | "external_metadata";
3602
+ authority: "authoritative" | "advisory";
3603
+ note?: string | undefined;
3604
+ };
3605
+ } | undefined;
3606
+ requestBodyExample?: {
3607
+ value: string;
3608
+ attribution: {
3609
+ source: "merchant_challenge" | "external_metadata";
3610
+ authority: "authoritative" | "advisory";
3611
+ note?: string | undefined;
3612
+ };
3613
+ } | undefined;
3614
+ };
3615
+ validationIssues: {
3616
+ code: string;
3617
+ message: string;
3618
+ source: "merchant_challenge" | "external_metadata";
3619
+ location: "path" | "headers" | "body" | "query";
3620
+ field: string;
3621
+ blocking: boolean;
3622
+ severity: "error" | "warning";
3623
+ suggestedFix?: string | undefined;
3624
+ }[];
3625
+ nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
3626
+ challenge: {
3627
+ headers: Record<string, string>;
3628
+ protocol: "x402" | "l402";
3629
+ body?: unknown;
3630
+ };
3631
+ probe?: {
3632
+ responseStatus: number;
3633
+ confirmedAt: string;
3634
+ } | undefined;
3635
+ paymentRequirement?: {
3636
+ protocol: "x402" | "l402";
3637
+ provenance: {
3638
+ source: "merchant_challenge" | "external_metadata";
3639
+ authority: "authoritative" | "advisory";
3640
+ note?: string | undefined;
3641
+ };
3642
+ asset?: string | undefined;
3643
+ amount?: string | undefined;
3644
+ amountMinor?: string | undefined;
3645
+ precision?: number | undefined;
3646
+ description?: string | undefined;
3647
+ network?: string | undefined;
3648
+ payee?: string | undefined;
3649
+ amountType?: "exact" | "max" | undefined;
3650
+ } | undefined;
3651
+ }, {
3652
+ protocol: "x402" | "l402";
3653
+ kind: "ready";
3654
+ request: {
3655
+ url: string;
3656
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
3657
+ headers?: Record<string, string> | undefined;
3658
+ body?: string | undefined;
3659
+ bodyHash?: string | undefined;
3660
+ };
3661
+ hints: {
3662
+ description?: {
3663
+ value: string;
3664
+ attribution: {
3665
+ source: "merchant_challenge" | "external_metadata";
3666
+ authority: "authoritative" | "advisory";
3667
+ note?: string | undefined;
3668
+ };
3669
+ } | undefined;
3670
+ requestBodyType?: {
3671
+ value: string;
3672
+ attribution: {
3673
+ source: "merchant_challenge" | "external_metadata";
3674
+ authority: "authoritative" | "advisory";
3675
+ note?: string | undefined;
3676
+ };
3677
+ } | undefined;
3678
+ requestBodyExample?: {
3679
+ value: string;
3680
+ attribution: {
3681
+ source: "merchant_challenge" | "external_metadata";
3682
+ authority: "authoritative" | "advisory";
3683
+ note?: string | undefined;
3684
+ };
3685
+ } | undefined;
3686
+ requestBodyFields?: {
3687
+ name: string;
3688
+ attribution: {
3689
+ source: "merchant_challenge" | "external_metadata";
3690
+ authority: "authoritative" | "advisory";
3691
+ note?: string | undefined;
3692
+ };
3693
+ type?: string | undefined;
3694
+ required?: boolean | undefined;
3695
+ description?: string | undefined;
3696
+ defaultValue?: unknown;
3697
+ enumValues?: string[] | undefined;
3698
+ }[] | undefined;
3699
+ requestQueryParams?: {
3700
+ name: string;
3701
+ attribution: {
3702
+ source: "merchant_challenge" | "external_metadata";
3703
+ authority: "authoritative" | "advisory";
3704
+ note?: string | undefined;
3705
+ };
3706
+ type?: string | undefined;
3707
+ required?: boolean | undefined;
3708
+ description?: string | undefined;
3709
+ defaultValue?: unknown;
3710
+ enumValues?: string[] | undefined;
3711
+ }[] | undefined;
3712
+ requestPathParams?: {
3713
+ name: string;
3714
+ attribution: {
3715
+ source: "merchant_challenge" | "external_metadata";
3716
+ authority: "authoritative" | "advisory";
3717
+ note?: string | undefined;
3718
+ };
3719
+ type?: string | undefined;
3720
+ required?: boolean | undefined;
3721
+ description?: string | undefined;
3722
+ defaultValue?: unknown;
3723
+ enumValues?: string[] | undefined;
3724
+ }[] | undefined;
3725
+ notes?: {
3726
+ value: string;
3727
+ attribution: {
3728
+ source: "merchant_challenge" | "external_metadata";
3729
+ authority: "authoritative" | "advisory";
3730
+ note?: string | undefined;
3731
+ };
3732
+ }[] | undefined;
3733
+ };
3734
+ nextAction: "execute" | "revise_request" | "treat_as_passthrough" | "manual_review";
3735
+ challenge: {
3736
+ protocol: "x402" | "l402";
3737
+ headers?: Record<string, string> | undefined;
3738
+ body?: unknown;
3739
+ };
3740
+ probe?: {
3741
+ responseStatus: number;
3742
+ confirmedAt: string;
3743
+ } | undefined;
3744
+ validationIssues?: {
3745
+ code: string;
3746
+ message: string;
3747
+ source: "merchant_challenge" | "external_metadata";
3748
+ location: "path" | "headers" | "body" | "query";
3749
+ field: string;
3750
+ blocking: boolean;
3751
+ severity: "error" | "warning";
3752
+ suggestedFix?: string | undefined;
3753
+ }[] | undefined;
3754
+ paymentRequirement?: {
3755
+ protocol: "x402" | "l402";
3756
+ provenance: {
3757
+ source: "merchant_challenge" | "external_metadata";
3758
+ authority: "authoritative" | "advisory";
3759
+ note?: string | undefined;
3760
+ };
3761
+ asset?: string | undefined;
3762
+ amount?: string | undefined;
3763
+ amountMinor?: string | undefined;
3764
+ precision?: number | undefined;
3765
+ description?: string | undefined;
3766
+ network?: string | undefined;
3767
+ payee?: string | undefined;
3768
+ amountType?: "exact" | "max" | undefined;
3769
+ } | undefined;
3770
+ }>]>;
3771
+ export type SdkPreparedPaidRequest = z.infer<typeof sdkPreparedPaidRequestSchema>;
3772
+ /** Control-plane request shape used for governed paid execution decisions. */
117
3773
  export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
118
3774
  context: z.ZodObject<{
119
3775
  organization: z.ZodString;
@@ -165,12 +3821,6 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
165
3821
  }>;
166
3822
  idempotencyKey: z.ZodOptional<z.ZodString>;
167
3823
  }, "strip", z.ZodTypeAny, {
168
- context: {
169
- organization: string;
170
- agent: string;
171
- description?: string | undefined;
172
- metadata?: Record<string, unknown> | undefined;
173
- };
174
3824
  request: {
175
3825
  url: string;
176
3826
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
@@ -183,14 +3833,14 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
183
3833
  protocol: "x402" | "l402";
184
3834
  body?: unknown;
185
3835
  };
186
- idempotencyKey?: string | undefined;
187
- }, {
188
3836
  context: {
189
3837
  organization: string;
190
3838
  agent: string;
191
3839
  description?: string | undefined;
192
3840
  metadata?: Record<string, unknown> | undefined;
193
3841
  };
3842
+ idempotencyKey?: string | undefined;
3843
+ }, {
194
3844
  request: {
195
3845
  url: string;
196
3846
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
@@ -203,9 +3853,16 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
203
3853
  headers?: Record<string, string> | undefined;
204
3854
  body?: unknown;
205
3855
  };
3856
+ context: {
3857
+ organization: string;
3858
+ agent: string;
3859
+ description?: string | undefined;
3860
+ metadata?: Record<string, unknown> | undefined;
3861
+ };
206
3862
  idempotencyKey?: string | undefined;
207
3863
  }>;
208
3864
  export type SdkPaymentDecisionRequest = z.infer<typeof sdkPaymentDecisionRequestSchema>;
3865
+ /** Durable receipt shape returned after the control plane records an outcome. */
209
3866
  export declare const sdkReceiptSchema: z.ZodObject<{
210
3867
  receiptId: z.ZodString;
211
3868
  paidRequestId: z.ZodString;
@@ -285,12 +3942,12 @@ export declare const sdkReceiptSchema: z.ZodObject<{
285
3942
  requestUrl: string;
286
3943
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
287
3944
  createdAt: string;
3945
+ confirmedAt?: string | undefined;
288
3946
  merchantId?: string | undefined;
289
3947
  confirmationSource?: "chain_observer" | undefined;
290
3948
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
291
3949
  attributionBasis?: Record<string, unknown> | undefined;
292
3950
  attributionRuleVersion?: string | undefined;
293
- confirmedAt?: string | undefined;
294
3951
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
295
3952
  canonicalSettlementKey?: string | undefined;
296
3953
  paymentReference?: string | undefined;
@@ -320,12 +3977,12 @@ export declare const sdkReceiptSchema: z.ZodObject<{
320
3977
  requestUrl: string;
321
3978
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
322
3979
  createdAt: string;
3980
+ confirmedAt?: string | undefined;
323
3981
  merchantId?: string | undefined;
324
3982
  confirmationSource?: "chain_observer" | undefined;
325
3983
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
326
3984
  attributionBasis?: Record<string, unknown> | undefined;
327
3985
  attributionRuleVersion?: string | undefined;
328
- confirmedAt?: string | undefined;
329
3986
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
330
3987
  canonicalSettlementKey?: string | undefined;
331
3988
  paymentReference?: string | undefined;
@@ -337,6 +3994,7 @@ export declare const sdkReceiptSchema: z.ZodObject<{
337
3994
  completedAt?: string | undefined;
338
3995
  }>;
339
3996
  export type SdkReceipt = z.infer<typeof sdkReceiptSchema>;
3997
+ /** Normalized merchant HTTP response embedded in SDK results and decisions. */
340
3998
  export declare const sdkMerchantResponseSchema: z.ZodObject<{
341
3999
  status: z.ZodNumber;
342
4000
  headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -449,12 +4107,12 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
449
4107
  requestUrl: string;
450
4108
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
451
4109
  createdAt: string;
4110
+ confirmedAt?: string | undefined;
452
4111
  merchantId?: string | undefined;
453
4112
  confirmationSource?: "chain_observer" | undefined;
454
4113
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
455
4114
  attributionBasis?: Record<string, unknown> | undefined;
456
4115
  attributionRuleVersion?: string | undefined;
457
- confirmedAt?: string | undefined;
458
4116
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
459
4117
  canonicalSettlementKey?: string | undefined;
460
4118
  paymentReference?: string | undefined;
@@ -484,12 +4142,12 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
484
4142
  requestUrl: string;
485
4143
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
486
4144
  createdAt: string;
4145
+ confirmedAt?: string | undefined;
487
4146
  merchantId?: string | undefined;
488
4147
  confirmationSource?: "chain_observer" | undefined;
489
4148
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
490
4149
  attributionBasis?: Record<string, unknown> | undefined;
491
4150
  attributionRuleVersion?: string | undefined;
492
- confirmedAt?: string | undefined;
493
4151
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
494
4152
  canonicalSettlementKey?: string | undefined;
495
4153
  paymentReference?: string | undefined;
@@ -531,12 +4189,12 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
531
4189
  requestUrl: string;
532
4190
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
533
4191
  createdAt: string;
4192
+ confirmedAt?: string | undefined;
534
4193
  merchantId?: string | undefined;
535
4194
  confirmationSource?: "chain_observer" | undefined;
536
4195
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
537
4196
  attributionBasis?: Record<string, unknown> | undefined;
538
4197
  attributionRuleVersion?: string | undefined;
539
- confirmedAt?: string | undefined;
540
4198
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
541
4199
  canonicalSettlementKey?: string | undefined;
542
4200
  paymentReference?: string | undefined;
@@ -578,12 +4236,12 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
578
4236
  requestUrl: string;
579
4237
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
580
4238
  createdAt: string;
4239
+ confirmedAt?: string | undefined;
581
4240
  merchantId?: string | undefined;
582
4241
  confirmationSource?: "chain_observer" | undefined;
583
4242
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
584
4243
  attributionBasis?: Record<string, unknown> | undefined;
585
4244
  attributionRuleVersion?: string | undefined;
586
- confirmedAt?: string | undefined;
587
4245
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
588
4246
  canonicalSettlementKey?: string | undefined;
589
4247
  paymentReference?: string | undefined;
@@ -695,12 +4353,12 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
695
4353
  requestUrl: string;
696
4354
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
697
4355
  createdAt: string;
4356
+ confirmedAt?: string | undefined;
698
4357
  merchantId?: string | undefined;
699
4358
  confirmationSource?: "chain_observer" | undefined;
700
4359
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
701
4360
  attributionBasis?: Record<string, unknown> | undefined;
702
4361
  attributionRuleVersion?: string | undefined;
703
- confirmedAt?: string | undefined;
704
4362
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
705
4363
  canonicalSettlementKey?: string | undefined;
706
4364
  paymentReference?: string | undefined;
@@ -730,12 +4388,12 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
730
4388
  requestUrl: string;
731
4389
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
732
4390
  createdAt: string;
4391
+ confirmedAt?: string | undefined;
733
4392
  merchantId?: string | undefined;
734
4393
  confirmationSource?: "chain_observer" | undefined;
735
4394
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
736
4395
  attributionBasis?: Record<string, unknown> | undefined;
737
4396
  attributionRuleVersion?: string | undefined;
738
- confirmedAt?: string | undefined;
739
4397
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
740
4398
  canonicalSettlementKey?: string | undefined;
741
4399
  paymentReference?: string | undefined;
@@ -780,12 +4438,12 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
780
4438
  requestUrl: string;
781
4439
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
782
4440
  createdAt: string;
4441
+ confirmedAt?: string | undefined;
783
4442
  merchantId?: string | undefined;
784
4443
  confirmationSource?: "chain_observer" | undefined;
785
4444
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
786
4445
  attributionBasis?: Record<string, unknown> | undefined;
787
4446
  attributionRuleVersion?: string | undefined;
788
- confirmedAt?: string | undefined;
789
4447
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
790
4448
  canonicalSettlementKey?: string | undefined;
791
4449
  paymentReference?: string | undefined;
@@ -830,12 +4488,12 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
830
4488
  requestUrl: string;
831
4489
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
832
4490
  createdAt: string;
4491
+ confirmedAt?: string | undefined;
833
4492
  merchantId?: string | undefined;
834
4493
  confirmationSource?: "chain_observer" | undefined;
835
4494
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
836
4495
  attributionBasis?: Record<string, unknown> | undefined;
837
4496
  attributionRuleVersion?: string | undefined;
838
- confirmedAt?: string | undefined;
839
4497
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
840
4498
  canonicalSettlementKey?: string | undefined;
841
4499
  paymentReference?: string | undefined;
@@ -975,6 +4633,7 @@ export declare const sdkPaymentDecisionDenyResponseSchema: z.ZodObject<{
975
4633
  paidRequestId?: string | undefined;
976
4634
  policyReviewEventId?: string | undefined;
977
4635
  }>;
4636
+ /** Full union of decision outcomes the control plane can return to the SDK. */
978
4637
  export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"outcome", [z.ZodObject<{
979
4638
  outcome: z.ZodLiteral<"allow">;
980
4639
  paidRequestId: z.ZodString;
@@ -1073,12 +4732,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1073
4732
  requestUrl: string;
1074
4733
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1075
4734
  createdAt: string;
4735
+ confirmedAt?: string | undefined;
1076
4736
  merchantId?: string | undefined;
1077
4737
  confirmationSource?: "chain_observer" | undefined;
1078
4738
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1079
4739
  attributionBasis?: Record<string, unknown> | undefined;
1080
4740
  attributionRuleVersion?: string | undefined;
1081
- confirmedAt?: string | undefined;
1082
4741
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1083
4742
  canonicalSettlementKey?: string | undefined;
1084
4743
  paymentReference?: string | undefined;
@@ -1108,12 +4767,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1108
4767
  requestUrl: string;
1109
4768
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1110
4769
  createdAt: string;
4770
+ confirmedAt?: string | undefined;
1111
4771
  merchantId?: string | undefined;
1112
4772
  confirmationSource?: "chain_observer" | undefined;
1113
4773
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1114
4774
  attributionBasis?: Record<string, unknown> | undefined;
1115
4775
  attributionRuleVersion?: string | undefined;
1116
- confirmedAt?: string | undefined;
1117
4776
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1118
4777
  canonicalSettlementKey?: string | undefined;
1119
4778
  paymentReference?: string | undefined;
@@ -1155,12 +4814,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1155
4814
  requestUrl: string;
1156
4815
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1157
4816
  createdAt: string;
4817
+ confirmedAt?: string | undefined;
1158
4818
  merchantId?: string | undefined;
1159
4819
  confirmationSource?: "chain_observer" | undefined;
1160
4820
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1161
4821
  attributionBasis?: Record<string, unknown> | undefined;
1162
4822
  attributionRuleVersion?: string | undefined;
1163
- confirmedAt?: string | undefined;
1164
4823
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1165
4824
  canonicalSettlementKey?: string | undefined;
1166
4825
  paymentReference?: string | undefined;
@@ -1202,12 +4861,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1202
4861
  requestUrl: string;
1203
4862
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1204
4863
  createdAt: string;
4864
+ confirmedAt?: string | undefined;
1205
4865
  merchantId?: string | undefined;
1206
4866
  confirmationSource?: "chain_observer" | undefined;
1207
4867
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1208
4868
  attributionBasis?: Record<string, unknown> | undefined;
1209
4869
  attributionRuleVersion?: string | undefined;
1210
- confirmedAt?: string | undefined;
1211
4870
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1212
4871
  canonicalSettlementKey?: string | undefined;
1213
4872
  paymentReference?: string | undefined;
@@ -1318,12 +4977,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1318
4977
  requestUrl: string;
1319
4978
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1320
4979
  createdAt: string;
4980
+ confirmedAt?: string | undefined;
1321
4981
  merchantId?: string | undefined;
1322
4982
  confirmationSource?: "chain_observer" | undefined;
1323
4983
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1324
4984
  attributionBasis?: Record<string, unknown> | undefined;
1325
4985
  attributionRuleVersion?: string | undefined;
1326
- confirmedAt?: string | undefined;
1327
4986
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1328
4987
  canonicalSettlementKey?: string | undefined;
1329
4988
  paymentReference?: string | undefined;
@@ -1353,12 +5012,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1353
5012
  requestUrl: string;
1354
5013
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1355
5014
  createdAt: string;
5015
+ confirmedAt?: string | undefined;
1356
5016
  merchantId?: string | undefined;
1357
5017
  confirmationSource?: "chain_observer" | undefined;
1358
5018
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1359
5019
  attributionBasis?: Record<string, unknown> | undefined;
1360
5020
  attributionRuleVersion?: string | undefined;
1361
- confirmedAt?: string | undefined;
1362
5021
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1363
5022
  canonicalSettlementKey?: string | undefined;
1364
5023
  paymentReference?: string | undefined;
@@ -1403,12 +5062,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1403
5062
  requestUrl: string;
1404
5063
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1405
5064
  createdAt: string;
5065
+ confirmedAt?: string | undefined;
1406
5066
  merchantId?: string | undefined;
1407
5067
  confirmationSource?: "chain_observer" | undefined;
1408
5068
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1409
5069
  attributionBasis?: Record<string, unknown> | undefined;
1410
5070
  attributionRuleVersion?: string | undefined;
1411
- confirmedAt?: string | undefined;
1412
5071
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1413
5072
  canonicalSettlementKey?: string | undefined;
1414
5073
  paymentReference?: string | undefined;
@@ -1453,12 +5112,12 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1453
5112
  requestUrl: string;
1454
5113
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1455
5114
  createdAt: string;
5115
+ confirmedAt?: string | undefined;
1456
5116
  merchantId?: string | undefined;
1457
5117
  confirmationSource?: "chain_observer" | undefined;
1458
5118
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1459
5119
  attributionBasis?: Record<string, unknown> | undefined;
1460
5120
  attributionRuleVersion?: string | undefined;
1461
- confirmedAt?: string | undefined;
1462
5121
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1463
5122
  canonicalSettlementKey?: string | undefined;
1464
5123
  paymentReference?: string | undefined;
@@ -1594,6 +5253,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
1594
5253
  policyReviewEventId?: string | undefined;
1595
5254
  }>]>;
1596
5255
  export type SdkPaymentDecisionResponse = z.infer<typeof sdkPaymentDecisionResponseSchema>;
5256
+ /** Receipt lookup response returned by AgentPayClient.lookupReceipt(). */
1597
5257
  export declare const sdkReceiptResponseSchema: z.ZodObject<{
1598
5258
  receipt: z.ZodObject<{
1599
5259
  receiptId: z.ZodString;
@@ -1674,12 +5334,12 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
1674
5334
  requestUrl: string;
1675
5335
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1676
5336
  createdAt: string;
5337
+ confirmedAt?: string | undefined;
1677
5338
  merchantId?: string | undefined;
1678
5339
  confirmationSource?: "chain_observer" | undefined;
1679
5340
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1680
5341
  attributionBasis?: Record<string, unknown> | undefined;
1681
5342
  attributionRuleVersion?: string | undefined;
1682
- confirmedAt?: string | undefined;
1683
5343
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1684
5344
  canonicalSettlementKey?: string | undefined;
1685
5345
  paymentReference?: string | undefined;
@@ -1709,12 +5369,12 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
1709
5369
  requestUrl: string;
1710
5370
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1711
5371
  createdAt: string;
5372
+ confirmedAt?: string | undefined;
1712
5373
  merchantId?: string | undefined;
1713
5374
  confirmationSource?: "chain_observer" | undefined;
1714
5375
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1715
5376
  attributionBasis?: Record<string, unknown> | undefined;
1716
5377
  attributionRuleVersion?: string | undefined;
1717
- confirmedAt?: string | undefined;
1718
5378
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1719
5379
  canonicalSettlementKey?: string | undefined;
1720
5380
  paymentReference?: string | undefined;
@@ -1746,12 +5406,12 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
1746
5406
  requestUrl: string;
1747
5407
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1748
5408
  createdAt: string;
5409
+ confirmedAt?: string | undefined;
1749
5410
  merchantId?: string | undefined;
1750
5411
  confirmationSource?: "chain_observer" | undefined;
1751
5412
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1752
5413
  attributionBasis?: Record<string, unknown> | undefined;
1753
5414
  attributionRuleVersion?: string | undefined;
1754
- confirmedAt?: string | undefined;
1755
5415
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1756
5416
  canonicalSettlementKey?: string | undefined;
1757
5417
  paymentReference?: string | undefined;
@@ -1783,12 +5443,12 @@ export declare const sdkReceiptResponseSchema: z.ZodObject<{
1783
5443
  requestUrl: string;
1784
5444
  requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1785
5445
  createdAt: string;
5446
+ confirmedAt?: string | undefined;
1786
5447
  merchantId?: string | undefined;
1787
5448
  confirmationSource?: "chain_observer" | undefined;
1788
5449
  attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
1789
5450
  attributionBasis?: Record<string, unknown> | undefined;
1790
5451
  attributionRuleVersion?: string | undefined;
1791
- confirmedAt?: string | undefined;
1792
5452
  finalityLevelUsed?: "evm_block_confirmations_12" | undefined;
1793
5453
  canonicalSettlementKey?: string | undefined;
1794
5454
  paymentReference?: string | undefined;