@402flow/sdk 0.1.0-alpha.22 → 0.1.0-alpha.24

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.
Files changed (16) hide show
  1. package/README.md +184 -3
  2. package/dist/contracts.d.ts +1317 -156
  3. package/dist/contracts.js +94 -1
  4. package/dist/contracts.js.map +1 -1
  5. package/dist/executors.d.ts +27 -0
  6. package/dist/executors.js +2 -0
  7. package/dist/executors.js.map +1 -0
  8. package/dist/harness-instructions.d.ts +8 -0
  9. package/dist/harness-instructions.js.map +1 -1
  10. package/dist/http-utils.d.ts +1 -0
  11. package/dist/http-utils.js +12 -0
  12. package/dist/http-utils.js.map +1 -0
  13. package/dist/index.d.ts +14 -3
  14. package/dist/index.js +119 -28
  15. package/dist/index.js.map +1 -1
  16. package/package.json +6 -3
package/dist/contracts.d.ts CHANGED
@@ -30,6 +30,8 @@ export declare const paidRequestProtocolSchema: z.ZodEnum<["x402", "l402"]>;
30
30
  export type PaidRequestProtocol = z.infer<typeof paidRequestProtocolSchema>;
31
31
  export declare const paidRequestHttpMethodSchema: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
32
32
  export type PaidRequestHttpMethod = z.infer<typeof paidRequestHttpMethodSchema>;
33
+ export declare const paidRequestExecutionProviderSchema: z.ZodString;
34
+ export type PaidRequestExecutionProvider = z.infer<typeof paidRequestExecutionProviderSchema>;
33
35
  export declare const paidRequestReasonCodeSchema: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "challenge_candidate_malformed", "challenge_no_supported_candidates", "challenge_mixed_environment_candidates", "challenge_execution_identity_unavailable", "challenge_execution_identity_ambiguous", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "settlement_proof_conflict", "merchant_transport_lost"]>;
34
36
  export type PaidRequestReasonCode = z.infer<typeof paidRequestReasonCodeSchema>;
35
37
  export declare const defaultMoneyPrecision = 6;
@@ -76,22 +78,78 @@ export declare const normalizedMoneySchema: z.ZodEffects<z.ZodObject<{
76
78
  unit: "minor";
77
79
  }>;
78
80
  export type NormalizedMoney = z.infer<typeof normalizedMoneySchema>;
79
- /** Request-scoped context the control plane uses for policy, audit, and identity. */
81
+ /** Request-scoped context the control plane uses for policy, audit, identity, and optional provenance. */
80
82
  export declare const paidRequestContextSchema: z.ZodObject<{
81
83
  organization: z.ZodString;
82
84
  agent: z.ZodString;
83
85
  description: z.ZodOptional<z.ZodString>;
84
86
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
87
+ executionProvider: z.ZodOptional<z.ZodString>;
88
+ attribution: z.ZodOptional<z.ZodObject<{
89
+ discoverySource: z.ZodOptional<z.ZodEnum<["coinbase_bazaar", "dexter", "pay_sh", "x402scan", "manual", "direct", "observed", "imported", "unknown"]>>;
90
+ resourceIdentity: z.ZodOptional<z.ZodObject<{
91
+ kind: z.ZodLiteral<"http_endpoint">;
92
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
93
+ canonicalUrl: z.ZodString;
94
+ canonicalKey: z.ZodString;
95
+ }, "strip", z.ZodTypeAny, {
96
+ kind: "http_endpoint";
97
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
98
+ canonicalUrl: string;
99
+ canonicalKey: string;
100
+ }, {
101
+ kind: "http_endpoint";
102
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
103
+ canonicalUrl: string;
104
+ canonicalKey: string;
105
+ }>>;
106
+ }, "strip", z.ZodTypeAny, {
107
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
108
+ resourceIdentity?: {
109
+ kind: "http_endpoint";
110
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
111
+ canonicalUrl: string;
112
+ canonicalKey: string;
113
+ } | undefined;
114
+ }, {
115
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
116
+ resourceIdentity?: {
117
+ kind: "http_endpoint";
118
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
119
+ canonicalUrl: string;
120
+ canonicalKey: string;
121
+ } | undefined;
122
+ }>>;
85
123
  }, "strip", z.ZodTypeAny, {
86
124
  organization: string;
87
125
  agent: string;
88
126
  description?: string | undefined;
89
127
  metadata?: Record<string, unknown> | undefined;
128
+ executionProvider?: string | undefined;
129
+ attribution?: {
130
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
131
+ resourceIdentity?: {
132
+ kind: "http_endpoint";
133
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
134
+ canonicalUrl: string;
135
+ canonicalKey: string;
136
+ } | undefined;
137
+ } | undefined;
90
138
  }, {
91
139
  organization: string;
92
140
  agent: string;
93
141
  description?: string | undefined;
94
142
  metadata?: Record<string, unknown> | undefined;
143
+ executionProvider?: string | undefined;
144
+ attribution?: {
145
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
146
+ resourceIdentity?: {
147
+ kind: "http_endpoint";
148
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
149
+ canonicalUrl: string;
150
+ canonicalKey: string;
151
+ } | undefined;
152
+ } | undefined;
95
153
  }>;
96
154
  export type PaidRequestContext = z.infer<typeof paidRequestContextSchema>;
97
155
  /** Exact HTTP request shape that gets prepared, hashed, and later executed. */
