Publish OpenAPI bundles and api-catalog linkset for agent discovery

Author: kaankacar

nginx/nginx.conf

@@ -18,13 +18,21 @@ http {
         rewrite ^/(.*)/$ /$1 permanent;
         try_files $uri $uri.html $uri/index.html =404;
 
-        add_header Link "</stellar-rpc.openrpc.json>; rel=\"service-desc\"; type=\"application/json\"; title=\"Stellar RPC (OpenRPC)\"" always;
+        add_header Link "</.well-known/api-catalog>; rel=\"api-catalog\"; type=\"application/linkset+json\"" always;
+        add_header Link "</openapi/horizon.yml>; rel=\"service-desc\"; type=\"application/yaml\"; title=\"Horizon OpenAPI\"" always;
+        add_header Link "</openapi/anchor-platform.yaml>; rel=\"service-desc\"; type=\"application/yaml\"; title=\"Anchor Platform OpenAPI\"" always;
+        add_header Link "</openapi/stellar-disbursement-platform.yaml>; rel=\"service-desc\"; type=\"application/yaml\"; title=\"Stellar Disbursement Platform OpenAPI\"" always;
+        add_header Link "</stellar-rpc.openrpc.json>; rel=\"service-desc\"; type=\"application/json\"; title=\"Stellar RPC OpenRPC\"" always;
         add_header Link "</docs/data/apis/horizon/api-reference>; rel=\"service-doc\"; title=\"Horizon API reference\"" always;
         add_header Link "</docs/data/apis/rpc/api-reference>; rel=\"service-doc\"; title=\"Stellar RPC API reference\"" always;
         add_header Link "</docs/platforms/anchor-platform/api-reference>; rel=\"service-doc\"; title=\"Anchor Platform API reference\"" always;
         add_header Link "</docs/platforms/stellar-disbursement-platform/api-reference>; rel=\"service-doc\"; title=\"Stellar Disbursement Platform API reference\"" always;
         add_header Link "</llms.txt>; rel=\"describedby\"; type=\"text/plain\"; title=\"LLM-friendly site description\"" always;
     }
+    location = /.well-known/api-catalog {
+        default_type application/linkset+json;
+        try_files $uri =404;
+    }
     location /assets/ {
         try_files $uri $uri/ =404;
     }

static/.well-known/api-catalog

@@ -0,0 +1,72 @@
+{
+  "linkset": [
+    {
+      "anchor": "https://developers.stellar.org/docs/data/apis/horizon",
+      "service-desc": [
+        {
+          "href": "https://developers.stellar.org/openapi/horizon.yml",
+          "type": "application/yaml",
+          "title": "Horizon OpenAPI specification"
+        }
+      ],
+      "service-doc": [
+        {
+          "href": "https://developers.stellar.org/docs/data/apis/horizon/api-reference",
+          "type": "text/html",
+          "title": "Horizon API reference"
+        }
+      ]
+    },
+    {
+      "anchor": "https://developers.stellar.org/docs/data/apis/rpc",
+      "service-desc": [
+        {
+          "href": "https://developers.stellar.org/stellar-rpc.openrpc.json",
+          "type": "application/json",
+          "title": "Stellar RPC OpenRPC specification"
+        }
+      ],
+      "service-doc": [
+        {
+          "href": "https://developers.stellar.org/docs/data/apis/rpc/api-reference",
+          "type": "text/html",
+          "title": "Stellar RPC API reference"
+        }
+      ]
+    },
+    {
+      "anchor": "https://developers.stellar.org/docs/platforms/anchor-platform",
+      "service-desc": [
+        {
+          "href": "https://developers.stellar.org/openapi/anchor-platform.yaml",
+          "type": "application/yaml",
+          "title": "Anchor Platform OpenAPI specification"
+        }
+      ],
+      "service-doc": [
+        {
+          "href": "https://developers.stellar.org/docs/platforms/anchor-platform/api-reference",
+          "type": "text/html",
+          "title": "Anchor Platform API reference"
+        }
+      ]
+    },
+    {
+      "anchor": "https://developers.stellar.org/docs/platforms/stellar-disbursement-platform",
+      "service-desc": [
+        {
+          "href": "https://developers.stellar.org/openapi/stellar-disbursement-platform.yaml",
+          "type": "application/yaml",
+          "title": "Stellar Disbursement Platform OpenAPI specification"
+        }
+      ],
+      "service-doc": [
+        {
+          "href": "https://developers.stellar.org/docs/platforms/stellar-disbursement-platform/api-reference",
+          "type": "text/html",
+          "title": "Stellar Disbursement Platform API reference"
+        }
+      ]
+    }
+  ]
+}