@spacefast/common 0.0.24 → 0.2.1

package/dist/vocabulary.js

@@ -5,27 +5,31 @@
 // dashboard label, or "E2B" in marketing copy).
 //
 // This module is intentionally pure data + types: no side effects, no imports.
-// It is additive — wiring consumers (CLI, MCP, dashboard, docs generators) onto
+// It is additive. Wiring consumers (CLI, MCP, dashboard, docs generators) onto
 // it happens in later chunks. The decisions encoded here are LOCKED:
 //
-//   - `space` is the primitive noun everywhere, user surfaces and platform API
+//   - `space` is the primitive noun everywhere, user surfaces and the Spacefast API
 //     alike. A space IS a site: there is no second host entity to name. `site`
-//     survives only as WP.Cloud's own word for the box, in operator surfaces
+//     survives only as WP Cloud's own word for the box, in operator surfaces
 //     and the warm-pool inventory.
 //   - `publish` is the verb. AMENDED 2026-07-02: `deploy` / `deployments` are
-//     first-class ALIASES of `publish` / `versions` (see DEPLOY_ALIASES) — they
+//     first-class ALIASES of `publish` / `versions` (see DEPLOY_ALIASES). They
 //     stay listed and documented, always with the sanctioned disambiguation
 //     line (DEPLOY_ALIAS_DISAMBIGUATION) and with the canonical command named
 //     first. A bare "deployment" noun in fresh prose is still discouraged (say
 //     "version"), and the `dep_*` id framing stays retired.
 //   - `version` / `channel` / `build` are the lifecycle nouns.
-//   - `API key` — never "access token".
+//   - `API key`, never "access token".
 //   - `Collab` is the feature; `comment` is the unit.
 //   - `Superpowers` is the page-enhancement feature.