@@ -102,14 +160,14 @@ export declare const paidRequestHttpRequestSchema: z.ZodObject<{
102
160
  body: z.ZodOptional<z.ZodString>;
103
161
  bodyHash: z.ZodOptional<z.ZodString>;
104
162
  }, "strip", z.ZodTypeAny, {
105
- url: string;
106
163
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
164
+ url: string;
107
165
  headers?: Record<string, string> | undefined;
108
166
  body?: string | undefined;
109
167
  bodyHash?: string | undefined;
110
168
  }, {
111
- url: string;
112
169
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
170
+ url: string;
113
171
  headers?: Record<string, string> | undefined;
114
172
  body?: string | undefined;
115
173
  bodyHash?: string | undefined;
@@ -356,24 +414,24 @@ export declare const sdkPreparedHintFieldSchema: z.ZodObject<{
356
414
  note?: string | undefined;
357
415
  }>;
358
416
  }, "strip", z.ZodTypeAny, {
359
- name: string;
360
417
  attribution: {
361
418
  source: "merchant_challenge" | "external_metadata";
362
419
  authority: "authoritative" | "advisory";
363
420
  note?: string | undefined;
364
421
  };
422
+ name: string;
365
423
  type?: string | undefined;
366
424
  required?: boolean | undefined;
367
425
  description?: string | undefined;
368
426
  defaultValue?: unknown;
369
427
  enumValues?: string[] | undefined;
370
428
  }, {
371
- name: string;
372
429
  attribution: {
373
430
  source: "merchant_challenge" | "external_metadata";
374
431
  authority: "authoritative" | "advisory";
375
432
  note?: string | undefined;
376
433
  };
434
+ name: string;
377
435
  type?: string | undefined;
378
436
  required?: boolean | undefined;
379
437
  description?: string | undefined;
@@ -499,24 +557,24 @@ export declare const sdkPreparedRequestHintsSchema: z.ZodObject<{
499
557
  note?: string | undefined;
500
558
  }>;
501
559
  }, "strip", z.ZodTypeAny, {
502
- name: string;
503
560
  attribution: {
504
561
  source: "merchant_challenge" | "external_metadata";
505
562
  authority: "authoritative" | "advisory";
506
563
  note?: string | undefined;
507
564
  };
565
+ name: string;
508
566
  type?: string | undefined;
509
567
  required?: boolean | undefined;
510
568
  description?: string | undefined;
511
569
  defaultValue?: unknown;
512
570
  enumValues?: string[] | undefined;
513
571
  }, {
514
- name: string;
515
572
  attribution: {
516
573
  source: "merchant_challenge" | "external_metadata";
517
574
  authority: "authoritative" | "advisory";
518
575
  note?: string | undefined;
519
576
  };
577
+ name: string;
520
578
  type?: string | undefined;
521
579
  required?: boolean | undefined;
522
580
  description?: string | undefined;
@@ -545,24 +603,24 @@ export declare const sdkPreparedRequestHintsSchema: z.ZodObject<{
545
603
  note?: string | undefined;
546
604
  }>;
547
605
  }, "strip", z.ZodTypeAny, {
548
- name: string;
549
606
  attribution: {
550
607
  source: "merchant_challenge" | "external_metadata";
551
608
  authority: "authoritative" | "advisory";
552
609
  note?: string | undefined;
553
610
  };
611
+ name: string;
554
612
  type?: string | undefined;
555
613
  required?: boolean | undefined;
556
614
  description?: string | undefined;
557
615
  defaultValue?: unknown;
558
616
  enumValues?: string[] | undefined;
559
617
  }, {
560
- name: string;
561
618
  attribution: {
562
619
  source: "merchant_challenge" | "external_metadata";
563
620
  authority: "authoritative" | "advisory";
564
621
  note?: string | undefined;
565
622
  };
623
+ name: string;
566
624
  type?: string | undefined;
567
625
  required?: boolean | undefined;
568
626
  description?: string | undefined;
@@ -591,24 +649,24 @@ export declare const sdkPreparedRequestHintsSchema: z.ZodObject<{
591
649
  note?: string | undefined;
592
650
  }>;
593
651
  }, "strip", z.ZodTypeAny, {
594
- name: string;
595
652
  attribution: {
596
653
  source: "merchant_challenge" | "external_metadata";
597
654
  authority: "authoritative" | "advisory";
598
655
  note?: string | undefined;
599
656
  };
657
+ name: string;
600
658
  type?: string | undefined;
601
659
  required?: boolean | undefined;
602
660
  description?: string | undefined;
603
661
  defaultValue?: unknown;
604
662
  enumValues?: string[] | undefined;
605
663
  }, {
606
- name: string;
607
664
  attribution: {
608
665
  source: "merchant_challenge" | "external_metadata";
609
666
  authority: "authoritative" | "advisory";
610
667
  note?: string | undefined;
611
668
  };
669
+ name: string;
612
670
  type?: string | undefined;
613
671
  required?: boolean | undefined;
614
672
  description?: string | undefined;
@@ -647,12 +705,12 @@ export declare const sdkPreparedRequestHintsSchema: z.ZodObject<{
647
705
  }>, "many">>;
648
706
  }, "strip", z.ZodTypeAny, {
649
707
  requestBodyFields: {
650
- name: string;
651
708
  attribution: {
652
709
  source: "merchant_challenge" | "external_metadata";
653
710
  authority: "authoritative" | "advisory";
654
711
  note?: string | undefined;
655
712
  };
713
+ name: string;
656
714
  type?: string | undefined;
657
715
  required?: boolean | undefined;
658
716
  description?: string | undefined;
@@ -660,12 +718,12 @@ export declare const sdkPreparedRequestHintsSchema: z.ZodObject<{
660
718
  enumValues?: string[] | undefined;
661
719
  }[];
662
720
  requestQueryParams: {
663
- name: string;
664
721
  attribution: {
665
722
  source: "merchant_challenge" | "external_metadata";
666
723
  authority: "authoritative" | "advisory";
667
724
  note?: string | undefined;
668
725
  };
726
+ name: string;
669
727
  type?: string | undefined;
670
728
  required?: boolean | undefined;
671
729
  description?: string | undefined;
@@ -673,12 +731,12 @@ export declare const sdkPreparedRequestHintsSchema: z.ZodObject<{
673
731
  enumValues?: string[] | undefined;
674
732
  }[];
675
733
  requestPathParams: {
676
- name: string;
677
734
  attribution: {
678
735
  source: "merchant_challenge" | "external_metadata";
679
736
  authority: "authoritative" | "advisory";
680
737
  note?: string | undefined;
681
738
  };
739
+ name: string;
682
740
  type?: string | undefined;
683
741
  required?: boolean | undefined;
684
742
  description?: string | undefined;
@@ -743,12 +801,12 @@ export declare const sdkPreparedRequestHintsSchema: z.ZodObject<{
743
801
  };
744
802
  } | undefined;
745
803
  requestBodyFields?: {
746
- name: string;
747
804
  attribution: {
748
805
  source: "merchant_challenge" | "external_metadata";
749
806
  authority: "authoritative" | "advisory";
750
807
  note?: string | undefined;
751
808
  };
809
+ name: string;
752
810
  type?: string | undefined;
753
811
  required?: boolean | undefined;
754
812
  description?: string | undefined;
@@ -756,12 +814,12 @@ export declare const sdkPreparedRequestHintsSchema: z.ZodObject<{
756
814
  enumValues?: string[] | undefined;
757
815
  }[] | undefined;
758
816
  requestQueryParams?: {
759
- name: string;
760
817
  attribution: {
761
818
  source: "merchant_challenge" | "external_metadata";
762
819
  authority: "authoritative" | "advisory";
763
820
  note?: string | undefined;
764
821
  };
822
+ name: string;
765
823
  type?: string | undefined;
766
824
  required?: boolean | undefined;
767
825
  description?: string | undefined;
@@ -769,12 +827,12 @@ export declare const sdkPreparedRequestHintsSchema: z.ZodObject<{
769
827
  enumValues?: string[] | undefined;
770
828
  }[] | undefined;
771
829
  requestPathParams?: {
772
- name: string;
773
830
  attribution: {
774
831
  source: "merchant_challenge" | "external_metadata";
775
832
  authority: "authoritative" | "advisory";
776
833
  note?: string | undefined;
777
834
  };
835
+ name: string;
778
836
  type?: string | undefined;
779
837
  required?: boolean | undefined;
780
838
  description?: string | undefined;
@@ -1072,14 +1130,14 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1072
1130
  body: z.ZodOptional<z.ZodString>;
1073
1131
  bodyHash: z.ZodOptional<z.ZodString>;
1074
1132
  }, "strip", z.ZodTypeAny, {
1075
- url: string;
1076
1133
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1134
+ url: string;
1077
1135
  headers?: Record<string, string> | undefined;
1078
1136
  body?: string | undefined;
1079
1137
  bodyHash?: string | undefined;
1080
1138
  }, {
1081
- url: string;
1082
1139
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1140
+ url: string;
1083
1141
  headers?: Record<string, string> | undefined;
1084
1142
  body?: string | undefined;
1085
1143
  bodyHash?: string | undefined;
@@ -1197,24 +1255,24 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1197
1255
  note?: string | undefined;
1198
1256
  }>;
1199
1257
  }, "strip", z.ZodTypeAny, {
1200
- name: string;
1201
1258
  attribution: {
1202
1259
  source: "merchant_challenge" | "external_metadata";
1203
1260
  authority: "authoritative" | "advisory";
1204
1261
  note?: string | undefined;
1205
1262
  };
1263
+ name: string;
1206
1264
  type?: string | undefined;
1207
1265
  required?: boolean | undefined;
1208
1266
  description?: string | undefined;
1209
1267
  defaultValue?: unknown;
1210
1268
  enumValues?: string[] | undefined;
1211
1269
  }, {
1212
- name: string;
1213
1270
  attribution: {
1214
1271
  source: "merchant_challenge" | "external_metadata";
1215
1272
  authority: "authoritative" | "advisory";
1216
1273
  note?: string | undefined;
1217
1274
  };
1275
+ name: string;
1218
1276
  type?: string | undefined;
1219
1277
  required?: boolean | undefined;
1220
1278
  description?: string | undefined;
@@ -1243,24 +1301,24 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1243
1301
  note?: string | undefined;
1244
1302
  }>;
1245
1303
  }, "strip", z.ZodTypeAny, {
1246
- name: string;
1247
1304
  attribution: {
1248
1305
  source: "merchant_challenge" | "external_metadata";
1249
1306
  authority: "authoritative" | "advisory";
1250
1307
  note?: string | undefined;
1251
1308
  };
1309
+ name: string;
1252
1310
  type?: string | undefined;
1253
1311
  required?: boolean | undefined;
1254
1312
  description?: string | undefined;
1255
1313
  defaultValue?: unknown;
1256
1314
  enumValues?: string[] | undefined;
1257
1315
  }, {
1258
- name: string;
1259
1316
  attribution: {
1260
1317
  source: "merchant_challenge" | "external_metadata";
1261
1318
  authority: "authoritative" | "advisory";
1262
1319
  note?: string | undefined;
1263
1320
  };
1321
+ name: string;
1264
1322
  type?: string | undefined;
1265
1323
  required?: boolean | undefined;
1266
1324
  description?: string | undefined;
@@ -1289,24 +1347,24 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1289
1347
  note?: string | undefined;
1290
1348
  }>;
1291
1349
  }, "strip", z.ZodTypeAny, {
1292
- name: string;
1293
1350
  attribution: {
1294
1351
  source: "merchant_challenge" | "external_metadata";
1295
1352
  authority: "authoritative" | "advisory";
1296
1353
  note?: string | undefined;
1297
1354
  };
1355
+ name: string;
1298
1356
  type?: string | undefined;
1299
1357
  required?: boolean | undefined;
1300
1358
  description?: string | undefined;
1301
1359
  defaultValue?: unknown;
1302
1360
  enumValues?: string[] | undefined;
1303
1361
  }, {
1304
- name: string;
1305
1362
  attribution: {
1306
1363
  source: "merchant_challenge" | "external_metadata";
1307
1364
  authority: "authoritative" | "advisory";
1308
1365
  note?: string | undefined;
1309
1366
  };
1367
+ name: string;
1310
1368
  type?: string | undefined;
1311
1369
  required?: boolean | undefined;
1312
1370
  description?: string | undefined;
@@ -1345,12 +1403,12 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1345
1403
  }>, "many">>;
1346
1404
  }, "strip", z.ZodTypeAny, {
1347
1405
  requestBodyFields: {
1348
- name: string;
1349
1406
  attribution: {
1350
1407
  source: "merchant_challenge" | "external_metadata";
1351
1408
  authority: "authoritative" | "advisory";
1352
1409
  note?: string | undefined;
1353
1410
  };
1411
+ name: string;
1354
1412
  type?: string | undefined;
1355
1413
  required?: boolean | undefined;
1356
1414
  description?: string | undefined;
@@ -1358,12 +1416,12 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1358
1416
  enumValues?: string[] | undefined;
1359
1417
  }[];
1360
1418
  requestQueryParams: {
1361
- name: string;
1362
1419
  attribution: {
1363
1420
  source: "merchant_challenge" | "external_metadata";
1364
1421
  authority: "authoritative" | "advisory";
1365
1422
  note?: string | undefined;
1366
1423
  };
1424
+ name: string;
1367
1425
  type?: string | undefined;
1368
1426
  required?: boolean | undefined;
1369
1427
  description?: string | undefined;
@@ -1371,12 +1429,12 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1371
1429
  enumValues?: string[] | undefined;
1372
1430
  }[];
1373
1431
  requestPathParams: {
1374
- name: string;
1375
1432
  attribution: {
1376
1433
  source: "merchant_challenge" | "external_metadata";
1377
1434
  authority: "authoritative" | "advisory";
1378
1435
  note?: string | undefined;
1379
1436
  };
1437
+ name: string;
1380
1438
  type?: string | undefined;
1381
1439
  required?: boolean | undefined;
1382
1440
  description?: string | undefined;
@@ -1441,12 +1499,12 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1441
1499
  };
1442
1500
  } | undefined;
1443
1501
  requestBodyFields?: {
1444
- name: string;
1445
1502
  attribution: {
1446
1503
  source: "merchant_challenge" | "external_metadata";
1447
1504
  authority: "authoritative" | "advisory";
1448
1505
  note?: string | undefined;
1449
1506
  };
1507
+ name: string;
1450
1508
  type?: string | undefined;
1451
1509
  required?: boolean | undefined;
1452
1510
  description?: string | undefined;
@@ -1454,12 +1512,12 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1454
1512
  enumValues?: string[] | undefined;
1455
1513
  }[] | undefined;
1456
1514
  requestQueryParams?: {
1457
- name: string;
1458
1515
  attribution: {
1459
1516
  source: "merchant_challenge" | "external_metadata";
1460
1517
  authority: "authoritative" | "advisory";
1461
1518
  note?: string | undefined;
1462
1519
  };
1520
+ name: string;
1463
1521
  type?: string | undefined;
1464
1522
  required?: boolean | undefined;
1465
1523
  description?: string | undefined;
@@ -1467,12 +1525,12 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1467
1525
  enumValues?: string[] | undefined;
1468
1526
  }[] | undefined;
1469
1527
  requestPathParams?: {
1470
- name: string;
1471
1528
  attribution: {
1472
1529
  source: "merchant_challenge" | "external_metadata";
1473
1530
  authority: "authoritative" | "advisory";
1474
1531
  note?: string | undefined;
1475
1532
  };
1533
+ name: string;
1476
1534
  type?: string | undefined;
1477
1535
  required?: boolean | undefined;
1478
1536
  description?: string | undefined;
@@ -1528,23 +1586,23 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1528
1586
  }>, "many">>;
1529
1587
  nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough"]>;
1530
1588
  }, "strip", z.ZodTypeAny, {
1531
- protocol: "none";
1532
1589
  kind: "passthrough";
1590
+ protocol: "none";
1533
1591
  request: {
1534
- url: string;
1535
1592
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1593
+ url: string;
1536
1594
  headers?: Record<string, string> | undefined;
1537
1595
  body?: string | undefined;
1538
1596
  bodyHash?: string | undefined;
1539
1597
  };
1540
1598
  hints: {
1541
1599
  requestBodyFields: {
1542
- name: string;
1543
1600
  attribution: {
1544
1601
  source: "merchant_challenge" | "external_metadata";
1545
1602
  authority: "authoritative" | "advisory";
1546
1603
  note?: string | undefined;
1547
1604
  };
1605
+ name: string;
1548
1606
  type?: string | undefined;
1549
1607
  required?: boolean | undefined;
1550
1608
  description?: string | undefined;
@@ -1552,12 +1610,12 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1552
1610
  enumValues?: string[] | undefined;
1553
1611
  }[];
1554
1612
  requestQueryParams: {
1555
- name: string;
1556
1613
  attribution: {
1557
1614
  source: "merchant_challenge" | "external_metadata";
1558
1615
  authority: "authoritative" | "advisory";
1559
1616
  note?: string | undefined;
1560
1617
  };
1618
+ name: string;
1561
1619
  type?: string | undefined;
1562
1620
  required?: boolean | undefined;
1563
1621
  description?: string | undefined;
@@ -1565,12 +1623,12 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1565
1623
  enumValues?: string[] | undefined;
1566
1624
  }[];
1567
1625
  requestPathParams: {
1568
- name: string;
1569
1626
  attribution: {
1570
1627
  source: "merchant_challenge" | "external_metadata";
1571
1628
  authority: "authoritative" | "advisory";
1572
1629
  note?: string | undefined;
1573
1630
  };
1631
+ name: string;
1574
1632
  type?: string | undefined;
1575
1633
  required?: boolean | undefined;
1576
1634
  description?: string | undefined;
@@ -1626,11 +1684,11 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1626
1684
  confirmedAt: string;
1627
1685
  } | undefined;
1628
1686
  }, {
1629
- protocol: "none";
1630
1687
  kind: "passthrough";
1688
+ protocol: "none";
1631
1689
  request: {
1632
- url: string;
1633
1690
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1691
+ url: string;
1634
1692
  headers?: Record<string, string> | undefined;
1635
1693
  body?: string | undefined;
1636
1694
  bodyHash?: string | undefined;
@@ -1661,12 +1719,12 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1661
1719
  };
1662
1720
  } | undefined;
1663
1721
  requestBodyFields?: {
1664
- name: string;
1665
1722
  attribution: {
1666
1723
  source: "merchant_challenge" | "external_metadata";
1667
1724
  authority: "authoritative" | "advisory";
1668
1725
  note?: string | undefined;
1669
1726
  };
1727
+ name: string;
1670
1728
  type?: string | undefined;
1671
1729
  required?: boolean | undefined;
1672
1730
  description?: string | undefined;
@@ -1674,12 +1732,12 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1674
1732
  enumValues?: string[] | undefined;
1675
1733
  }[] | undefined;
1676
1734
  requestQueryParams?: {
1677
- name: string;
1678
1735
  attribution: {
1679
1736
  source: "merchant_challenge" | "external_metadata";
1680
1737
  authority: "authoritative" | "advisory";
1681
1738
  note?: string | undefined;
1682
1739
  };
1740
+ name: string;
1683
1741
  type?: string | undefined;
1684
1742
  required?: boolean | undefined;
1685
1743
  description?: string | undefined;
@@ -1687,12 +1745,12 @@ export declare const sdkPreparedPaidRequestPassthroughSchema: z.ZodObject<{
1687
1745
  enumValues?: string[] | undefined;
1688
1746
  }[] | undefined;
1689
1747
  requestPathParams?: {
1690
- name: string;
1691
1748
  attribution: {
1692
1749
  source: "merchant_challenge" | "external_metadata";
1693
1750
  authority: "authoritative" | "advisory";
1694
1751
  note?: string | undefined;
1695
1752
  };
1753
+ name: string;
1696
1754
  type?: string | undefined;
1697
1755
  required?: boolean | undefined;
1698
1756
  description?: string | undefined;
@@ -1736,14 +1794,14 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
1736
1794
  body: z.ZodOptional<z.ZodString>;
1737
1795
  bodyHash: z.ZodOptional<z.ZodString>;
1738
1796
  }, "strip", z.ZodTypeAny, {
1739
- url: string;
1740
1797
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1798
+ url: string;
1741
1799
  headers?: Record<string, string> | undefined;
1742
1800
  body?: string | undefined;
1743
1801
  bodyHash?: string | undefined;
1744
1802
  }, {
1745
- url: string;
1746
1803
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
1804
+ url: string;
1747
1805
  headers?: Record<string, string> | undefined;
1748
1806
  body?: string | undefined;
1749
1807
  bodyHash?: string | undefined;
@@ -2032,24 +2090,24 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2032
2090
  note?: string | undefined;
2033
2091
  }>;
2034
2092
  }, "strip", z.ZodTypeAny, {
2035
- name: string;
2036
2093
  attribution: {
2037
2094
  source: "merchant_challenge" | "external_metadata";
2038
2095
  authority: "authoritative" | "advisory";
2039
2096
  note?: string | undefined;
2040
2097
  };
2098
+ name: string;
2041
2099
  type?: string | undefined;
2042
2100
  required?: boolean | undefined;
2043
2101
  description?: string | undefined;
2044
2102
  defaultValue?: unknown;
2045
2103
  enumValues?: string[] | undefined;
2046
2104
  }, {
2047
- name: string;
2048
2105
  attribution: {
2049
2106
  source: "merchant_challenge" | "external_metadata";
2050
2107
  authority: "authoritative" | "advisory";
2051
2108
  note?: string | undefined;
2052
2109
  };
2110
+ name: string;
2053
2111
  type?: string | undefined;
2054
2112
  required?: boolean | undefined;
2055
2113
  description?: string | undefined;
@@ -2078,24 +2136,24 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2078
2136
  note?: string | undefined;
2079
2137
  }>;
2080
2138
  }, "strip", z.ZodTypeAny, {
2081
- name: string;
2082
2139
  attribution: {
2083
2140
  source: "merchant_challenge" | "external_metadata";
2084
2141
  authority: "authoritative" | "advisory";
2085
2142
  note?: string | undefined;
2086
2143
  };
2144
+ name: string;
2087
2145
  type?: string | undefined;
2088
2146
  required?: boolean | undefined;
2089
2147
  description?: string | undefined;
2090
2148
  defaultValue?: unknown;
2091
2149
  enumValues?: string[] | undefined;
2092
2150
  }, {
2093
- name: string;
2094
2151
  attribution: {
2095
2152
  source: "merchant_challenge" | "external_metadata";
2096
2153
  authority: "authoritative" | "advisory";
2097
2154
  note?: string | undefined;
2098
2155
  };
2156
+ name: string;
2099
2157
  type?: string | undefined;
2100
2158
  required?: boolean | undefined;
2101
2159
  description?: string | undefined;
@@ -2124,24 +2182,24 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2124
2182
  note?: string | undefined;
2125
2183
  }>;
2126
2184
  }, "strip", z.ZodTypeAny, {
2127
- name: string;
2128
2185
  attribution: {
2129
2186
  source: "merchant_challenge" | "external_metadata";
2130
2187
  authority: "authoritative" | "advisory";
2131
2188
  note?: string | undefined;
2132
2189
  };
2190
+ name: string;
2133
2191
  type?: string | undefined;
2134
2192
  required?: boolean | undefined;
2135
2193
  description?: string | undefined;
2136
2194
  defaultValue?: unknown;
2137
2195
  enumValues?: string[] | undefined;
2138
2196
  }, {
2139
- name: string;
2140
2197
  attribution: {
2141
2198
  source: "merchant_challenge" | "external_metadata";
2142
2199
  authority: "authoritative" | "advisory";
2143
2200
  note?: string | undefined;
2144
2201
  };
2202
+ name: string;
2145
2203
  type?: string | undefined;
2146
2204
  required?: boolean | undefined;
2147
2205
  description?: string | undefined;
@@ -2180,12 +2238,12 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2180
2238
  }>, "many">>;
2181
2239
  }, "strip", z.ZodTypeAny, {
2182
2240
  requestBodyFields: {
2183
- name: string;
2184
2241
  attribution: {
2185
2242
  source: "merchant_challenge" | "external_metadata";
2186
2243
  authority: "authoritative" | "advisory";
2187
2244
  note?: string | undefined;
2188
2245
  };
2246
+ name: string;
2189
2247
  type?: string | undefined;
2190
2248
  required?: boolean | undefined;
2191
2249
  description?: string | undefined;
@@ -2193,12 +2251,12 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2193
2251
  enumValues?: string[] | undefined;
2194
2252
  }[];
2195
2253
  requestQueryParams: {
2196
- name: string;
2197
2254
  attribution: {
2198
2255
  source: "merchant_challenge" | "external_metadata";
2199
2256
  authority: "authoritative" | "advisory";
2200
2257
  note?: string | undefined;
2201
2258
  };
2259
+ name: string;
2202
2260
  type?: string | undefined;
2203
2261
  required?: boolean | undefined;
2204
2262
  description?: string | undefined;
@@ -2206,12 +2264,12 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2206
2264
  enumValues?: string[] | undefined;
2207
2265
  }[];
2208
2266
  requestPathParams: {
2209
- name: string;
2210
2267
  attribution: {
2211
2268
  source: "merchant_challenge" | "external_metadata";
2212
2269
  authority: "authoritative" | "advisory";
2213
2270
  note?: string | undefined;
2214
2271
  };
2272
+ name: string;
2215
2273
  type?: string | undefined;
2216
2274
  required?: boolean | undefined;
2217
2275
  description?: string | undefined;
@@ -2276,12 +2334,12 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2276
2334
  };
2277
2335
  } | undefined;
