@spacefast/common 0.0.20 → 0.0.23

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

@@ -93,15 +93,18 @@ export declare function vscodeHostedMcpServersJson(mcpEndpoint: string): {
         };
     };
 };
-/** A complete, schema-pinned OpenCode V2 config for the hosted MCP server. */
+/**
+ * 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: {
-        servers: {
-            spacefast: {
-                type: string;
-                url: string;
-            };
+        spacefast: {
+            type: string;
+            url: string;
+            enabled: boolean;
         };
     };
 };

package/dist/agents/connect-targets.js

@@ -165,16 +165,19 @@ export function vscodeHostedMcpServersJson(mcpEndpoint) {
         },
     };
 }
-/** A complete, schema-pinned OpenCode V2 config for the hosted MCP server. */
+/**
+ * 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 function opencodeHostedMcpConfig(mcpEndpoint) {
     return {
         $schema: "https://opencode.ai/config.json",
         mcp: {
-            servers: {
-                [LOCAL_MCP_PACKAGE]: {
-                    type: "remote",
-                    url: mcpEndpoint,
-                },
+            [LOCAL_MCP_PACKAGE]: {
+                type: "remote",
+                url: mcpEndpoint,
+                enabled: true,
             },
         },
     };

package/dist/contracts/teams.d.ts

@@ -217,12 +217,16 @@ export declare const teamUsageResponseSchema: z.ZodObject<{
         storageQuotaBytes: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         storageOverageBytes: z.ZodNumber;
         storageCalculatedAt: z.ZodNullable<z.ZodString>;
-        storageOverQuotaSince: z.ZodNullable<z.ZodString>;
-        storageWarningSentAt: z.ZodNullable<z.ZodString>;
         buildsDeploysThisMonth: z.ZodNumber;
         buildsDeploysMonthly: z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>;
         meterStartedAt: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
+    spaceStorage: z.ZodArray<z.ZodObject<{
+        spaceId: z.ZodString;
+        slug: z.ZodString;
+        title: z.ZodString;
+        storageBytes: z.ZodNumber;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const teamInvitationPreviewSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/contracts/teams.js

@@ -144,14 +144,6 @@ export const teamUsageResponseSchema = z.object({
             .string()
             .nullable()
             .describe("Instant when storage was last accounted."),
-        storageOverQuotaSince: z
-            .string()
-            .nullable()
-            .describe("Instant when the team first went over its storage quota."),
-        storageWarningSentAt: z
-            .string()
-            .nullable()
-            .describe("Instant when the over-quota warning went out."),
         buildsDeploysThisMonth: z
             .number()
             .int()
@@ -163,6 +155,16 @@ export const teamUsageResponseSchema = z.object({
             .describe("Instant when the current metering month started."),
     })
         .describe("Usage counters against the named plan limits."),
+    spaceStorage: z
+        .array(z.object({
+        spaceId: z.string().describe("Space id."),
+        slug: z.string().describe("Space slug."),
+        title: z.string().describe("Space display title."),
+        storageBytes: z
+            .number()
+            .describe("Deduplicated bytes this space's ready versions hold. Spaces sharing files each count them, so the sum can exceed the team total."),
+    }))
+        .describe("Per-space storage breakdown for spaces the caller can read."),
 });
 // Served by `GET /v1/teams/invitations/{invitationId}/preview`: the unauthenticated
 // invite landing view (email is masked, never the full address).

package/dist/docs/agent-prose.js

@@ -65,8 +65,8 @@ export const POSITIONING_PROSE = [
     "optimizes for agent-safe one-shot publish, claim, versioning, rollback, and continuation.",
 ].join("\n");
 export const EXPLAIN_TO_USER_PROSE = [
-    "Present Open and Claim as the only actions. State anonymous expiry in user terms: the Space",
-    "exists until `data.claim.expiresAt` unless claimed; claiming preserves Open and removes its expiry.",
+    "Present Access and Claim as the only actions. State anonymous expiry in user terms: the Space",
+    "exists until `data.claim.expiresAt` unless claimed; claiming preserves Access and removes its expiry.",
     "Keep live and immutable Version addresses as receipt metadata. After claim, the agent key is named",
     "and revocable in the dashboard.",
 ].join("\n");
@@ -88,7 +88,7 @@ export const HOW_TO_RESEARCH_PROSE = [
 /** Curl/API skill lane: docs URLs only — no MCP or CLI tools required. */
 export const HOW_TO_RESEARCH_API_PROSE = [
     "For an error, fetch the problem document's `type` URL. For capability questions, append `.md` to website docs",
-    "URLs (for example `https://spacefast.com/docs/getting-started/agents.md`) or read",
+    "URLs (for example `https://spacefast.com/docs/agents.md`) or read",
     "`https://spacefast.com/llms.txt`. For contracts, read `https://spacefast.com/publish-spec.json`",
     "or the OpenAPI linked from the API docs. Never guess limits: publish, then read diagnostics.",
 ].join("\n");
