@creatornader/agent-bridge 0.3.0 → 0.4.0

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 (75) hide show
  1. package/CHANGELOG.md +174 -5
  2. package/README.md +341 -33
  3. package/ROADMAP.md +78 -16
  4. package/SECURITY.md +68 -1
  5. package/SKILL.md +104 -1
  6. package/dist/archive.d.ts +2 -2
  7. package/dist/archive.js +2 -2
  8. package/dist/{bridge-service-hX1ZQp4W.d.ts → bridge-service-YTjGr91A.d.ts} +1 -1
  9. package/dist/{bridge-store-DPVSCwfs.d.ts → bridge-store-Boaj-ZbO.d.ts} +2 -0
  10. package/dist/bridge.d.ts +17 -7
  11. package/dist/bridge.js +15 -7
  12. package/dist/{chunk-WAI2IYIQ.js → chunk-3YHVUPU2.js} +48 -5
  13. package/dist/chunk-3YHVUPU2.js.map +1 -0
  14. package/dist/{chunk-45BZGB77.js → chunk-6BTJE6D4.js} +168 -7
  15. package/dist/chunk-6BTJE6D4.js.map +1 -0
  16. package/dist/{chunk-5GMB3A77.js → chunk-DQOZJJZ2.js} +22 -10
  17. package/dist/chunk-DQOZJJZ2.js.map +1 -0
  18. package/dist/{chunk-NCO7RLBM.js → chunk-GTK4KOED.js} +108 -8
  19. package/dist/chunk-GTK4KOED.js.map +1 -0
  20. package/dist/{chunk-GADH244D.js → chunk-IHZFI7TH.js} +12 -4
  21. package/dist/chunk-IHZFI7TH.js.map +1 -0
  22. package/dist/{chunk-CEXBMOI5.js → chunk-LAHNQZDN.js} +2 -2
  23. package/dist/{chunk-UAHMP6GC.js → chunk-MCKKVNCE.js} +9 -6
  24. package/dist/chunk-MCKKVNCE.js.map +1 -0
  25. package/dist/{chunk-MBPZXTJA.js → chunk-PDIHDBP3.js} +173 -20
  26. package/dist/chunk-PDIHDBP3.js.map +1 -0
  27. package/dist/{chunk-Q6PPMXJC.js → chunk-SV3SVBYS.js} +377 -21
  28. package/dist/chunk-SV3SVBYS.js.map +1 -0
  29. package/dist/{chunk-SPSMZOCJ.js → chunk-SYGONYMM.js} +4 -4
  30. package/dist/{chunk-A6W4QALF.js → chunk-TC6A7GMF.js} +2 -2
  31. package/dist/cli.js +5856 -413
  32. package/dist/cli.js.map +1 -1
  33. package/dist/client-runtime.d.ts +4 -2
  34. package/dist/client-runtime.js +6 -6
  35. package/dist/contracts/generate.js +1 -1
  36. package/dist/dr.d.ts +9 -2
  37. package/dist/dr.js +6 -4
  38. package/dist/{gateway-CggQ8vTC.d.ts → gateway-BQHpV-MZ.d.ts} +27 -3
  39. package/dist/gateway-main.js +69 -5
  40. package/dist/gateway-main.js.map +1 -1
  41. package/dist/gateway.d.ts +3 -3
  42. package/dist/gateway.js +2 -2
  43. package/dist/index.js +7 -7
  44. package/dist/{postgres-bridge-store-Bfd3hRId.d.ts → postgres-bridge-store-WASumj26.d.ts} +1 -1
  45. package/dist/server.js +7 -7
  46. package/dist/sqlite-edge-store-Bc15DvpX.d.ts +148 -0
  47. package/dist/sqlite.d.ts +19 -80
  48. package/dist/sqlite.js +11 -3
  49. package/docs/architecture-v2.md +278 -13
  50. package/docs/decisions/0001-protocol-layers-and-acknowledgment-semantics.md +2 -2
  51. package/docs/decisions/0003-host-adapters-and-consumer-instance-keys.md +88 -0
  52. package/docs/decisions/0004-client-lifecycle-and-endpoint-migration.md +204 -0
  53. package/docs/deployment.md +205 -0
  54. package/docs/ecosystem.md +35 -3
  55. package/docs/troubleshooting.md +23 -0
  56. package/llms.txt +79 -3
  57. package/openapi/agent-bridge-v2.openapi.json +1023 -0
  58. package/package.json +6 -2
  59. package/schemas/agent-bridge-v2.capabilities.json +24 -0
  60. package/schemas/agent-bridge-v2.mcp.json +6 -0
  61. package/schemas/agent-bridge-v2.schema.json +163 -0
  62. package/sql/migrations/017_gateway_authority_binding.sql +99 -0
  63. package/sql/migrations/018_endpoint_migration_challenges.sql +1028 -0
  64. package/sql/migrations/019_endpoint_migration_same_successor.sql +324 -0
  65. package/dist/chunk-45BZGB77.js.map +0 -1
  66. package/dist/chunk-5GMB3A77.js.map +0 -1
  67. package/dist/chunk-GADH244D.js.map +0 -1
  68. package/dist/chunk-MBPZXTJA.js.map +0 -1
  69. package/dist/chunk-NCO7RLBM.js.map +0 -1
  70. package/dist/chunk-Q6PPMXJC.js.map +0 -1
  71. package/dist/chunk-UAHMP6GC.js.map +0 -1
  72. package/dist/chunk-WAI2IYIQ.js.map +0 -1
  73. /package/dist/{chunk-CEXBMOI5.js.map → chunk-LAHNQZDN.js.map} +0 -0
  74. /package/dist/{chunk-SPSMZOCJ.js.map → chunk-SYGONYMM.js.map} +0 -0
  75. /package/dist/{chunk-A6W4QALF.js.map → chunk-TC6A7GMF.js.map} +0 -0