2278
2336
  requestBodyFields?: {
2279
- name: string;
2280
2337
  attribution: {
2281
2338
  source: "merchant_challenge" | "external_metadata";
2282
2339
  authority: "authoritative" | "advisory";
2283
2340
  note?: string | undefined;
2284
2341
  };
2342
+ name: string;
2285
2343
  type?: string | undefined;
2286
2344
  required?: boolean | undefined;
2287
2345
  description?: string | undefined;
@@ -2289,12 +2347,12 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2289
2347
  enumValues?: string[] | undefined;
2290
2348
  }[] | undefined;
2291
2349
  requestQueryParams?: {
2292
- name: string;
2293
2350
  attribution: {
2294
2351
  source: "merchant_challenge" | "external_metadata";
2295
2352
  authority: "authoritative" | "advisory";
2296
2353
  note?: string | undefined;
2297
2354
  };
2355
+ name: string;
2298
2356
  type?: string | undefined;
2299
2357
  required?: boolean | undefined;
2300
2358
  description?: string | undefined;
@@ -2302,12 +2360,12 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2302
2360
  enumValues?: string[] | undefined;
2303
2361
  }[] | undefined;
2304
2362
  requestPathParams?: {
2305
- name: string;
2306
2363
  attribution: {
2307
2364
  source: "merchant_challenge" | "external_metadata";
2308
2365
  authority: "authoritative" | "advisory";
2309
2366
  note?: string | undefined;
2310
2367
  };
2368
+ name: string;
2311
2369
  type?: string | undefined;
2312
2370
  required?: boolean | undefined;
2313
2371
  description?: string | undefined;
@@ -2363,23 +2421,23 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2363
2421
  }>, "many">>;
2364
2422
  nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough"]>;
2365
2423
  }, "strip", z.ZodTypeAny, {
2366
- protocol: "x402" | "l402";
2367
2424
  kind: "ready";
2425
+ protocol: "x402" | "l402";
2368
2426
  request: {
2369
- url: string;
2370
2427
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
2428
+ url: string;
2371
2429
  headers?: Record<string, string> | undefined;
2372
2430
  body?: string | undefined;
2373
2431
  bodyHash?: string | undefined;
2374
2432
  };
2375
2433
  hints: {
2376
2434
  requestBodyFields: {
2377
- name: string;
2378
2435
  attribution: {
2379
2436
  source: "merchant_challenge" | "external_metadata";
2380
2437
  authority: "authoritative" | "advisory";
2381
2438
  note?: string | undefined;
2382
2439
  };
2440
+ name: string;
2383
2441
  type?: string | undefined;
2384
2442
  required?: boolean | undefined;
2385
2443
  description?: string | undefined;
@@ -2387,12 +2445,12 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2387
2445
  enumValues?: string[] | undefined;
2388
2446
  }[];
2389
2447
  requestQueryParams: {
2390
- name: string;
2391
2448
  attribution: {
2392
2449
  source: "merchant_challenge" | "external_metadata";
2393
2450
  authority: "authoritative" | "advisory";
2394
2451
  note?: string | undefined;
2395
2452
  };
2453
+ name: string;
2396
2454
  type?: string | undefined;
2397
2455
  required?: boolean | undefined;
2398
2456
  description?: string | undefined;
@@ -2400,12 +2458,12 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2400
2458
  enumValues?: string[] | undefined;
2401
2459
  }[];
2402
2460
  requestPathParams: {
2403
- name: string;
2404
2461
  attribution: {
2405
2462
  source: "merchant_challenge" | "external_metadata";
2406
2463
  authority: "authoritative" | "advisory";
2407
2464
  note?: string | undefined;
2408
2465
  };
2466
+ name: string;
2409
2467
  type?: string | undefined;
2410
2468
  required?: boolean | undefined;
2411
2469
  description?: string | undefined;
@@ -2506,11 +2564,11 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2506
2564
  amountType?: "exact" | "max" | undefined;
2507
2565
  } | undefined;
2508
2566
  }, {
2509
- protocol: "x402" | "l402";
2510
2567
  kind: "ready";
2568
+ protocol: "x402" | "l402";
2511
2569
  request: {
2512
- url: string;
2513
2570
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
2571
+ url: string;
2514
2572
  headers?: Record<string, string> | undefined;
2515
2573
  body?: string | undefined;
2516
2574
  bodyHash?: string | undefined;
@@ -2541,12 +2599,12 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2541
2599
  };
2542
2600
  } | undefined;
2543
2601
  requestBodyFields?: {
2544
- name: string;
2545
2602
  attribution: {
2546
2603
  source: "merchant_challenge" | "external_metadata";
2547
2604
  authority: "authoritative" | "advisory";
2548
2605
  note?: string | undefined;
2549
2606
  };
2607
+ name: string;
2550
2608
  type?: string | undefined;
2551
2609
  required?: boolean | undefined;
2552
2610
  description?: string | undefined;
@@ -2554,12 +2612,12 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2554
2612
  enumValues?: string[] | undefined;
2555
2613
  }[] | undefined;
2556
2614
  requestQueryParams?: {
2557
- name: string;
2558
2615
  attribution: {
2559
2616
  source: "merchant_challenge" | "external_metadata";
2560
2617
  authority: "authoritative" | "advisory";
2561
2618
  note?: string | undefined;
2562
2619
  };
2620
+ name: string;
2563
2621
  type?: string | undefined;
2564
2622
  required?: boolean | undefined;
2565
2623
  description?: string | undefined;
@@ -2567,12 +2625,12 @@ export declare const sdkPreparedPaidRequestReadySchema: z.ZodObject<{
2567
2625
  enumValues?: string[] | undefined;
2568
2626
  }[] | undefined;
2569
2627
  requestPathParams?: {
2570
- name: string;
2571
2628
  attribution: {
2572
2629
  source: "merchant_challenge" | "external_metadata";
2573
2630
  authority: "authoritative" | "advisory";
2574
2631
  note?: string | undefined;
2575
2632
  };
2633
+ name: string;
2576
2634
  type?: string | undefined;
2577
2635
  required?: boolean | undefined;
2578
2636
  description?: string | undefined;
@@ -2661,14 +2719,14 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
2661
2719
  body: z.ZodOptional<z.ZodString>;
2662
2720
  bodyHash: z.ZodOptional<z.ZodString>;
2663
2721
  }, "strip", z.ZodTypeAny, {
2664
- url: string;
2665
2722
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
2723
+ url: string;
2666
2724
  headers?: Record<string, string> | undefined;
2667
2725
  body?: string | undefined;
2668
2726
  bodyHash?: string | undefined;
2669
2727
  }, {
2670
- url: string;
2671
2728
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
2729
+ url: string;
2672
2730
  headers?: Record<string, string> | undefined;
2673
2731
  body?: string | undefined;
2674
2732
  bodyHash?: string | undefined;
@@ -2786,24 +2844,24 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
2786
2844
  note?: string | undefined;
2787
2845
  }>;
2788
2846
  }, "strip", z.ZodTypeAny, {
2789
- name: string;
2790
2847
  attribution: {
2791
2848
  source: "merchant_challenge" | "external_metadata";
2792
2849
  authority: "authoritative" | "advisory";
2793
2850
  note?: string | undefined;
2794
2851
  };
2852
+ name: string;
2795
2853
  type?: string | undefined;
2796
2854
  required?: boolean | undefined;
2797
2855
  description?: string | undefined;
2798
2856
  defaultValue?: unknown;
2799
2857
  enumValues?: string[] | undefined;
2800
2858
  }, {
2801
- name: string;
2802
2859
  attribution: {
2803
2860
  source: "merchant_challenge" | "external_metadata";
2804
2861
  authority: "authoritative" | "advisory";
2805
2862
  note?: string | undefined;
2806
2863
  };
2864
+ name: string;
2807
2865
  type?: string | undefined;
2808
2866
  required?: boolean | undefined;
2809
2867
  description?: string | undefined;
@@ -2832,24 +2890,24 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
2832
2890
  note?: string | undefined;
2833
2891
  }>;
2834
2892
  }, "strip", z.ZodTypeAny, {
2835
- name: string;
2836
2893
  attribution: {
2837
2894
  source: "merchant_challenge" | "external_metadata";
2838
2895
  authority: "authoritative" | "advisory";
2839
2896
  note?: string | undefined;
2840
2897
  };
2898
+ name: string;
2841
2899
  type?: string | undefined;
2842
2900
  required?: boolean | undefined;
2843
2901
  description?: string | undefined;
2844
2902
  defaultValue?: unknown;
2845
2903
  enumValues?: string[] | undefined;
2846
2904
  }, {
2847
- name: string;
2848
2905
  attribution: {
2849
2906
  source: "merchant_challenge" | "external_metadata";
2850
2907
  authority: "authoritative" | "advisory";
2851
2908
  note?: string | undefined;
2852
2909
  };
2910
+ name: string;
2853
2911
  type?: string | undefined;
2854
2912
  required?: boolean | undefined;
2855
2913
  description?: string | undefined;
@@ -2878,24 +2936,24 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
2878
2936
  note?: string | undefined;
2879
2937
  }>;
2880
2938
  }, "strip", z.ZodTypeAny, {
2881
- name: string;
2882
2939
  attribution: {
2883
2940
  source: "merchant_challenge" | "external_metadata";
2884
2941
  authority: "authoritative" | "advisory";
2885
2942
  note?: string | undefined;
2886
2943
  };
2944
+ name: string;
2887
2945
  type?: string | undefined;
2888
2946
  required?: boolean | undefined;
2889
2947
  description?: string | undefined;
2890
2948
  defaultValue?: unknown;
2891
2949
  enumValues?: string[] | undefined;
2892
2950
  }, {
2893
- name: string;
2894
2951
  attribution: {
2895
2952
  source: "merchant_challenge" | "external_metadata";
2896
2953
  authority: "authoritative" | "advisory";
2897
2954
  note?: string | undefined;
2898
2955
  };
2956
+ name: string;
2899
2957
  type?: string | undefined;
2900
2958
  required?: boolean | undefined;
2901
2959
  description?: string | undefined;
@@ -2934,12 +2992,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
2934
2992
  }>, "many">>;
2935
2993
  }, "strip", z.ZodTypeAny, {
2936
2994
  requestBodyFields: {
2937
- name: string;
2938
2995
  attribution: {
2939
2996
  source: "merchant_challenge" | "external_metadata";
2940
2997
  authority: "authoritative" | "advisory";
2941
2998
  note?: string | undefined;
2942
2999
  };
3000
+ name: string;
2943
3001
  type?: string | undefined;
2944
3002
  required?: boolean | undefined;
2945
3003
  description?: string | undefined;
@@ -2947,12 +3005,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
2947
3005
  enumValues?: string[] | undefined;
2948
3006
  }[];
2949
3007
  requestQueryParams: {
2950
- name: string;
2951
3008
  attribution: {
2952
3009
  source: "merchant_challenge" | "external_metadata";
2953
3010
  authority: "authoritative" | "advisory";
2954
3011
  note?: string | undefined;
2955
3012
  };
3013
+ name: string;
2956
3014
  type?: string | undefined;
2957
3015
  required?: boolean | undefined;
2958
3016
  description?: string | undefined;
@@ -2960,12 +3018,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
2960
3018
  enumValues?: string[] | undefined;
2961
3019
  }[];
2962
3020
  requestPathParams: {
2963
- name: string;
2964
3021
  attribution: {
2965
3022
  source: "merchant_challenge" | "external_metadata";
2966
3023
  authority: "authoritative" | "advisory";
2967
3024
  note?: string | undefined;
2968
3025
  };
3026
+ name: string;
2969
3027
  type?: string | undefined;
2970
3028
  required?: boolean | undefined;
2971
3029
  description?: string | undefined;
@@ -3030,12 +3088,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3030
3088
  };
3031
3089
  } | undefined;
3032
3090
  requestBodyFields?: {
3033
- name: string;
3034
3091
  attribution: {
3035
3092
  source: "merchant_challenge" | "external_metadata";
3036
3093
  authority: "authoritative" | "advisory";
3037
3094
  note?: string | undefined;
3038
3095
  };
3096
+ name: string;
3039
3097
  type?: string | undefined;
3040
3098
  required?: boolean | undefined;
3041
3099
  description?: string | undefined;
@@ -3043,12 +3101,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3043
3101
  enumValues?: string[] | undefined;
3044
3102
  }[] | undefined;
3045
3103
  requestQueryParams?: {
3046
- name: string;
3047
3104
  attribution: {
3048
3105
  source: "merchant_challenge" | "external_metadata";
3049
3106
  authority: "authoritative" | "advisory";
3050
3107
  note?: string | undefined;
3051
3108
  };
3109
+ name: string;
3052
3110
  type?: string | undefined;
3053
3111
  required?: boolean | undefined;
3054
3112
  description?: string | undefined;
@@ -3056,12 +3114,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3056
3114
  enumValues?: string[] | undefined;
3057
3115
  }[] | undefined;
3058
3116
  requestPathParams?: {
3059
- name: string;
3060
3117
  attribution: {
3061
3118
  source: "merchant_challenge" | "external_metadata";
3062
3119
  authority: "authoritative" | "advisory";
3063
3120
  note?: string | undefined;
3064
3121
  };
3122
+ name: string;
3065
3123
  type?: string | undefined;
3066
3124
  required?: boolean | undefined;
3067
3125
  description?: string | undefined;
@@ -3117,23 +3175,23 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3117
3175
  }>, "many">>;
3118
3176
  nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough"]>;