@@ -107,7 +107,7 @@ export const ENV_NOTES_API_PROSE = [
     "claude.ai: allow `api.spacefast.com` in egress settings. Codex sandbox: escalate only the",
     "network call to `api.spacefast.com`. This skill is complete with curl and the docs links above;",
     "CLI and MCP are optional upgrades documented at https://spacefast.com/docs/cli and",
-    "https://spacefast.com/docs/getting-started/agents.",
+    "https://spacefast.com/docs/agents.",
 ].join("\n");
 /**
  * The CHECK verb: before ever creating a space, look for the one the project
@@ -378,10 +378,10 @@ export const RECEIPT_SHAPE_PROSE = [
     "The JSON receipt is the source of truth:",
     "",
     "- `data.space.liveUrl` — the live URL.",
-    "- `data.open.url` and `data.open.expiresAt` — reusable access; claim preserves the URL and changes its expiry to null.",
+    "- `data.access.url` and `data.access.expiresAt` — reusable access; claim preserves the URL and changes its expiry to null.",
     "  It is not a stable URL or recipient Link; clients must not persist it as Space state.",
     "- `data.version.immutableUrl` — the permanent address of the frozen Version. The bare URL",
-    "  carries no authority: use the receipt's Open URL for the author's browser or create a scoped",
+    "  carries no authority: use the receipt's Access URL for the author's browser or create a scoped",
     "  Link for a recipient. It is reserved in the initial receipt. If the publish is still",
     "  finalizing, poll `data.links.status` with the claim token until the status is `ready`.",
     "- `data.upload` — signed upload instructions for manifest publishes when file bytes were not sent",

package/dist/docs/agent-setup.js

@@ -306,9 +306,9 @@ export function aiInstructionsText() {
         "If `sf` is already on PATH, use it. The package is `spacefast`; the default binary is `sf`.",
         "",
         "```bash",
-        "sf setup agent --agent auto --connect  # pick the right MCP lane and write client config",
+        "sf setup agent --agent auto  # pick the right MCP lane and write client config",
         "sf publish {file-or-dir}   # publish; prints live, version, and claim URLs",
-        "sf versions                # list versions",
+        "sf versions ls             # list versions",
         "sf rollback {version}      # make an earlier ready version live, no rebuild",
         "sf login                   # device flow; mints a scoped API key",
         "sf --help                  # the full command surface",
@@ -346,9 +346,9 @@ export function aiInstructionsText() {
         "Use On-Device MCP when the agent needs path-based publish from the user's checkout:",
         "",
         "```bash",
-        "sf setup agent --agent auto --connect",
-        "sf mcp install --agent codex --mode hosted --connect",
-        "sf mcp install --agent codex --mode local --transport stdio --connect",
+        "sf setup agent --agent auto",
+        "sf mcp install --agent codex --remote --oauth",
+        "sf mcp install --agent codex",
         "sf mcp",
         "sf mcp http --host 127.0.0.1 --port 3945 --path /mcp",
         "```",
@@ -391,7 +391,7 @@ export function aiInstructionsText() {
         "## Agent-aware routing",
         "",
         `${BRAND.productName} supports an \`Agent=true\` condition in \`_redirects\` — a browser gets the HTML`,
-        "page, an agent fetch gets plain text at the same URL. This very page uses it:",
+        "page, an agent fetch gets plain text at the same URL. For example:",
         "",
         "```text",
         "/ai /ai.txt 200! Agent=true",
@@ -401,15 +401,14 @@ export function aiInstructionsText() {
         "",
         "- Docs index for agents: https://spacefast.com/llms.txt",
         "- One-click connect (Claude Code, Claude, Codex, Cursor, VS Code): https://spacefast.com/agents",
-        "- Agent guide: https://spacefast.com/docs/getting-started/agents",
+        "- Agent guide: https://spacefast.com/docs/agents",
         "- CLI reference: https://spacefast.com/docs/cli",
         "- REST API + OpenAPI: https://spacefast.com/docs/api",
         "- Publish contract (machine-readable): https://spacefast.com/publish-spec.json",
         "- Connectors-directory manifest (hosted MCP listing): https://spacefast.com/.well-known/connector.json",
         "- Every error code: https://spacefast.com/docs/errors",
         "",
-        "Append `.md` to any docs URL for Markdown, or just fetch — agent user agents get",
-        "Markdown automatically.",
+        "Append `.md` to any docs URL for Markdown.",
         "",
         "## Environment notes",
         "",
@@ -571,7 +570,7 @@ export function agentSetupMarkdown() {
         buildHermesMcpAddCommand(mcpEndpoint),
         "```",
         "",
-        "OpenCode V2 — merge this schema-pinned config into `~/.config/opencode/opencode.jsonc`:",
+        "OpenCode V2 — merge this schema-pinned config into `~/.config/opencode/opencode.json`:",
         "",
         "```json",
         JSON.stringify(opencodeHostedMcpConfig(mcpEndpoint), null, 2),

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

@@ -54,7 +54,7 @@ export declare const agentSolutions: readonly [{
     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}/getting-started/agents`;
+    readonly guideUrl: `${string}/agents`;
     readonly setupText: string;
 }, {
     readonly id: "claude-ai";
@@ -64,7 +64,7 @@ export declare const agentSolutions: readonly [{
     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}/getting-started/agents`;
+    readonly guideUrl: `${string}/agents`;
     readonly setupText: string;
 }, {
     readonly id: "raycast";
@@ -74,7 +74,7 @@ export declare const agentSolutions: readonly [{
     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}/getting-started/agents`;
+    readonly guideUrl: `${string}/agents`;
     readonly setupText: string;
 }, {
     readonly id: "cursor";
@@ -84,7 +84,7 @@ export declare const agentSolutions: readonly [{
     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}/getting-started/agents`;
+    readonly guideUrl: `${string}/agents`;
     readonly setupText: string;
 }, {
     readonly id: "terminal";

package/dist/docs/agent-solutions.js

@@ -89,8 +89,8 @@ export const agentSolutions = [
         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}/getting-started/agents`,
-        setupText: hostedMcpText("ChatGPT", `${DOCS_BASE_URL}/getting-started/agents`),
+        guideUrl: `${DOCS_BASE_URL}/agents`,
+        setupText: hostedMcpText("ChatGPT", `${DOCS_BASE_URL}/agents`),
     },
     {
         id: "claude-ai",
@@ -100,8 +100,8 @@ export const agentSolutions = [
         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}/getting-started/agents`,
-        setupText: hostedMcpText("Claude.ai", `${DOCS_BASE_URL}/getting-started/agents`),
+        guideUrl: `${DOCS_BASE_URL}/agents`,
+        setupText: hostedMcpText("Claude.ai", `${DOCS_BASE_URL}/agents`),
     },
     {
         id: "raycast",
@@ -111,8 +111,8 @@ export const agentSolutions = [
         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}/getting-started/agents`,
-        setupText: hostedMcpText("Raycast", `${DOCS_BASE_URL}/getting-started/agents`),
+        guideUrl: `${DOCS_BASE_URL}/agents`,
+        setupText: hostedMcpText("Raycast", `${DOCS_BASE_URL}/agents`),
     },
     {
         id: "cursor",
@@ -125,8 +125,8 @@ export const agentSolutions = [
             "sf setup agent --agent auto --connect",
             "sf mcp install --agent auto --mode local --transport stdio --connect",
         ],
-        guideUrl: `${DOCS_BASE_URL}/getting-started/agents`,
-        setupText: localMcpText("Cursor or another MCP client", `${DOCS_BASE_URL}/getting-started/agents`),
+        guideUrl: `${DOCS_BASE_URL}/agents`,
+        setupText: localMcpText("Cursor or another MCP client", `${DOCS_BASE_URL}/agents`),
     },
     {
         id: "terminal",

package/dist/docs/skills.d.ts

@@ -39,7 +39,7 @@ export declare const SPACEFAST_SKILLS: readonly [{
     readonly recipe: {
         readonly slug: "recipes/create-and-publish-site";
         readonly tier: "full";
-        readonly url: `${string}/getting-started/agents`;
+        readonly url: `${string}/agents`;
     };
 }, {
     readonly name: "publish-and-verify";
@@ -212,7 +212,7 @@ export declare const SPACEFAST_PROMPT_SKILLS: ({
     readonly recipe: {
         readonly slug: "recipes/create-and-publish-site";
         readonly tier: "full";
-        readonly url: `${string}/getting-started/agents`;
+        readonly url: `${string}/agents`;
     };
 } | {
     readonly name: "publish-and-verify";
@@ -385,7 +385,7 @@ export declare const SPACEFAST_RECIPE_SKILLS: (({
     readonly recipe: {
         readonly slug: "recipes/create-and-publish-site";
         readonly tier: "full";
-        readonly url: `${string}/getting-started/agents`;
+        readonly url: `${string}/agents`;
     };
 } | {
     readonly name: "publish-and-verify";

package/dist/docs/skills.js

@@ -31,7 +31,7 @@ export const SPACEFAST_SKILLS = [
         recipe: {
             slug: "recipes/create-and-publish-site",
             tier: "full",
-            url: `${DOCS_BASE_URL}/getting-started/agents`,
+            url: `${DOCS_BASE_URL}/agents`,
         },
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spacefast/common",
-  "version": "0.0.20",
+  "version": "0.0.23",
   "license": "MIT",
   "description": "Shared TypeScript contracts and utilities for Spacefast packages.",
   "repository": {