From 42b9d2b5a39d0b1e50db0ca4a8c615be7a05c469 Mon Sep 17 00:00:00 2001 From: Elliot Date: Tue, 12 May 2026 10:10:33 -0500 Subject: [PATCH 1/3] add agent-friendly content-signal to robots.txt --- static/robots.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/static/robots.txt b/static/robots.txt index 4504538d3e..b814f30709 100644 --- a/static/robots.txt +++ b/static/robots.txt @@ -2,4 +2,5 @@ User-agent: * Allow: / +Content-Signal: ai-train=yes, search=yes, ai-input=yes Sitemap: https://developers.stellar.org/sitemap.xml \ No newline at end of file From 648dbbade6d322cc67e8621d1b3d81f0ff884878 Mon Sep 17 00:00:00 2001 From: Elliot Date: Tue, 12 May 2026 10:11:16 -0500 Subject: [PATCH 2/3] add well-known agent-skills discovery stub TODO: figure out the proper way to share our stellar-dev-skill here --- static/.well-known/agent-skills/index.json | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 static/.well-known/agent-skills/index.json diff --git a/static/.well-known/agent-skills/index.json b/static/.well-known/agent-skills/index.json new file mode 100644 index 0000000000..2263c8f312 --- /dev/null +++ b/static/.well-known/agent-skills/index.json @@ -0,0 +1,4 @@ +{ + "$schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json", + "skills": [] +} From e42bab9bb1692667a0944aa3e21ecaaab65b1233 Mon Sep 17 00:00:00 2001 From: Elliot Date: Tue, 12 May 2026 10:12:58 -0500 Subject: [PATCH 3/3] add well-known api-catalog file pointing to our data APIs TODO: consider publishing static routes to horizon API spec --- nginx/nginx.conf | 6 +++++ static/.well-known/api-catalog | 46 ++++++++++++++++++++++++++++++++++ 2 files changed, 52 insertions(+) create mode 100644 static/.well-known/api-catalog diff --git a/nginx/nginx.conf b/nginx/nginx.conf index ea3faa8861..1a64e451c7 100644 --- a/nginx/nginx.conf +++ b/nginx/nginx.conf @@ -17,6 +17,7 @@ http { location / { rewrite ^/(.*)/$ /$1 permanent; try_files $uri $uri.html $uri/index.html =404; + add_header 'Link' '; rel="api-catalog"' always; } location /assets/ { try_files $uri $uri/ =404; @@ -29,9 +30,14 @@ http { } location /index.html { add_header 'Cache-Control' 'no-store' always; + add_header 'Link' '; rel="api-catalog"' always; } location /404.html { add_header 'Cache-Control' 'no-store' always; } + # RFC 9727 — extension-less file, advertise correct content type + location = /.well-known/api-catalog { + types { } default_type application/linkset+json; + } } } diff --git a/static/.well-known/api-catalog b/static/.well-known/api-catalog new file mode 100644 index 0000000000..8199102865 --- /dev/null +++ b/static/.well-known/api-catalog @@ -0,0 +1,46 @@ +{ + "linkset": [ + { + "anchor": "https://developers.stellar.org/docs/data/apis/rpc", + "service-desc": [ + { + "href": "https://developers.stellar.org/stellar-rpc.openrpc.json", + "type": "application/json" + } + ], + "service-doc": [ + { + "href": "https://developers.stellar.org/docs/data/apis/rpc/api-reference", + "type": "text/html" + } + ] + }, + { + "anchor": "https://developers.stellar.org/docs/data/apis/horizon", + "service-doc": [ + { + "href": "https://developers.stellar.org/docs/data/apis/horizon/api-reference", + "type": "text/html" + } + ] + }, + { + "anchor": "https://developers.stellar.org/docs/platforms/anchor-platform", + "service-doc": [ + { + "href": "https://developers.stellar.org/docs/platforms/anchor-platform/api-reference", + "type": "text/html" + } + ] + }, + { + "anchor": "https://developers.stellar.org/docs/platforms/stellar-disbursement-platform", + "service-doc": [ + { + "href": "https://developers.stellar.org/docs/platforms/stellar-disbursement-platform/api-reference", + "type": "text/html" + } + ] + } + ] +}