@spacefast/common 0.0.26 → 0.2.2

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;

package/dist/docs/agent-solutions.js

@@ -1,183 +0,0 @@
-import { BRAND } from "../brand.js";
-import { DOCS_BASE_URL, serviceOrigin } from "../config/domains.js";
-import { agentSetupPrompt, agentSetupTextUrl, agentSetupUrl } from "./agent-setup.js";
-import { spacefastClaudePluginAddCommand, spacefastClaudePluginInstallCommand, spacefastCodexSkillInstallCommand, spacefastInstallCurlCommand, } from "./skill-distribution.js";
-export const hostedMcpEndpointUrl = "https://mcp.spacefast.com";
-const WEBSITE_ORIGIN = serviceOrigin("www", "prod");
-function pluginText(label, commands, guideUrl) {
-    return [
-        `Set up ${BRAND.productName} for ${label}.`,
-        "",
-        "Run once:",
-        ...commands.map((command) => `  ${command}`),
-        "",
-        `Then ask ${label} to publish with ${BRAND.productName}.`,
-        `Guide: ${guideUrl}`,
-        `Generic agent contract: ${agentSetupUrl}`,
-    ].join("\n");
-}
-function hostedMcpText(label, guideUrl) {
-    return [
-        `Connect ${label} to ${BRAND.productName} with hosted MCP.`,
-        "",
-        `MCP endpoint: ${hostedMcpEndpointUrl}`,
-        "Transport: Streamable HTTP",
-        "Resource: https://mcp.spacefast.com",
-        "Minimum scope: mcp:tools",
-        "Common scopes: teams:read teams:create spaces:read spaces:write spaces:rename publish:write domains:read domains:write",
-        "",
-        "Hosted MCP is for cloud/browser agents. Publish small generated files inline or use signed uploads for larger artifacts; it has no filesystem.",
-        `Guide: ${guideUrl}`,
-        `Plain-text setup contract: ${agentSetupTextUrl}`,
-    ].join("\n");
-}
-function localMcpText(label, guideUrl) {
-    return [
-        `Set up ${BRAND.productName} for ${label} with local MCP when it needs your checkout or filesystem.`,
-        "",
-        `Install CLI: ${spacefastInstallCurlCommand}`,
-        "Configure the agent: sf setup agent --agent auto --connect",
-        "Install local stdio MCP: sf mcp install --agent auto --mode local --transport stdio --connect",
-        "Run stdio server directly: sf mcp",
-        "",
-        `Guide: ${guideUrl}`,
-        `Plain-text setup contract: ${agentSetupTextUrl}`,
-    ].join("\n");
-}
-export const agentSolutions = [
-    {
-        id: "codex",
-        label: "Codex",
-        aliases: ["codex cli", "codex plugin", "openai codex"],
-        lane: "plugin",
-        summary: "Recommended: Codex plugin.",
-        description: `Install the ${BRAND.productName} skill/plugin so Codex can publish, update, and inspect spaces from the same setup path.`,
-        commands: [spacefastCodexSkillInstallCommand],
-        guideUrl: `${WEBSITE_ORIGIN}/for-codex`,
-        detailGuideUrl: `${WEBSITE_ORIGIN}/guides/how-to-use-with-codex`,
-        setupText: pluginText("Codex", [spacefastCodexSkillInstallCommand], `${WEBSITE_ORIGIN}/for-codex`),
-    },
-    {
-        id: "claude-code",
-        label: "Claude Code",
-        aliases: ["claude code", "claude cli"],
-        lane: "plugin",
-        summary: "Recommended: Claude plugin.",
-        description: `Install the ${BRAND.productName} Claude plugin once, then Claude Code can publish and operate spaces from the terminal.`,
-        commands: [spacefastClaudePluginAddCommand, spacefastClaudePluginInstallCommand],
-        guideUrl: `${WEBSITE_ORIGIN}/for-claude`,
-        detailGuideUrl: `${WEBSITE_ORIGIN}/guides/how-to-use-with-claude-code`,
-        setupText: pluginText("Claude Code", [spacefastClaudePluginAddCommand, spacefastClaudePluginInstallCommand], `${WEBSITE_ORIGIN}/guides/how-to-use-with-claude-code`),
-    },
-    {
-        id: "claude-cowork",
-        label: "Claude Cowork",
-        aliases: ["cowork", "claude cowork"],
-        lane: "plugin",
-        summary: "Recommended: Claude plugin.",
-        description: `Use the ${BRAND.productName} Claude plugin path so Cowork gets the same publish instructions and MCP-aware setup as Claude Code.`,
-        commands: [spacefastClaudePluginAddCommand, spacefastClaudePluginInstallCommand],
-        guideUrl: `${WEBSITE_ORIGIN}/for-claude`,
-        detailGuideUrl: `${WEBSITE_ORIGIN}/guides/how-to-use-with-claude-cowork`,
-        setupText: pluginText("Claude Cowork", [spacefastClaudePluginAddCommand, spacefastClaudePluginInstallCommand, agentSetupPrompt], `${WEBSITE_ORIGIN}/guides/how-to-use-with-claude-cowork`),
-    },
-    {
-        id: "chatgpt",
-        label: "ChatGPT",
-        aliases: ["chatgpt", "custom gpt", "openai apps"],
-        lane: "hosted-mcp",
-        summary: "Recommended: direct hosted MCP.",
-        description: `Connect ChatGPT-style cloud agents to ${BRAND.productName} through hosted MCP; use inline files or signed uploads instead of local paths.`,
-        commands: [hostedMcpEndpointUrl],
-        guideUrl: `${DOCS_BASE_URL}/agents`,
-        setupText: hostedMcpText("ChatGPT", `${DOCS_BASE_URL}/agents`),
-    },
-    {
-        id: "claude-ai",
-        label: "Claude.ai",
-        aliases: ["claude.ai", "claude app", "claude web"],
-        lane: "hosted-mcp",
-        summary: "Recommended: direct hosted MCP.",
-        description: `Connect the web Claude app to ${BRAND.productName} through hosted MCP when it cannot read your local checkout.`,
-        commands: [hostedMcpEndpointUrl],
-        guideUrl: `${DOCS_BASE_URL}/agents`,
-        setupText: hostedMcpText("Claude.ai", `${DOCS_BASE_URL}/agents`),
-    },
-    {
-        id: "raycast",
-        label: "Raycast",
-        aliases: ["raycast", "raycast ai"],
-        lane: "hosted-mcp",
-        summary: "Recommended: direct hosted MCP.",
-        description: `Use hosted MCP for Raycast and similar clients that can connect to a remote MCP server but should not need a local ${BRAND.productName} install.`,
-        commands: [hostedMcpEndpointUrl],
-        guideUrl: `${DOCS_BASE_URL}/agents`,
-        setupText: hostedMcpText("Raycast", `${DOCS_BASE_URL}/agents`),
-    },
-    {
-        id: "cursor",
-        label: "Cursor or MCP client",
-        aliases: ["cursor", "mcp client", "windsurf", "opencode"],
-        lane: "local-mcp",
-        summary: "Recommended: local MCP when it needs the checkout.",
-        description: `Use On-Device MCP for editor agents that need local files; use hosted MCP instead when they only need cloud-safe tools.`,
-        commands: [
-            "sf setup agent --agent auto --connect",
-            "sf mcp install --agent auto --mode local --transport stdio --connect",
-        ],
-        guideUrl: `${DOCS_BASE_URL}/agents`,
-        setupText: localMcpText("Cursor or another MCP client", `${DOCS_BASE_URL}/agents`),
-    },
-    {
-        id: "terminal",
-        label: "Terminal or CI",
-        aliases: ["terminal", "cli", "ci", "github actions"],
-        lane: "cli",
-        summary: `Recommended: ${BRAND.productName} CLI.`,
-        description: "Use the CLI for repeat publishes, CI jobs, JSON output, rollback, logs, and domains.",
-        commands: [spacefastInstallCurlCommand, "sf login", "sf publish {file-or-dir} --json"],
-        guideUrl: `${DOCS_BASE_URL}/cli`,
-        setupText: [
-            `Install CLI: ${spacefastInstallCurlCommand}`,
-            "Login: sf login",
-            "Publish: sf publish {file-or-dir} --json",
-            `Guide: ${DOCS_BASE_URL}/cli`,
-        ].join("\n"),
-    },
-    {
-        id: "generic",
-        label: "Generic agent prompt",
-        aliases: ["generic", "unknown", "gemini"],
-        lane: "prompt",
-        summary: "Recommended: generic prompt + setup contract.",
-        description: `Use this when the client has no known plugin or MCP connector. The agent reads ${BRAND.productName}'s setup contract and picks the smallest working lane.`,
-        guideUrl: agentSetupUrl,
-        setupText: agentSetupPrompt,
-    },
-];
-export function getAgentSolution(id) {
-    const solution = agentSolutions.find((entry) => entry.id === id);
-    if (!solution)
-        throw new Error(`Unknown agent solution: ${id}`);
-    return solution;
-}
-export function renderAgentSolutionIndexText(solutions = agentSolutions) {
-    return [
-        `# ${BRAND.productName} agent setup options`,
-        "",
-        ...solutions.flatMap((solution) => [
-            `## ${solution.label}`,
-            "",
-            `Recommended lane: ${solution.lane}`,
-            solution.summary,
-            solution.description,
-            "",
-            `Guide: ${solution.guideUrl}`,
-            solution.detailGuideUrl ? `Detailed guide: ${solution.detailGuideUrl}` : null,
-            "",
-            "Setup:",
-            solution.setupText,
-            "",
-        ].filter((line) => Boolean(line))),
-    ].join("\n");
-}

