From 0b1a4308654b213784bf050993f7038f75b76bb1 Mon Sep 17 00:00:00 2001
From: Drew Stone <drewstone329@gmail.com>
Date: Tue, 16 Jun 2026 05:51:40 -0600
Subject: [PATCH] feat(discovery): add agent-readable docs entrypoints

---
 public/.well-known/tangle-agent.json | 18 ++++++++++++++++++
 public/llms.txt                      | 20 ++++++++++++++++++++
 public/sitemap.xml                   | 18 ++++++++++++++++++
 3 files changed, 56 insertions(+)
 create mode 100644 public/.well-known/tangle-agent.json
 create mode 100644 public/llms.txt
 create mode 100644 public/sitemap.xml

diff --git a/public/.well-known/tangle-agent.json b/public/.well-known/tangle-agent.json
new file mode 100644
index 00000000..3e9231d7
--- /dev/null
+++ b/public/.well-known/tangle-agent.json
@@ -0,0 +1,18 @@
+{
+  "schema_version": "2026-06-16",
+  "name": "Tangle Docs",
+  "description": "Documentation for Tangle Blueprints, operators, sandbox runtime, Router, and x402 payments.",
+  "homepage": "https://docs.tangle.tools/",
+  "llms": "https://docs.tangle.tools/llms.txt",
+  "product_manifest": "https://tangle.tools/.well-known/tangle-agent.json",
+  "recommended_first_reads": [
+    "https://docs.tangle.tools/developers/cli/quickstart",
+    "https://docs.tangle.tools/developers/blueprints/introduction",
+    "https://docs.tangle.tools/infrastructure/sandboxing"
+  ],
+  "install": [
+    "npm install @tangle-network/tcloud",
+    "npm install @tangle-network/sandbox",
+    "npm install -g @tangle-network/browser-agent-driver"
+  ]
+}
diff --git a/public/llms.txt b/public/llms.txt
new file mode 100644
index 00000000..ddb7698e
--- /dev/null
+++ b/public/llms.txt
@@ -0,0 +1,20 @@
+# Tangle Docs
+
+Tangle Docs explain how to build and operate services on Tangle: Blueprints, operators, sandbox runtime, Router, and x402 payments.
+
+## Core pages
+
+- Docs home: https://docs.tangle.tools/
+- Developers: https://docs.tangle.tools/developers
+- Blueprints: https://docs.tangle.tools/developers/blueprints/introduction
+- Blueprint quickstart: https://docs.tangle.tools/developers/cli/quickstart
+- Sandbox docs: https://docs.tangle.tools/infrastructure/sandboxing
+- Router: https://router.tangle.tools/
+- Marketing overview: https://tangle.tools/
+
+## Agent guidance
+
+- Use the Tangle product manifest at https://tangle.tools/.well-known/tangle-agent.json.
+- Use Router OpenAPI at https://router.tangle.tools/openapi.json for model-routing calls.
+- Install scoped npm packages only: `@tangle-network/tcloud`, `@tangle-network/sandbox`, `@tangle-network/browser-agent-driver`.
+- Use `TANGLE_API_KEY` for authenticated calls.
diff --git a/public/sitemap.xml b/public/sitemap.xml
new file mode 100644
index 00000000..9423734c
--- /dev/null
+++ b/public/sitemap.xml
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://docs.tangle.tools/</loc>
+  </url>
+  <url>
+    <loc>https://docs.tangle.tools/developers</loc>
+  </url>
+  <url>
+    <loc>https://docs.tangle.tools/developers/cli/quickstart</loc>
+  </url>
+  <url>
+    <loc>https://docs.tangle.tools/developers/blueprints/introduction</loc>
+  </url>
+  <url>
+    <loc>https://docs.tangle.tools/infrastructure/sandboxing</loc>
+  </url>
+</urlset>