package/openapi/agent-bridge-v2.openapi.json CHANGED
@@ -349,6 +349,12 @@
349
349
  "legacy-supabase"
350
350
  ]
351
351
  },
352
+ "grantedScopes": {
353
+ "type": "array",
354
+ "items": {
355
+ "type": "string"
356
+ }
357
+ },
352
358
  "operations": {
353
359
  "type": "array",
354
360
  "items": {
@@ -946,6 +952,12 @@
946
952
  }
947
953
  ]
948
954
  },
955
+ "gatewayAuthorityId": {
956
+ "type": "string"
957
+ },
958
+ "credentialId": {
959
+ "type": "string"
960
+ },
949
961
  "principal": {
950
962
  "type": "object",
951
963
  "required": [
@@ -1361,6 +1373,1017 @@
1361
1373
  }
1362
1374
  }
1363
1375
  },
1376
+ "/v2/endpoint-migration-challenges": {
1377
+ "post": {
1378
+ "operationId": "issue_endpoint_migration_challenge",
1379
+ "summary": "Issue a short-lived endpoint migration challenge commitment.",
1380
+ "security": [
1381
+ {
1382
+ "bearerAuth": []
1383
+ }
1384
+ ],
1385
+ "x-agent-bridge-required-scopes": [],
1386
+ "x-agent-bridge-scope-enforcement": true,
1387
+ "parameters": [
1388
+ {
1389
+ "name": "x-agent-bridge-protocol-version",
1390
+ "in": "header",
1391
+ "required": true,
1392
+ "description": "This OpenAPI operation describes protocol 2.1. Headerless protocol 2.0 uses the separate schemas named by x-agent-bridge-protocol-2.0.",
1393
+ "schema": {
1394
+ "type": "string",
1395
+ "enum": [
1396
+ "2.1"
1397
+ ]
1398
+ }
1399
+ }
1400
+ ],
1401
+ "requestBody": {
1402
+ "required": true,
1403
+ "content": {
1404
+ "application/json": {
1405
+ "schema": {
1406
+ "type": "object",
1407
+ "required": [
1408
+ "challenge",
1409
+ "expectedGatewayAuthorityId",
1410
+ "verifierCredentialId"
1411
+ ],
1412
+ "properties": {
1413
+ "challenge": {
1414
+ "type": "string",
1415
+ "pattern": "^[0-9a-f]{64}$"
1416
+ },
1417
+ "expectedGatewayAuthorityId": {
1418
+ "type": "string",
1419
+ "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
1420
+ },
1421
+ "verifierCredentialId": {
1422
+ "type": "string",
1423
+ "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
1424
+ }
1425
+ },
1426
+ "additionalProperties": false
1427
+ }
1428
+ }
1429
+ }
1430
+ },
1431
+ "responses": {
1432
+ "200": {
1433
+ "description": "Successful response.",
1434
+ "headers": {
1435
+ "x-agent-bridge-protocol-version": {
1436
+ "description": "Selected Agent Bridge protocol version.",
1437
+ "required": true,
1438
+ "schema": {
1439
+ "type": "string",
1440
+ "enum": [
1441
+ "2.0",
1442
+ "2.1"
1443
+ ]
1444
+ }
1445
+ },
1446
+ "x-agent-bridge-supported-protocol-versions": {
1447
+ "description": "Comma-separated protocol versions supported by this gateway.",
1448
+ "required": true,
1449
+ "schema": {
1450
+ "type": "string"
1451
+ }
1452
+ }
1453
+ },
1454
+ "content": {
1455
+ "application/json": {
1456
+ "schema": {
1457
+ "type": "object",
1458
+ "required": [
1459
+ "gatewayAuthorityId",
1460
+ "issuerCredentialId",
1461
+ "verifierCredentialId",
1462
+ "expiresAt"
1463
+ ],
1464
+ "properties": {
1465
+ "gatewayAuthorityId": {
1466
+ "type": "string"
1467
+ },
1468
+ "issuerCredentialId": {
1469
+ "type": "string"
1470
+ },
1471
+ "verifierCredentialId": {
1472
+ "type": "string"
1473
+ },
1474
+ "expiresAt": {
1475
+ "type": "string"
1476
+ }
1477
+ },
1478
+ "additionalProperties": false
1479
+ }
1480
+ }
1481
+ }
1482
+ },
1483
+ "400": {
1484
+ "description": "The request does not match the operation contract.",
1485
+ "headers": {
1486
+ "x-agent-bridge-protocol-version": {
1487
+ "description": "Selected Agent Bridge protocol version.",
1488
+ "required": true,
1489
+ "schema": {
1490
+ "type": "string",
1491
+ "enum": [
1492
+ "2.0",
1493
+ "2.1"
1494
+ ]
1495
+ }
1496
+ },
1497
+ "x-agent-bridge-supported-protocol-versions": {
1498
+ "description": "Comma-separated protocol versions supported by this gateway.",
1499
+ "required": true,
1500
+ "schema": {
1501
+ "type": "string"
1502
+ }
1503
+ }
1504
+ },
1505
+ "content": {
1506
+ "application/json": {
1507
+ "schema": {
1508
+ "$ref": "#/components/schemas/ErrorEnvelope"
1509
+ }
1510
+ }
1511
+ }
1512
+ },
1513
+ "401": {
1514
+ "description": "The bearer credential is missing or invalid.",
1515
+ "headers": {
1516
+ "x-agent-bridge-protocol-version": {
1517
+ "description": "Selected Agent Bridge protocol version.",
1518
+ "required": true,
1519
+ "schema": {
1520
+ "type": "string",
1521
+ "enum": [
1522
+ "2.0",
1523
+ "2.1"
1524
+ ]
1525
+ }
1526
+ },
1527
+ "x-agent-bridge-supported-protocol-versions": {
1528
+ "description": "Comma-separated protocol versions supported by this gateway.",
1529
+ "required": true,
1530
+ "schema": {
1531
+ "type": "string"
1532
+ }
1533
+ }
1534
+ },
1535
+ "content": {
1536
+ "application/json": {
1537
+ "schema": {
1538
+ "$ref": "#/components/schemas/ErrorEnvelope"
1539
+ }
1540
+ }
1541
+ }
1542
+ },
1543
+ "403": {
1544
+ "description": "The credential cannot access the requested principal or origin.",
1545
+ "headers": {
1546
+ "x-agent-bridge-protocol-version": {
1547
+ "description": "Selected Agent Bridge protocol version.",
1548
+ "required": true,
1549
+ "schema": {
1550
+ "type": "string",
1551
+ "enum": [
1552
+ "2.0",
1553
+ "2.1"
1554
+ ]
1555
+ }
1556
+ },
1557
+ "x-agent-bridge-supported-protocol-versions": {
1558
+ "description": "Comma-separated protocol versions supported by this gateway.",
1559
+ "required": true,
1560
+ "schema": {
1561
+ "type": "string"
1562
+ }
1563
+ }
1564
+ },
1565
+ "content": {
1566
+ "application/json": {
1567
+ "schema": {
1568
+ "$ref": "#/components/schemas/ErrorEnvelope"
1569
+ }
1570
+ }
1571
+ }
1572
+ },
1573
+ "404": {
1574
+ "description": "The route or requested resource does not exist.",
1575
+ "headers": {
1576
+ "x-agent-bridge-protocol-version": {
1577
+ "description": "Selected Agent Bridge protocol version.",
1578
+ "required": true,
1579
+ "schema": {
1580
+ "type": "string",
1581
+ "enum": [
1582
+ "2.0",
1583
+ "2.1"
1584
+ ]
1585
+ }
1586
+ },
1587
+ "x-agent-bridge-supported-protocol-versions": {
1588
+ "description": "Comma-separated protocol versions supported by this gateway.",
1589
+ "required": true,
1590
+ "schema": {
1591
+ "type": "string"
1592
+ }
1593
+ }
1594
+ },
1595
+ "content": {
1596
+ "application/json": {
1597
+ "schema": {
1598
+ "$ref": "#/components/schemas/ErrorEnvelope"
1599
+ }
1600
+ }
1601
+ }
1602
+ },
1603
+ "409": {
1604
+ "description": "The request conflicts with current delivery or idempotency state.",
1605
+ "headers": {
1606
+ "x-agent-bridge-protocol-version": {
1607
+ "description": "Selected Agent Bridge protocol version.",
1608
+ "required": true,
1609
+ "schema": {
1610
+ "type": "string",
1611
+ "enum": [
1612
+ "2.0",
1613
+ "2.1"
1614
+ ]
1615
+ }
1616
+ },
1617
+ "x-agent-bridge-supported-protocol-versions": {
1618
+ "description": "Comma-separated protocol versions supported by this gateway.",
1619
+ "required": true,
1620
+ "schema": {
1621
+ "type": "string"
1622
+ }
1623
+ }
1624
+ },
1625
+ "content": {
1626
+ "application/json": {
1627
+ "schema": {
1628
+ "$ref": "#/components/schemas/ErrorEnvelope"
1629
+ }
1630
+ }
1631
+ }
1632
+ },
1633
+ "413": {
1634
+ "description": "The request body exceeds the configured limit.",
1635
+ "headers": {
1636
+ "x-agent-bridge-protocol-version": {
1637
+ "description": "Selected Agent Bridge protocol version.",
1638
+ "required": true,
1639
+ "schema": {
1640
+ "type": "string",
1641
+ "enum": [
1642
+ "2.0",
1643
+ "2.1"
1644
+ ]
1645
+ }
1646
+ },
1647
+ "x-agent-bridge-supported-protocol-versions": {
1648
+ "description": "Comma-separated protocol versions supported by this gateway.",
1649
+ "required": true,
1650
+ "schema": {
1651
+ "type": "string"
1652
+ }
1653
+ }
1654
+ },
1655
+ "content": {
1656
+ "application/json": {
1657
+ "schema": {
1658
+ "$ref": "#/components/schemas/ErrorEnvelope"
1659
+ }
1660
+ }
1661
+ }
1662
+ },
1663
+ "415": {
1664
+ "description": "The request content type is not application/json.",
1665
+ "headers": {
1666
+ "x-agent-bridge-protocol-version": {
1667
+ "description": "Selected Agent Bridge protocol version.",
1668
+ "required": true,
1669
+ "schema": {
1670
+ "type": "string",
1671
+ "enum": [
1672
+ "2.0",
1673
+ "2.1"
1674
+ ]
1675
+ }
1676
+ },
1677
+ "x-agent-bridge-supported-protocol-versions": {
1678
+ "description": "Comma-separated protocol versions supported by this gateway.",
1679
+ "required": true,
1680
+ "schema": {
1681
+ "type": "string"
1682
+ }
1683
+ }
1684
+ },
1685
+ "content": {
1686
+ "application/json": {
1687
+ "schema": {
1688
+ "$ref": "#/components/schemas/ErrorEnvelope"
1689
+ }
1690
+ }
1691
+ }
1692
+ },
1693
+ "426": {
1694
+ "description": "The requested protocol version is unsupported.",
1695
+ "headers": {
1696
+ "x-agent-bridge-protocol-version": {
1697
+ "description": "Selected Agent Bridge protocol version.",
1698
+ "required": true,
1699
+ "schema": {
1700
+ "type": "string",
1701
+ "enum": [
1702
+ "2.0",
1703
+ "2.1"
1704
+ ]
1705
+ }
1706
+ },
1707
+ "x-agent-bridge-supported-protocol-versions": {
1708
+ "description": "Comma-separated protocol versions supported by this gateway.",
1709
+ "required": true,
1710
+ "schema": {
1711
+ "type": "string"
1712
+ }
1713
+ }
1714
+ },
1715
+ "content": {
1716
+ "application/json": {
1717
+ "schema": {
1718
+ "$ref": "#/components/schemas/ErrorEnvelope"
1719
+ }
1720
+ }
1721
+ }
1722
+ },
1723
+ "429": {
1724
+ "description": "The gateway has rate-limited the request.",
1725
+ "headers": {
1726
+ "x-agent-bridge-protocol-version": {
1727
+ "description": "Selected Agent Bridge protocol version.",
1728
+ "required": true,
1729
+ "schema": {
1730
+ "type": "string",
1731
+ "enum": [
1732
+ "2.0",
1733
+ "2.1"
1734
+ ]
1735
+ }
1736
+ },
1737
+ "x-agent-bridge-supported-protocol-versions": {
1738
+ "description": "Comma-separated protocol versions supported by this gateway.",
1739
+ "required": true,
1740
+ "schema": {
1741
+ "type": "string"
1742
+ }
1743
+ }
1744
+ },
1745
+ "content": {
1746
+ "application/json": {
1747
+ "schema": {
1748
+ "$ref": "#/components/schemas/ErrorEnvelope"
1749
+ }
1750
+ }
1751
+ }
1752
+ },
1753
+ "500": {
1754
+ "description": "The gateway could not complete the request.",
1755
+ "headers": {
1756
+ "x-agent-bridge-protocol-version": {
1757
+ "description": "Selected Agent Bridge protocol version.",
1758
+ "required": true,
1759
+ "schema": {
1760
+ "type": "string",
1761
+ "enum": [
1762
+ "2.0",
1763
+ "2.1"
1764
+ ]
1765
+ }
1766
+ },
1767
+ "x-agent-bridge-supported-protocol-versions": {
1768
+ "description": "Comma-separated protocol versions supported by this gateway.",
1769
+ "required": true,
1770
+ "schema": {
1771
+ "type": "string"
1772
+ }
1773
+ }
1774
+ },
1775
+ "content": {
1776
+ "application/json": {
1777
+ "schema": {
1778
+ "$ref": "#/components/schemas/ErrorEnvelope"
1779
+ }
1780
+ }
1781
+ }
1782
+ },
1783
+ "502": {
1784
+ "description": "The upstream response does not match the selected protocol contract.",
1785
+ "headers": {
1786
+ "x-agent-bridge-protocol-version": {
1787
+ "description": "Selected Agent Bridge protocol version.",
1788
+ "required": true,
1789
+ "schema": {
1790
+ "type": "string",
1791
+ "enum": [
1792
+ "2.0",
1793
+ "2.1"
1794
+ ]
1795
+ }
1796
+ },
1797
+ "x-agent-bridge-supported-protocol-versions": {
1798
+ "description": "Comma-separated protocol versions supported by this gateway.",
1799
+ "required": true,
1800
+ "schema": {
1801
+ "type": "string"
1802
+ }
1803
+ }
1804
+ },
1805
+ "content": {
1806
+ "application/json": {
1807
+ "schema": {
1808
+ "$ref": "#/components/schemas/ErrorEnvelope"
1809
+ }
1810
+ }
1811
+ }
1812
+ },
1813
+ "503": {
1814
+ "description": "The backing service is unavailable.",
1815
+ "headers": {
1816
+ "x-agent-bridge-protocol-version": {
1817
+ "description": "Selected Agent Bridge protocol version.",
1818
+ "required": true,
1819
+ "schema": {
1820
+ "type": "string",
1821
+ "enum": [
1822
+ "2.0",
1823
+ "2.1"
1824
+ ]
1825
+ }
1826
+ },
1827
+ "x-agent-bridge-supported-protocol-versions": {
1828
+ "description": "Comma-separated protocol versions supported by this gateway.",
1829
+ "required": true,
1830
+ "schema": {
1831
+ "type": "string"
1832
+ }
1833
+ }
1834
+ },
1835
+ "content": {
1836
+ "application/json": {
1837
+ "schema": {
1838
+ "$ref": "#/components/schemas/ErrorEnvelope"
1839
+ }
1840
+ }
1841
+ }
1842
+ },
1843
+ "504": {
1844
+ "description": "The request exceeded the gateway deadline.",
1845
+ "headers": {
1846
+ "x-agent-bridge-protocol-version": {
1847
+ "description": "Selected Agent Bridge protocol version.",
1848
+ "required": true,
1849
+ "schema": {
1850
+ "type": "string",
1851
+ "enum": [
1852
+ "2.0",
1853
+ "2.1"
1854
+ ]
1855
+ }
1856
+ },
1857
+ "x-agent-bridge-supported-protocol-versions": {
1858
+ "description": "Comma-separated protocol versions supported by this gateway.",
1859
+ "required": true,
1860
+ "schema": {
1861
+ "type": "string"
1862
+ }
1863
+ }
1864
+ },
1865
+ "content": {
1866
+ "application/json": {
1867
+ "schema": {
1868
+ "$ref": "#/components/schemas/ErrorEnvelope"
1869
+ }
1870
+ }
1871
+ }
1872
+ }
1873
+ }
1874
+ }
1875
+ },
1876
+ "/v2/endpoint-migration-challenges/consume": {
1877
+ "post": {
1878
+ "operationId": "consume_endpoint_migration_challenge",
1879
+ "summary": "Consume a short-lived endpoint migration challenge commitment.",
1880
+ "security": [
1881
+ {
1882
+ "bearerAuth": []
1883
+ }
1884
+ ],
1885
+ "x-agent-bridge-required-scopes": [],
1886
+ "x-agent-bridge-scope-enforcement": true,
1887
+ "parameters": [
1888
+ {
1889
+ "name": "x-agent-bridge-protocol-version",
1890
+ "in": "header",
1891
+ "required": true,
1892
+ "description": "This OpenAPI operation describes protocol 2.1. Headerless protocol 2.0 uses the separate schemas named by x-agent-bridge-protocol-2.0.",
1893
+ "schema": {
1894
+ "type": "string",
1895
+ "enum": [
1896
+ "2.1"
1897
+ ]
1898
+ }
1899
+ }
1900
+ ],
1901
+ "requestBody": {
1902
+ "required": true,
1903
+ "content": {
1904
+ "application/json": {
1905
+ "schema": {
1906
+ "type": "object",
1907
+ "required": [
1908
+ "challenge",
1909
+ "expectedGatewayAuthorityId",
1910
+ "issuerCredentialId"
1911
+ ],
1912
+ "properties": {
1913
+ "challenge": {
1914
+ "type": "string",
1915
+ "pattern": "^[0-9a-f]{64}$"
1916
+ },
1917
+ "expectedGatewayAuthorityId": {
1918
+ "type": "string",
1919
+ "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
1920
+ },
1921
+ "issuerCredentialId": {
1922
+ "type": "string",
1923
+ "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
1924
+ }
1925
+ },
1926
+ "additionalProperties": false
1927
+ }
1928
+ }
1929
+ }
1930
+ },
1931
+ "responses": {
1932
+ "200": {
1933
+ "description": "Successful response.",
1934
+ "headers": {
1935
+ "x-agent-bridge-protocol-version": {
1936
+ "description": "Selected Agent Bridge protocol version.",
1937
+ "required": true,
1938
+ "schema": {
1939
+ "type": "string",
1940
+ "enum": [
1941
+ "2.0",
1942
+ "2.1"
1943
+ ]
1944
+ }
1945
+ },
1946
+ "x-agent-bridge-supported-protocol-versions": {
1947
+ "description": "Comma-separated protocol versions supported by this gateway.",
1948
+ "required": true,
1949
+ "schema": {
1950
+ "type": "string"
1951
+ }
1952
+ }
1953
+ },
1954
+ "content": {
1955
+ "application/json": {
1956
+ "schema": {
1957
+ "type": "object",
1958
+ "required": [
1959
+ "gatewayAuthorityId",
1960
+ "issuerCredentialId",
1961
+ "verifierCredentialId",
1962
+ "expiresAt",
1963
+ "consumed"
1964
+ ],
1965
+ "properties": {
1966
+ "gatewayAuthorityId": {
1967
+ "type": "string"
1968
+ },
1969
+ "issuerCredentialId": {
1970
+ "type": "string"
1971
+ },
1972
+ "verifierCredentialId": {
1973
+ "type": "string"
1974
+ },
1975
+ "expiresAt": {
1976
+ "anyOf": [
1977
+ {
1978
+ "type": "string"
1979
+ },
1980
+ {
1981
+ "type": "null"
1982
+ }
1983
+ ]
1984
+ },
1985
+ "consumed": {
1986
+ "type": "boolean"
1987
+ }
1988
+ },
1989
+ "additionalProperties": false
1990
+ }
1991
+ }
1992
+ }
1993
+ },
1994
+ "400": {
1995
+ "description": "The request does not match the operation contract.",
1996
+ "headers": {
1997
+ "x-agent-bridge-protocol-version": {
1998
+ "description": "Selected Agent Bridge protocol version.",
1999
+ "required": true,
2000
+ "schema": {
2001
+ "type": "string",
2002
+ "enum": [
2003
+ "2.0",
2004
+ "2.1"
2005
+ ]
2006
+ }
2007
+ },
2008
+ "x-agent-bridge-supported-protocol-versions": {
2009
+ "description": "Comma-separated protocol versions supported by this gateway.",
2010
+ "required": true,
2011
+ "schema": {
2012
+ "type": "string"
2013
+ }
2014
+ }
2015
+ },
2016
+ "content": {
2017
+ "application/json": {
2018
+ "schema": {
2019
+ "$ref": "#/components/schemas/ErrorEnvelope"
2020
+ }
2021
+ }
2022
+ }
2023
+ },
2024
+ "401": {
2025
+ "description": "The bearer credential is missing or invalid.",
2026
+ "headers": {
2027
+ "x-agent-bridge-protocol-version": {
2028
+ "description": "Selected Agent Bridge protocol version.",
2029
+ "required": true,
2030
+ "schema": {
2031
+ "type": "string",
2032
+ "enum": [
2033
+ "2.0",
2034
+ "2.1"
2035
+ ]
2036
+ }
2037
+ },
2038
+ "x-agent-bridge-supported-protocol-versions": {
2039
+ "description": "Comma-separated protocol versions supported by this gateway.",
2040
+ "required": true,
2041
+ "schema": {
2042
+ "type": "string"
2043
+ }
2044
+ }
2045
+ },
2046
+ "content": {
2047
+ "application/json": {
2048
+ "schema": {
2049
+ "$ref": "#/components/schemas/ErrorEnvelope"
2050
+ }
2051
+ }
2052
+ }
2053
+ },
2054
+ "403": {
2055
+ "description": "The credential cannot access the requested principal or origin.",
2056
+ "headers": {
2057
+ "x-agent-bridge-protocol-version": {
2058
+ "description": "Selected Agent Bridge protocol version.",
2059
+ "required": true,
2060
+ "schema": {
2061
+ "type": "string",
2062
+ "enum": [
2063
+ "2.0",
2064
+ "2.1"
2065
+ ]
2066
+ }
2067
+ },
2068
+ "x-agent-bridge-supported-protocol-versions": {
2069
+ "description": "Comma-separated protocol versions supported by this gateway.",
2070
+ "required": true,
2071
+ "schema": {
2072
+ "type": "string"
2073
+ }
2074
+ }
2075
+ },
2076
+ "content": {
2077
+ "application/json": {
2078
+ "schema": {
2079
+ "$ref": "#/components/schemas/ErrorEnvelope"
2080
+ }
2081
+ }
2082
+ }
2083
+ },
2084
+ "404": {
2085
+ "description": "The route or requested resource does not exist.",
2086
+ "headers": {
2087
+ "x-agent-bridge-protocol-version": {
2088
+ "description": "Selected Agent Bridge protocol version.",
2089
+ "required": true,
2090
+ "schema": {
2091
+ "type": "string",
2092
+ "enum": [
2093
+ "2.0",
2094
+ "2.1"
2095
+ ]
2096
+ }
2097
+ },
2098
+ "x-agent-bridge-supported-protocol-versions": {
2099
+ "description": "Comma-separated protocol versions supported by this gateway.",
2100
+ "required": true,
2101
+ "schema": {
2102
+ "type": "string"
2103
+ }
2104
+ }
2105
+ },
2106
+ "content": {
2107
+ "application/json": {
2108
+ "schema": {
2109
+ "$ref": "#/components/schemas/ErrorEnvelope"
2110
+ }
2111
+ }
2112
+ }
2113
+ },
2114
+ "409": {
2115
+ "description": "The request conflicts with current delivery or idempotency state.",
2116
+ "headers": {
2117
+ "x-agent-bridge-protocol-version": {
2118
+ "description": "Selected Agent Bridge protocol version.",
2119
+ "required": true,
2120
+ "schema": {
2121
+ "type": "string",
2122
+ "enum": [
2123
+ "2.0",
2124
+ "2.1"
2125
+ ]
2126
+ }
2127
+ },
2128
+ "x-agent-bridge-supported-protocol-versions": {
2129
+ "description": "Comma-separated protocol versions supported by this gateway.",
2130
+ "required": true,
2131
+ "schema": {
2132
+ "type": "string"
2133
+ }
2134
+ }
2135
+ },
2136
+ "content": {
2137
+ "application/json": {
2138
+ "schema": {
2139
+ "$ref": "#/components/schemas/ErrorEnvelope"
2140
+ }
2141
+ }
2142
+ }
2143
+ },
2144
+ "413": {
2145
+ "description": "The request body exceeds the configured limit.",
2146
+ "headers": {
2147
+ "x-agent-bridge-protocol-version": {
2148
+ "description": "Selected Agent Bridge protocol version.",
2149
+ "required": true,
2150
+ "schema": {
2151
+ "type": "string",
2152
+ "enum": [
2153
+ "2.0",
2154
+ "2.1"
2155
+ ]
2156
+ }
2157
+ },
2158
+ "x-agent-bridge-supported-protocol-versions": {
2159
+ "description": "Comma-separated protocol versions supported by this gateway.",
2160
+ "required": true,
2161
+ "schema": {
2162
+ "type": "string"
2163
+ }
2164
+ }
2165
+ },
2166
+ "content": {
2167
+ "application/json": {
2168
+ "schema": {
2169
+ "$ref": "#/components/schemas/ErrorEnvelope"
2170
+ }
2171
+ }
2172
+ }
2173
+ },
2174
+ "415": {
2175
+ "description": "The request content type is not application/json.",
2176
+ "headers": {
2177
+ "x-agent-bridge-protocol-version": {
2178
+ "description": "Selected Agent Bridge protocol version.",
2179
+ "required": true,
2180
+ "schema": {
2181
+ "type": "string",
2182
+ "enum": [
2183
+ "2.0",
2184
+ "2.1"
2185
+ ]
2186
+ }
2187
+ },
2188
+ "x-agent-bridge-supported-protocol-versions": {
2189
+ "description": "Comma-separated protocol versions supported by this gateway.",
2190
+ "required": true,
2191
+ "schema": {
2192
+ "type": "string"
2193
+ }
2194
+ }
2195
+ },
2196
+ "content": {
2197
+ "application/json": {
2198
+ "schema": {
2199
+ "$ref": "#/components/schemas/ErrorEnvelope"
2200
+ }
2201
+ }
2202
+ }
2203
+ },
2204
+ "426": {
2205
+ "description": "The requested protocol version is unsupported.",
2206
+ "headers": {
2207
+ "x-agent-bridge-protocol-version": {
2208
+ "description": "Selected Agent Bridge protocol version.",
2209
+ "required": true,
2210
+ "schema": {
2211
+ "type": "string",
2212
+ "enum": [
2213
+ "2.0",
2214
+ "2.1"
2215
+ ]
2216
+ }
2217
+ },
2218
+ "x-agent-bridge-supported-protocol-versions": {
2219
+ "description": "Comma-separated protocol versions supported by this gateway.",
2220
+ "required": true,
2221
+ "schema": {
2222
+ "type": "string"
2223
+ }
2224
+ }
2225
+ },
2226
+ "content": {
2227
+ "application/json": {
2228
+ "schema": {
2229
+ "$ref": "#/components/schemas/ErrorEnvelope"
2230
+ }
2231
+ }
2232
+ }
2233
+ },
2234
+ "429": {
2235
+ "description": "The gateway has rate-limited the request.",
2236
+ "headers": {
2237
+ "x-agent-bridge-protocol-version": {
2238
+ "description": "Selected Agent Bridge protocol version.",
2239
+ "required": true,
2240
+ "schema": {
2241
+ "type": "string",
2242
+ "enum": [
2243
+ "2.0",
2244
+ "2.1"
2245
+ ]
2246
+ }
2247
+ },
2248
+ "x-agent-bridge-supported-protocol-versions": {
2249
+ "description": "Comma-separated protocol versions supported by this gateway.",
2250
+ "required": true,
2251
+ "schema": {
2252
+ "type": "string"
2253
+ }
2254
+ }
2255
+ },
2256
+ "content": {
2257
+ "application/json": {
2258
+ "schema": {
2259
+ "$ref": "#/components/schemas/ErrorEnvelope"
2260
+ }
2261
+ }
2262
+ }
2263
+ },
2264
+ "500": {
2265
+ "description": "The gateway could not complete the request.",
2266
+ "headers": {
2267
+ "x-agent-bridge-protocol-version": {
2268
+ "description": "Selected Agent Bridge protocol version.",
2269
+ "required": true,
2270
+ "schema": {
2271
+ "type": "string",
2272
+ "enum": [
2273
+ "2.0",
2274
+ "2.1"
2275
+ ]
2276
+ }
2277
+ },
2278
+ "x-agent-bridge-supported-protocol-versions": {
2279
+ "description": "Comma-separated protocol versions supported by this gateway.",
2280
+ "required": true,
2281
+ "schema": {
2282
+ "type": "string"
2283
+ }
2284
+ }
2285
+ },
2286
+ "content": {
2287
+ "application/json": {
2288
+ "schema": {
2289
+ "$ref": "#/components/schemas/ErrorEnvelope"
2290
+ }
2291
+ }
2292
+ }
2293
+ },
2294
+ "502": {
2295
+ "description": "The upstream response does not match the selected protocol contract.",
2296
+ "headers": {
2297
+ "x-agent-bridge-protocol-version": {
2298
+ "description": "Selected Agent Bridge protocol version.",
2299
+ "required": true,
2300
+ "schema": {
2301
+ "type": "string",
2302
+ "enum": [
2303
+ "2.0",
2304
+ "2.1"
2305
+ ]
2306
+ }
2307
+ },
2308
+ "x-agent-bridge-supported-protocol-versions": {
2309
+ "description": "Comma-separated protocol versions supported by this gateway.",
2310
+ "required": true,
2311
+ "schema": {
2312
+ "type": "string"
2313
+ }
2314
+ }
2315
+ },
2316
+ "content": {
2317
+ "application/json": {
2318
+ "schema": {
2319
+ "$ref": "#/components/schemas/ErrorEnvelope"
2320
+ }
2321
+ }
2322
+ }
2323
+ },
2324
+ "503": {
2325
+ "description": "The backing service is unavailable.",
2326
+ "headers": {
2327
+ "x-agent-bridge-protocol-version": {
2328
+ "description": "Selected Agent Bridge protocol version.",
2329
+ "required": true,
2330
+ "schema": {
2331
+ "type": "string",
2332
+ "enum": [
2333
+ "2.0",
2334
+ "2.1"
2335
+ ]
2336
+ }
2337
+ },
2338
+ "x-agent-bridge-supported-protocol-versions": {
2339
+ "description": "Comma-separated protocol versions supported by this gateway.",
2340
+ "required": true,
2341
+ "schema": {
2342
+ "type": "string"
2343
+ }
2344
+ }
2345
+ },
2346
+ "content": {
2347
+ "application/json": {
2348
+ "schema": {
2349
+ "$ref": "#/components/schemas/ErrorEnvelope"
2350
+ }
2351
+ }
2352
+ }
2353
+ },
2354
+ "504": {
2355
+ "description": "The request exceeded the gateway deadline.",
2356
+ "headers": {
2357
+ "x-agent-bridge-protocol-version": {
2358
+ "description": "Selected Agent Bridge protocol version.",
2359
+ "required": true,
2360
+ "schema": {
2361
+ "type": "string",
2362
+ "enum": [
2363
+ "2.0",
2364
+ "2.1"
2365
+ ]
2366
+ }
2367
+ },
2368
+ "x-agent-bridge-supported-protocol-versions": {
2369
+ "description": "Comma-separated protocol versions supported by this gateway.",
2370
+ "required": true,
2371
+ "schema": {
2372
+ "type": "string"
2373
+ }
2374
+ }
2375
+ },
2376
+ "content": {
2377
+ "application/json": {
2378
+ "schema": {
2379
+ "$ref": "#/components/schemas/ErrorEnvelope"
2380
+ }
2381
+ }
2382
+ }
2383
+ }
2384
+ }
2385
+ }
2386
+ },
1364
2387
  "/metrics": {
1365
2388
  "get": {
1366
2389
  "operationId": "gateway_metrics",