3119
3177
  }, "strip", z.ZodTypeAny, {
3120
- protocol: "none";
3121
3178
  kind: "passthrough";
3179
+ protocol: "none";
3122
3180
  request: {
3123
- url: string;
3124
3181
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
3182
+ url: string;
3125
3183
  headers?: Record<string, string> | undefined;
3126
3184
  body?: string | undefined;
3127
3185
  bodyHash?: string | undefined;
3128
3186
  };
3129
3187
  hints: {
3130
3188
  requestBodyFields: {
3131
- name: string;
3132
3189
  attribution: {
3133
3190
  source: "merchant_challenge" | "external_metadata";
3134
3191
  authority: "authoritative" | "advisory";
3135
3192
  note?: string | undefined;
3136
3193
  };
3194
+ name: string;
3137
3195
  type?: string | undefined;
3138
3196
  required?: boolean | undefined;
3139
3197
  description?: string | undefined;
@@ -3141,12 +3199,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3141
3199
  enumValues?: string[] | undefined;
3142
3200
  }[];
3143
3201
  requestQueryParams: {
3144
- name: string;
3145
3202
  attribution: {
3146
3203
  source: "merchant_challenge" | "external_metadata";
3147
3204
  authority: "authoritative" | "advisory";
3148
3205
  note?: string | undefined;
3149
3206
  };
3207
+ name: string;
3150
3208
  type?: string | undefined;
3151
3209
  required?: boolean | undefined;
3152
3210
  description?: string | undefined;
@@ -3154,12 +3212,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3154
3212
  enumValues?: string[] | undefined;
3155
3213
  }[];
3156
3214
  requestPathParams: {
3157
- name: string;
3158
3215
  attribution: {
3159
3216
  source: "merchant_challenge" | "external_metadata";
3160
3217
  authority: "authoritative" | "advisory";
3161
3218
  note?: string | undefined;
3162
3219
  };
3220
+ name: string;
3163
3221
  type?: string | undefined;
3164
3222
  required?: boolean | undefined;
3165
3223
  description?: string | undefined;
@@ -3215,11 +3273,11 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3215
3273
  confirmedAt: string;
3216
3274
  } | undefined;
3217
3275
  }, {
3218
- protocol: "none";
3219
3276
  kind: "passthrough";
3277
+ protocol: "none";
3220
3278
  request: {
3221
- url: string;
3222
3279
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
3280
+ url: string;
3223
3281
  headers?: Record<string, string> | undefined;
3224
3282
  body?: string | undefined;
3225
3283
  bodyHash?: string | undefined;
@@ -3250,12 +3308,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3250
3308
  };
3251
3309
  } | undefined;
3252
3310
  requestBodyFields?: {
3253
- name: string;
3254
3311
  attribution: {
3255
3312
  source: "merchant_challenge" | "external_metadata";
3256
3313
  authority: "authoritative" | "advisory";
3257
3314
  note?: string | undefined;
3258
3315
  };
3316
+ name: string;
3259
3317
  type?: string | undefined;
3260
3318
  required?: boolean | undefined;
3261
3319
  description?: string | undefined;
@@ -3263,12 +3321,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3263
3321
  enumValues?: string[] | undefined;
3264
3322
  }[] | undefined;
3265
3323
  requestQueryParams?: {
3266
- name: string;
3267
3324
  attribution: {
3268
3325
  source: "merchant_challenge" | "external_metadata";
3269
3326
  authority: "authoritative" | "advisory";
3270
3327
  note?: string | undefined;
3271
3328
  };
3329
+ name: string;
3272
3330
  type?: string | undefined;
3273
3331
  required?: boolean | undefined;
3274
3332
  description?: string | undefined;
@@ -3276,12 +3334,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3276
3334
  enumValues?: string[] | undefined;
3277
3335
  }[] | undefined;
3278
3336
  requestPathParams?: {
3279
- name: string;
3280
3337
  attribution: {
3281
3338
  source: "merchant_challenge" | "external_metadata";
3282
3339
  authority: "authoritative" | "advisory";
3283
3340
  note?: string | undefined;
3284
3341
  };
3342
+ name: string;
3285
3343
  type?: string | undefined;
3286
3344
  required?: boolean | undefined;
3287
3345
  description?: string | undefined;
@@ -3322,14 +3380,14 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3322
3380
  body: z.ZodOptional<z.ZodString>;
3323
3381
  bodyHash: z.ZodOptional<z.ZodString>;
3324
3382
  }, "strip", z.ZodTypeAny, {
3325
- url: string;
3326
3383
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
3384
+ url: string;
3327
3385
  headers?: Record<string, string> | undefined;
3328
3386
  body?: string | undefined;
3329
3387
  bodyHash?: string | undefined;
3330
3388
  }, {
3331
- url: string;
3332
3389
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
3390
+ url: string;
3333
3391
  headers?: Record<string, string> | undefined;
3334
3392
  body?: string | undefined;
3335
3393
  bodyHash?: string | undefined;
@@ -3618,24 +3676,24 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3618
3676
  note?: string | undefined;
3619
3677
  }>;
3620
3678
  }, "strip", z.ZodTypeAny, {
3621
- name: string;
3622
3679
  attribution: {
3623
3680
  source: "merchant_challenge" | "external_metadata";
3624
3681
  authority: "authoritative" | "advisory";
3625
3682
  note?: string | undefined;
3626
3683
  };
3684
+ name: string;
3627
3685
  type?: string | undefined;
3628
3686
  required?: boolean | undefined;
3629
3687
  description?: string | undefined;
3630
3688
  defaultValue?: unknown;
3631
3689
  enumValues?: string[] | undefined;
3632
3690
  }, {
3633
- name: string;
3634
3691
  attribution: {
3635
3692
  source: "merchant_challenge" | "external_metadata";
3636
3693
  authority: "authoritative" | "advisory";
3637
3694
  note?: string | undefined;
3638
3695
  };
3696
+ name: string;
3639
3697
  type?: string | undefined;
3640
3698
  required?: boolean | undefined;
3641
3699
  description?: string | undefined;
@@ -3664,24 +3722,24 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3664
3722
  note?: string | undefined;
3665
3723
  }>;
3666
3724
  }, "strip", z.ZodTypeAny, {
3667
- name: string;
3668
3725
  attribution: {
3669
3726
  source: "merchant_challenge" | "external_metadata";
3670
3727
  authority: "authoritative" | "advisory";
3671
3728
  note?: string | undefined;
3672
3729
  };
3730
+ name: string;
3673
3731
  type?: string | undefined;
3674
3732
  required?: boolean | undefined;
3675
3733
  description?: string | undefined;
3676
3734
  defaultValue?: unknown;
3677
3735
  enumValues?: string[] | undefined;
3678
3736
  }, {
3679
- name: string;
3680
3737
  attribution: {
3681
3738
  source: "merchant_challenge" | "external_metadata";
3682
3739
  authority: "authoritative" | "advisory";
3683
3740
  note?: string | undefined;
3684
3741
  };
3742
+ name: string;
3685
3743
  type?: string | undefined;
3686
3744
  required?: boolean | undefined;
3687
3745
  description?: string | undefined;
@@ -3710,24 +3768,24 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3710
3768
  note?: string | undefined;
3711
3769
  }>;
3712
3770
  }, "strip", z.ZodTypeAny, {
3713
- name: string;
3714
3771
  attribution: {
3715
3772
  source: "merchant_challenge" | "external_metadata";
3716
3773
  authority: "authoritative" | "advisory";
3717
3774
  note?: string | undefined;
3718
3775
  };
3776
+ name: string;
3719
3777
  type?: string | undefined;
3720
3778
  required?: boolean | undefined;
3721
3779
  description?: string | undefined;
3722
3780
  defaultValue?: unknown;
3723
3781
  enumValues?: string[] | undefined;
3724
3782
  }, {
3725
- name: string;
3726
3783
  attribution: {
3727
3784
  source: "merchant_challenge" | "external_metadata";
3728
3785
  authority: "authoritative" | "advisory";
3729
3786
  note?: string | undefined;
3730
3787
  };
3788
+ name: string;
3731
3789
  type?: string | undefined;
3732
3790
  required?: boolean | undefined;
3733
3791
  description?: string | undefined;
@@ -3766,12 +3824,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3766
3824
  }>, "many">>;
3767
3825
  }, "strip", z.ZodTypeAny, {
3768
3826
  requestBodyFields: {
3769
- name: string;
3770
3827
  attribution: {
3771
3828
  source: "merchant_challenge" | "external_metadata";
3772
3829
  authority: "authoritative" | "advisory";
3773
3830
  note?: string | undefined;
3774
3831
  };
3832
+ name: string;
3775
3833
  type?: string | undefined;
3776
3834
  required?: boolean | undefined;
3777
3835
  description?: string | undefined;
@@ -3779,12 +3837,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3779
3837
  enumValues?: string[] | undefined;
3780
3838
  }[];
3781
3839
  requestQueryParams: {
3782
- name: string;
3783
3840
  attribution: {
3784
3841
  source: "merchant_challenge" | "external_metadata";
3785
3842
  authority: "authoritative" | "advisory";
3786
3843
  note?: string | undefined;
3787
3844
  };
3845
+ name: string;
3788
3846
  type?: string | undefined;
3789
3847
  required?: boolean | undefined;
3790
3848
  description?: string | undefined;
@@ -3792,12 +3850,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3792
3850
  enumValues?: string[] | undefined;
3793
3851
  }[];
3794
3852
  requestPathParams: {
3795
- name: string;
3796
3853
  attribution: {
3797
3854
  source: "merchant_challenge" | "external_metadata";
3798
3855
  authority: "authoritative" | "advisory";
3799
3856
  note?: string | undefined;
3800
3857
  };
3858
+ name: string;
3801
3859
  type?: string | undefined;
3802
3860
  required?: boolean | undefined;
3803
3861
  description?: string | undefined;
@@ -3862,12 +3920,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3862
3920
  };
3863
3921
  } | undefined;
3864
3922
  requestBodyFields?: {
3865
- name: string;
3866
3923
  attribution: {
3867
3924
  source: "merchant_challenge" | "external_metadata";
3868
3925
  authority: "authoritative" | "advisory";
3869
3926
  note?: string | undefined;
3870
3927
  };
3928
+ name: string;
3871
3929
  type?: string | undefined;
3872
3930
  required?: boolean | undefined;
3873
3931
  description?: string | undefined;
@@ -3875,12 +3933,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3875
3933
  enumValues?: string[] | undefined;
3876
3934
  }[] | undefined;
3877
3935
  requestQueryParams?: {
3878
- name: string;
3879
3936
  attribution: {
3880
3937
  source: "merchant_challenge" | "external_metadata";
3881
3938
  authority: "authoritative" | "advisory";
3882
3939
  note?: string | undefined;
3883
3940
  };
3941
+ name: string;
3884
3942
  type?: string | undefined;
3885
3943
  required?: boolean | undefined;
3886
3944
  description?: string | undefined;
@@ -3888,12 +3946,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3888
3946
  enumValues?: string[] | undefined;
3889
3947
  }[] | undefined;
3890
3948
  requestPathParams?: {
3891
- name: string;
3892
3949
  attribution: {
3893
3950
  source: "merchant_challenge" | "external_metadata";
3894
3951
  authority: "authoritative" | "advisory";
3895
3952
  note?: string | undefined;
3896
3953
  };
3954
+ name: string;
3897
3955
  type?: string | undefined;
3898
3956
  required?: boolean | undefined;
3899
3957
  description?: string | undefined;
@@ -3949,23 +4007,23 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3949
4007
  }>, "many">>;
3950
4008
  nextAction: z.ZodEnum<["execute", "revise_request", "treat_as_passthrough"]>;
