@spacefast/common 0.0.24 → 0.2.1

package/brand-assets/LICENSE-Haskoy.txt

@@ -0,0 +1,93 @@
+Copyright 2021 The Haskoy Project Authors (https://github.com/ertekinno/haskoy)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/brand-assets/spacefast-favicon.svg

@@ -1,14 +1,14 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 160 160" role="img" aria-label="Spacefast">
   <style>
-    .sf-favicon-primary { fill: #141419; }
-    @media (prefers-color-scheme: dark) { .sf-favicon-primary { fill: #fbf8f1; } }
+    .sf-favicon-primary { fill: #0c0c0c; }
+    @media (prefers-color-scheme: dark) { .sf-favicon-primary { fill: #fcfcfa; } }
   </style>
   <g transform="rotate(-1 80 80)">
-    <g transform="translate(22.5 48) scale(2.15)" fill="#ff4217">
+    <g transform="translate(22.5 48) scale(2.15)" fill="#d8f24b">
       <path d="M0 0h24v7H7v7h17v20H0v-7h17v-7H0V0Z"/>
       <path d="M0 0h25v7H7v6h15v7H7v14H0V0Z" transform="translate(31 0)"/>
     </g>
-    <g class="sf-favicon-primary" transform="translate(17.5 43) scale(2.15)" fill="#141419">
+    <g class="sf-favicon-primary" transform="translate(17.5 43) scale(2.15)" fill="#0c0c0c">
       <path d="M0 0h24v7H7v7h17v20H0v-7h17v-7H0V0Z"/>
       <path d="M0 0h25v7H7v6h15v7H7v14H0V0Z" transform="translate(31 0)"/>
     </g>

package/brand-assets/spacefast-sf-full-bleed.svg

@@ -1,11 +1,11 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 160 160" role="img" aria-label="Spacefast">
-  <rect width="160" height="160" fill="#141419"/>
+  <rect width="160" height="160" fill="#0c0c0c"/>
   <g transform="rotate(-1 80 80)">
-    <g transform="translate(39.75 55.5) scale(1.5)" fill="#ff4217">
+    <g transform="translate(39.75 55.5) scale(1.5)" fill="#d8f24b">
       <path d="M0 0h24v7H7v7h17v20H0v-7h17v-7H0V0Z"/>
       <path d="M0 0h25v7H7v6h15v7H7v14H0V0Z" transform="translate(31 0)"/>
     </g>
-    <g transform="translate(34.75 50.5) scale(1.5)" fill="#fbf8f1">
+    <g transform="translate(34.75 50.5) scale(1.5)" fill="#fcfcfa">
       <path d="M0 0h24v7H7v7h17v20H0v-7h17v-7H0V0Z"/>
       <path d="M0 0h25v7H7v6h15v7H7v14H0V0Z" transform="translate(31 0)"/>
     </g>

package/brand-assets/spacefast-wordmark.svg

@@ -1,5 +1,3 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 326 62" role="img" aria-label="Spacefast">
-  <rect x="14" y="12" width="306" height="48" fill="#ff4217"/>
-  <rect x="10" y="8" width="306" height="48" fill="#141419" stroke="#141419" stroke-width="1"/>
-  <path fill="#fbf8f1" d="M20 15h24v7H27v7h17v20H20v-7h17v-7H20V15ZM51 15h24v18H58v16h-7V15Zm7 11h10v-4H58v4ZM83 15h24l9 34h-8l-2-8H84l-2 8h-8l9-34Zm3 19h18l-4-12H90l-4 12ZM145 22h-19v20h19v7h-26V15h26v7ZM152 15h26v7h-19v6h15v7h-15v7h19v7h-26V15ZM185 15h25v7h-18v6h15v7h-15v14h-7V15ZM215 15h24l9 34h-8l-2-8h-22l-2 8h-8l9-34Zm3 19h18l-4-12h-10l-4 12ZM250 15h24v7h-17v7h17v20h-24v-7h17v-7h-17V15ZM279 15h27v7h-10v27h-7V22h-10v-7Z"/>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 152 28.9062" role="img" aria-label="Spacefast">
+  <path fill="#0c0c0c" d="M9.32925 6.99344H20.5187V10.257H12.5929V13.5206H20.5187V22.8452H9.32925V19.5816H17.2551V16.318H9.32925V6.99344ZM23.7824 6.99344H34.9718V15.3856H27.046V22.8452H23.7824V6.99344ZM27.046 12.122H31.7082V10.257H27.046V12.122ZM38.7017 6.99344H49.8912L54.0872 22.8452H50.3574L49.4249 19.1154H39.1679L38.2355 22.8452H34.5056L38.7017 6.99344ZM40.1004 15.8518H48.4925L46.6276 10.257H41.9653L40.1004 15.8518ZM67.6079 10.257H58.7495V19.5816H67.6079V22.8452H55.4859V6.99344H67.6079V10.257ZM70.8715 6.99344H82.9934V10.257H74.1351V13.0544H81.1285V16.318H74.1351V19.5816H82.9934V22.8452H70.8715V6.99344ZM86.257 6.99344H97.9128V10.257H89.5206V13.0544H96.5141V16.318H89.5206V22.8452H86.257V6.99344ZM100.244 6.99344H111.433L115.629 22.8452H111.9L110.967 19.1154H100.71L99.7777 22.8452H96.0479L100.244 6.99344ZM101.643 15.8518H110.035L108.17 10.257H103.508L101.643 15.8518ZM116.562 6.99344H127.751V10.257H119.826V13.5206H127.751V22.8452H116.562V19.5816H124.488V16.318H116.562V6.99344ZM130.083 6.99344H142.671V10.257H138.008V22.8452H134.745V10.257H130.083V6.99344Z"/>
 </svg>

package/dist/agents/connect-targets.d.ts

@@ -1,141 +1,10 @@
-import { type ConnectTargetId } from "./client-registry.js";
-export { CONNECT_TARGET_IDS } from "./client-registry.js";
-export type { ConnectTargetId } from "./client-registry.js";
+import { type AgentId } from "./registry/core.js";
+export declare const CONNECT_TARGET_IDS: readonly ["claude-code", "claude-app", "claude-desktop", "cursor", "codex", "chatgpt", "vscode", "github-copilot", "devin-desktop", "devin-cloud", "zed", "gemini-cli", "opencode", "amp", "warp", "factory-droid", "cline", "continue", "raycast", "poke", "pi", "indent", "hermes", "openclaw"];
+export type ConnectTargetId = AgentId;
 export declare const LOCAL_MCP_PACKAGE = "spacefast";
 export declare const LOCAL_MCP_COMMAND = "npx";
 export declare const LOCAL_MCP_ARGS: readonly ["-y", "spacefast", "mcp"];
-/** The copy-paste one-liner for the fixed On-Device product surface. */
 export declare const LOCAL_MCP_COMMAND_LINE: string;
-/**
- * base64 of a UTF-8 string, without Buffer. Byte-identical to
- * `Buffer.from(value, "utf8").toString("base64")`, so deeplinks stay stable
- * whether they are built at the Astro build (Node) or in the dashboard (browser).
- */
-export declare function base64Utf8(value: string): string;
-/** The on-device MCP server entry, byte-identical to the committed plugin `.mcp.json`. */
-export declare function localMcpServersJson(): {
-    mcpServers: {
-        spacefast: {
-            command: string;
-            args: ("mcp" | "spacefast" | "-y")[];
-            env: {};
-        };
-    };
-};
-/**
- * VS Code's `.vscode/mcp.json` uses a top-level `servers` key (not the
- * `mcpServers` key Cursor/Claude Code use), so it gets its own generator —
- * single-sourced from the same command/args/package so it can never drift.
- * See https://code.visualstudio.com/docs/agent-customization/mcp-servers.
- */
-export declare function vscodeMcpServersJson(): {
-    servers: {
-        spacefast: {
-            type: string;
-            command: string;
-            args: ("mcp" | "spacefast" | "-y")[];
-        };
-    };
-};
-export declare function cursorHostedMcpDeeplink(mcpEndpoint: string): string;
-export declare function vscodeHostedMcpDeeplink(mcpEndpoint: string): string;
-export declare function pokeHostedMcpDeeplink(mcpEndpoint: string): string;
-/**
- * The hosted server entry for the Pi coding agent's `pi-mcp-extension`
- * (`~/.pi/agent/mcp.json` or a project `.pi/mcp.json`). Pi has no built-in
- * MCP; the extension (`pi install npm:pi-mcp-extension`) adds it with a
- * `transport: "streamable-http"` entry — its own key names, not the
- * `type: "http"` shape Claude Code and VS Code use.
- */
-export declare function piHostedMcpConfig(mcpEndpoint: string): {
-    mcpServers: {
-        spacefast: {
-            transport: string;
-            url: string;
-        };
-    };
-};
-export declare function claudeHostedConnectorInstallUrl(mcpEndpoint: string): string;
-export declare function claudeOrgConnectorInstallUrl(mcpEndpoint: string): string;
-/**
- * The hosted server entry for Claude Code's `.mcp.json`. Claude Code rejects a
- * bare `{ url }` as invalid, so the entry carries `type: "http"` — byte-identical
- * to the committed `plugins/claude-code/.mcp.json`.
- */
-export declare function hostedMcpServersJson(mcpEndpoint: string): {
-    mcpServers: {
-        spacefast: {
-            type: string;
-            url: string;
-        };
-    };
-};
-/**
- * The hosted server entry for Cursor's `~/.cursor/mcp.json`. Cursor's known-good
- * shape is a bare `{ url }` (no `type`) — matching the committed
- * `plugins/cursor/.mcp.json`. Kept separate from the Claude Code generator
- * rather than adding `type` everywhere, since `type: "http"` in Cursor's file is
- * untested territory.
- */
-export declare function cursorHostedMcpServersJson(mcpEndpoint: string): {
-    mcpServers: {
-        spacefast: {
-            url: string;
-        };
-    };
-};
-/** The hosted server entry for VS Code's `.vscode/mcp.json` (`servers` + `type: http`). */
-export declare function vscodeHostedMcpServersJson(mcpEndpoint: string): {
-    servers: {
-        spacefast: {
-            type: string;
-            url: string;
-        };
-    };
-};
-/**
- * A complete, schema-pinned OpenCode V2 config for the hosted MCP server.
- * OpenCode's `mcp` key is a flat map keyed by server name (no `servers` level) —
- * the same shape `sf mcp install` writes (packages/cli/src/agent-setup.ts).
- */
-export declare function opencodeHostedMcpConfig(mcpEndpoint: string): {
-    $schema: string;
-    mcp: {
-        spacefast: {
-            type: string;
-            url: string;
-            enabled: boolean;
-        };
-    };
-};
-export declare function codexHostedMcpToml(mcpEndpoint: string): string;
-export declare const CODEX_MCP_TOML: string;
-/**
- * Claude Code's one-command hosted-MCP connect (`claude mcp add`). Parameterized
- * by the hosted endpoint so the dashboard can point it at the runtime-derived
- * endpoint while the marketing site passes the prod constant.
- */
-export declare function buildClaudeMcpAddCommand(mcpEndpoint: string): string;
-/**
- * Codex's hosted-MCP connect. `codex mcp add` registers the server; OAuth is a
- * separate `codex mcp login` step, so both are chained — a bare `add` leaves the
- * connection unauthenticated and the tools 401.
- */
-export declare function buildCodexMcpAddCommand(mcpEndpoint: string): string;
-/**
- * Hermes's hosted-MCP connect (`hermes mcp add --url`), the form NousResearch's
- * hermes-agent MCP guide documents. `--auth oauth` opts the hosted server into
- * the browser sign-in flow; unlike Codex there is no separate login command.
- */
-export declare function buildHermesMcpAddCommand(mcpEndpoint: string): string;
-/**
- * OpenClaw's hosted-MCP connect (`openclaw mcp add`), the form
- * docs.openclaw.ai/cli/mcp documents: `--transport streamable-http` is required
- * (no auto-detection), `--auth oauth` opts into OAuth. Sign-in is a separate
- * two-step `openclaw mcp login <name>` (prints an auth URL, then `--code`), so
- * setup copy must not promise a single-command flow.
- */
-export declare function buildOpenclawMcpAddCommand(mcpEndpoint: string): string;
 export type ConnectCopyLanguage = "bash" | "json" | "toml" | "text";
 export type ConnectCopy = Readonly<{
     /** Short label for the affordance and the copied-value toast. */
@@ -153,11 +22,7 @@ export type ConnectDownload = Readonly<{
     href: string;
     label: string;
 }>;
-/**
- * A single connect card: one agent, one primary action (a one-click deeplink or
- * a copy of the command/endpoint that wires it), plus an optional secondary
- * "copy the client config file" affordance.
- */
+/** A single connect card: one agent, one primary action, optional extras. */
 export type ConnectTarget = Readonly<{
     id: ConnectTargetId;
     name: string;
@@ -172,15 +37,10 @@ export type ConnectTarget = Readonly<{
     /** A downloadable installer for clients that ship one (Claude Desktop). */
     download?: ConnectDownload;
 }>;
-/**
- * The per-agent connect catalog, parameterized by the hosted MCP endpoint.
- * Every one-click and copy-config path carries the hosted endpoint (OAuth,
- * nothing to install); on-device stdio is the CLI users' alternative and
- * lives in the docs/marketing setup lanes, not here.
- */
+/** The per-agent connect catalog, parameterized by the hosted MCP endpoint. */
 export declare function buildConnectTargets({ mcpEndpoint }: {
     mcpEndpoint: string;
 }): ConnectTarget[];
-export declare function getConnectTarget(id: ConnectTargetId, options: {
+export declare function getConnectTarget(id: string, options: {
     mcpEndpoint: string;
 }): ConnectTarget;