docs(landing): SEO/GEO for the SQL docs page

- sitemap.xml + sitemap.md: add /docs/sql (IndexNow submits it on deploy, since
  it parses sitemap.xml).
- DocsPage: per-document SEO meta — unique <title>, description, canonical,
  Open Graph, Twitter, and TechArticle JSON-LD — so every doc page (including
  sql) is independently indexable and answer-engine citable.
- Re-sync public/docs/openapi.json to the 0.9.0 spec.

llms.txt already lists the SQL page (Reference + core commands); public/docs/sql.md
is synced from docs/sql.md by generate:md.

Author: tarasyarema

landing/public/docs/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "agent-fs API",
-    "version": "0.8.1",
+    "version": "0.9.0",
     "description": "A persistent, searchable filesystem for AI agents. agent-fs is to files what agentmail is to email.",
     "license": {
       "name": "MIT",
@@ -769,6 +769,69 @@
                     },
                     "additionalProperties": false
                   },
+                  {
+                    "type": "object",
+                    "title": "sql",
+                    "description": "Run a DuckDB SQL query over documents stored in the drive. Reference documents directly by path string literal (e.g. SELECT * FROM '/data/sales.csv') or bind them as named tables via `tables` ({ name: path } or { name: { path, format } } to override format detection). Supports csv, tsv, parquet, xlsx, json, ndjson/jsonl (each also .gz except parquet/xlsx), sqlite (.db/.sqlite/.sqlite3, tables exposed as name.tablename), and .duckdb files. Queries run sandboxed: no filesystem or network access beyond the bound documents. Returns { columns, rows, rowCount, truncated, files, elapsedMs }.",
+                    "required": [
+                      "op",
+                      "query"
+                    ],
+                    "properties": {
+                      "op": {
+                        "type": "string",
+                        "const": "sql"
+                      },
+                      "driveId": {
+                        "type": "string",
+                        "description": "Target drive ID (optional, uses default drive)"
+                      },
+                      "query": {
+                        "type": "string"
+                      },
+                      "tables": {
+                        "type": "object",
+                        "additionalProperties": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "path": {
+                                  "type": "string"
+                                },
+                                "format": {
+                                  "type": "string",
+                                  "enum": [
+                                    "csv",
+                                    "tsv",
+                                    "parquet",
+                                    "xlsx",
+                                    "json",
+                                    "ndjson",
+                                    "sqlite",
+                                    "duckdb"
+                                  ]
+                                }
+                              },
+                              "required": [
+                                "path"
+                              ],
+                              "additionalProperties": false
+                            }
+                          ]
+                        }
+                      },
+                      "maxRows": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "maximum": 10000
+                      }
+                    },
+                    "additionalProperties": false
+                  },
                   {
                     "type": "object",
                     "title": "signed-url",

landing/public/sitemap.md

@@ -14,6 +14,8 @@ machine-readable representation (where available) linked alongside.
 - [/docs](https://agent-fs.dev/docs) — Documentation index.
 - [/docs/api-reference](https://agent-fs.dev/docs/api-reference) — HTTP API,
   auth, MCP transport, and operation dispatch.
+- [/docs/sql](https://agent-fs.dev/docs/sql) — Query CSV, Parquet, Excel, JSON,
+  and SQLite documents with DuckDB (CLI, API, MCP).
 - [/docs/mcp-setup](https://agent-fs.dev/docs/mcp-setup) — MCP client setup.
 - [/docs/deployment](https://agent-fs.dev/docs/deployment) — Local and hosted
   deployment guide.

landing/public/sitemap.xml

@@ -18,6 +18,12 @@
     <changefreq>weekly</changefreq>
     <priority>0.8</priority>
   </url>
+  <url>
+    <loc>https://agent-fs.dev/docs/sql</loc>
+    <lastmod>2026-06-11</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
   <url>
     <loc>https://agent-fs.dev/docs/mcp-setup</loc>
     <lastmod>2026-05-19</lastmod>

landing/src/pages/DocsPage.tsx

@@ -685,6 +685,62 @@ export function DocsPage({ slug }: { slug?: string }) {
   const activeId = useActiveHeading(activeDoc.slug)
   const sidebarRef = useRef<HTMLElement | null>(null)
 
+  // Per-document SEO/GEO: unique title, description, canonical, Open Graph,
+  // Twitter, and TechArticle JSON-LD so each doc page is independently
+  // indexable by search engines and citable by answer engines.
+  useEffect(() => {
+    const url = `https://agent-fs.dev/docs/${activeDoc.slug}`
+    const title = `${activeDoc.title} — agent-fs docs`
+    document.title = title
+
+    const upsertMeta = (
+      key: string,
+      content: string,
+      attr: "name" | "property" = "name",
+    ) => {
+      let el = document.head.querySelector<HTMLMetaElement>(`meta[${attr}="${key}"]`)
+      if (!el) {
+        el = document.createElement("meta")
+        el.setAttribute(attr, key)
+        document.head.appendChild(el)
+      }
+      el.setAttribute("content", content)
+    }
+    upsertMeta("description", activeDoc.summary)
+    upsertMeta("og:title", title, "property")
+    upsertMeta("og:description", activeDoc.summary, "property")
+    upsertMeta("og:url", url, "property")
+    upsertMeta("og:type", "article", "property")
+    upsertMeta("twitter:title", title)
+    upsertMeta("twitter:description", activeDoc.summary)
+
+    let canonical = document.head.querySelector<HTMLLinkElement>('link[rel="canonical"]')
+    if (!canonical) {
+      canonical = document.createElement("link")
+      canonical.rel = "canonical"
+      document.head.appendChild(canonical)
+    }
+    canonical.href = url
+
+    const jsonLd = {
+      "@context": "https://schema.org",
+      "@type": "TechArticle",
+      headline: activeDoc.title,
+      description: activeDoc.summary,
+      url,
+      inLanguage: "en",
+      isPartOf: { "@type": "WebSite", name: "agent-fs", url: "https://agent-fs.dev" },
+    }
+    let script = document.getElementById("doc-jsonld") as HTMLScriptElement | null
+    if (!script) {
+      script = document.createElement("script")
+      script.id = "doc-jsonld"
+      script.type = "application/ld+json"
+      document.head.appendChild(script)
+    }
+    script.textContent = JSON.stringify(jsonLd)
+  }, [activeDoc])
+
   useEffect(() => {
     const onKey = (e: KeyboardEvent) => {
       if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === "k") {