-//   - Provider names never leak externally: never "E2B" (say "Spacefast
-//     Builds" / "Spacefast CI"), never "WP.Cloud" (say "infra", except the
-//     platform API or the fixed phrase "built on WP.Cloud"), never
-//     "code.storage" / "Pierre" (see PROVIDER_HYGIENE).
+//   - Provider names stay off public surfaces by default: never "E2B" (say
+//     "Spacefast Builds" / "Spacefast CI"), never "code.storage" / "Pierre".
+//     The infra brand is "WP Cloud", never "WP.Cloud"/"wp-cloud" (AMENDED
+//     2026-08-13). Prefer "infra"; when an external reference is genuinely
+//     necessary (provider identity fields, domain conflicts), name WP Cloud
+//     outright, NEVER the euphemism "the hosting provider". Marketing may use
+//     the family line "the same infra as Automattic, WP Cloud, Pressable, and
+//     WordPress.com" (see PROVIDER_HYGIENE).
 export const CONCEPTS = {
     space: {
         id: "space",
@@ -33,7 +37,7 @@ export const CONCEPTS = {
         aliases: [],
         externalTerms: [],
         deprecated: ["project", "site"],
-        description: "The primitive noun everywhere, user surfaces and platform API alike. A " +
+        description: "The primitive noun everywhere, user surfaces and the Spacefast API alike. A " +
             "space IS a site, so 'site' names nothing of ours; 'project' is never " +
             "the primitive.",
     },
@@ -102,10 +106,11 @@ export const CONCEPTS = {
         id: "infra",
         canonicalNoun: "infra",
         aliases: ["infrastructure"],
-        externalTerms: ["WP.Cloud"],
-        deprecated: ["code.storage", "Pierre"],
-        description: "The hosting substrate. Say 'infra' externally; 'WP.Cloud' only in the " +
-            "platform API or the phrase 'built on WP.Cloud'. Never 'code.storage'/'Pierre'.",
+        externalTerms: ["WP Cloud"],
+        deprecated: ["code.storage", "Pierre", "the hosting provider"],
+        description: "The hosting substrate. Prefer 'infra'; when an external reference is " +
+            "necessary, name 'WP Cloud' (its real spelling), never the euphemism " +
+            "'the hosting provider'. Never 'code.storage'/'Pierre'.",
     },
 };
 export const EXTERNAL_TERM_ALLOWLIST = [
@@ -114,7 +119,7 @@ export const EXTERNAL_TERM_ALLOWLIST = [
         concept: "publish",
         allowedContexts: ["github-integration", "platform-api"],
         replacement: "version / publish",
-        reason: "GitHub speaks 'deployment'; the platform API keeps it for contract " +
+        reason: "GitHub speaks 'deployment'; the Spacefast API keeps it for contract " +
             "stability. Elsewhere it is a sanctioned alias of 'version' when paired " +
             "with DEPLOY_ALIAS_DISAMBIGUATION (see DEPLOY_ALIASES); bare fresh prose " +
             "still says 'publish a version'.",
@@ -133,18 +138,29 @@ export const EXTERNAL_TERM_ALLOWLIST = [
         concept: "space",
         allowedContexts: ["operator"],
         replacement: "space",
-        reason: "A space IS a site, so 'site' is no longer a Spacefast noun — it is only " +
-            "WP.Cloud's word for the box, which operator surfaces and warm-pool " +
+        reason: "A space IS a site, so 'site' is no longer a Spacefast noun. It is only " +
+            "WP Cloud's word for the box, which operator surfaces and warm-pool " +
             "inventory may use. Every customer-facing surface says 'space'.",
     },
     {
-        term: "WP.Cloud",
+        term: "WP Cloud",
         concept: "infra",
-        allowedContexts: ["platform-api", "fixed-phrase"],
-        allowedPhrases: ["built on WP.Cloud"],
+        allowedContexts: ["fixed-phrase"],
+        allowedPhrases: [
+            "the same infra as Automattic, WP Cloud, Pressable, and WordPress.com",
+            // The product-positioning line every agent-facing surface leads with
+            // (`SPACEFAST_POSITIONING` in brand.ts). Same licence as the family
+            // line above: WP Cloud is named as one of several sibling platforms,
+            // never as "the hosting provider" and never on its own.
+            "the same infrastructure as WordPress.com, Tumblr, WordPress VIP and WP Cloud",
+        ],
         replacement: "infra",
-        reason: "Only the platform API or the exact phrase 'built on WP.Cloud' may name " +
-            "the provider; general copy says 'infra'.",
+        reason: "AMENDED 2026-08-13: prefer 'infra'. Same day: the platform-api " +
+            "carve-out is revoked. API values say mysql/phpmyadmin/infra, never " +
+            "wpcloud. Name WP Cloud (its real spelling, never 'WP.Cloud') only " +
+            "where the external reference is necessary: domain-conflict copy and " +
+            "the marketing family line in allowedPhrases. Never the euphemism " +
+            "'the hosting provider'.",
     },
 ];
 export const DEPLOY_ALIASES = [
@@ -167,12 +183,21 @@ export const PROVIDER_HYGIENE = {
         reason: "The build sandbox vendor is never named; it is 'Spacefast Builds'.",
     },
     wpcloud: {
-        internalName: "WP.Cloud",
+        internalName: "WP Cloud",
         replacement: "infra",
-        allowedContexts: ["platform-api", "fixed-phrase"],
-        allowedPhrases: ["built on WP.Cloud"],
-        reason: "Hosting substrate; externally 'infra' except the platform API or the " +
-            "phrase 'built on WP.Cloud'.",
+        allowedContexts: ["fixed-phrase"],
+        allowedPhrases: [
+            "the same infra as Automattic, WP Cloud, Pressable, and WordPress.com",
+            // The product-positioning line every agent-facing surface leads with
+            // (`SPACEFAST_POSITIONING` in brand.ts). Same licence as the family
+            // line above: WP Cloud is named as one of several sibling platforms,
+            // never as "the hosting provider" and never on its own.
+            "the same infrastructure as WordPress.com, Tumblr, WordPress VIP and WP Cloud",
+        ],
+        reason: "Hosting substrate; prefer 'infra' (AMENDED 2026-08-13, same day: the " +
+            "platform-api carve-out is revoked. API values say mysql/phpmyadmin/" +
+            "infra, never wpcloud). Necessary external references name WP Cloud " +
+            "outright, never 'the hosting provider'.",
     },
     codeStorage: {
         internalName: "code.storage",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spacefast/common",
-  "version": "0.0.24",
+  "version": "0.2.1",
   "license": "MIT",
   "description": "Shared TypeScript contracts and utilities for Spacefast packages.",
   "repository": {
@@ -20,22 +20,6 @@
     "brand-assets",
     "dist"
   ],
-  "spacefastTestCache": {
-    "mode": "hermetic",
-    "inputs": [
-      "../../apps/www/dist/.well-known/agent-card.json",
-      "../../apps/www/dist/ai.txt",
-      "../../apps/www/dist/llms-full.txt",
-      "../../apps/www/dist/llms.txt",
-      "../cli/skill.template.md",
-      "../cli/skill.references.template.md",
-      "../cli/scripts/generate-skill.mjs",
-      "../../e2e-tests/fixtures/zero-all-features/api-finalize-request.json",
-      "../../e2e-tests/fixtures/zero-all-features/runtime-compiler-finalize-input.json",
-      "../../runtime/engine/shared/fonts",
-      "src/docs/agent-prose.ts"
-    ]
-  },
   "exports": {
     "./brand": {
       "types": "./dist/brand.d.ts",
@@ -52,6 +36,11 @@
       "import": "./dist/brand-assets-build.js",
       "default": "./dist/brand-assets-build.js"
     },
+    "./og-template": {
+      "types": "./dist/og-template.d.ts",
+      "import": "./dist/og-template.js",
+      "default": "./dist/og-template.js"
+    },
     "./brand-assets/spacefast-wordmark.svg": "./brand-assets/spacefast-wordmark.svg",
     "./brand-assets/spacefast-sf-full-bleed.svg": "./brand-assets/spacefast-sf-full-bleed.svg",
     "./brand-assets/spacefast-favicon.svg": "./brand-assets/spacefast-favicon.svg",
@@ -112,12 +101,20 @@
     }
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.101.4",
     "culori": "^4.0.2",
     "js-yaml": "^4.1.1",
     "mime": "^4.1.0",
+    "oauth4webapi": "3.8.7",
     "parse5": "^7.3.0",
     "smol-toml": "^1.7.0",
     "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.101.4"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-query": {
+      "optional": true
+    }
   }
 }

package/dist/agents/client-registry.d.ts

@@ -1,22 +0,0 @@
-export declare const MACHINE_AGENT_CLIENT_IDS: readonly ["universal", "claude-code", "codex", "opencode", "github-copilot", "factory-droid", "cursor", "vscode", "gemini-cli", "windsurf", "cline", "continue"];
-export declare const CONNECT_TARGET_IDS: readonly ["claude-code", "cursor", "vscode", "codex", "claude", "chatgpt"];
-export type MachineAgentClientId = (typeof MACHINE_AGENT_CLIENT_IDS)[number];
-export type ConnectTargetId = (typeof CONNECT_TARGET_IDS)[number];
-export type AgentProductId = MachineAgentClientId | ConnectTargetId;
-export declare const AGENT_PRODUCT_NAMES: {
-    readonly universal: "Universal (.agents)";
-    readonly "claude-code": "Claude Code";
-    readonly codex: "Codex";
-    readonly cursor: "Cursor";
-    readonly vscode: "VS Code";
-    readonly "github-copilot": "GitHub Copilot";
-    readonly "factory-droid": "Factory Droid";
-    readonly opencode: "OpenCode";
-    readonly "gemini-cli": "Gemini CLI";
-    readonly windsurf: "Windsurf";
-    readonly cline: "Cline";
-    readonly continue: "Continue";
-    readonly claude: "Claude";
-    readonly chatgpt: "ChatGPT";
-};
-export declare function agentProductName(id: AgentProductId): string;

package/dist/agents/client-registry.js

@@ -1,41 +0,0 @@
-export const MACHINE_AGENT_CLIENT_IDS = [
-    "universal",
-    "claude-code",
-    "codex",
-    "opencode",
-    "github-copilot",
-    "factory-droid",
-    "cursor",
-    "vscode",
-    "gemini-cli",
-    "windsurf",
-    "cline",
-    "continue",
-];
-export const CONNECT_TARGET_IDS = [
-    "claude-code",
-    "cursor",
-    "vscode",
-    "codex",
-    "claude",
-    "chatgpt",
-];
-export const AGENT_PRODUCT_NAMES = {
-    universal: "Universal (.agents)",
-    "claude-code": "Claude Code",
-    codex: "Codex",
-    cursor: "Cursor",
-    vscode: "VS Code",
-    "github-copilot": "GitHub Copilot",
-    "factory-droid": "Factory Droid",
-    opencode: "OpenCode",
-    "gemini-cli": "Gemini CLI",
-    windsurf: "Windsurf",
-    cline: "Cline",
-    continue: "Continue",
-    claude: "Claude",
-    chatgpt: "ChatGPT",
-};
-export function agentProductName(id) {
-    return AGENT_PRODUCT_NAMES[id];
-}

package/dist/docs/agent-handoff-document.d.ts

@@ -1,15 +0,0 @@
-/**
- * The exact markdown body served to agents at `/agent/<documentId>`.
- * Deterministic and ID-free on purpose — see the module comment.
- */
-export declare function renderAgentHandoffDocumentMarkdown(input: {
-    mcpEndpoint: string;
-}): string;
-/**
- * The browser variant served at `/agent/<documentId>`: the full instructions in
- * the initial response body, zero scripts (nothing may ever inspect or echo a
- * handoff credential), same bytes for every ID.
- */
-export declare function renderAgentHandoffDocumentHtml(input: {
-    mcpEndpoint: string;
-}): string;

package/dist/docs/agent-handoff-document.js

@@ -1,180 +0,0 @@
-/*
- * The public setup document behind agent handoff links.
- *
- * Private handoff links carry a one-use path token while the durable agent
- * credential stays encrypted at the broker. The minted prompt tells the agent
- * to fetch the reconstructed clean document URL instead. This
- * fetch is UNAUTHENTICATED BY DESIGN — which means the response
- * must never become an existence oracle. The contract here is
- * indistinguishability: every well-formed document ID serves the exact same
- * bytes, with the same status and the same timing, whether or not a handoff with
- * that ID exists. That is why these renderers take no document ID and hit no
- * store: the document is one static artifact, target-agnostic, published behind
- * a `/agent/*` rewrite on the dashboard space. Per-target polish deliberately
- * loses to indistinguishability — instead of looking up the handoff's client
- * target (which would need a public by-ID lookup, an oracle), the document
- * carries a named section for every connect target and the minted prompt's
- * "follow the <client> setup instructions" resolves to the right section.
- *
- * Lifecycle safety stays where the secret authenticates: an expired, used, or
- * revoked link fails at the app-private exchange, never at fetch time (see
- * ./agent-setup.ts, `AGENT_HANDOFF_DECLINE_REASONS`).
- */
-import { buildConnectTargets } from "../agents/connect-targets.js";
-import { BRAND } from "../brand.js";
-import { AGENT_HANDOFF_BROWSER_APPROVAL_GUIDANCE, AGENT_HANDOFF_CLI_APPROVAL_GUIDANCE, AGENT_HANDOFF_CLI_TARGET_IDS, AGENT_HANDOFF_CREDENTIAL_HYGIENE, AGENT_HANDOFF_FETCH_SAFETY, AGENT_HANDOFF_PREAMBLE, AGENT_HANDOFF_PUBLISH_PROSE, agentHandoffConnectSections, agentSetupTextUrl, } from "./agent-setup.js";
-const DOCUMENT_TITLE = `Set up ${BRAND.productName} from an agent handoff`;
-const DOCUMENT_SCOPE = `This is the public setup document for ${BRAND.productName} agent handoff links (\`/agent/<id>\` on the dashboard origin). Every link serves this same document — fetching it never uses a handoff and reveals nothing about one.`;
-const CONNECT_INTRO = "Set up the client you are running in. Each section stands on its own.";
-/**
- * The exact markdown body served to agents at `/agent/<documentId>`.
- * Deterministic and ID-free on purpose — see the module comment.
- */
-export function renderAgentHandoffDocumentMarkdown(input) {
-    const targets = buildConnectTargets({ mcpEndpoint: input.mcpEndpoint });
-    const cliTargetNames = targets
-        .filter((target) => AGENT_HANDOFF_CLI_TARGET_IDS.includes(target.id))
-        .map((target) => target.name);
-    const connectSections = targets.flatMap((target) => {
-        const sections = agentHandoffConnectSections(target);
-        sections.unshift(`### ${target.name}`);
-        return sections;
-    });
-    const sections = [
-        `# ${DOCUMENT_TITLE}`,
-        DOCUMENT_SCOPE,
-        AGENT_HANDOFF_PREAMBLE,
-        ["## Connect", CONNECT_INTRO, ...connectSections].join("\n\n"),
-        [
-            "## Continue the approved handoff",
-            AGENT_HANDOFF_FETCH_SAFETY,
-            `From ${cliTargetNames.join(" or ")} (or any client with a shell): ${AGENT_HANDOFF_CLI_APPROVAL_GUIDANCE}`,
-            `From every other client: ${AGENT_HANDOFF_BROWSER_APPROVAL_GUIDANCE}`,
-            AGENT_HANDOFF_CREDENTIAL_HYGIENE,
-        ].join("\n\n"),
-        ["## Publish", AGENT_HANDOFF_PUBLISH_PROSE].join("\n\n"),
-        `General agent instructions: ${agentSetupTextUrl}`,
-    ];
-    return `${sections.join("\n\n")}\n`;
-}
-function escapeHtml(value) {
-    return value
-        .replaceAll("&", "&amp;")
-        .replaceAll("<", "&lt;")
-        .replaceAll(">", "&gt;")
-        .replaceAll('"', "&quot;");
-}
-function linkify(escaped) {
-    return escaped.replace(/https?:\/\/[^\s<)]+/g, (url) => `<a href="${url}" rel="noopener">${url}</a>`);
-}
-/** Inline markdown: backtick code spans stay literal; bare URLs become links. */
-function renderInline(text) {
-    return text
-        .split("`")
-        .map((part, index) => index % 2 === 1 ? `<code>${escapeHtml(part)}</code>` : linkify(escapeHtml(part)))
-        .join("");
-}
-/**
- * Renders the document's own markdown grammar (headings, paragraphs, fenced
- * code, inline code, bare URLs) to HTML. Not a general markdown engine: the
- * input is our generated document above, so anything else stays literal text.
- */
-function markdownToHtmlBody(markdown) {
-    const html = [];
-    let paragraph = [];
-    let codeBlock = null;
-    const flushParagraph = () => {
-        if (paragraph.length > 0) {
-            html.push(`<p>${paragraph.map(renderInline).join("\n")}</p>`);
-            paragraph = [];
-        }
-    };
-    for (const line of markdown.split("\n")) {
-        if (codeBlock !== null) {
-            if (line.startsWith("```")) {
-                html.push(`<pre><code>${escapeHtml(codeBlock.join("\n"))}</code></pre>`);
-                codeBlock = null;
-            }
-            else {
-                codeBlock.push(line);
-            }
-            continue;
-        }
-        if (line.startsWith("```")) {
-            flushParagraph();
-            codeBlock = [];
-            continue;
-        }
-        const heading = /^(#{1,3}) (.*)$/.exec(line);
-        if (heading?.[1] && heading[2] !== undefined) {
-            flushParagraph();
-            const level = heading[1].length;
-            html.push(`<h${level}>${renderInline(heading[2])}</h${level}>`);
-            continue;
-        }
-        if (line.trim() === "") {
-            flushParagraph();
-            continue;
-        }
-        paragraph.push(line);
-    }
-    flushParagraph();
-    return html.join("\n");
-}
-const DOCUMENT_STYLES = `
-:root { color-scheme: light dark; }
-body {
-  margin: 0 auto;
-  padding: 3rem 1.25rem 5rem;
-  max-width: 42rem;
-  font: 16px/1.6 ui-sans-serif, system-ui, sans-serif;
-  background: #ffffff;
-  color: #1a1a1e;
-}
-h1 { font-size: 1.6rem; line-height: 1.25; margin: 0 0 1rem; }
-h2 { font-size: 1.2rem; margin: 2.5rem 0 0.75rem; }
-h3 { font-size: 1rem; margin: 2rem 0 0.5rem; }
-p { margin: 0.75rem 0; }
-a { color: inherit; text-underline-offset: 3px; word-break: break-word; }
-code {
-  font: 0.875em ui-monospace, monospace;
-  background: rgba(125, 125, 135, 0.14);
-  border-radius: 4px;
-  padding: 0.1em 0.35em;
-}
-pre {
-  background: rgba(125, 125, 135, 0.1);
-  border: 1px solid rgba(125, 125, 135, 0.25);
-  border-radius: 8px;
-  padding: 0.875rem 1rem;
-  overflow-x: auto;
-}
-pre code { background: none; padding: 0; font-size: 0.8125rem; }
-@media (prefers-color-scheme: dark) {
-  body { background: #0e0e10; color: #ececf1; }
-}
-`.trim();
-/**
- * The browser variant served at `/agent/<documentId>`: the full instructions in
- * the initial response body, zero scripts (nothing may ever inspect or echo a
- * handoff credential), same bytes for every ID.
- */
-export function renderAgentHandoffDocumentHtml(input) {
-    const markdown = renderAgentHandoffDocumentMarkdown(input);
-    return [
-        "<!doctype html>",
-        '<html lang="en">',
-        "<head>",
-        '<meta charset="utf-8">',
-        '<meta name="viewport" content="width=device-width, initial-scale=1">',
-        '<meta name="robots" content="noindex">',
-        `<title>${escapeHtml(DOCUMENT_TITLE)}</title>`,
-        `<style>${DOCUMENT_STYLES}</style>`,
-        "</head>",
-        "<body>",
-        markdownToHtmlBody(markdown),
-        "</body>",
-        "</html>",
-        "",
-    ].join("\n");
-}

package/dist/docs/agent-solutions.d.ts

@@ -1,110 +0,0 @@
-export declare const hostedMcpEndpointUrl = "https://mcp.spacefast.com";
-export type AgentSolutionLane = "plugin" | "hosted-mcp" | "local-mcp" | "cli" | "prompt";
-export type AgentSolutionId = "codex" | "claude-code" | "claude-cowork" | "chatgpt" | "claude-ai" | "raycast" | "cursor" | "terminal" | "generic";
-export type AgentSolution = {
-    aliases: readonly string[];
-    commands?: readonly string[];
-    description: string;
-    detailGuideUrl?: string;
-    guideUrl: string;
-    id: AgentSolutionId;
-    label: string;
-    lane: AgentSolutionLane;
-    setupText: string;
-    summary: string;
-};
-export declare const agentSolutions: readonly [{
-    readonly id: "codex";
-    readonly label: "Codex";
-    readonly aliases: readonly ["codex cli", "codex plugin", "openai codex"];
-    readonly lane: "plugin";
-    readonly summary: "Recommended: Codex plugin.";
-    readonly description: "Install the Spacefast skill/plugin so Codex can publish, update, and inspect spaces from the same setup path.";
-    readonly commands: readonly ["npx -y skills add spacefast/plugins --skill spacefast -g -a codex -y"];
-    readonly guideUrl: `${string}/for-codex`;
-    readonly detailGuideUrl: `${string}/guides/how-to-use-with-codex`;
-    readonly setupText: string;
-}, {
-    readonly id: "claude-code";
-    readonly label: "Claude Code";
-    readonly aliases: readonly ["claude code", "claude cli"];
-    readonly lane: "plugin";
-    readonly summary: "Recommended: Claude plugin.";
-    readonly description: "Install the Spacefast Claude plugin once, then Claude Code can publish and operate spaces from the terminal.";
-    readonly commands: readonly ["claude plugin marketplace add spacefast/plugins", "claude plugin install spacefast@spacefast"];
-    readonly guideUrl: `${string}/for-claude`;
-    readonly detailGuideUrl: `${string}/guides/how-to-use-with-claude-code`;
-    readonly setupText: string;
-}, {
-    readonly id: "claude-cowork";
-    readonly label: "Claude Cowork";
-    readonly aliases: readonly ["cowork", "claude cowork"];
-    readonly lane: "plugin";
-    readonly summary: "Recommended: Claude plugin.";
-    readonly description: "Use the Spacefast Claude plugin path so Cowork gets the same publish instructions and MCP-aware setup as Claude Code.";
-    readonly commands: readonly ["claude plugin marketplace add spacefast/plugins", "claude plugin install spacefast@spacefast"];
-    readonly guideUrl: `${string}/for-claude`;
-    readonly detailGuideUrl: `${string}/guides/how-to-use-with-claude-cowork`;
-    readonly setupText: string;
-}, {
-    readonly id: "chatgpt";
-    readonly label: "ChatGPT";
-    readonly aliases: readonly ["chatgpt", "custom gpt", "openai apps"];
-    readonly lane: "hosted-mcp";
-    readonly summary: "Recommended: direct hosted MCP.";
-    readonly description: "Connect ChatGPT-style cloud agents to Spacefast through hosted MCP; use inline files or signed uploads instead of local paths.";
-    readonly commands: readonly ["https://mcp.spacefast.com"];
-    readonly guideUrl: `${string}/agents`;
-    readonly setupText: string;
-}, {
-    readonly id: "claude-ai";
-    readonly label: "Claude.ai";
-    readonly aliases: readonly ["claude.ai", "claude app", "claude web"];
-    readonly lane: "hosted-mcp";
-    readonly summary: "Recommended: direct hosted MCP.";
-    readonly description: "Connect the web Claude app to Spacefast through hosted MCP when it cannot read your local checkout.";
-    readonly commands: readonly ["https://mcp.spacefast.com"];
-    readonly guideUrl: `${string}/agents`;
-    readonly setupText: string;
-}, {
-    readonly id: "raycast";
-    readonly label: "Raycast";
-    readonly aliases: readonly ["raycast", "raycast ai"];
-    readonly lane: "hosted-mcp";
-    readonly summary: "Recommended: direct hosted MCP.";
-    readonly description: "Use hosted MCP for Raycast and similar clients that can connect to a remote MCP server but should not need a local Spacefast install.";
-    readonly commands: readonly ["https://mcp.spacefast.com"];
-    readonly guideUrl: `${string}/agents`;
-    readonly setupText: string;
-}, {
-    readonly id: "cursor";
-    readonly label: "Cursor or MCP client";
-    readonly aliases: readonly ["cursor", "mcp client", "windsurf", "opencode"];
-    readonly lane: "local-mcp";
-    readonly summary: "Recommended: local MCP when it needs the checkout.";
-    readonly description: "Use On-Device MCP for editor agents that need local files; use hosted MCP instead when they only need cloud-safe tools.";
-    readonly commands: readonly ["sf setup agent --agent auto --connect", "sf mcp install --agent auto --mode local --transport stdio --connect"];
-    readonly guideUrl: `${string}/agents`;
-    readonly setupText: string;
-}, {
-    readonly id: "terminal";
-    readonly label: "Terminal or CI";
-    readonly aliases: readonly ["terminal", "cli", "ci", "github actions"];
-    readonly lane: "cli";
-    readonly summary: "Recommended: Spacefast CLI.";
-    readonly description: "Use the CLI for repeat publishes, CI jobs, JSON output, rollback, logs, and domains.";
-    readonly commands: readonly [string, "sf login", "sf publish {file-or-dir} --json"];
-    readonly guideUrl: `${string}/cli`;
-    readonly setupText: string;
-}, {
-    readonly id: "generic";
-    readonly label: "Generic agent prompt";
-    readonly aliases: readonly ["generic", "unknown", "gemini"];
-    readonly lane: "prompt";
-    readonly summary: "Recommended: generic prompt + setup contract.";
-    readonly description: "Use this when the client has no known plugin or MCP connector. The agent reads Spacefast's setup contract and picks the smallest working lane.";
-    readonly guideUrl: string;
-    readonly setupText: string;
-}];
-export declare function getAgentSolution(id: AgentSolutionId): AgentSolution;
-export declare function renderAgentSolutionIndexText(solutions?: readonly AgentSolution[]): string;