package/dist/utils/query-keys.d.ts

@@ -1,84 +0,0 @@
-export declare const qk: {
-    session: () => readonly ["session"];
-    authCapabilities: () => readonly ["auth", "capabilities"];
-    accountSessions: () => readonly ["account", "sessions"];
-    accountConnections: () => readonly ["account", "connections"];
-    accountInvitations: () => readonly ["account", "invitations"];
-    apiTokens: (teamId?: string) => readonly ["api-tokens"] | readonly ["api-tokens", string];
-    agentAccounts: (teamId: string) => readonly ["agent-accounts", string];
-    mcpDashboard: (teamId: string) => readonly ["mcp", "dashboard", string];
-    teams: () => readonly ["teams", "list"];
-    team: (ref: string) => readonly ["teams", "by-ref", string];
-    teamDetail: (id: string) => readonly ["teams", string, "detail"];
-    teamMembers: (id: string) => readonly ["teams", string, "members"];
-    teamInvites: (id: string) => readonly ["teams", string, "invites"];
-    teamBilling: (id: string) => readonly ["teams", string, "billing"];
-    teamUsage: (id: string) => readonly ["teams", string, "usage"];
-    teamEntitlements: (id: string) => readonly ["teams", string, "entitlements"];
-    teamFeatures: (id: string) => readonly ["teams", string, "features"];
-    teamSettings: (id: string) => readonly ["teams", string, "settings"];
-    teamSpaces: (id: string) => readonly ["teams", string, "spaces"];
-    teamDomains: (id: string) => readonly ["teams", string, "domains"];
-    teamManagedDomains: (id: string) => readonly ["teams", string, "managed-domains"];
-    slugAvailability: (kind: "team" | "space", slug: string, teamId?: string, currentSlug?: string) => readonly ["slugs", "availability", "space" | "team", string, string, string];
-    teamVariables: (id: string) => readonly ["teams", string, "variables"];
-    teamActivity: (id: string, limit: number) => readonly ["teams", string, "activity", number];
-    space: (id: string) => readonly ["spaces", string];
-    spaceByRef: (teamRef: string, spaceRef: string) => readonly ["spaces", "by-ref", string, string];
-    spaceVersions: (id: string) => readonly ["spaces", string, "versions"];
-    spaceVersionsHistory: (id: string) => readonly ["spaces", string, "versions", "history"];
-    spaceCollaboration: (id: string) => readonly ["spaces", string, "collaboration"];
-    spaceComments: (id: string) => readonly ["spaces", string, "comments"];
-    spaceCommentThread: (id: string, threadId: string) => readonly ["spaces", string, "comments", string];
-    spaceActivity: (id: string, limit: number) => readonly ["spaces", string, "activity", number];
-    spaceTags: (id: string) => readonly ["spaces", string, "tags"];
-    spaceTagVersion: (id: string, versionId: string) => readonly ["spaces", string, "tags", string];
-    spaceTagDiff: (id: string, versionId: string) => readonly ["spaces", string, "tags", string, "diff"];
-    spaceTagReleases: (id: string) => readonly ["spaces", string, "tags", "releases"];
-    spaceTagsEffective: (id: string) => readonly ["spaces", string, "tags", "effective"];
-    build: (spaceId: string, id: string) => readonly ["spaces", string, "builds", string];
-    buildLogs: (spaceId: string, id: string, limit?: number) => readonly ["spaces", string, "builds", string, "logs"] | readonly ["spaces", string, "builds", string, "logs", number];
-    spaceBuilds: (id: string) => readonly ["spaces", string, "builds"];
-    spaceRepositoryConnection: (id: string, connectionType?: string) => readonly ["spaces", string, "repository-connection", string];
-    repositoryInstallations: (spaceId: string) => readonly ["spaces", string, "repository-installations"];
-    repositoryInstallationRepositories: (spaceId: string, installationId: string) => readonly ["spaces", string, "repository-installations", string, "repositories"];
-    spaceRepositoryAnalyze: (id: string, connectionType?: string, ref?: string, root?: string) => readonly ["spaces", string, "repository-connection", string, "analyze", string, string];
-    spaceRepositoryWebhookDeliveries: (id: string, connectionType?: string) => readonly ["spaces", string, "repository-webhook-deliveries", string];
-    teamWebhooks: (teamId: string) => readonly ["teams", string, "webhooks"];
-    webhook: (webhookId: string) => readonly ["webhooks", string];
-    webhookDeliveries: (webhookId: string) => readonly ["webhooks", string, "deliveries"];
-    spaceVersion: (id: string, versionId: string) => readonly ["spaces", string, "versions", string];
-    spaceVersionComments: (id: string, versionId: string, status?: string) => readonly ["spaces", string, "versions", string, "comments"] | readonly ["spaces", string, "versions", string, "comments", string];
-    spaceVersionFiles: (id: string, versionId: string) => readonly ["spaces", string, "versions", string, "files"];
-    spaceVersionFile: (id: string, versionId: string, path: string) => readonly ["spaces", string, "versions", string, "files", string];
-    spaceVersionFileUrlPreview: (id: string, versionId: string, path: string) => readonly ["spaces", string, "versions", string, "files", string, "url-preview"];
-    spaceVersionFileDiff: (id: string, versionId: string, baseVersionId?: string) => readonly ["spaces", string, "versions", string, "files", "diff", string];
-    spaceVersionConventionArtifacts: (id: string, versionId: string) => readonly ["spaces", string, "versions", string, "convention-artifacts"];
-    spaceVersionConventionArtifact: (id: string, versionId: string, kind: "redirects" | "headers") => readonly ["spaces", string, "versions", string, "convention-artifacts", "headers" | "redirects"];
-    spaceVersionRoutingSummary: (id: string, versionId: string) => readonly ["spaces", string, "versions", string, "routing-summary"];
-    spaceDiagnostics: (id: string) => readonly ["spaces", string, "diagnostics"];
-    spaceDomains: (id: string) => readonly ["spaces", string, "domains"];
-    spaceRuntimeStatus: (id: string) => readonly ["spaces", string, "runtime"];
-    spaceApplyState: (id: string) => readonly ["spaces", string, "apply-state"];
-    spaceDatabase: (id: string) => readonly ["spaces", string, "db"];
-    spaceDatabaseDump: (id: string, table: string | undefined, limit: number) => readonly ["spaces", string, "db", "dump", string, number];
-    spaceStorage: (id: string) => readonly ["spaces", string, "storage"];
-    spaceRuntimeLogs: (id: string, limit: number) => readonly ["spaces", string, "logs", "runtime", number];
-    spaceRuntimeRealtimeEvents: (id: string, limit: number) => readonly ["spaces", string, "runtime", "realtime", "events", number];
-    spaceVariables: (id: string) => readonly ["spaces", string, "variables"];
-    spaceCertificates: (id: string) => readonly ["spaces", string, "runtime", "certificates"];
-    spaceLogs: (id: string, kind: "build" | "access" | "runtime") => readonly ["spaces", string, "logs", "build" | "access" | "runtime"];
-    spaceAnalytics: (id: string, window: string) => readonly ["spaces", string, "analytics", string];
-    teamAgentHandoffs: (teamId: string) => readonly ["teams", string, "agent-handoffs"];
-    teamAccessDefaults: (teamId: string) => readonly ["teams", string, "access", "defaults"];
-    domain: (teamId: string, ref: string) => readonly ["teams", string, "domains", string];
-    domainDiagnostics: (teamId: string, domainId: string) => readonly ["teams", string, "domains", string, "diagnostics"];
-    domainDnsCapabilities: (domainId: string) => readonly ["domains", string, "dns", "capabilities"];
-    domainDnsRecords: (domainId: string) => readonly ["domains", string, "dns", "records"];
-    domainDnsOperations: (domainId: string) => readonly ["domains", string, "dns", "operations"];
-    domainActions: (domainId: string) => readonly ["domains", string, "actions"];
-    domainProviderConnections: (teamId: string) => readonly ["domains", "provider-connections", string];
-    notifications: () => readonly ["notifications"];
-    notificationsList: (unreadOnly: boolean) => readonly ["notifications", "list", boolean];
-    notificationsUnreadCount: () => readonly ["notifications", "unread-count"];
-};