3951
4009
  }, "strip", z.ZodTypeAny, {
3952
- protocol: "x402" | "l402";
3953
4010
  kind: "ready";
4011
+ protocol: "x402" | "l402";
3954
4012
  request: {
3955
- url: string;
3956
4013
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4014
+ url: string;
3957
4015
  headers?: Record<string, string> | undefined;
3958
4016
  body?: string | undefined;
3959
4017
  bodyHash?: string | undefined;
3960
4018
  };
3961
4019
  hints: {
3962
4020
  requestBodyFields: {
3963
- name: string;
3964
4021
  attribution: {
3965
4022
  source: "merchant_challenge" | "external_metadata";
3966
4023
  authority: "authoritative" | "advisory";
3967
4024
  note?: string | undefined;
3968
4025
  };
4026
+ name: string;
3969
4027
  type?: string | undefined;
3970
4028
  required?: boolean | undefined;
3971
4029
  description?: string | undefined;
@@ -3973,12 +4031,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3973
4031
  enumValues?: string[] | undefined;
3974
4032
  }[];
3975
4033
  requestQueryParams: {
3976
- name: string;
3977
4034
  attribution: {
3978
4035
  source: "merchant_challenge" | "external_metadata";
3979
4036
  authority: "authoritative" | "advisory";
3980
4037
  note?: string | undefined;
3981
4038
  };
4039
+ name: string;
3982
4040
  type?: string | undefined;
3983
4041
  required?: boolean | undefined;
3984
4042
  description?: string | undefined;
@@ -3986,12 +4044,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
3986
4044
  enumValues?: string[] | undefined;
3987
4045
  }[];
3988
4046
  requestPathParams: {
3989
- name: string;
3990
4047
  attribution: {
3991
4048
  source: "merchant_challenge" | "external_metadata";
3992
4049
  authority: "authoritative" | "advisory";
3993
4050
  note?: string | undefined;
3994
4051
  };
4052
+ name: string;
3995
4053
  type?: string | undefined;
3996
4054
  required?: boolean | undefined;
3997
4055
  description?: string | undefined;
@@ -4092,11 +4150,11 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
4092
4150
  amountType?: "exact" | "max" | undefined;
4093
4151
  } | undefined;
4094
4152
  }, {
4095
- protocol: "x402" | "l402";
4096
4153
  kind: "ready";
4154
+ protocol: "x402" | "l402";
4097
4155
  request: {
4098
- url: string;
4099
4156
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4157
+ url: string;
4100
4158
  headers?: Record<string, string> | undefined;
4101
4159
  body?: string | undefined;
4102
4160
  bodyHash?: string | undefined;
@@ -4127,12 +4185,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
4127
4185
  };
4128
4186
  } | undefined;
4129
4187
  requestBodyFields?: {
4130
- name: string;
4131
4188
  attribution: {
4132
4189
  source: "merchant_challenge" | "external_metadata";
4133
4190
  authority: "authoritative" | "advisory";
4134
4191
  note?: string | undefined;
4135
4192
  };
4193
+ name: string;
4136
4194
  type?: string | undefined;
4137
4195
  required?: boolean | undefined;
4138
4196
  description?: string | undefined;
@@ -4140,12 +4198,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
4140
4198
  enumValues?: string[] | undefined;
4141
4199
  }[] | undefined;
4142
4200
  requestQueryParams?: {
4143
- name: string;
4144
4201
  attribution: {
4145
4202
  source: "merchant_challenge" | "external_metadata";
4146
4203
  authority: "authoritative" | "advisory";
4147
4204
  note?: string | undefined;
4148
4205
  };
4206
+ name: string;
4149
4207
  type?: string | undefined;
4150
4208
  required?: boolean | undefined;
4151
4209
  description?: string | undefined;
@@ -4153,12 +4211,12 @@ export declare const sdkPreparedPaidRequestSchema: z.ZodDiscriminatedUnion<"kind
4153
4211
  enumValues?: string[] | undefined;
4154
4212
  }[] | undefined;
4155
4213
  requestPathParams?: {
4156
- name: string;
4157
4214
  attribution: {
4158
4215
  source: "merchant_challenge" | "external_metadata";
4159
4216
  authority: "authoritative" | "advisory";
4160
4217
  note?: string | undefined;
4161
4218
  };
4219
+ name: string;
4162
4220
  type?: string | undefined;
4163
4221
  required?: boolean | undefined;
4164
4222
  description?: string | undefined;
@@ -4243,16 +4301,72 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
4243
4301
  agent: z.ZodString;
4244
4302
  description: z.ZodOptional<z.ZodString>;
4245
4303
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4304
+ executionProvider: z.ZodOptional<z.ZodString>;
4305
+ attribution: z.ZodOptional<z.ZodObject<{
4306
+ discoverySource: z.ZodOptional<z.ZodEnum<["coinbase_bazaar", "dexter", "pay_sh", "x402scan", "manual", "direct", "observed", "imported", "unknown"]>>;
4307
+ resourceIdentity: z.ZodOptional<z.ZodObject<{
4308
+ kind: z.ZodLiteral<"http_endpoint">;
4309
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
4310
+ canonicalUrl: z.ZodString;
4311
+ canonicalKey: z.ZodString;
4312
+ }, "strip", z.ZodTypeAny, {
4313
+ kind: "http_endpoint";
4314
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4315
+ canonicalUrl: string;
4316
+ canonicalKey: string;
4317
+ }, {
4318
+ kind: "http_endpoint";
4319
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4320
+ canonicalUrl: string;
4321
+ canonicalKey: string;
4322
+ }>>;
4323
+ }, "strip", z.ZodTypeAny, {
4324
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4325
+ resourceIdentity?: {
4326
+ kind: "http_endpoint";
4327
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4328
+ canonicalUrl: string;
4329
+ canonicalKey: string;
4330
+ } | undefined;
4331
+ }, {
4332
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4333
+ resourceIdentity?: {
4334
+ kind: "http_endpoint";
4335
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4336
+ canonicalUrl: string;
4337
+ canonicalKey: string;
4338
+ } | undefined;
4339
+ }>>;
4246
4340
  }, "strip", z.ZodTypeAny, {
4247
4341
  organization: string;
4248
4342
  agent: string;
4249
4343
  description?: string | undefined;
4250
4344
  metadata?: Record<string, unknown> | undefined;
4345
+ executionProvider?: string | undefined;
4346
+ attribution?: {
4347
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4348
+ resourceIdentity?: {
4349
+ kind: "http_endpoint";
4350
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4351
+ canonicalUrl: string;
4352
+ canonicalKey: string;
4353
+ } | undefined;
4354
+ } | undefined;
4251
4355
  }, {
4252
4356
  organization: string;
4253
4357
  agent: string;
4254
4358
  description?: string | undefined;
4255
4359
  metadata?: Record<string, unknown> | undefined;
4360
+ executionProvider?: string | undefined;
4361
+ attribution?: {
4362
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4363
+ resourceIdentity?: {
4364
+ kind: "http_endpoint";
4365
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4366
+ canonicalUrl: string;
4367
+ canonicalKey: string;
4368
+ } | undefined;
4369
+ } | undefined;
4256
4370
  }>;
4257
4371
  request: z.ZodObject<{
4258
4372
  url: z.ZodString;
@@ -4261,14 +4375,14 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
4261
4375
  body: z.ZodOptional<z.ZodString>;
4262
4376
  bodyHash: z.ZodOptional<z.ZodString>;
4263
4377
  }, "strip", z.ZodTypeAny, {
4264
- url: string;
4265
4378
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4379
+ url: string;
4266
4380
  headers?: Record<string, string> | undefined;
4267
4381
  body?: string | undefined;
4268
4382
  bodyHash?: string | undefined;
4269
4383
  }, {
4270
- url: string;
4271
4384
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4385
+ url: string;
4272
4386
  headers?: Record<string, string> | undefined;
4273
4387
  body?: string | undefined;
4274
4388
  bodyHash?: string | undefined;
@@ -4289,8 +4403,8 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
4289
4403
  idempotencyKey: z.ZodOptional<z.ZodString>;
4290
4404
  }, "strip", z.ZodTypeAny, {
4291
4405
  request: {
4292
- url: string;
4293
4406
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4407
+ url: string;
4294
4408
  headers?: Record<string, string> | undefined;
4295
4409
  body?: string | undefined;
4296
4410
  bodyHash?: string | undefined;
@@ -4305,12 +4419,22 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
4305
4419
  agent: string;
4306
4420
  description?: string | undefined;
4307
4421
  metadata?: Record<string, unknown> | undefined;
4422
+ executionProvider?: string | undefined;
4423
+ attribution?: {
4424
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4425
+ resourceIdentity?: {
4426
+ kind: "http_endpoint";
4427
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4428
+ canonicalUrl: string;
4429
+ canonicalKey: string;
4430
+ } | undefined;
4431
+ } | undefined;
4308
4432
  };
4309
4433
  idempotencyKey?: string | undefined;
4310
4434
  }, {
4311
4435
  request: {
4312
- url: string;
4313
4436
  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4437
+ url: string;
4314
4438
  headers?: Record<string, string> | undefined;
4315
4439
  body?: string | undefined;
4316
4440
  bodyHash?: string | undefined;
@@ -4325,13 +4449,191 @@ export declare const sdkPaymentDecisionRequestSchema: z.ZodObject<{
4325
4449
  agent: string;
4326
4450
  description?: string | undefined;
4327
4451
  metadata?: Record<string, unknown> | undefined;
4452
+ executionProvider?: string | undefined;
4453
+ attribution?: {
4454
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4455
+ resourceIdentity?: {
4456
+ kind: "http_endpoint";
4457
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4458
+ canonicalUrl: string;
4459
+ canonicalKey: string;
4460
+ } | undefined;
4461
+ } | undefined;
4328
4462
  };
4329
4463
  idempotencyKey?: string | undefined;
4330
4464
  }>;
4331
4465
  export type SdkPaymentDecisionRequest = z.infer<typeof sdkPaymentDecisionRequestSchema>;
4332
- /** Durable receipt shape returned after the control plane records an outcome. */
4333
- export declare const sdkReceiptSchema: z.ZodObject<{
4334
- receiptId: z.ZodString;
4466
+ export declare const sdkPaymentAuthorizationRequestSchema: z.ZodObject<{
4467
+ context: z.ZodObject<{
4468
+ organization: z.ZodString;
4469
+ agent: z.ZodString;
4470
+ description: z.ZodOptional<z.ZodString>;
4471
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4472
+ executionProvider: z.ZodOptional<z.ZodString>;
4473
+ attribution: z.ZodOptional<z.ZodObject<{
4474
+ discoverySource: z.ZodOptional<z.ZodEnum<["coinbase_bazaar", "dexter", "pay_sh", "x402scan", "manual", "direct", "observed", "imported", "unknown"]>>;
4475
+ resourceIdentity: z.ZodOptional<z.ZodObject<{
4476
+ kind: z.ZodLiteral<"http_endpoint">;
4477
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
4478
+ canonicalUrl: z.ZodString;
4479
+ canonicalKey: z.ZodString;
4480
+ }, "strip", z.ZodTypeAny, {
4481
+ kind: "http_endpoint";
4482
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4483
+ canonicalUrl: string;
4484
+ canonicalKey: string;
4485
+ }, {
4486
+ kind: "http_endpoint";
4487
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4488
+ canonicalUrl: string;
4489
+ canonicalKey: string;
4490
+ }>>;
4491
+ }, "strip", z.ZodTypeAny, {
4492
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4493
+ resourceIdentity?: {
4494
+ kind: "http_endpoint";
4495
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4496
+ canonicalUrl: string;
4497
+ canonicalKey: string;
4498
+ } | undefined;
4499
+ }, {
4500
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4501
+ resourceIdentity?: {
4502
+ kind: "http_endpoint";
4503
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4504
+ canonicalUrl: string;
4505
+ canonicalKey: string;
4506
+ } | undefined;
4507
+ }>>;
4508
+ }, "strip", z.ZodTypeAny, {
4509
+ organization: string;
4510
+ agent: string;
4511
+ description?: string | undefined;
4512
+ metadata?: Record<string, unknown> | undefined;
4513
+ executionProvider?: string | undefined;
4514
+ attribution?: {
4515
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4516
+ resourceIdentity?: {
4517
+ kind: "http_endpoint";
4518
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4519
+ canonicalUrl: string;
4520
+ canonicalKey: string;
4521
+ } | undefined;
4522
+ } | undefined;
4523
+ }, {
4524
+ organization: string;
4525
+ agent: string;
4526
+ description?: string | undefined;
4527
+ metadata?: Record<string, unknown> | undefined;
4528
+ executionProvider?: string | undefined;
4529
+ attribution?: {
4530
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4531
+ resourceIdentity?: {
4532
+ kind: "http_endpoint";
4533
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4534
+ canonicalUrl: string;
4535
+ canonicalKey: string;
4536
+ } | undefined;
4537
+ } | undefined;
4538
+ }>;
4539
+ request: z.ZodObject<{
4540
+ url: z.ZodString;
4541
+ method: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
4542
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
4543
+ body: z.ZodOptional<z.ZodString>;
4544
+ bodyHash: z.ZodOptional<z.ZodString>;
4545
+ }, "strip", z.ZodTypeAny, {
4546
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4547
+ url: string;
4548
+ headers?: Record<string, string> | undefined;
4549
+ body?: string | undefined;
4550
+ bodyHash?: string | undefined;
4551
+ }, {
4552
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4553
+ url: string;
4554
+ headers?: Record<string, string> | undefined;
4555
+ body?: string | undefined;
4556
+ bodyHash?: string | undefined;
4557
+ }>;
4558
+ challenge: z.ZodObject<{
4559
+ protocol: z.ZodEnum<["x402", "l402"]>;
4560
+ headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
4561
+ body: z.ZodOptional<z.ZodUnknown>;
4562
+ }, "strip", z.ZodTypeAny, {
4563
+ headers: Record<string, string>;
4564
+ protocol: "x402" | "l402";
4565
+ body?: unknown;
4566
+ }, {
4567
+ protocol: "x402" | "l402";
4568
+ headers?: Record<string, string> | undefined;
4569
+ body?: unknown;
4570
+ }>;
4571
+ idempotencyKey: z.ZodOptional<z.ZodString>;
4572
+ }, "strip", z.ZodTypeAny, {
4573
+ request: {
4574
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4575
+ url: string;
4576
+ headers?: Record<string, string> | undefined;
4577
+ body?: string | undefined;
4578
+ bodyHash?: string | undefined;
4579
+ };
4580
+ challenge: {
4581
+ headers: Record<string, string>;
4582
+ protocol: "x402" | "l402";
4583
+ body?: unknown;
4584
+ };
4585
+ context: {
4586
+ organization: string;
4587
+ agent: string;
4588
+ description?: string | undefined;
4589
+ metadata?: Record<string, unknown> | undefined;
4590
+ executionProvider?: string | undefined;
4591
+ attribution?: {
4592
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4593
+ resourceIdentity?: {
4594
+ kind: "http_endpoint";
4595
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4596
+ canonicalUrl: string;
4597
+ canonicalKey: string;
4598
+ } | undefined;
4599
+ } | undefined;
4600
+ };
4601
+ idempotencyKey?: string | undefined;
4602
+ }, {
4603
+ request: {
4604
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4605
+ url: string;
4606
+ headers?: Record<string, string> | undefined;
4607
+ body?: string | undefined;
4608
+ bodyHash?: string | undefined;
4609
+ };
4610
+ challenge: {
4611
+ protocol: "x402" | "l402";
4612
+ headers?: Record<string, string> | undefined;
4613
+ body?: unknown;
4614
+ };
4615
+ context: {
4616
+ organization: string;
4617
+ agent: string;
4618
+ description?: string | undefined;
4619
+ metadata?: Record<string, unknown> | undefined;
4620
+ executionProvider?: string | undefined;
4621
+ attribution?: {
4622
+ discoverySource?: "coinbase_bazaar" | "dexter" | "pay_sh" | "x402scan" | "manual" | "direct" | "observed" | "imported" | "unknown" | undefined;
4623
+ resourceIdentity?: {
4624
+ kind: "http_endpoint";
4625
+ method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
4626
+ canonicalUrl: string;
4627
+ canonicalKey: string;
4628
+ } | undefined;
4629
+ } | undefined;
4630
+ };
4631
+ idempotencyKey?: string | undefined;
4632
+ }>;
4633
+ export type SdkPaymentAuthorizationRequest = SdkPaymentDecisionRequest;
4634
+ /** Durable receipt shape returned after the control plane records an outcome. */
4635
+ export declare const sdkReceiptSchema: z.ZodObject<{
4636
+ receiptId: z.ZodString;
4335
4637
  paidRequestId: z.ZodString;
4336
4638
  paymentAttemptId: z.ZodString;
4337
4639
  organizationId: z.ZodString;
@@ -4476,6 +4778,228 @@ export declare const sdkMerchantResponseSchema: z.ZodObject<{
4476
4778
  body?: string | undefined;
4477
4779
  }>;
4478
4780
  export type SdkMerchantResponse = z.infer<typeof sdkMerchantResponseSchema>;
4781
+ export declare const sdkDelegatedExecutionStatusSchema: z.ZodEnum<["succeeded", "failed", "inconclusive", "preflight_failed"]>;
4782
+ export type SdkDelegatedExecutionStatus = z.infer<typeof sdkDelegatedExecutionStatusSchema>;
4783
+ export declare const sdkDelegatedMerchantOutcomeSchema: z.ZodEnum<["success_response", "failure_response", "no_response", "unknown"]>;
4784
+ export type SdkDelegatedMerchantOutcome = z.infer<typeof sdkDelegatedMerchantOutcomeSchema>;
4785
+ export declare const sdkDelegatedExecutionDiagnosticCodeSchema: z.ZodEnum<["preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "merchant_transport_lost", "settlement_proof_conflict"]>;
4786
+ export type SdkDelegatedExecutionDiagnosticCode = z.infer<typeof sdkDelegatedExecutionDiagnosticCodeSchema>;
4787
+ export declare const sdkDelegatedExecutionResultSchema: z.ZodObject<{
4788
+ protocol: z.ZodEnum<["x402", "l402"]>;
4789
+ executionStatus: z.ZodEnum<["succeeded", "failed", "inconclusive", "preflight_failed"]>;
4790
+ settlementEvidenceClass: z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>;
4791
+ merchantOutcome: z.ZodEnum<["success_response", "failure_response", "no_response", "unknown"]>;
4792
+ settlementReference: z.ZodOptional<z.ZodString>;
4793
+ paymentReference: z.ZodOptional<z.ZodString>;
4794
+ evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
4795
+ signerSubmissionEvidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4796
+ merchantResponse: z.ZodOptional<z.ZodObject<{
4797
+ status: z.ZodNumber;
4798
+ headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
4799
+ body: z.ZodDefault<z.ZodString>;
4800
+ }, "strip", z.ZodTypeAny, {
4801
+ status: number;
4802
+ headers: Record<string, string>;
4803
+ body: string;
4804
+ }, {
4805
+ status: number;
4806
+ headers?: Record<string, string> | undefined;
4807
+ body?: string | undefined;
4808
+ }>>;
4809
+ diagnostic: z.ZodOptional<z.ZodObject<{
4810
+ code: z.ZodEnum<["preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "merchant_transport_lost", "settlement_proof_conflict"]>;
4811
+ message: z.ZodOptional<z.ZodString>;
4812
+ }, "strip", z.ZodTypeAny, {
4813
+ code: "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4814
+ message?: string | undefined;
4815
+ }, {
4816
+ code: "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4817
+ message?: string | undefined;
4818
+ }>>;
4819
+ protocolArtifacts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4820
+ }, "strip", z.ZodTypeAny, {
4821
+ protocol: "x402" | "l402";
4822
+ settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
4823
+ executionStatus: "inconclusive" | "succeeded" | "failed" | "preflight_failed";
4824
+ merchantOutcome: "unknown" | "success_response" | "failure_response" | "no_response";
4825
+ paymentReference?: string | undefined;
4826
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
4827
+ settlementReference?: string | undefined;
4828
+ signerSubmissionEvidence?: Record<string, unknown> | undefined;
4829
+ merchantResponse?: {
4830
+ status: number;
4831
+ headers: Record<string, string>;
4832
+ body: string;
4833
+ } | undefined;
4834
+ diagnostic?: {
4835
+ code: "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4836
+ message?: string | undefined;
4837
+ } | undefined;
4838
+ protocolArtifacts?: Record<string, unknown> | undefined;
4839
+ }, {
4840
+ protocol: "x402" | "l402";
4841
+ settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
4842
+ executionStatus: "inconclusive" | "succeeded" | "failed" | "preflight_failed";
4843
+ merchantOutcome: "unknown" | "success_response" | "failure_response" | "no_response";
4844
+ paymentReference?: string | undefined;
4845
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
4846
+ settlementReference?: string | undefined;
4847
+ signerSubmissionEvidence?: Record<string, unknown> | undefined;
4848
+ merchantResponse?: {
4849
+ status: number;
4850
+ headers?: Record<string, string> | undefined;
4851
+ body?: string | undefined;
4852
+ } | undefined;
4853
+ diagnostic?: {
4854
+ code: "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4855
+ message?: string | undefined;
4856
+ } | undefined;
4857
+ protocolArtifacts?: Record<string, unknown> | undefined;
4858
+ }>;
4859
+ export type SdkDelegatedExecutionResult = z.infer<typeof sdkDelegatedExecutionResultSchema>;
4860
+ export declare const sdkPaymentFinalizationRequestSchema: z.ZodObject<{
4861
+ paidRequestId: z.ZodString;
4862
+ paymentAttemptId: z.ZodString;
4863
+ result: z.ZodObject<{
4864
+ protocol: z.ZodEnum<["x402", "l402"]>;
4865
+ executionStatus: z.ZodEnum<["succeeded", "failed", "inconclusive", "preflight_failed"]>;
4866
+ settlementEvidenceClass: z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>;
4867
+ merchantOutcome: z.ZodEnum<["success_response", "failure_response", "no_response", "unknown"]>;
4868
+ settlementReference: z.ZodOptional<z.ZodString>;
4869
+ paymentReference: z.ZodOptional<z.ZodString>;
4870
+ evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
4871
+ signerSubmissionEvidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4872
+ merchantResponse: z.ZodOptional<z.ZodObject<{
4873
+ status: z.ZodNumber;
4874
+ headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
4875
+ body: z.ZodDefault<z.ZodString>;
4876
+ }, "strip", z.ZodTypeAny, {
4877
+ status: number;
4878
+ headers: Record<string, string>;
4879
+ body: string;
4880
+ }, {
4881
+ status: number;
4882
+ headers?: Record<string, string> | undefined;
4883
+ body?: string | undefined;
4884
+ }>>;
4885
+ diagnostic: z.ZodOptional<z.ZodObject<{
4886
+ code: z.ZodEnum<["preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "merchant_transport_lost", "settlement_proof_conflict"]>;
4887
+ message: z.ZodOptional<z.ZodString>;
4888
+ }, "strip", z.ZodTypeAny, {
4889
+ code: "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4890
+ message?: string | undefined;
4891
+ }, {
4892
+ code: "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4893
+ message?: string | undefined;
4894
+ }>>;
4895
+ protocolArtifacts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4896
+ }, "strip", z.ZodTypeAny, {
4897
+ protocol: "x402" | "l402";
4898
+ settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
4899
+ executionStatus: "inconclusive" | "succeeded" | "failed" | "preflight_failed";
4900
+ merchantOutcome: "unknown" | "success_response" | "failure_response" | "no_response";
4901
+ paymentReference?: string | undefined;
4902
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
4903
+ settlementReference?: string | undefined;
4904
+ signerSubmissionEvidence?: Record<string, unknown> | undefined;
4905
+ merchantResponse?: {
4906
+ status: number;
4907
+ headers: Record<string, string>;
4908
+ body: string;
4909
+ } | undefined;
4910
+ diagnostic?: {
4911
+ code: "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4912
+ message?: string | undefined;
4913
+ } | undefined;
4914
+ protocolArtifacts?: Record<string, unknown> | undefined;
4915
+ }, {
4916
+ protocol: "x402" | "l402";
4917
+ settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
4918
+ executionStatus: "inconclusive" | "succeeded" | "failed" | "preflight_failed";
4919
+ merchantOutcome: "unknown" | "success_response" | "failure_response" | "no_response";
4920
+ paymentReference?: string | undefined;
4921
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
4922
+ settlementReference?: string | undefined;
4923
+ signerSubmissionEvidence?: Record<string, unknown> | undefined;
4924
+ merchantResponse?: {
4925
+ status: number;
4926
+ headers?: Record<string, string> | undefined;
4927
+ body?: string | undefined;
4928
+ } | undefined;
4929
+ diagnostic?: {
4930
+ code: "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4931
+ message?: string | undefined;
4932
+ } | undefined;
4933
+ protocolArtifacts?: Record<string, unknown> | undefined;
4934
+ }>;
4935
+ }, "strip", z.ZodTypeAny, {
4936
+ paidRequestId: string;
4937
+ paymentAttemptId: string;
4938
+ result: {
4939
+ protocol: "x402" | "l402";
4940
+ settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
4941
+ executionStatus: "inconclusive" | "succeeded" | "failed" | "preflight_failed";
4942
+ merchantOutcome: "unknown" | "success_response" | "failure_response" | "no_response";
4943
+ paymentReference?: string | undefined;
4944
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
4945
+ settlementReference?: string | undefined;
4946
+ signerSubmissionEvidence?: Record<string, unknown> | undefined;
4947
+ merchantResponse?: {
4948
+ status: number;
4949
+ headers: Record<string, string>;
4950
+ body: string;
4951
+ } | undefined;
4952
+ diagnostic?: {
4953
+ code: "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4954
+ message?: string | undefined;
4955
+ } | undefined;
4956
+ protocolArtifacts?: Record<string, unknown> | undefined;
4957
+ };
4958
+ }, {
4959
+ paidRequestId: string;
4960
+ paymentAttemptId: string;
4961
+ result: {
4962
+ protocol: "x402" | "l402";
4963
+ settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
4964
+ executionStatus: "inconclusive" | "succeeded" | "failed" | "preflight_failed";
4965
+ merchantOutcome: "unknown" | "success_response" | "failure_response" | "no_response";
4966
+ paymentReference?: string | undefined;
4967
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
4968
+ settlementReference?: string | undefined;
4969
+ signerSubmissionEvidence?: Record<string, unknown> | undefined;
4970
+ merchantResponse?: {
4971
+ status: number;
4972
+ headers?: Record<string, string> | undefined;
4973
+ body?: string | undefined;
4974
+ } | undefined;
4975
+ diagnostic?: {
4976
+ code: "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4977
+ message?: string | undefined;
4978
+ } | undefined;
4979
+ protocolArtifacts?: Record<string, unknown> | undefined;
4980
+ };
4981
+ }>;
4982
+ export type SdkPaymentFinalizationRequest = z.infer<typeof sdkPaymentFinalizationRequestSchema>;
4983
+ export declare const sdkPaymentAuthorizationAuthorizedResponseSchema: z.ZodObject<{
4984
+ outcome: z.ZodLiteral<"authorized">;
4985
+ paidRequestId: z.ZodString;
4986
+ paymentAttemptId: z.ZodString;
4987
+ reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "challenge_candidate_malformed", "challenge_no_supported_candidates", "challenge_mixed_environment_candidates", "challenge_execution_identity_unavailable", "challenge_execution_identity_ambiguous", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "settlement_proof_conflict", "merchant_transport_lost"]>;
4988
+ reason: z.ZodString;
4989
+ }, "strip", z.ZodTypeAny, {
4990
+ paidRequestId: string;
4991
+ paymentAttemptId: string;
4992
+ outcome: "authorized";
4993
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4994
+ reason: string;
4995
+ }, {
4996
+ paidRequestId: string;
4997
+ paymentAttemptId: string;
4998
+ outcome: "authorized";
4999
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
5000
+ reason: string;
5001
+ }>;
5002
+ export type SdkPaymentAuthorizationAuthorizedResponse = z.infer<typeof sdkPaymentAuthorizationAuthorizedResponseSchema>;
4479
5003
  export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
4480
5004
  outcome: z.ZodLiteral<"allow">;
4481
5005
  paidRequestId: z.ZodString;
@@ -4628,14 +5152,14 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
4628
5152
  }, "strip", z.ZodTypeAny, {
4629
5153
  paidRequestId: string;
4630
5154
  paymentAttemptId: string;
4631
- outcome: "allow";
4632
- reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4633
- reason: string;
4634
5155
  merchantResponse: {
4635
5156
  status: number;
4636
5157
  headers: Record<string, string>;
4637
5158
  body: string;
4638
5159
  };
5160
+ outcome: "allow";
5161
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
5162
+ reason: string;
4639
5163
  receipt: {
4640
5164
  status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
4641
5165
  protocol: "x402" | "l402";
@@ -4675,14 +5199,14 @@ export declare const sdkPaymentDecisionAllowResponseSchema: z.ZodObject<{
4675
5199
  }, {
4676
5200
  paidRequestId: string;
4677
5201
  paymentAttemptId: string;
4678
- outcome: "allow";
4679
- reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
4680
- reason: string;
4681
5202
  merchantResponse: {
4682
5203
  status: number;
4683
5204
  headers?: Record<string, string> | undefined;
4684
5205
  body?: string | undefined;
4685
5206
  };
5207
+ outcome: "allow";
5208
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
5209
+ reason: string;
4686
5210
  receipt: {
4687
5211
  status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
4688
5212
  protocol: "x402" | "l402";
@@ -4877,14 +5401,14 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
4877
5401
  paymentAttemptId: string;
4878
5402
  settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
4879
5403
  fulfillmentStatus: "failed";
4880
- outcome: "paid_fulfillment_failed";
4881
- reasonCode: "merchant_rejected" | "merchant_execution_failed";
4882
- reason: string;
4883
5404
  merchantResponse: {
4884
5405
  status: number;
4885
5406
  headers: Record<string, string>;
4886
5407
  body: string;
4887
5408
  };
5409
+ outcome: "paid_fulfillment_failed";
5410
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
5411
+ reason: string;
4888
5412
  receipt: {
4889
5413
  status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
4890
5414
  protocol: "x402" | "l402";
@@ -4927,14 +5451,14 @@ export declare const sdkPaymentDecisionPaidFulfillmentFailedResponseSchema: z.Zo
4927
5451
  paymentAttemptId: string;
4928
5452
  settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
4929
5453
  fulfillmentStatus: "failed";
4930
- outcome: "paid_fulfillment_failed";
4931
- reasonCode: "merchant_rejected" | "merchant_execution_failed";
4932
- reason: string;
4933
5454
  merchantResponse: {
4934
5455
  status: number;
4935
5456
  headers?: Record<string, string> | undefined;
4936
5457
  body?: string | undefined;
4937
5458
  };
5459
+ outcome: "paid_fulfillment_failed";
5460
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
5461
+ reason: string;
4938
5462
  receipt: {
4939
5463
  status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
4940
5464
  protocol: "x402" | "l402";
@@ -4996,26 +5520,26 @@ export declare const sdkPaymentDecisionExecutionFailedResponseSchema: z.ZodObjec
4996
5520
  }, "strip", z.ZodTypeAny, {
4997
5521
  paidRequestId: string;
4998
5522
  paymentAttemptId: string;
4999
- outcome: "execution_failed";
5000
- reasonCode: "merchant_rejected" | "merchant_execution_failed";
5001
- reason: string;
5002
5523
  merchantResponse: {
5003
5524
  status: number;
5004
5525
  headers: Record<string, string>;
5005
5526
  body: string;
5006
5527
  };
5528
+ outcome: "execution_failed";
5529
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
5530
+ reason: string;
5007
5531
  evidence?: Record<string, unknown> | undefined;
5008
5532
  }, {
5009
5533
  paidRequestId: string;
5010
5534
  paymentAttemptId: string;
5011
- outcome: "execution_failed";
5012
- reasonCode: "merchant_rejected" | "merchant_execution_failed";
5013
- reason: string;
5014
5535
  merchantResponse: {
5015
5536
  status: number;
5016
5537
  headers?: Record<string, string> | undefined;
5017
5538
  body?: string | undefined;
5018
5539
  };
5540
+ outcome: "execution_failed";
5541
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
5542
+ reason: string;
5019
5543
  evidence?: Record<string, unknown> | undefined;
5020
5544
  }>;
5021
5545
  export declare const sdkPaymentDecisionPreflightFailedResponseSchema: z.ZodObject<{
@@ -5253,14 +5777,14 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
5253
5777
  }, "strip", z.ZodTypeAny, {
5254
5778
  paidRequestId: string;
5255
5779
  paymentAttemptId: string;
5256
- outcome: "allow";
5257
- reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
5258
- reason: string;
5259
5780
  merchantResponse: {
5260
5781
  status: number;
5261
5782
  headers: Record<string, string>;
5262
5783
  body: string;
5263
5784
  };
5785
+ outcome: "allow";
5786
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
5787
+ reason: string;
5264
5788
  receipt: {
5265
5789
  status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
5266
5790
  protocol: "x402" | "l402";
@@ -5300,14 +5824,14 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
5300
5824
  }, {
5301
5825
  paidRequestId: string;
5302
5826
  paymentAttemptId: string;
5303
- outcome: "allow";
5304
- reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
5305
- reason: string;
5306
5827
  merchantResponse: {
5307
5828
  status: number;
5308
5829
  headers?: Record<string, string> | undefined;
5309
5830
  body?: string | undefined;
5310
5831
  };
5832
+ outcome: "allow";
5833
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
5834
+ reason: string;
5311
5835
  receipt: {
5312
5836
  status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
5313
5837
  protocol: "x402" | "l402";
@@ -5501,14 +6025,14 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
5501
6025
  paymentAttemptId: string;
5502
6026
  settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
5503
6027
  fulfillmentStatus: "failed";
5504
- outcome: "paid_fulfillment_failed";
5505
- reasonCode: "merchant_rejected" | "merchant_execution_failed";
5506
- reason: string;
5507
6028
  merchantResponse: {
5508
6029
  status: number;
5509
6030
  headers: Record<string, string>;
5510
6031
  body: string;
5511
6032
  };
6033
+ outcome: "paid_fulfillment_failed";
6034
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
6035
+ reason: string;
5512
6036
  receipt: {
5513
6037
  status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
5514
6038
  protocol: "x402" | "l402";
@@ -5551,14 +6075,651 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
5551
6075
  paymentAttemptId: string;
5552
6076
  settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
5553
6077
  fulfillmentStatus: "failed";
5554
- outcome: "paid_fulfillment_failed";
5555
- reasonCode: "merchant_rejected" | "merchant_execution_failed";
6078
+ merchantResponse: {
6079
+ status: number;
6080
+ headers?: Record<string, string> | undefined;
6081
+ body?: string | undefined;
6082
+ };
6083
+ outcome: "paid_fulfillment_failed";
6084
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
6085
+ reason: string;
6086
+ receipt: {
6087
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
6088
+ protocol: "x402" | "l402";
6089
+ receiptId: string;
6090
+ paidRequestId: string;
6091
+ paymentAttemptId: string;
6092
+ organizationId: string;
6093
+ agentId: string;
6094
+ money: {
6095
+ asset: string;
6096
+ amount: string;
6097
+ amountMinor: string;
6098
+ precision: number;
6099
+ unit: "minor";
6100
+ };
6101
+ authorizationOutcome: "allowed";
6102
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
6103
+ requestUrl: string;
6104
+ requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
6105
+ createdAt: string;
6106
+ confirmedAt?: string | undefined;
6107
+ merchantId?: string | undefined;
6108
+ confirmationSource?: "chain_observer" | undefined;
6109
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
6110
+ attributionBasis?: Record<string, unknown> | undefined;
6111
+ attributionRuleVersion?: string | undefined;
6112
+ finalityLevelUsed?: "evm_block_confirmations_12" | "solana_commitment_finalized" | undefined;
6113
+ canonicalSettlementKey?: string | undefined;
6114
+ paymentReference?: string | undefined;
6115
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
6116
+ settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
6117
+ settlementIdentifier?: string | undefined;
6118
+ supersededByReceiptId?: string | undefined;
6119
+ fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
6120
+ completedAt?: string | undefined;
6121
+ };
6122
+ evidence?: Record<string, unknown> | undefined;
6123
+ }>, z.ZodObject<{
6124
+ outcome: z.ZodLiteral<"executing">;
6125
+ paidRequestId: z.ZodString;
6126
+ paymentAttemptId: z.ZodString;
6127
+ reasonCode: z.ZodLiteral<"payment_execution_in_progress">;
6128
+ reason: z.ZodString;
6129
+ }, "strip", z.ZodTypeAny, {
6130
+ paidRequestId: string;
6131
+ paymentAttemptId: string;
6132
+ outcome: "executing";
6133
+ reasonCode: "payment_execution_in_progress";
6134
+ reason: string;
6135
+ }, {
6136
+ paidRequestId: string;
6137
+ paymentAttemptId: string;
6138
+ outcome: "executing";
6139
+ reasonCode: "payment_execution_in_progress";
6140
+ reason: string;
6141
+ }>, z.ZodObject<{
6142
+ outcome: z.ZodLiteral<"preflight_failed">;
6143
+ paidRequestId: z.ZodString;
6144
+ paymentAttemptId: z.ZodString;
6145
+ reasonCode: z.ZodLiteral<"preflight_incompatible">;
6146
+ reason: z.ZodString;
6147
+ evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6148
+ }, "strip", z.ZodTypeAny, {
6149
+ paidRequestId: string;
6150
+ paymentAttemptId: string;
6151
+ outcome: "preflight_failed";
6152
+ reasonCode: "preflight_incompatible";
6153
+ reason: string;
6154
+ evidence?: Record<string, unknown> | undefined;
6155
+ }, {
6156
+ paidRequestId: string;
6157
+ paymentAttemptId: string;
6158
+ outcome: "preflight_failed";
6159
+ reasonCode: "preflight_incompatible";
6160
+ reason: string;
6161
+ evidence?: Record<string, unknown> | undefined;
6162
+ }>, z.ZodObject<{
6163
+ outcome: z.ZodLiteral<"execution_failed">;
6164
+ paidRequestId: z.ZodString;
6165
+ paymentAttemptId: z.ZodString;
6166
+ reasonCode: z.ZodEnum<["merchant_rejected", "merchant_execution_failed"]>;
6167
+ reason: z.ZodString;
6168
+ merchantResponse: z.ZodObject<{
6169
+ status: z.ZodNumber;
6170
+ headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
6171
+ body: z.ZodDefault<z.ZodString>;
6172
+ }, "strip", z.ZodTypeAny, {
6173
+ status: number;
6174
+ headers: Record<string, string>;
6175
+ body: string;
6176
+ }, {
6177
+ status: number;
6178
+ headers?: Record<string, string> | undefined;
6179
+ body?: string | undefined;
6180
+ }>;
6181
+ evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6182
+ }, "strip", z.ZodTypeAny, {
6183
+ paidRequestId: string;
6184
+ paymentAttemptId: string;
6185
+ merchantResponse: {
6186
+ status: number;
6187
+ headers: Record<string, string>;
6188
+ body: string;
6189
+ };
6190
+ outcome: "execution_failed";
6191
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
6192
+ reason: string;
6193
+ evidence?: Record<string, unknown> | undefined;
6194
+ }, {
6195
+ paidRequestId: string;
6196
+ paymentAttemptId: string;
6197
+ merchantResponse: {
6198
+ status: number;
6199
+ headers?: Record<string, string> | undefined;
6200
+ body?: string | undefined;
6201
+ };
6202
+ outcome: "execution_failed";
6203
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
6204
+ reason: string;
6205
+ evidence?: Record<string, unknown> | undefined;
6206
+ }>, z.ZodObject<{
6207
+ outcome: z.ZodLiteral<"inconclusive">;
6208
+ paidRequestId: z.ZodString;
6209
+ paymentAttemptId: z.ZodString;
6210
+ reasonCode: z.ZodLiteral<"merchant_transport_lost">;
6211
+ reason: z.ZodString;
6212
+ evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6213
+ }, "strip", z.ZodTypeAny, {
6214
+ paidRequestId: string;
6215
+ paymentAttemptId: string;
6216
+ outcome: "inconclusive";
6217
+ reasonCode: "merchant_transport_lost";
6218
+ reason: string;
6219
+ evidence?: Record<string, unknown> | undefined;
6220
+ }, {
6221
+ paidRequestId: string;
6222
+ paymentAttemptId: string;
6223
+ outcome: "inconclusive";
6224
+ reasonCode: "merchant_transport_lost";
6225
+ reason: string;
6226
+ evidence?: Record<string, unknown> | undefined;
6227
+ }>, z.ZodObject<{
6228
+ outcome: z.ZodLiteral<"deny">;
6229
+ paidRequestId: z.ZodOptional<z.ZodString>;
6230
+ reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "challenge_candidate_malformed", "challenge_no_supported_candidates", "challenge_mixed_environment_candidates", "challenge_execution_identity_unavailable", "challenge_execution_identity_ambiguous", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "settlement_proof_conflict", "merchant_transport_lost"]>;
6231
+ reason: z.ZodString;
6232
+ policyReviewEventId: z.ZodOptional<z.ZodString>;
6233
+ }, "strip", z.ZodTypeAny, {
6234
+ outcome: "deny";
6235
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
6236
+ reason: string;
6237
+ paidRequestId?: string | undefined;
6238
+ policyReviewEventId?: string | undefined;
6239
+ }, {
6240
+ outcome: "deny";
6241
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
6242
+ reason: string;
6243
+ paidRequestId?: string | undefined;
6244
+ policyReviewEventId?: string | undefined;
6245
+ }>]>;
6246
+ export type SdkPaymentDecisionResponse = z.infer<typeof sdkPaymentDecisionResponseSchema>;
6247
+ export declare const sdkPaymentAuthorizationResponseSchema: z.ZodDiscriminatedUnion<"outcome", [z.ZodObject<{
6248
+ outcome: z.ZodLiteral<"authorized">;
6249
+ paidRequestId: z.ZodString;
6250
+ paymentAttemptId: z.ZodString;
6251
+ reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "challenge_candidate_malformed", "challenge_no_supported_candidates", "challenge_mixed_environment_candidates", "challenge_execution_identity_unavailable", "challenge_execution_identity_ambiguous", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "settlement_proof_conflict", "merchant_transport_lost"]>;
6252
+ reason: z.ZodString;
6253
+ }, "strip", z.ZodTypeAny, {
6254
+ paidRequestId: string;
6255
+ paymentAttemptId: string;
6256
+ outcome: "authorized";
6257
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
6258
+ reason: string;
6259
+ }, {
6260
+ paidRequestId: string;
6261
+ paymentAttemptId: string;
6262
+ outcome: "authorized";
6263
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
6264
+ reason: string;
6265
+ }>, z.ZodObject<{
6266
+ outcome: z.ZodLiteral<"allow">;
6267
+ paidRequestId: z.ZodString;
6268
+ paymentAttemptId: z.ZodString;
6269
+ reasonCode: z.ZodEnum<["policy_allow", "policy_denied", "policy_review_required", "challenge_candidate_malformed", "challenge_no_supported_candidates", "challenge_mixed_environment_candidates", "challenge_execution_identity_unavailable", "challenge_execution_identity_ambiguous", "payment_execution_in_progress", "preflight_incompatible", "merchant_rejected", "merchant_execution_failed", "settlement_proof_conflict", "merchant_transport_lost"]>;
6270
+ reason: z.ZodString;
6271
+ merchantResponse: z.ZodObject<{
6272
+ status: z.ZodNumber;
6273
+ headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
6274
+ body: z.ZodDefault<z.ZodString>;
6275
+ }, "strip", z.ZodTypeAny, {
6276
+ status: number;
6277
+ headers: Record<string, string>;
6278
+ body: string;
6279
+ }, {
6280
+ status: number;
6281
+ headers?: Record<string, string> | undefined;
6282
+ body?: string | undefined;
6283
+ }>;
6284
+ receipt: z.ZodObject<{
6285
+ receiptId: z.ZodString;
6286
+ paidRequestId: z.ZodString;
6287
+ paymentAttemptId: z.ZodString;
6288
+ organizationId: z.ZodString;
6289
+ agentId: z.ZodString;
6290
+ merchantId: z.ZodOptional<z.ZodString>;
6291
+ protocol: z.ZodEnum<["x402", "l402"]>;
6292
+ money: z.ZodEffects<z.ZodObject<{
6293
+ asset: z.ZodString;
6294
+ amount: z.ZodString;
6295
+ amountMinor: z.ZodString;
6296
+ precision: z.ZodNumber;
6297
+ unit: z.ZodLiteral<"minor">;
6298
+ }, "strip", z.ZodTypeAny, {
6299
+ asset: string;
6300
+ amount: string;
6301
+ amountMinor: string;
6302
+ precision: number;
6303
+ unit: "minor";
6304
+ }, {
6305
+ asset: string;
6306
+ amount: string;
6307
+ amountMinor: string;
6308
+ precision: number;
6309
+ unit: "minor";
6310
+ }>, {
6311
+ asset: string;
6312
+ amount: string;
6313
+ amountMinor: string;
6314
+ precision: number;
6315
+ unit: "minor";
6316
+ }, {
6317
+ asset: string;
6318
+ amount: string;
6319
+ amountMinor: string;
6320
+ precision: number;
6321
+ unit: "minor";
6322
+ }>;
6323
+ authorizationOutcome: z.ZodEnum<["allowed"]>;
6324
+ status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
6325
+ reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
6326
+ confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
6327
+ attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
6328
+ attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6329
+ attributionRuleVersion: z.ZodOptional<z.ZodString>;
6330
+ confirmedAt: z.ZodOptional<z.ZodString>;
6331
+ finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12", "solana_commitment_finalized"]>>;
6332
+ requestUrl: z.ZodString;
6333
+ requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
6334
+ canonicalSettlementKey: z.ZodOptional<z.ZodString>;
6335
+ paymentReference: z.ZodOptional<z.ZodString>;
6336
+ evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
6337
+ settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
6338
+ settlementIdentifier: z.ZodOptional<z.ZodString>;
6339
+ supersededByReceiptId: z.ZodOptional<z.ZodString>;
6340
+ fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
6341
+ createdAt: z.ZodString;
6342
+ completedAt: z.ZodOptional<z.ZodString>;
6343
+ }, "strip", z.ZodTypeAny, {
6344
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
6345
+ protocol: "x402" | "l402";
6346
+ receiptId: string;
6347
+ paidRequestId: string;
6348
+ paymentAttemptId: string;
6349
+ organizationId: string;
6350
+ agentId: string;
6351
+ money: {
6352
+ asset: string;
6353
+ amount: string;
6354
+ amountMinor: string;
6355
+ precision: number;
6356
+ unit: "minor";
6357
+ };
6358
+ authorizationOutcome: "allowed";
6359
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
6360
+ requestUrl: string;
6361
+ requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
6362
+ createdAt: string;
6363
+ confirmedAt?: string | undefined;
6364
+ merchantId?: string | undefined;
6365
+ confirmationSource?: "chain_observer" | undefined;
6366
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
6367
+ attributionBasis?: Record<string, unknown> | undefined;
6368
+ attributionRuleVersion?: string | undefined;
6369
+ finalityLevelUsed?: "evm_block_confirmations_12" | "solana_commitment_finalized" | undefined;
6370
+ canonicalSettlementKey?: string | undefined;
6371
+ paymentReference?: string | undefined;
6372
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
6373
+ settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
6374
+ settlementIdentifier?: string | undefined;
6375
+ supersededByReceiptId?: string | undefined;
6376
+ fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
6377
+ completedAt?: string | undefined;
6378
+ }, {
6379
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
6380
+ protocol: "x402" | "l402";
6381
+ receiptId: string;
6382
+ paidRequestId: string;
6383
+ paymentAttemptId: string;
6384
+ organizationId: string;
6385
+ agentId: string;
6386
+ money: {
6387
+ asset: string;
6388
+ amount: string;
6389
+ amountMinor: string;
6390
+ precision: number;
6391
+ unit: "minor";
6392
+ };
6393
+ authorizationOutcome: "allowed";
6394
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
6395
+ requestUrl: string;
6396
+ requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
6397
+ createdAt: string;
6398
+ confirmedAt?: string | undefined;
6399
+ merchantId?: string | undefined;
6400
+ confirmationSource?: "chain_observer" | undefined;
6401
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
6402
+ attributionBasis?: Record<string, unknown> | undefined;
6403
+ attributionRuleVersion?: string | undefined;
6404
+ finalityLevelUsed?: "evm_block_confirmations_12" | "solana_commitment_finalized" | undefined;
6405
+ canonicalSettlementKey?: string | undefined;
6406
+ paymentReference?: string | undefined;
6407
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
6408
+ settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
6409
+ settlementIdentifier?: string | undefined;
6410
+ supersededByReceiptId?: string | undefined;
6411
+ fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
6412
+ completedAt?: string | undefined;
6413
+ }>;
6414
+ }, "strip", z.ZodTypeAny, {
6415
+ paidRequestId: string;
6416
+ paymentAttemptId: string;
6417
+ merchantResponse: {
6418
+ status: number;
6419
+ headers: Record<string, string>;
6420
+ body: string;
6421
+ };
6422
+ outcome: "allow";
6423
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
6424
+ reason: string;
6425
+ receipt: {
6426
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
6427
+ protocol: "x402" | "l402";
6428
+ receiptId: string;
6429
+ paidRequestId: string;
6430
+ paymentAttemptId: string;
6431
+ organizationId: string;
6432
+ agentId: string;
6433
+ money: {
6434
+ asset: string;
6435
+ amount: string;
6436
+ amountMinor: string;
6437
+ precision: number;
6438
+ unit: "minor";
6439
+ };
6440
+ authorizationOutcome: "allowed";
6441
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
6442
+ requestUrl: string;
6443
+ requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
6444
+ createdAt: string;
6445
+ confirmedAt?: string | undefined;
6446
+ merchantId?: string | undefined;
6447
+ confirmationSource?: "chain_observer" | undefined;
6448
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
6449
+ attributionBasis?: Record<string, unknown> | undefined;
6450
+ attributionRuleVersion?: string | undefined;
6451
+ finalityLevelUsed?: "evm_block_confirmations_12" | "solana_commitment_finalized" | undefined;
6452
+ canonicalSettlementKey?: string | undefined;
6453
+ paymentReference?: string | undefined;
6454
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
6455
+ settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
6456
+ settlementIdentifier?: string | undefined;
6457
+ supersededByReceiptId?: string | undefined;
6458
+ fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
6459
+ completedAt?: string | undefined;
6460
+ };
6461
+ }, {
6462
+ paidRequestId: string;
6463
+ paymentAttemptId: string;
6464
+ merchantResponse: {
6465
+ status: number;
6466
+ headers?: Record<string, string> | undefined;
6467
+ body?: string | undefined;
6468
+ };
6469
+ outcome: "allow";
6470
+ reasonCode: "policy_allow" | "policy_denied" | "policy_review_required" | "challenge_candidate_malformed" | "challenge_no_supported_candidates" | "challenge_mixed_environment_candidates" | "challenge_execution_identity_unavailable" | "challenge_execution_identity_ambiguous" | "payment_execution_in_progress" | "preflight_incompatible" | "merchant_rejected" | "merchant_execution_failed" | "settlement_proof_conflict" | "merchant_transport_lost";
6471
+ reason: string;
6472
+ receipt: {
6473
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
6474
+ protocol: "x402" | "l402";
6475
+ receiptId: string;
6476
+ paidRequestId: string;
6477
+ paymentAttemptId: string;
6478
+ organizationId: string;
6479
+ agentId: string;
6480
+ money: {
6481
+ asset: string;
6482
+ amount: string;
6483
+ amountMinor: string;
6484
+ precision: number;
6485
+ unit: "minor";
6486
+ };
6487
+ authorizationOutcome: "allowed";
6488
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
6489
+ requestUrl: string;
6490
+ requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
6491
+ createdAt: string;
6492
+ confirmedAt?: string | undefined;
6493
+ merchantId?: string | undefined;
6494
+ confirmationSource?: "chain_observer" | undefined;
6495
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
6496
+ attributionBasis?: Record<string, unknown> | undefined;
6497
+ attributionRuleVersion?: string | undefined;
6498
+ finalityLevelUsed?: "evm_block_confirmations_12" | "solana_commitment_finalized" | undefined;
6499
+ canonicalSettlementKey?: string | undefined;
6500
+ paymentReference?: string | undefined;
6501
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
6502
+ settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
6503
+ settlementIdentifier?: string | undefined;
6504
+ supersededByReceiptId?: string | undefined;
6505
+ fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
6506
+ completedAt?: string | undefined;
6507
+ };
6508
+ }>, z.ZodObject<{
6509
+ outcome: z.ZodLiteral<"paid_fulfillment_failed">;
6510
+ paidRequestId: z.ZodString;
6511
+ paymentAttemptId: z.ZodString;
6512
+ reasonCode: z.ZodEnum<["merchant_rejected", "merchant_execution_failed"]>;
6513
+ reason: z.ZodString;
6514
+ merchantResponse: z.ZodObject<{
6515
+ status: z.ZodNumber;
6516
+ headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
6517
+ body: z.ZodDefault<z.ZodString>;
6518
+ }, "strip", z.ZodTypeAny, {
6519
+ status: number;
6520
+ headers: Record<string, string>;
6521
+ body: string;
6522
+ }, {
6523
+ status: number;
6524
+ headers?: Record<string, string> | undefined;
6525
+ body?: string | undefined;
6526
+ }>;
6527
+ settlementEvidenceClass: z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>;
6528
+ fulfillmentStatus: z.ZodLiteral<"failed">;
6529
+ receipt: z.ZodObject<{
6530
+ receiptId: z.ZodString;
6531
+ paidRequestId: z.ZodString;
6532
+ paymentAttemptId: z.ZodString;
6533
+ organizationId: z.ZodString;
6534
+ agentId: z.ZodString;
6535
+ merchantId: z.ZodOptional<z.ZodString>;
6536
+ protocol: z.ZodEnum<["x402", "l402"]>;
6537
+ money: z.ZodEffects<z.ZodObject<{
6538
+ asset: z.ZodString;
6539
+ amount: z.ZodString;
6540
+ amountMinor: z.ZodString;
6541
+ precision: z.ZodNumber;
6542
+ unit: z.ZodLiteral<"minor">;
6543
+ }, "strip", z.ZodTypeAny, {
6544
+ asset: string;
6545
+ amount: string;
6546
+ amountMinor: string;
6547
+ precision: number;
6548
+ unit: "minor";
6549
+ }, {
6550
+ asset: string;
6551
+ amount: string;
6552
+ amountMinor: string;
6553
+ precision: number;
6554
+ unit: "minor";
6555
+ }>, {
6556
+ asset: string;
6557
+ amount: string;
6558
+ amountMinor: string;
6559
+ precision: number;
6560
+ unit: "minor";
6561
+ }, {
6562
+ asset: string;
6563
+ amount: string;
6564
+ amountMinor: string;
6565
+ precision: number;
6566
+ unit: "minor";
6567
+ }>;
6568
+ authorizationOutcome: z.ZodEnum<["allowed"]>;
6569
+ status: z.ZodEnum<["confirmed", "provisional", "expired_unconfirmed", "refunded", "void"]>;
6570
+ reconciliationStatus: z.ZodEnum<["none", "required", "in_progress", "resolved", "refunded"]>;
6571
+ confirmationSource: z.ZodOptional<z.ZodEnum<["chain_observer"]>>;
6572
+ attributionStrength: z.ZodOptional<z.ZodEnum<["strong_request_scoped", "constrained_unique"]>>;
6573
+ attributionBasis: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6574
+ attributionRuleVersion: z.ZodOptional<z.ZodString>;
6575
+ confirmedAt: z.ZodOptional<z.ZodString>;
6576
+ finalityLevelUsed: z.ZodOptional<z.ZodEnum<["evm_block_confirmations_12", "solana_commitment_finalized"]>>;
6577
+ requestUrl: z.ZodString;
6578
+ requestMethod: z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]>;
6579
+ canonicalSettlementKey: z.ZodOptional<z.ZodString>;
6580
+ paymentReference: z.ZodOptional<z.ZodString>;
6581
+ evidenceSource: z.ZodOptional<z.ZodEnum<["merchant", "local_simulation"]>>;
6582
+ settlementEvidenceClass: z.ZodOptional<z.ZodEnum<["none", "inconclusive", "merchant_verifiable_success", "settled"]>>;
6583
+ settlementIdentifier: z.ZodOptional<z.ZodString>;
6584
+ supersededByReceiptId: z.ZodOptional<z.ZodString>;
6585
+ fulfillmentStatus: z.ZodOptional<z.ZodEnum<["succeeded", "failed", "inconclusive"]>>;
6586
+ createdAt: z.ZodString;
6587
+ completedAt: z.ZodOptional<z.ZodString>;
6588
+ }, "strip", z.ZodTypeAny, {
6589
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
6590
+ protocol: "x402" | "l402";
6591
+ receiptId: string;
6592
+ paidRequestId: string;
6593
+ paymentAttemptId: string;
6594
+ organizationId: string;
6595
+ agentId: string;
6596
+ money: {
6597
+ asset: string;
6598
+ amount: string;
6599
+ amountMinor: string;
6600
+ precision: number;
6601
+ unit: "minor";
6602
+ };
6603
+ authorizationOutcome: "allowed";
6604
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
6605
+ requestUrl: string;
6606
+ requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
6607
+ createdAt: string;
6608
+ confirmedAt?: string | undefined;
6609
+ merchantId?: string | undefined;
6610
+ confirmationSource?: "chain_observer" | undefined;
6611
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
6612
+ attributionBasis?: Record<string, unknown> | undefined;
6613
+ attributionRuleVersion?: string | undefined;
6614
+ finalityLevelUsed?: "evm_block_confirmations_12" | "solana_commitment_finalized" | undefined;
6615
+ canonicalSettlementKey?: string | undefined;
6616
+ paymentReference?: string | undefined;
6617
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
6618
+ settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
6619
+ settlementIdentifier?: string | undefined;
6620
+ supersededByReceiptId?: string | undefined;
6621
+ fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
6622
+ completedAt?: string | undefined;
6623
+ }, {
6624
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
6625
+ protocol: "x402" | "l402";
6626
+ receiptId: string;
6627
+ paidRequestId: string;
6628
+ paymentAttemptId: string;
6629
+ organizationId: string;
6630
+ agentId: string;
6631
+ money: {
6632
+ asset: string;
6633
+ amount: string;
6634
+ amountMinor: string;
6635
+ precision: number;
6636
+ unit: "minor";
6637
+ };
6638
+ authorizationOutcome: "allowed";
6639
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
6640
+ requestUrl: string;
6641
+ requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
6642
+ createdAt: string;
6643
+ confirmedAt?: string | undefined;
6644
+ merchantId?: string | undefined;
6645
+ confirmationSource?: "chain_observer" | undefined;
6646
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
6647
+ attributionBasis?: Record<string, unknown> | undefined;
6648
+ attributionRuleVersion?: string | undefined;
6649
+ finalityLevelUsed?: "evm_block_confirmations_12" | "solana_commitment_finalized" | undefined;
6650
+ canonicalSettlementKey?: string | undefined;
6651
+ paymentReference?: string | undefined;
6652
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
6653
+ settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
6654
+ settlementIdentifier?: string | undefined;
6655
+ supersededByReceiptId?: string | undefined;
6656
+ fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
6657
+ completedAt?: string | undefined;
6658
+ }>;
6659
+ evidence: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
6660
+ }, "strip", z.ZodTypeAny, {
6661
+ paidRequestId: string;
6662
+ paymentAttemptId: string;
6663
+ settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
6664
+ fulfillmentStatus: "failed";
6665
+ merchantResponse: {
6666
+ status: number;
6667
+ headers: Record<string, string>;
6668
+ body: string;
6669
+ };
6670
+ outcome: "paid_fulfillment_failed";
6671
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
5556
6672
  reason: string;
6673
+ receipt: {
6674
+ status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
6675
+ protocol: "x402" | "l402";
6676
+ receiptId: string;
6677
+ paidRequestId: string;
6678
+ paymentAttemptId: string;
6679
+ organizationId: string;
6680
+ agentId: string;
6681
+ money: {
6682
+ asset: string;
6683
+ amount: string;
6684
+ amountMinor: string;
6685
+ precision: number;
6686
+ unit: "minor";
6687
+ };
6688
+ authorizationOutcome: "allowed";
6689
+ reconciliationStatus: "none" | "refunded" | "required" | "in_progress" | "resolved";
6690
+ requestUrl: string;
6691
+ requestMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
6692
+ createdAt: string;
6693
+ confirmedAt?: string | undefined;
6694
+ merchantId?: string | undefined;
6695
+ confirmationSource?: "chain_observer" | undefined;
6696
+ attributionStrength?: "strong_request_scoped" | "constrained_unique" | undefined;
6697
+ attributionBasis?: Record<string, unknown> | undefined;
6698
+ attributionRuleVersion?: string | undefined;
6699
+ finalityLevelUsed?: "evm_block_confirmations_12" | "solana_commitment_finalized" | undefined;
6700
+ canonicalSettlementKey?: string | undefined;
6701
+ paymentReference?: string | undefined;
6702
+ evidenceSource?: "merchant" | "local_simulation" | undefined;
6703
+ settlementEvidenceClass?: "none" | "inconclusive" | "merchant_verifiable_success" | "settled" | undefined;
6704
+ settlementIdentifier?: string | undefined;
6705
+ supersededByReceiptId?: string | undefined;
6706
+ fulfillmentStatus?: "inconclusive" | "succeeded" | "failed" | undefined;
6707
+ completedAt?: string | undefined;
6708
+ };
6709
+ evidence?: Record<string, unknown> | undefined;
6710
+ }, {
6711
+ paidRequestId: string;
6712
+ paymentAttemptId: string;
6713
+ settlementEvidenceClass: "none" | "inconclusive" | "merchant_verifiable_success" | "settled";
6714
+ fulfillmentStatus: "failed";
5557
6715
  merchantResponse: {
5558
6716
  status: number;
5559
6717
  headers?: Record<string, string> | undefined;
5560
6718
  body?: string | undefined;
5561
6719
  };
6720
+ outcome: "paid_fulfillment_failed";
6721
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
6722
+ reason: string;
5562
6723
  receipt: {
5563
6724
  status: "confirmed" | "provisional" | "expired_unconfirmed" | "refunded" | "void";
5564
6725
  protocol: "x402" | "l402";
@@ -5658,26 +6819,26 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
5658
6819
  }, "strip", z.ZodTypeAny, {
5659
6820
  paidRequestId: string;
5660
6821
  paymentAttemptId: string;
5661
- outcome: "execution_failed";
5662
- reasonCode: "merchant_rejected" | "merchant_execution_failed";
5663
- reason: string;
5664
6822
  merchantResponse: {
5665
6823
  status: number;
5666
6824
  headers: Record<string, string>;
5667
6825
  body: string;
5668
6826
  };
6827
+ outcome: "execution_failed";
6828
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
6829
+ reason: string;
5669
6830
  evidence?: Record<string, unknown> | undefined;
5670
6831
  }, {
5671
6832
  paidRequestId: string;
5672
6833
  paymentAttemptId: string;
5673
- outcome: "execution_failed";
5674
- reasonCode: "merchant_rejected" | "merchant_execution_failed";
5675
- reason: string;
5676
6834
  merchantResponse: {
5677
6835
  status: number;
5678
6836
  headers?: Record<string, string> | undefined;
5679
6837
  body?: string | undefined;
5680
6838
  };
6839
+ outcome: "execution_failed";
6840
+ reasonCode: "merchant_rejected" | "merchant_execution_failed";
6841
+ reason: string;
5681
6842
  evidence?: Record<string, unknown> | undefined;
5682
6843
  }>, z.ZodObject<{
5683
6844
  outcome: z.ZodLiteral<"inconclusive">;
@@ -5719,7 +6880,7 @@ export declare const sdkPaymentDecisionResponseSchema: z.ZodDiscriminatedUnion<"
5719
6880
  paidRequestId?: string | undefined;
5720
6881
  policyReviewEventId?: string | undefined;
5721
6882
  }>]>;
5722
- export type SdkPaymentDecisionResponse = z.infer<typeof sdkPaymentDecisionResponseSchema>;
6883
+ export type SdkPaymentAuthorizationResponse = z.infer<typeof sdkPaymentAuthorizationResponseSchema>;
5723
6884
  /** Receipt lookup response returned by AgentPayClient.lookupReceipt(). */
5724
6885
  export declare const sdkReceiptResponseSchema: z.ZodObject<{
5725
6886
  receipt: z.ZodObject<{