@spacefast/common 0.0.26 → 0.2.1

package/dist/docs/catalog.d.ts

@@ -1,7 +1,7 @@
+import { DOCS_BASE_URL } from "../config/domains.js";
 import type { CliDisclosureTier } from "../vocabulary.js";
 /** Which part of the docs a page belongs to (runtime list + derived type). */
 export declare const DOC_KINDS: readonly ["guide", "cli", "api", "recipe", "workflow", "error"];
-/** Which part of the docs a page belongs to. */
 export type DocKind = (typeof DOC_KINDS)[number];
 /** One searchable documentation page. */
 export interface DocEntry {
@@ -22,8 +22,12 @@ export interface DocEntry {
     /** Short printable body shown by `sf docs <topic>`. */
     readonly body: string;
 }
-/** Base URL all bundled docs links resolve against. */
-export declare const DOCS_BASE_URL = "https://spacefast.com/docs";
+/**
+ * Base URL all bundled docs links resolve against. Owned by the domain registry
+ * (`../config/domains.ts`) and re-exported here, where every docs caller
+ * already looks for it.
+ */
+export { DOCS_BASE_URL };
 export declare const DOCS_CATALOG: readonly [{
     readonly slug: "quickstart";
     readonly title: "Quickstart";
@@ -31,7 +35,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "essential";
     readonly summary: "Publish your first space in under two minutes.";
     readonly keywords: readonly ["start", "getting started", "first", "new", "setup", "hello world"];
-    readonly url: "https://spacefast.com/docs/quickstart";
+    readonly url: `${string}/quickstart`;
     readonly body: "Install the CLI, run `sf init` in your working directory, then `sf publish` to take the current build live on a new space.";
 }, {
     readonly slug: "publishing";
@@ -40,7 +44,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "essential";
     readonly summary: "How `sf publish` builds, uploads, and goes live.";
     readonly keywords: readonly ["publish", "go live", "upload", "release", "artifact"];
-    readonly url: "https://spacefast.com/docs/publishing";
+    readonly url: `${string}/publish`;
     readonly body: "`sf publish` snapshots your output directory into an immutable version and promotes it to the production channel. Use `--no-wait` to return before serving finishes.";
 }, {
     readonly slug: "spaces/rename";
@@ -49,7 +53,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Change a space slug and its managed view.fast address without breaking old links.";
     readonly keywords: readonly ["space", "rename", "slug", "view.fast", "redirect", "managed hostname"];
-    readonly url: "https://spacefast.com/docs/spaces/rename";
+    readonly url: `${string}/operate/spaces`;
     readonly body: "Run `sf spaces update --space <space> --slug <new-slug> --wait`, or PATCH `/v1/spaces/{spaceId}` with `{ \"slug\": \"<new-slug>\" }`. The managed view.fast hostname changes with the slug. Former managed addresses and branch aliases redirect directly to their current counterparts with a temporary, path- and query-preserving 307 for the life of the space unless an operator explicitly releases them. Custom domains stay attached, and immutable version URLs do not change.";
 }, {
     readonly slug: "versions-and-rollback";
@@ -58,7 +62,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "essential";
     readonly summary: "Every publish is an immutable version you can roll back to.";
     readonly keywords: readonly ["version", "rollback", "history", "revert", "channel", "promote"];
-    readonly url: "https://spacefast.com/docs/rollback";
+    readonly url: `${string}/rollback`;
     readonly body: "List versions with `sf versions`, promote one to a channel, and undo a bad publish instantly with `sf rollback`.";
 }, {
     readonly slug: "anonymous-publish";
@@ -67,7 +71,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "essential";
     readonly summary: "Publish without an account, then claim the space with its key.";
     readonly keywords: readonly ["anonymous", "claim", "unclaimed", "agent", "token", "adopt"];
-    readonly url: "https://spacefast.com/docs/anonymous-publish";
+    readonly url: `${string}/anonymous-publish`;
     readonly body: "Publish without logging in to get an instant URL and a space key; run `sf spaces claim` with that key to bind the space to your account.";
 }, {
     readonly slug: "agents";
@@ -76,7 +80,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "essential";
     readonly summary: "Let an AI agent publish and operate spaces via the CLI, API, or MCP.";
     readonly keywords: readonly ["agent", "ai", "mcp", "model context protocol", "automation", "assistant"];
-    readonly url: "https://spacefast.com/docs/agents";
+    readonly url: `${string}/agents`;
     readonly body: "Agents use the same REST API and CLI as humans. Install the MCP server with `sf mcp install` so an assistant can publish, inspect, and manage spaces with structured tools.";
 }, {
     readonly slug: "workflow/publish-curl";
@@ -85,17 +89,17 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Publish a file or zipped output folder directly to /v1/publish. No account, CLI install, or MCP setup is required for anonymous publishes.";
     readonly keywords: readonly ["publish", "curl", "anonymous", "no install", "claim"];
-    readonly url: "https://spacefast.com/docs/agents#publish-with-curl";
+    readonly url: `${string}/agents#publish-with-curl`;
     readonly body: "curl publish file folder archive zip anonymous no account no install live URL immutable version claim link /v1/publish";
 }, {
     readonly slug: "workflow/publish-receipt";
     readonly title: "Publish receipt fields";
     readonly kind: "workflow";
     readonly tier: "full";
-    readonly summary: "Use the receipt as the source of truth. For anonymous publishes, claim.url is the private-site door and claim.claimUrl is the browser claim link; liveUrl and immutableUrl identify resources for automation.";
+    readonly summary: "Use the receipt as the source of truth. For anonymous publishes, claim.url is the private-site door and claim.claimUrl is the browser claim link; space.liveUrl and version.immutableUrl identify resources for automation.";
     readonly keywords: readonly ["receipt", "share", "claim", "diagnostics"];
-    readonly url: "https://spacefast.com/docs/api#publish";
-    readonly body: "receipt liveUrl open url immutableUrl claim expiresAt diagnostics links finalize promote upload errors docsUrl";
+    readonly url: `${string}/api#publish`;
+    readonly body: "receipt space.liveUrl open url version.immutableUrl claim expiresAt diagnostics links finalize promote upload errors docsUrl";
 }, {
     readonly slug: "workflow/continue-after-claim";
     readonly title: "Keep publishing after the user claims";
@@ -103,7 +107,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "After the owner claims an anonymous space with continuation enabled, exchange the saved space key once for a durable space-scoped access token, save it over the key, and keep publishing.";
     readonly keywords: readonly ["continue", "exchange", "claim token", "space_claimed_credential_available", "continuation"];
-    readonly url: "https://spacefast.com/docs/agents#continue-after-claim";
+    readonly url: `${string}/agents#continue-after-claim`;
     readonly body: "continue continuation space key claim token exchange voucher publish execute POST /v1/claim/exchange space_claimed_credential_available continuation_used continuation_unavailable durable access token state.json update after claim";
 }, {
     readonly slug: "workflow/secret-handling";
@@ -112,7 +116,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Treat space keys, upload tokens, device codes, API keys, auth files, and .spacefast state as credentials. Do not print, commit, archive, or log them.";
     readonly keywords: readonly ["secret", "token", "claim token", "redact"];
-    readonly url: "https://spacefast.com/docs/agents#secret-handling";
+    readonly url: `${string}/agents#secret-handling`;
     readonly body: "secret handling claim token upload token device code API key auth file .spacefast state redact logs transcripts archive";
 }, {
     readonly slug: "workflow/cli-surface";
@@ -121,17 +125,17 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Use sf for repeat work: publish, versions, rollback, logs, domains, sharing, teams, API calls, and On-Device MCP serving.";
     readonly keywords: readonly ["sf", "cli", "spacefast", "mcp", "json"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "sf spacefast CLI publish versions rollback logs domains share teams api mcp setup profile login --json";
 }, {
     readonly slug: "workflow/mcp-local";
     readonly title: "On-Device MCP through the CLI";
     readonly kind: "workflow";
     readonly tier: "full";
-    readonly summary: "Run sf mcp for stdio or sf mcp http --host 127.0.0.1 --port 3945 --path /mcp for On-Device Streamable HTTP.";
-    readonly keywords: readonly ["mcp", "stdio", "streamable http", "on-device", "local"];
-    readonly url: "https://spacefast.com/docs/agents#mcp";
-    readonly body: "MCP on-device local CLI stdio streamable HTTP sf mcp roots files workspace tool calls structuredContent apps";
+    readonly summary: "Run sf mcp for the stdio On-Device MCP server in the local checkout.";
+    readonly keywords: readonly ["mcp", "stdio", "on-device", "local"];
+    readonly url: `${string}/agents#mcp`;
+    readonly body: "MCP on-device local CLI stdio sf mcp roots files workspace tool calls structuredContent apps";
 }, {
     readonly slug: "workflow/space-files";
     readonly title: "Space file conventions";
@@ -139,7 +143,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Spacefast recognizes _redirects, _headers, nearest 404.html, and sf.jsonc. Published artifacts are served as files; server code is not executed.";
     readonly keywords: readonly ["_redirects", "_headers", "sf.jsonc", "spacefast.jsonc", "404"];
-    readonly url: "https://spacefast.com/docs/configuration";
+    readonly url: `${string}/configuration`;
     readonly body: "_redirects _headers 404.html sf.jsonc artifact server code not executed proxy rewrite headers";
 }, {
     readonly slug: "workflow/domains-diagnostics";
@@ -148,7 +152,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Use domain diagnostics for attach, verification, DNS, nameserver, and rollback-safe recovery steps.";
     readonly keywords: readonly ["domain", "dns", "verification"];
-    readonly url: "https://spacefast.com/docs/domains";
+    readonly url: `${string}/domains`;
     readonly body: "domains DNS diagnostics attach verification nameservers custom domain certificate recovery instructions";
 }, {
     readonly slug: "workflow/logs-diagnostics";
@@ -157,17 +161,17 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Use access logs for traffic questions, runtime logs for serving diagnostics, and build logs for publish/finalize failures.";
     readonly keywords: readonly ["logs", "diagnostics", "build logs"];
-    readonly url: "https://spacefast.com/docs/builds#watch-and-manage-builds";
+    readonly url: `${string}/builds#watch-and-manage-builds`;
     readonly body: "logs access runtime build diagnostics publish finalize failures request id docsUrl suggestions recovery";
 }, {
     readonly slug: "workflow/agent-auth";
-    readonly title: "Agent accounts and OAuth";
+    readonly title: "Machine OAuth clients";
     readonly kind: "workflow";
     readonly tier: "full";
-    readonly summary: "Prefer OAuth agent accounts with private_key_jwt and SPACEFAST_AGENT_CONFIG for On-Device MCP and automation instead of broad shared API keys.";
-    readonly keywords: readonly ["oauth", "agent account", "private_key_jwt", "SPACEFAST_AGENT_CONFIG"];
-    readonly url: "https://spacefast.com/docs/agents#agent-accounts";
-    readonly body: "OAuth agent account private_key_jwt SPACEFAST_AGENT_CONFIG client credentials scoped token mcp automation teams";
+    readonly summary: "Use team-owned OAuth clients with private_key_jwt and SPACEFAST_AGENT_CONFIG for On-Device MCP and automation. Do not use broad shared API keys.";
+    readonly keywords: readonly ["oauth", "client credentials", "private_key_jwt", "SPACEFAST_AGENT_CONFIG"];
+    readonly url: `${string}/agents#agent-accounts`;
+    readonly body: "OAuth client private_key_jwt SPACEFAST_AGENT_CONFIG client credentials scoped token mcp automation teams";
 }, {
     readonly slug: "custom-domains";
     readonly title: "Custom domains";
@@ -175,7 +179,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Attach your own domain and let Spacefast manage TLS.";
     readonly keywords: readonly ["domain", "dns", "https", "tls", "certificate", "cname", "nameserver"];
-    readonly url: "https://spacefast.com/docs/domains";
+    readonly url: `${string}/domains`;
     readonly body: "Add a domain with `sf domains add`, point DNS at Spacefast, and a certificate is issued automatically. Inspect status with `sf domains check`.";
 }, {
     readonly slug: "configuration";
@@ -184,7 +188,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Ship space metadata and SPA settings alongside your files.";
     readonly keywords: readonly ["config", "sf.jsonc", "spacefast.jsonc", "metadata", "spa", "schema", "settings"];
-    readonly url: "https://spacefast.com/docs/configuration";
+    readonly url: `${string}/configuration`;
     readonly body: "Add `sf.jsonc` at your publish root so configuration travels with each version and rolls back with it. `sf init` scaffolds it with a `$schema` pointer for autocomplete.";
 }, {
     readonly slug: "environment-variables";
@@ -193,7 +197,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Set build-time configuration and secrets per space.";
     readonly keywords: readonly ["env", "environment", "secrets", "config", "variables", "dotenv"];
-    readonly url: "https://spacefast.com/docs/configuration";
+    readonly url: `${string}/configuration`;
     readonly body: "Manage a space's variables with `sf env set` / `sf env ls`, or import a dotenv file with `sf env import`. Secret values are masked in `--json` output.";
 }, {
     readonly slug: "access-control";
@@ -202,7 +206,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Create scoped Grants, invite People, and manage Links or credentials.";
     readonly keywords: readonly ["access", "share", "people", "links", "private", "team", "public"];
-    readonly url: "https://spacefast.com/docs/access";
+    readonly url: `${string}/access`;
     readonly body: "Use `sf share grant`, `sf share people`, `sf share link`, `sf share password`, or `sf share token`. Inspect one route with `sf share check`; every audience uses the same path, capability, target, and constraint evaluator.";
 }, {
     readonly slug: "redirects";
@@ -211,7 +215,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Declare redirect rules that travel with each version.";
     readonly keywords: readonly ["redirect", "rewrite", "routing", "301", "302", "_redirects"];
-    readonly url: "https://spacefast.com/docs/redirects";
+    readonly url: `${string}/redirects`;
     readonly body: "Add a `_redirects` file at your publish root to redirect, rewrite, or proxy; it compiles at finalize and rolls back with the version. Inspect resolution with `sf routing inspect`.";
 }, {
     readonly slug: "headers";
@@ -220,7 +224,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Attach supported response headers by path.";
     readonly keywords: readonly ["headers", "cache", "security", "_headers", "cors"];
-    readonly url: "https://spacefast.com/docs/headers";
+    readonly url: `${string}/headers`;
     readonly body: "Add a `_headers` file at your publish root to set or remove supported response headers per path.";
 }, {
     readonly slug: "builds";
@@ -229,7 +233,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Connect a repository so pushes build and publish automatically.";
     readonly keywords: readonly ["build", "git", "github", "ci", "push", "connect", "preview"];
-    readonly url: "https://spacefast.com/docs/builds";
+    readonly url: `${string}/builds`;
     readonly body: "Connect a repository with `sf git connect`; each push runs your build on Spacefast and publishes a version. Branch and pull-request previews are private by default; use Open for yourself or create a scoped Link for reviewers.";
 }, {
     readonly slug: "runtimes";
@@ -238,7 +242,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Run code on a space with Zero or Functions.";
     readonly keywords: readonly ["runtime", "zero", "functions", "server", "dynamic", "code", "backend", "sf.jsonc"];
-    readonly url: "https://spacefast.com/docs/runtimes";
+    readonly url: `${string}/runtimes`;
     readonly body: "A space serves published files until you declare a `runtime` block in sf.jsonc. Every space has its own runtime site. Zero is a capsule with its own database and transactions; Functions is a Cloudflare worker with one `fetch` handler and any npm package. Both are available on every plan and compile during `sf publish`.";
 }, {
     readonly slug: "runtimes/zero";
@@ -247,7 +251,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "A capsule with a database: schema, queries, mutations, endpoints.";
     readonly keywords: readonly ["zero", "capsule", "database", "schema", "query", "mutation", "endpoint", "transaction", "sql", "sf dev"];
-    readonly url: "https://spacefast.com/docs/runtimes/zero";
+    readonly url: `${string}/zero-runtime`;
     readonly body: "Zero is for apps where the data is the point. Write one capsule — schema, queries, mutations, endpoints — start it locally with `sf dev`, and `sf publish` puts it live with its own database and dedicated runtime site on every plan.";
 }, {
     readonly slug: "runtimes/functions";
@@ -256,7 +260,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "A worker for your space: one `fetch` handler, any npm package.";
     readonly keywords: readonly ["functions", "worker", "fetch", "ssr", "cloudflare", "npm", "handler", "server", "api"];
-    readonly url: "https://spacefast.com/docs/runtimes/functions";
+    readonly url: `${string}/runtimes/functions`;
     readonly body: "Functions runs a Cloudflare worker for your space: a default export with a `fetch` method, served from your space's own origin, so requests no file answers reach your code. It is available on every plan. Opt into a database with `\"database\": true`. Automatic Next.js builds use a private, version-scoped origin cache for the Data Cache, `revalidateTag()`, `revalidatePath()`, and ISR regeneration leases; no cache credential enters the worker.";
 }, {
     readonly slug: "collab";
@@ -265,7 +269,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Leave comments directly on a space.";
     readonly keywords: readonly ["comments", "collaboration", "feedback"];
-    readonly url: "https://spacefast.com/docs/collab";
+    readonly url: `${string}/collab`;
     readonly body: "Leave comments directly on a live space and archive them from the dashboard or with `sf comments`.";
 }, {
     readonly slug: "analytics";
@@ -274,7 +278,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "See traffic and visitor counts for a space.";
     readonly keywords: readonly ["analytics", "traffic", "visitors", "stats", "metrics", "pageviews"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "Inspect a space's traffic with `sf analytics`; history depth and granularity depend on the team's plan.";
 }, {
     readonly slug: "proxy-routes";
@@ -283,7 +287,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "reference";
     readonly summary: "Proxy selected paths to an upstream origin.";
     readonly keywords: readonly ["proxy", "upstream", "route", "api", "backend", "rewrite"];
-    readonly url: "https://spacefast.com/docs/proxy-routes";
+    readonly url: `${string}/proxy-routes`;
     readonly body: "Forward specific path prefixes to an external upstream so a space can front an external API without exposing its origin.";
 }, {
     readonly slug: "image-acceleration";
@@ -292,7 +296,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "reference";
     readonly summary: "Serve optimized, resized images from your space.";
     readonly keywords: readonly ["image", "images", "optimization", "resize", "cdn", "acceleration"];
-    readonly url: "https://spacefast.com/docs/image-acceleration";
+    readonly url: `${string}/image-acceleration`;
     readonly body: "Spacefast can resize and re-encode images on the fly so you ship one source asset and serve device-appropriate variants.";
 }, {
     readonly slug: "integrations/nextjs";
@@ -301,8 +305,8 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "reference";
     readonly summary: "Build and publish a full Next.js app with OpenNext.";
     readonly keywords: readonly ["nextjs", "next", "react", "framework", "integration", "opennext", "isr", "data cache", "revalidateTag", "revalidatePath"];
-    readonly url: "https://spacefast.com/docs/integrations/nextjs";
-    readonly body: "Run `sf publish` in a Next.js project. Spacefast builds it with pinned OpenNext and publishes the browser assets plus its Functions worker. The automatic adapter keeps the Next Data Cache and tag invalidations in private origin storage scoped to the exact space and version, so cached data survives cold Worker isolates; `revalidateTag()` and `revalidatePath()` invalidate that same store. Concurrent stale ISR requests share a 30-second regeneration lease, with at most 4,096 leases active for one version. Each cached value is limited to 4 MiB; one version may retain 128 MiB, 4,096 entries, and 8,192 tags. A project with its own `open-next.config.ts` owns its adapters instead of receiving Spacefast's automatic cache config.";
+    readonly url: `${string}/integrations/nextjs`;
+    readonly body: "Run `sf publish` in a Next.js project. Spacefast reads the resolved build mode from Next itself: `output: \"export\"` ships the generated browser files directly, while server-rendered apps are bundled with pinned OpenNext and publish their browser assets plus a Functions worker. The automatic adapter keeps the Next Data Cache and tag invalidations in private origin storage scoped to the exact space and version, so cached data survives cold Worker isolates; `revalidateTag()` and `revalidatePath()` invalidate that same store. Concurrent stale ISR requests share a 30-second regeneration lease, with at most 4,096 leases active for one version. Each cached value is limited to 4 MiB; one version may retain 128 MiB, 4,096 entries, and 8,192 tags. A project with its own `open-next.config.ts` owns its adapters instead of receiving Spacefast's automatic cache config.";
 }, {
     readonly slug: "integrations/vite";
     readonly title: "Vite integration";
@@ -310,7 +314,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "reference";
     readonly summary: "Publish a Vite build to a space.";
     readonly keywords: readonly ["vite", "react", "vue", "svelte", "framework", "integration", "build"];
-    readonly url: "https://spacefast.com/docs/integrations/vite";
+    readonly url: `${string}/integrations/vite`;
     readonly body: "Run your Vite build and publish `dist/` with `sf publish`; `sf init` detects Vite and preconfigures the output directory.";
 }, {
     readonly slug: "limits";
@@ -319,7 +323,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "reference";
     readonly summary: "File counts, sizes, and rate limits per plan.";
     readonly keywords: readonly ["limits", "quota", "size", "rate limit", "plan", "storage"];
-    readonly url: "https://spacefast.com/docs/limits";
+    readonly url: `${string}/account/plans`;
     readonly body: "Reference for per-space file counts, archive and file size ceilings, and rate limits, which vary by plan.";
 }, {
     readonly slug: "troubleshooting";
@@ -328,7 +332,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "reference";
     readonly summary: "Diagnose failed publishes, builds, and domains.";
     readonly keywords: readonly ["troubleshoot", "debug", "error", "doctor", "diagnose", "fix"];
-    readonly url: "https://spacefast.com/docs/troubleshooting";
+    readonly url: `${string}/troubleshooting`;
     readonly body: "Common publish, build, and domain failures and how to resolve them. Run `sf doctor` to check your local setup and auth state.";
 }, {
     readonly slug: "migrate-from";
@@ -337,7 +341,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "reference";
     readonly summary: "Move from Netlify, Vercel, and other hosts.";
     readonly keywords: readonly ["migrate", "netlify", "vercel", "cloudflare", "github pages", "here.now", "import"];
-    readonly url: "https://spacefast.com/docs/migrate-from";
+    readonly url: `${string}/migrate-from`;
     readonly body: "Step-by-step migrations that map another host's build output, redirects, and headers onto a Spacefast space.";
 }, {
     readonly slug: "cli";
@@ -346,7 +350,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "essential";
     readonly summary: "Install, authenticate, and the first-publish command path.";
     readonly keywords: readonly ["cli", "sf", "command", "install", "overview", "help"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "Run `sf help` for the essential commands, `sf help --full` for everything. The CLI emits a `{ data }` / `{ error }` JSON envelope under `--json`.";
 }, {
     readonly slug: "cli/publish";
@@ -355,7 +359,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "essential";
     readonly summary: "Build, upload, and take the current output live on a space.";
     readonly keywords: readonly ["publish", "sf publish", "go live", "upload", "release"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf publish [DIR]` snapshots a directory into an immutable version and promotes it to the production channel. Add `--no-wait` to return before serving finishes.";
 }, {
     readonly slug: "login";
@@ -364,7 +368,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "essential";
     readonly summary: "Authenticate the CLI with your Spacefast account.";
     readonly keywords: readonly ["login", "auth", "authenticate", "token", "device", "signin"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf login` starts the device-authorization flow; for non-interactive use pass `--token` or set `SPACEFAST_TOKEN`.";
 }, {
     readonly slug: "init";
@@ -373,7 +377,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "essential";
     readonly summary: "Scaffold an sf.jsonc config in the current directory.";
     readonly keywords: readonly ["init", "config", "scaffold", "sf.jsonc", "setup"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf init` detects your framework and writes a starter `sf.jsonc` so subsequent `sf publish` runs are zero-config.";
 }, {
     readonly slug: "claim";
@@ -382,7 +386,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "essential";
     readonly summary: "Attach an anonymously-published space to your account.";
     readonly keywords: readonly ["claim", "anonymous", "attach", "token", "adopt", "spaces"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "After an agent publishes anonymously, run `sf spaces claim` with the space key to bind the space to your account.";
 }, {
     readonly slug: "cli/spaces";
@@ -391,7 +395,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "List, inspect, download, duplicate, transfer, and remove spaces.";
     readonly keywords: readonly ["spaces", "space", "ls", "get", "download", "duplicate", "rm", "transfer"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "The `sf spaces` group manages spaces: `ls`, `get`, `claim`, `download`, `duplicate`, `transfer`, and `rm`. Use `sf spaces download --version <ref>` to retrieve one immutable version.";
 }, {
     readonly slug: "cli/versions";
@@ -400,7 +404,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "List, inspect, and remove immutable versions.";
     readonly keywords: readonly ["versions", "version", "ls", "get", "rm", "rollback", "history"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf versions ls` shows a space's history; `sf versions get` inspects one and `sf rollback` promotes an earlier version back to live.";
 }, {
     readonly slug: "cli/channels";
@@ -409,7 +413,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "List channels and see which version each points at.";
     readonly keywords: readonly ["channels", "channel", "promote", "production", "preview", "history"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf channels ls` lists a space's channels and their current version; `sf channels history` shows past pointer moves. Move a channel with `sf promote`.";
 }, {
     readonly slug: "cli/domains";
@@ -418,7 +422,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Add, check, and manage custom domains and DNS.";
     readonly keywords: readonly ["domains", "domain", "dns", "add", "check", "nameservers", "diagnostics"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "The `sf domains` group covers `add`, `check`, `diagnostics`, `ls`, `rm`, and a full `dns` subtree for managing records and nameservers.";
 }, {
     readonly slug: "cli/env";
@@ -427,7 +431,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Set, list, import, and pull a space's variables.";
     readonly keywords: readonly ["env", "environment", "variables", "secrets", "set", "import", "pull"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf env set` / `sf env ls` manage a space's variables; `sf env import` loads a dotenv file and `sf env pull` writes them back out.";
 }, {
     readonly slug: "cli/builds";
@@ -436,7 +440,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "List, inspect, and retry cloud builds.";
     readonly keywords: readonly ["builds", "build", "ls", "logs", "retry", "cancel", "ci"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf builds ls` lists cloud builds; `sf builds logs`, `sf builds retry`, and `sf builds cancel` operate on a single build.";
 }, {
     readonly slug: "cli/git";
@@ -445,7 +449,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Connect a repository for push-to-publish builds.";
     readonly keywords: readonly ["git", "github", "connect", "repository", "ci", "sync", "disconnect"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf git connect` links a repository so pushes build and publish automatically; `sf git ls`, `sf git sync`, and `sf git disconnect` manage the connection.";
 }, {
     readonly slug: "cli/access";
@@ -454,7 +458,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Emergency visitor-session revocation.";
     readonly keywords: readonly ["access", "sessions", "revoke", "logout"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "Use `sf access logout-all` to revoke every opened visitor session. Define audience-specific network restrictions on the corresponding Grant.";
 }, {
     readonly slug: "cli/teams";
@@ -463,16 +467,16 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Create teams, invite members, and switch context.";
     readonly keywords: readonly ["teams", "team", "members", "invitations", "switch", "create"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf teams create` makes a team, `sf teams invitations add` invites people, `sf teams members ls` lists them, and `sf teams switch` sets the active team.";
 }, {
     readonly slug: "cli/api-keys";
     readonly title: "sf api-keys";
     readonly kind: "cli";
     readonly tier: "full";
-    readonly summary: "Create and revoke API keys for the platform API.";
+    readonly summary: "Create and revoke API keys for the Spacefast API.";
     readonly keywords: readonly ["api-keys", "api key", "token", "create", "revoke", "list", "credential"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf api-keys create` mints a bearer key (shown once, masked in `--json`); `sf api-keys list` and `sf api-keys revoke` manage existing keys.";
 }, {
     readonly slug: "cli/analytics";
@@ -481,7 +485,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Print traffic and visitor counts for a space.";
     readonly keywords: readonly ["analytics", "traffic", "visitors", "stats", "metrics"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf analytics` reports a space's traffic; history depth and granularity depend on the team's plan.";
 }, {
     readonly slug: "cli/api";
@@ -490,7 +494,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Call the core public API through a safe escape hatch.";
     readonly keywords: readonly ["api", "sf api", "http", "raw", "request", "curl", "endpoint"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf api <METHOD> /v1/...` calls only the core public contract with resolved CLI credentials. JSON envelopes print verbatim; cursor lists support `--paginate`, and non-JSON bodies require `--output` or `--raw-stdout`.";
 }, {
     readonly slug: "cli/mcp";
@@ -499,7 +503,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Run and install the Spacefast MCP server.";
     readonly keywords: readonly ["mcp", "model context protocol", "agent", "install", "server", "tools"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf mcp` runs the MCP server so an AI assistant can call Spacefast tools; `sf mcp install` wires it into a supported client's config.";
 }, {
     readonly slug: "cli/docs";
@@ -508,7 +512,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Search the offline documentation index from the CLI.";
     readonly keywords: readonly ["docs", "search", "help", "reference", "offline", "topic"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "`sf docs` lists documentation topics and `sf docs <topic>` prints a page. The index ships with the CLI and mirrors the machine-readable `GET /v1/docs` API.";
 }, {
     readonly slug: "json-output";
@@ -517,17 +521,17 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Machine-readable envelopes and stable exit codes for scripts.";
     readonly keywords: readonly ["json", "exit code", "scripting", "envelope", "automation", "ci", "agent"];
-    readonly url: "https://spacefast.com/docs/cli";
+    readonly url: `${string}/cli`;
     readonly body: "Pass `--json` for a `{ data }` success or `{ error }` failure envelope on stdout/stderr. Exit codes are stable so scripts and agents can branch on them.";
 }, {
     readonly slug: "api";
-    readonly title: "Platform API overview";
+    readonly title: "API overview";
     readonly kind: "api";
     readonly tier: "full";
-    readonly summary: "Authenticate and call the Spacefast platform API.";
-    readonly keywords: readonly ["api", "rest", "http", "platform", "endpoint", "openapi", "bearer"];
-    readonly url: "https://spacefast.com/docs/api";
-    readonly body: "The platform API uses bearer API keys and returns the same `{ data }` / `{ error }` envelope as the CLI. Create a key with `sf api-keys create`.";
+    readonly summary: "Authenticate and call the Spacefast API.";
+    readonly keywords: readonly ["api", "rest", "http", "spacefast", "endpoint", "openapi", "bearer"];
+    readonly url: `${string}/api`;
+    readonly body: "The Spacefast API uses bearer API keys and returns the same `{ data }` / `{ error }` envelope as the CLI. Create a key with `sf api-keys create`.";
 }, {
     readonly slug: "api/publish";
     readonly title: "Publish API";
@@ -535,7 +539,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Publish a version in a single authenticated request.";
     readonly keywords: readonly ["api", "publish", "upload", "version", "archive", "http"];
-    readonly url: "https://spacefast.com/docs/api";
+    readonly url: `${string}/api`;
     readonly body: "Send your files in one authenticated publish request to create an immutable version and take it live; the response carries the space and live URL.";
 }, {
     readonly slug: "api/spaces";
@@ -544,7 +548,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "Create, list, and update spaces over HTTP.";
     readonly keywords: readonly ["api", "spaces", "space", "create", "list", "endpoint"];
-    readonly url: "https://spacefast.com/docs/api";
+    readonly url: `${string}/api`;
     readonly body: "`GET /v1/spaces` lists spaces; `POST /v1/spaces` creates one. `PATCH /v1/spaces/{spaceId}` with a slug-only body renames the space and managed hostname. Former managed addresses temporarily 307 to the current hostname while immutable version URLs stay unchanged. Responses carry the space id, slug, and live URL.";
 }, {
     readonly slug: "api/versions";
@@ -553,7 +557,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "full";
     readonly summary: "List versions and promote them to channels over HTTP.";
     readonly keywords: readonly ["api", "versions", "publish", "channel", "promote", "rollback"];
-    readonly url: "https://spacefast.com/docs/api";
+    readonly url: `${string}/api`;
     readonly body: "List a space's versions, then promote one to a channel to move traffic. Rolling back is promoting an earlier version.";
 }, {
     readonly slug: "api/domains";
@@ -562,8 +566,8 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "reference";
     readonly summary: "Attach and inspect custom domains over HTTP.";
     readonly keywords: readonly ["api", "domains", "domain", "dns", "certificate", "endpoint"];
-    readonly url: "https://spacefast.com/docs/api";
-    readonly body: "Add a custom domain, read its verification and certificate status, and manage DNS records through the platform API.";
+    readonly url: `${string}/api`;
+    readonly body: "Add a custom domain, read its verification and certificate status, and manage DNS records through the Spacefast API.";
 }, {
     readonly slug: "api/teams";
     readonly title: "Teams API";
@@ -571,7 +575,7 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "reference";
     readonly summary: "Manage teams, members, and invitations over HTTP.";
     readonly keywords: readonly ["api", "teams", "team", "members", "invitations", "endpoint"];
-    readonly url: "https://spacefast.com/docs/api";
+    readonly url: `${string}/api`;
     readonly body: "Create teams, list members, and manage invitations programmatically. Webhooks and API keys are team-scoped.";
 }, {
     readonly slug: "api/docs";
@@ -580,8 +584,8 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "reference";
     readonly summary: "Fetch the machine-readable documentation index.";
     readonly keywords: readonly ["api", "docs", "index", "discovery", "machine-readable", "v1/docs"];
-    readonly url: "https://spacefast.com/docs/api";
-    readonly body: "`GET /v1/docs` returns the tier-aware docs index (filter with `q` and `category`); `GET /v1/docs/{slug}` returns one page. It mirrors the CLI's offline `sf docs`.";
+    readonly url: `${string}/api`;
+    readonly body: "`GET /v1/docs` returns the tier-aware docs index (filter with `q` and `category`); `GET /v1/docs/pages/{slug}` returns one page. It mirrors the CLI's offline `sf docs`.";
 }, {
     readonly slug: "api/webhooks";
     readonly title: "Webhooks";
@@ -589,15 +593,69 @@ export declare const DOCS_CATALOG: readonly [{
     readonly tier: "reference";
     readonly summary: "Subscribe to version, build, and domain lifecycle events.";
     readonly keywords: readonly ["api", "webhook", "events", "callback", "notifications", "build", "signature"];
-    readonly url: "https://spacefast.com/docs/webhooks";
+    readonly url: `${string}/webhooks`;
     readonly body: "Register a team-scoped, signed webhook to receive version, build, domain, and transfer events. Verify the signature header before trusting a payload.";
 }, {
-    readonly slug: "api/platform";
-    readonly title: "Platform (tenant) API";
+    readonly slug: "sdk";
+    readonly title: "TypeScript SDK (@spacefast/sdk)";
+    readonly kind: "api";
+    readonly tier: "essential";
+    readonly summary: "The typed client for the API, generated from the OpenAPI spec.";
+    readonly keywords: readonly ["sdk", "typescript", "javascript", "client", "npm", "library", "types", "tanstack", "react-query", "node"];
+    readonly url: `${string}/sdk`;
+    readonly body: "`npm install @spacefast/sdk`, then `createSpacefastClient({ baseUrl: 'https://api.spacefast.com', apiKey })`. Paths, parameters, and responses are all typed from the same OpenAPI spec the API serves: `client.get('/v1/spaces/{spaceId}', { path: { spaceId } })` returns the space. Failures throw `SpacefastApiError` carrying the problem document (`status`, `code`, `pointer`, `next`, `requestId`). Subpaths: `/schema` for raw types, `/query` for TanStack Query factories (browser, cookie-authenticated), `/transport` for the HTTP core, `/publish` for the publish pipeline, `/openapi.json` for your own codegen.";
+}, {
+    readonly slug: "api/partner";
+    readonly title: "Partner (tenant) API";
+    readonly kind: "api";
+    readonly tier: "reference";
+    readonly summary: "The tenant-facing partner API for running Spacefast as infra.";
+    readonly keywords: readonly ["api", "partner", "tenant", "infra", "openapi", "multi-tenant", "white label"];
+    readonly url: `${string}/partners`;
+    readonly body: `There is no partner route tree. Partners call the same \`/v1\` routes as everyone else: successes carry a \`{ data }\` envelope and failures are RFC 9457 problem documents (\`application/problem+json\` with a stable \`code\`), exactly as elsewhere in the API. A tenant-rooted credential's policy scope and response projection decide what it sees. "Partner" is a spec visibility tier: those operations, plus tenants and principals, are published as a second OpenAPI document at ${string}/openapi.partner.json, rendered at ${string}. Point \`openapi-typescript\` at that document for types. Configuration is not a set of endpoints: a tenant declares its integration in one designated space's published manifest (see \`partner/system-space\`).`;
+}, {
+    readonly slug: "partner/onboarding";
+    readonly title: "Partner onboarding";
+    readonly kind: "api";
+    readonly tier: "reference";
+    readonly summary: "Bootstrap a tenant: one key, one space, one designation, one publish.";
+    readonly keywords: readonly ["partner", "onboarding", "tenant", "bootstrap", "partner_admin", "api key", "setup"];
+    readonly url: `${string}/partners#onboarding`;
+    readonly body: "Tenant creation is superadmin-side and mints one bootstrap tenant-rooted API key with the `partner_admin` preset (`tenants:*`, `principals:read`, and space/domain/publish actions over the tenant). From there it is four steps you drive yourself: create a space with that key, `PATCH /v1/tenants/{tenantId}` with `systemSpaceId` to designate it, publish the manifest, then read `manifestStatus` on `GET /v1/tenants/{tenantId}` to watch each declared item converge. Mint further keys through the normal API-key routes — every one is bounded to a subset of its grantor's policy.";
+}, {
+    readonly slug: "partner/system-space";
+    readonly title: "The system space";
+    readonly kind: "api";
+    readonly tier: "reference";
+    readonly summary: "Your integration is a published space, so config versions and rolls back.";
+    readonly keywords: readonly ["partner", "system space", "manifest", "sf.jsonc", "systemSpaceId", "manifestStatus", "gitops", "reconciliation", "white label"];
+    readonly url: `${string}/partners#system-space`;
+    readonly body: "A tenant designates one ordinary space as its system space, and that space's live version *is* the integration definition: a top-level `system` section in `sf.jsonc` (presentation, hostname apex, API origin, token issuers, event subscriptions) plus `_pages/` and `theme.json` as the defaults layer. One config language, one validation pipeline, one publish flow — and `sf rollback` rolls back your configuration with it. Finalize, promote, and rollback all reconcile declared state against current state. Presentation, pages, theme, and subscriptions apply immediately; hostnames, API origins, and token issuers enter `pending` until their DNS, TLS, or key-possession check passes. Dropping an item from the manifest deactivates it. Per-item state lands in `manifestStatus` (`{ key, state, detail, since }` plus the source version id) on `GET /v1/tenants/{tenantId}`. There are no imperative config routes: the fix for a failed item is a new publish. Secrets are never declared — webhook secrets and API keys are minted by their own routes.";
+}, {
+    readonly slug: "partner/tokens";
+    readonly title: "Partner tokens";
+    readonly kind: "api";
+    readonly tier: "reference";
+    readonly summary: "Let your own auth system mint tokens Spacefast verifies directly.";
+    readonly keywords: readonly ["partner", "token", "jwt", "issuer", "eddsa", "ed25519", "auth", "partner_token", "audience", "revocation"];
+    readonly url: `${string}/partners#tokens`;
+    readonly body: "Your customers never need a Spacefast credential: your auth system mints standard JWT access tokens and Spacefast verifies them. Declare the issuer in the system-space manifest with its pinned Ed25519 public keys — there is no issuer CRUD. The first publish returns `state: pending` with a challenge nonce in `manifestStatus`; sign it with the declared key and republish with the `proof` field, and the issuer activates. Proof of key possession lives in your repo next to the declaration. The token profile is strict: `typ` of `at+jwt`, `alg` of `EdDSA` only, the per-issuer minted `aud` (never a shared value), all of `iss`/`sub`/`client_id`/`jti`/`iat`/`exp` required, `exp - iat` at most 30 minutes, 300s clock skew; embedded or fetched keys are rejected. A verified token becomes a `partner_token` credential bound to one external principal, carrying a fixed least-privilege policy: publish, read, versions, and variables over that principal's subtree — never tenant or principal management. Revoke by removing the issuer or rotating its keys; worst-case acceptance of a revoked token is the shorter of a 30s cache TTL and the token's own expiry.";
+}, {
+    readonly slug: "partner/principals";
+    readonly title: "Principals and ownership";
+    readonly kind: "api";
+    readonly tier: "reference";
+    readonly summary: "External principals are your customer directory; spaces have exactly one owner.";
+    readonly keywords: readonly ["partner", "principals", "external", "tenant", "ownership", "iam", "policy", "scope", "variables"];
+    readonly url: `${string}/partners#principals`;
+    readonly body: "Your customers are external principals inside your tenant. `GET /v1/principals` lists them within the caller's granted scope (a tenant-rooted key sees the whole tenant) and `GET /v1/principals/external/{principalId}` reads one. There is no create route: a principal is upserted implicitly in the same transaction as its first owned resource, and its identity is the normalized id — the display casing you first sent is preserved but never authoritative. Every space has exactly one owner: a team, an external principal, or an open claim token. IAM actions stay generic nouns (`tenants:read`, `tenants:write`, `principals:read`) rather than a `partner:*` namespace, evaluated per route like every other action, so a partner credential's reach is a policy fact and not a router branch. Per-principal environment variables live under `/v1/principals/{principalType}/{principalId}/variables`.";
+}, {
+    readonly slug: "partner/events";
+    readonly title: "Partner events and notifications";
     readonly kind: "api";
     readonly tier: "reference";
-    readonly summary: "The tenant-facing platform API for running Spacefast as infra.";
-    readonly keywords: readonly ["api", "platform", "tenant", "infra", "openapi", "multi-tenant"];
-    readonly url: "https://spacefast.com/docs/platforms";
-    readonly body: "The platform API is the tenant-facing surface for operating Spacefast as hosting infra. It shares the `{ data }` / `{ error }` envelope and is documented via OpenAPI.";
+    readonly summary: "Tenant-owned webhooks, declared in the manifest — including customer email.";
+    readonly keywords: readonly ["partner", "events", "webhook", "subscriptions", "notifications", "email", "signature", "hmac"];
+    readonly url: `${string}/partners#events`;
+    readonly body: "Webhooks are the one event primitive, and their ownership generalizes from teams to tenants. Declare subscriptions in the system-space manifest (`url` plus an `events` selection) and reconciliation creates, updates, or disables the rows; delivery uses the same `Spacefast-Signature` HMAC and dual-secret rotation as team webhooks, so verify the signature before trusting a payload. Email white-labeling is not a separate endpoint: subscribe to `principal.notification.*` events (claim link issued, security notice, publish receipt) and send them yourself in your own voice. For a partner tenant these events replace Spacefast-sent email to your customers — no active subscription means no send, and Spacefast never falls back to sending as itself to someone else's customer.";
 }, ...DocEntry[]];