@spacefast/common 0.0.24 → 0.0.26

package/dist/contracts/teams.d.ts

@@ -1,8 +1,8 @@
 import { z } from "zod";
 export declare const TEAM_ROLE_VALUES: readonly ["owner", "admin", "member"];
 export declare const teamMemberRole: z.ZodEnum<{
-    owner: "owner";
     admin: "admin";
+    owner: "owner";
     member: "member";
 }>;
 /**
@@ -10,12 +10,12 @@ export declare const teamMemberRole: z.ZodEnum<{
  * it back has to land on the same canonical value. Unknown roles carry no
  * privilege, so they read as the least-privileged one.
  */
-export declare function normalizeTeamMemberRole(role: string | null | undefined): "owner" | "admin" | "member";
+export declare function normalizeTeamMemberRole(role: string | null | undefined): "admin" | "owner" | "member";
 export declare const teamInvitationCreateSchema: z.ZodObject<{
     email: z.ZodString;
     role: z.ZodDefault<z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>>;
 }, z.core.$strip>;
@@ -46,8 +46,8 @@ export declare const TeamMemberSchema: z.ZodObject<{
     teamId: z.ZodString;
     userId: z.ZodString;
     role: z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>;
     createdAt: z.ZodString;
@@ -60,8 +60,8 @@ export declare const TeamMemberSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const teamMemberRoleUpdateSchema: z.ZodObject<{
     role: z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>;
 }, z.core.$strip>;
@@ -71,8 +71,8 @@ export declare const TeamInvitationSchema: z.ZodObject<{
     teamId: z.ZodString;
     email: z.ZodString;
     role: z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>;
     status: z.ZodString;
@@ -93,8 +93,8 @@ export declare const TeamSummarySchema: z.ZodObject<{
     name: z.ZodString;
     slug: z.ZodString;
     role: z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>;
     plan: z.ZodEnum<{
@@ -114,8 +114,8 @@ export declare const TeamDetailSchema: z.ZodObject<{
     name: z.ZodString;
     slug: z.ZodString;
     role: z.ZodEnum<{
-        owner: "owner";
         admin: "admin";
+        owner: "owner";
         member: "member";
     }>;
     plan: z.ZodEnum<{
@@ -139,8 +139,8 @@ export declare const teamListResponseSchema: z.ZodObject<{
         name: z.ZodString;
         slug: z.ZodString;
         role: z.ZodEnum<{
-            owner: "owner";
             admin: "admin";
+            owner: "owner";
             member: "member";
         }>;
         plan: z.ZodEnum<{
@@ -165,8 +165,8 @@ export declare const teamMemberListResponseSchema: z.ZodObject<{
         teamId: z.ZodString;
         userId: z.ZodString;
         role: z.ZodEnum<{
-            owner: "owner";
             admin: "admin";
+            owner: "owner";
             member: "member";
         }>;
         createdAt: z.ZodString;
@@ -198,8 +198,8 @@ export declare const teamInvitationAcceptResponseSchema: z.ZodObject<{
         teamSlug: z.ZodString;
         userId: z.ZodString;
         role: z.ZodEnum<{
-            owner: "owner";
             admin: "admin";
+            owner: "owner";
             member: "member";
         }>;
     }, z.core.$strip>;
@@ -210,8 +210,8 @@ export declare const teamInvitationListResponseSchema: z.ZodObject<{
         teamId: z.ZodString;
         email: z.ZodString;
         role: z.ZodEnum<{
-            owner: "owner";
             admin: "admin";
+            owner: "owner";
             member: "member";
         }>;
         status: z.ZodString;
@@ -234,15 +234,12 @@ export declare const teamSettingsResponseSchema: z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
     }, z.core.$strip>>;
-    wpCloudCapabilities: z.ZodObject<{
+    infraCapabilities: z.ZodObject<{
         datacenters: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             label: z.ZodString;
         }, z.core.$strip>>;
-        phpVersions: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            label: z.ZodString;
-        }, z.core.$strip>>;
+        phpVersion: z.ZodLiteral<"8.5">;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const teamUsageResponseSchema: z.ZodObject<{

package/dist/contracts/teams.js

@@ -50,7 +50,7 @@ export const TeamInvitationSchema = z.object({
     expiresAt: z.string().datetime(),
     createdAt: z.string().datetime(),
 });
-// Team (internal-docs/platform.md "Team"): Better Auth team in the main
+// Team (the platform spec "Team"): Better Auth team in the main
 // tenant, carrying the resolved plan and default data location.
 export const teamPlanCode = planCodeSchema;
 export const TeamSummarySchema = z.object({
@@ -123,7 +123,7 @@ export const teamDataLocationSchema = z
 export const teamSettingsUpdateSchema = z.object({
     defaultDataLocation: teamDataLocationSchema,
 });
-const wpCloudCapabilityOptionSchema = z.object({
+const infraCapabilityOptionSchema = z.object({
     id: z.string(),
     label: z.string(),
 });
@@ -133,12 +133,12 @@ export const teamSettingsResponseSchema = z.object({
     teamId: z.string().describe("The team id the settings belong to."),
     defaultDataLocation: teamDataLocationSchema,
     regionOptions: z
-        .array(wpCloudCapabilityOptionSchema)
+        .array(infraCapabilityOptionSchema)
         .describe("Placement regions currently available for new spaces."),
-    wpCloudCapabilities: z
+    infraCapabilities: z
         .object({
-        datacenters: z.array(wpCloudCapabilityOptionSchema),
-        phpVersions: z.array(wpCloudCapabilityOptionSchema),
+        datacenters: z.array(infraCapabilityOptionSchema),
+        phpVersion: z.literal("8.5"),
     })
         .describe("Live capabilities for the team's infra provider account."),
 });

package/dist/contracts/transfers.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { spaceTransferStatus } from "./enums.js";
-// Tenant-local external principal id grammar (internal-docs/platform.md
+// Tenant-local external principal id grammar (the platform spec
 // "Principal"): 1-256 chars, no whitespace, no `/` or `\`, no
 // control/non-printable characters. Team principal ids are Better Auth team
 // ids and trivially satisfy the same grammar.
@@ -15,7 +15,7 @@ export const principalIdSchema = z
 }))
     .describe("Tenant-local principal id: a team id or an integrator external customer id.");
 // Request `to` omits tenantId: transfers are tenant-local and the tenant is
-// inferred from the space (internal-docs/platform.md "Transfer semantics").
+// inferred from the space (the platform spec "Transfer semantics").
 export const transferPrincipalInputSchema = z.object({
     principalType: z
         .enum(["team", "external"])

package/dist/contracts/variables.d.ts

@@ -117,14 +117,14 @@ export declare const variableMutationResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;
@@ -161,14 +161,14 @@ export declare const variableDeleteResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;

package/dist/contracts/variables.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { AsyncOperationSchema, CursorPaginationSchema, cursorListQuerySchema } from "./common.js";
-// Variable (internal-docs/platform.md "Product Data Shapes"): one model for
+// Variable (the platform spec "Product Data Shapes"): one model for
 // every scope. Resolution order at finalize is space -> principal. A space IS
 // a site, so a space variable is the site variable — there is no third scope
 // underneath it. Secret values are write-only after creation: never returned
@@ -28,7 +28,7 @@ export const VariableSchema = z.object({
     createdAt: z.string().datetime().describe("Instant when the variable was created."),
     updatedAt: z.string().datetime().describe("Instant when the value was last written."),
 });
-// Version provenance (internal-docs/platform.md "Variable rules"): versions
+// Version provenance (the platform spec "Variable rules"): versions
 // record which variable names and value hashes they were finalized with —
 // never values. Stored only for internal cascade and synchronization; it is
 // never echoed on the public Version resource because historical rows cannot
@@ -67,7 +67,7 @@ export const spaceVariableListResponseSchema = z.object({
     pagination: CursorPaginationSchema,
 });
 // Variable mutations return the debounced cascade operation
-// (internal-docs/platform.md "Debounce contract"): every coalesced PUT/DELETE
+// (the platform spec "Debounce contract"): every coalesced PUT/DELETE
 // returns the same pending `op_` id, so "mutation returns `operation`" holds.
 export const variableMutationResponseSchema = z.object({
     data: VariableSchema,

package/dist/contracts/webhooks.d.ts

@@ -94,14 +94,14 @@ export declare const webhookDeliverySchema: z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
             info: "info";
-            warning: "warning";
             error: "error";
+            warning: "warning";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             registrar: "registrar";
-            wpcloud: "wpcloud";
+            infra: "infra";
             dns: "dns";
             runtime: "runtime";
         }>>>;
@@ -135,14 +135,14 @@ export declare const webhookDeliveryListResponseSchema: z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
                 info: "info";
-                warning: "warning";
                 error: "error";
+                warning: "warning";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 registrar: "registrar";
-                wpcloud: "wpcloud";
+                infra: "infra";
                 dns: "dns";
                 runtime: "runtime";
             }>>>;

package/dist/contracts/zero.d.ts

@@ -42,7 +42,7 @@ export declare const ZERO_RUNTIME_STORAGE_ROOT = "__spacefast/zero";
 export declare const ZERO_RUNTIME_ARTIFACT_PATH = "__spacefast/zero/artifact.json";
 export declare const ZERO_RUNTIME_CONFIG_PATH = "__spacefast/zero/config.json";
 export declare const ZERO_RUNTIME_BINARY_PATH = "__spacefast/zero/bin/stattic-runtime";
-export declare const ZERO_RUNTIME_BINARY_COMPATIBILITY_TARGET = "wpcloud-linux-x86_64-gnu-v1";
+export declare const ZERO_RUNTIME_BINARY_COMPATIBILITY_TARGET = "linux-x86_64-gnu-v1";
 export declare const ZERO_RUNTIME_BUNDLE_ROOT = "__spacefast/zero/bundles";
 export declare const ZERO_RUNTIME_SERVER_BUNDLE_PATH = "__spacefast/zero/bundles/server.qjs.mjs";
 /** The compiled capsule client, served at the app root. */
@@ -142,7 +142,6 @@ export declare const zeroTableIndexSchema: z.ZodObject<{
     name: z.ZodString;
     fields: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
-export type ZeroTableIndex = z.infer<typeof zeroTableIndexSchema>;
 export declare const zeroTableSchema: z.ZodObject<{
     name: z.ZodString;
     columns: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -360,8 +359,8 @@ export declare const zeroMigrationPlanSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type ZeroMigrationPlan = z.infer<typeof zeroMigrationPlanSchema>;
 export declare const zeroInspectPolicySchema: z.ZodEnum<{
-    public: "public";
     private: "private";
+    public: "public";
 }>;
 export declare const zeroRuntimePublicAuthConfigSchema: z.ZodObject<{
     provider: z.ZodDefault<z.ZodLiteral<"gravatar">>;
@@ -389,7 +388,6 @@ export declare const zeroRuntimePublicRealtimeConfigSchema: z.ZodObject<{
     spaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     versionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strict>;
-export type ZeroRuntimePublicRealtimeConfig = z.infer<typeof zeroRuntimePublicRealtimeConfigSchema>;
 export declare const zeroRuntimeClientConfigSchema: z.ZodObject<{
     runtimeKind: z.ZodLiteral<"zero">;
     basePath: z.ZodOptional<z.ZodString>;
@@ -430,7 +428,7 @@ export declare const zeroRuntimeInstallProfileSchema: z.ZodObject<{
     binary: z.ZodObject<{
         path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
         compatibilityTarget: z.ZodObject<{
-            profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
+            profile: z.ZodLiteral<"linux-x86_64-gnu-v1">;
             os: z.ZodLiteral<"linux">;
             cpu: z.ZodLiteral<"x86_64">;
             libc: z.ZodLiteral<"glibc">;
@@ -534,7 +532,7 @@ export declare const zeroCapsuleArtifactSchema: z.ZodObject<{
         sockets: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>;
     db: z.ZodObject<{
-        backend: z.ZodLiteral<"wpcloud-mysql">;
+        backend: z.ZodLiteral<"mysql">;
         migrations: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             op: z.ZodLiteral<"create_table">;
             table: z.ZodString;
@@ -631,7 +629,7 @@ export declare const zeroRuntimeFinalizePayloadSchema: z.ZodObject<{
         binary: z.ZodObject<{
             path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
             compatibilityTarget: z.ZodObject<{
-                profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
+                profile: z.ZodLiteral<"linux-x86_64-gnu-v1">;
                 os: z.ZodLiteral<"linux">;
                 cpu: z.ZodLiteral<"x86_64">;
                 libc: z.ZodLiteral<"glibc">;
@@ -696,7 +694,7 @@ export declare const zeroRuntimeFinalizePayloadSchema: z.ZodObject<{
             sockets: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>;
         db: z.ZodObject<{
-            backend: z.ZodLiteral<"wpcloud-mysql">;
+            backend: z.ZodLiteral<"mysql">;
             migrations: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 op: z.ZodLiteral<"create_table">;
                 table: z.ZodString;
@@ -924,8 +922,8 @@ export declare const zeroRuntimeFinalizePayloadSchema: z.ZodObject<{
     }, z.core.$strict>>;
     inspect: z.ZodDefault<z.ZodObject<{
         policy: z.ZodDefault<z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
@@ -1003,7 +1001,7 @@ export declare const zeroRuntimeConfigSchema: z.ZodObject<{
             sockets: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>;
         db: z.ZodObject<{
-            backend: z.ZodLiteral<"wpcloud-mysql">;
+            backend: z.ZodLiteral<"mysql">;
             migrations: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 op: z.ZodLiteral<"create_table">;
                 table: z.ZodString;
@@ -1156,7 +1154,7 @@ export declare const zeroRuntimeConfigSchema: z.ZodObject<{
         binary: z.ZodObject<{
             path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
             compatibilityTarget: z.ZodObject<{
-                profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
+                profile: z.ZodLiteral<"linux-x86_64-gnu-v1">;
                 os: z.ZodLiteral<"linux">;
                 cpu: z.ZodLiteral<"x86_64">;
                 libc: z.ZodLiteral<"glibc">;
@@ -1177,8 +1175,8 @@ export declare const zeroRuntimeConfigSchema: z.ZodObject<{
     }, z.core.$strict>;
     inspect: z.ZodDefault<z.ZodObject<{
         policy: z.ZodDefault<z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>>;
     }, z.core.$strict>>;
     variableValues: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -1201,7 +1199,7 @@ export declare const zeroDeployMetadataSchema: z.ZodObject<{
             binary: z.ZodObject<{
                 path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
                 compatibilityTarget: z.ZodObject<{
-                    profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
+                    profile: z.ZodLiteral<"linux-x86_64-gnu-v1">;
                     os: z.ZodLiteral<"linux">;
                     cpu: z.ZodLiteral<"x86_64">;
                     libc: z.ZodLiteral<"glibc">;
@@ -1266,7 +1264,7 @@ export declare const zeroDeployMetadataSchema: z.ZodObject<{
                 sockets: z.ZodDefault<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>;
             db: z.ZodObject<{
-                backend: z.ZodLiteral<"wpcloud-mysql">;
+                backend: z.ZodLiteral<"mysql">;
                 migrations: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     op: z.ZodLiteral<"create_table">;
                     table: z.ZodString;
@@ -1494,8 +1492,8 @@ export declare const zeroDeployMetadataSchema: z.ZodObject<{
         }, z.core.$strict>>;
         inspect: z.ZodDefault<z.ZodObject<{
             policy: z.ZodDefault<z.ZodEnum<{
-                public: "public";
                 private: "private";
+                public: "public";
             }>>;
         }, z.core.$strict>>;
     }, z.core.$strict>;
@@ -1524,8 +1522,8 @@ export declare const zeroAppSchema: z.ZodObject<{
     serverRuntime: z.ZodLiteral<"quickjs-rust">;
     inspect: z.ZodObject<{
         policy: z.ZodEnum<{
-            public: "public";
             private: "private";
+            public: "public";
         }>;
     }, z.core.$strict>;
     install: z.ZodObject<{
@@ -1537,7 +1535,7 @@ export declare const zeroAppSchema: z.ZodObject<{
         binary: z.ZodObject<{
             path: z.ZodLiteral<"__spacefast/zero/bin/stattic-runtime">;
             compatibilityTarget: z.ZodObject<{
-                profile: z.ZodLiteral<"wpcloud-linux-x86_64-gnu-v1">;
+                profile: z.ZodLiteral<"linux-x86_64-gnu-v1">;
                 os: z.ZodLiteral<"linux">;
                 cpu: z.ZodLiteral<"x86_64">;
                 libc: z.ZodLiteral<"glibc">;

package/dist/contracts/zero.js

@@ -42,7 +42,7 @@ export const ZERO_RUNTIME_STORAGE_ROOT = "__spacefast/zero";
 export const ZERO_RUNTIME_ARTIFACT_PATH = `${ZERO_RUNTIME_STORAGE_ROOT}/artifact.json`;
 export const ZERO_RUNTIME_CONFIG_PATH = `${ZERO_RUNTIME_STORAGE_ROOT}/config.json`;
 export const ZERO_RUNTIME_BINARY_PATH = `${ZERO_RUNTIME_STORAGE_ROOT}/bin/stattic-runtime`;
-export const ZERO_RUNTIME_BINARY_COMPATIBILITY_TARGET = "wpcloud-linux-x86_64-gnu-v1";
+export const ZERO_RUNTIME_BINARY_COMPATIBILITY_TARGET = "linux-x86_64-gnu-v1";
 export const ZERO_RUNTIME_BUNDLE_ROOT = `${ZERO_RUNTIME_STORAGE_ROOT}/bundles`;
 export const ZERO_RUNTIME_SERVER_BUNDLE_PATH = `${ZERO_RUNTIME_BUNDLE_ROOT}/server.qjs.mjs`;
 /** The compiled capsule client, served at the app root. */
@@ -137,7 +137,7 @@ export const zeroEndpointSchema = z
     path: zeroRoutePathSchema,
 })
     .strict();
-function zeroEndpointRouteMatchShape(path) {
+function zeroEndpointRouteMatch(path) {
     const segments = [];
     let score = 0;
     let splat = false;
@@ -166,17 +166,17 @@ export function zeroEndpointRoutesAmbiguous(left, right) {
         (left.method === "HEAD" && right.method === "GET");
     if (!methodsOverlap)
         return false;
-    const leftShape = zeroEndpointRouteMatchShape(left.path);
-    const rightShape = zeroEndpointRouteMatchShape(right.path);
-    if (leftShape.score !== rightShape.score)
+    const leftMatch = zeroEndpointRouteMatch(left.path);
+    const rightMatch = zeroEndpointRouteMatch(right.path);
+    if (leftMatch.score !== rightMatch.score)
         return false;
-    if (!leftShape.splat && leftShape.segments.length < rightShape.segments.length)
+    if (!leftMatch.splat && leftMatch.segments.length < rightMatch.segments.length)
         return false;
-    if (!rightShape.splat && rightShape.segments.length < leftShape.segments.length)
+    if (!rightMatch.splat && rightMatch.segments.length < leftMatch.segments.length)
         return false;
-    return Array.from({ length: Math.min(leftShape.segments.length, rightShape.segments.length) }, (_, index) => index).every((index) => {
-        const segment = leftShape.segments[index];
-        const other = rightShape.segments[index];
+    return Array.from({ length: Math.min(leftMatch.segments.length, rightMatch.segments.length) }, (_, index) => index).every((index) => {
+        const segment = leftMatch.segments[index];
+        const other = rightMatch.segments[index];
         return segment === null || other === null || segment === other;
     });
 }
@@ -536,7 +536,7 @@ export const zeroCapsuleArtifactSchema = z
         .strict(),
     db: z
         .object({
-        backend: z.literal("wpcloud-mysql"),
+        backend: z.literal("mysql"),
         migrations: z.array(zeroMigrationOperationSchema).default([]),
     })
         .strict(),
@@ -726,7 +726,7 @@ export function createZeroCapsuleArtifact(input) {
             sockets: input.sockets ?? [],
         },
         db: {
-            backend: "wpcloud-mysql",
+            backend: "mysql",
             migrations: [],
         },
         realtime: {

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

@@ -6,6 +6,7 @@ export declare const ARCHIVE_SECRET_GLOBS: readonly [".env*", ".npmrc", ".netrc"
 export declare const SECRET_RULES_PROSE: string;
 export declare const POSITIONING_PROSE: string;
 export declare const EXPLAIN_TO_USER_PROSE: string;
+export declare const FEEDBACK_PROSE = "With user approval, send feedback with `sf feedback`, MCP `execute` (search `send feedback`), or `POST /v1/feedback`. Never include credentials or private links.";
 export declare const FAILURE_CONDUCT_PROSE: string;
 export declare const LANE_PICKER_PROSE: string;
 export declare const HOW_TO_RESEARCH_PROSE: string;
@@ -91,4 +92,3 @@ export declare const AGENT_PROSE: {
     readonly envNotes: string;
     readonly envNotesApi: string;
 };
-export type AgentProseKey = keyof typeof AGENT_PROSE;

package/dist/docs/agent-prose.js

@@ -4,7 +4,7 @@ import { serviceOrigin } from "../config/domains.js";
 //
 //   - packages/cli/skill.template.md  (the SKILL.md router + copies)
 //   - packages/common/src/docs/agent-setup.ts (the /ai and /ai.txt page body)
-//   - apps/www/src/lib/llmo.ts                (the agent-card / discovery prose)
+//   - spacefast/www                           (the agent-card / discovery prose)
 //
 // Each surface re-stated the publish sequence, the secret rules, and the receipt
 // shape in its own words, so they drifted. These fragments are the one source of
@@ -70,14 +70,13 @@ export const SECRET_RULES_PROSE = [
     "clear them after use, and avoid durable auth unless the user explicitly asks.",
 ].join("\n");
 export const POSITIONING_PROSE = [
-    "Spacefast is a static host for AI-made web artifacts: permanent live URLs, immutable version",
-    "URLs, anonymous publish with a claim link, and agent continuation after claim. Spaces serve",
-    "static files; app code runs only through a declared Zero or Functions runtime.",
+    "Spacefast is the best place to share AI artifacts.",
+    "Spaces serve files directly; app code runs only through a declared Zero or Functions runtime.",
     "",
     "Do not claim that no-account publish followed by claim is unique to Spacefast. here.now and",
     "Netlify offer native anonymous publish-and-claim flows; Cloudflare offers temporary accounts",
     "and claim deployments; Vercel lets agents and platforms transfer deployments to users.",
-    "Spacefast's narrower lane is direct static HTTP publishing with separate Access and Claim",
+    "Spacefast's narrower lane is direct HTTP publishing with separate Access and Claim",
     "authority, immutable versions, rollback, and agent continuation after claim. GitHub Pages",
     "remains repository-native and has no equivalent anonymous ownership-handoff flow documented.",
 ].join("\n");
@@ -87,10 +86,12 @@ export const EXPLAIN_TO_USER_PROSE = [
     "Keep live and immutable Version addresses as receipt metadata. After claim, the agent key is named",
     "and revocable in the dashboard.",
 ].join("\n");
+export const FEEDBACK_PROSE = "With user approval, send feedback with `sf feedback`, MCP `execute` (search `send feedback`), or `POST /v1/feedback`. Never include credentials or private links.";
 export const FAILURE_CONDUCT_PROSE = [
     "On failure, surface the problem document's `code`, `type`, and `requestId`, then stop.",
-    "Do not invent undocumented endpoints. Do not read credentials out of auth files. Do not",
-    "retry a one-shot operation without reusing its `Idempotency-Key`.",
+    "Do not invent undocumented endpoints. Do not read credentials out of auth files. Retrying a",
+    "failed publish with the same files is safe: it returns the Space the first attempt created.",
+    FEEDBACK_PROSE,
 ].join("\n");
 export const LANE_PICKER_PROSE = [
     "Pick the lane by environment: filesystem plus repeat work means CLI or On-Device MCP; no",
@@ -141,7 +142,7 @@ export const CHECK_BEFORE_PUBLISH_PROSE = [
     "",
     "If any of these finds a space, publish a new version to that `spaceId` (see the update",
     "instructions) instead of creating another space. Only create a new space when none exists",
-    "and the user wants a new site.",
+    "and the user wants a new one.",
 ].join("\n");
 export const CHECK_BEFORE_PUBLISH_API_PROSE = [
     "Before creating a space, check whether this project already has one:",
@@ -157,7 +158,7 @@ export const CHECK_BEFORE_PUBLISH_API_PROSE = [
     "",
     "If any of these finds a space, publish a new version to that `spaceId` (see the update",
     "instructions) instead of creating another space. Only create a new space when none exists",
-    "and the user wants a new site.",
+    "and the user wants a new one.",
 ].join("\n");
 export const CHECK_BEFORE_PUBLISH_MCP_PROSE = [
     "Before creating a space, check whether this project already has one:",
@@ -168,7 +169,7 @@ export const CHECK_BEFORE_PUBLISH_MCP_PROSE = [
     "- When authenticated, use `execute` to call the generated list-spaces operation.",
     "",
     "If any of these finds a space, publish a new version to that space instead of creating",
-    "another. Only create a new space when none exists and the user wants a new site.",
+    "another. Only create a new space when none exists and the user wants a new one.",
 ].join("\n");
 /**
  * The SAVE verb: persist the space id and credential after a first publish so
@@ -340,12 +341,8 @@ export const PUBLISH_SEQUENCE_PROSE = [
     '[ -f "$publish_target" ] || { printf "error: publish file is not a regular file\\n" >&2; exit 2; }',
     'escaped_path="${publish_target//\\\\/\\\\\\\\}"',
     'escaped_path="${escaped_path//\\"/\\\\\\"}"',
-    "idempotency_key=\"publish-$(od -An -N16 -tx1 /dev/urandom | tr -d ' \\n')\"",
-    "idempotency_principal=\"$(od -An -N32 -tx1 /dev/urandom | tr -d ' \\n')\"",
     'api_origin="${SPACEFAST_API_ORIGIN:-https://api.spacefast.com}"',
     'curl -q -sS -F "files=@\\"$escaped_path\\"" \\',
-    '  -H "Idempotency-Key: $idempotency_key" \\',
-    '  -H "x-spacefast-idempotency-principal: $idempotency_principal" \\',
     '  "$api_origin/v1/publish"',
     "SPACEFAST_PUBLISH",
     "```",

package/dist/docs/agent-setup.js

@@ -1,8 +1,9 @@
 import { buildClaudeMcpAddCommand, buildHermesMcpAddCommand, cursorHostedMcpDeeplink, cursorHostedMcpServersJson, getConnectTarget, opencodeHostedMcpConfig, vscodeHostedMcpDeeplink, vscodeHostedMcpServersJson, } from "../agents/connect-targets.js";
 import { BRAND } from "../brand.js";
 import { serviceOrigin } from "../config/domains.js";
+import { PLAN_DEFINITIONS, SELF_SERVE_PLAN_CODES } from "../contracts/features.js";
 import { createBrowserCredentialUrl, parseBrowserCredentialUrl, } from "../utils/browser-credential.js";
-import { CHECK_BEFORE_PUBLISH_PROSE, CONTINUE_AFTER_CLAIM_PROSE, ENV_NOTES_PROSE, FAILURE_CONDUCT_PROSE, HOW_TO_RESEARCH_PROSE, LANE_PICKER_PROSE, POSITIONING_PROSE, PUBLISH_SEQUENCE_PROSE, RECEIPT_SHAPE_PROSE, SAVE_STATE_PROSE, SECRET_RULES_PROSE, SIGNED_UPLOAD_PROSE, UPDATE_SPACE_PROSE, } from "./agent-prose.js";
+import { CHECK_BEFORE_PUBLISH_PROSE, CONTINUE_AFTER_CLAIM_PROSE, ENV_NOTES_PROSE, FAILURE_CONDUCT_PROSE, FEEDBACK_PROSE, HOW_TO_RESEARCH_PROSE, LANE_PICKER_PROSE, POSITIONING_PROSE, PUBLISH_SEQUENCE_PROSE, RECEIPT_SHAPE_PROSE, SAVE_STATE_PROSE, SECRET_RULES_PROSE, SIGNED_UPLOAD_PROSE, UPDATE_SPACE_PROSE, } from "./agent-prose.js";
 import { spacefastClaudePluginAddCommand, spacefastClaudeDesktopExtensionUrl, spacefastClaudePluginInstallCommand, spacefastCodexPluginAddCommand, spacefastCodexPluginInstallCommand, spacefastInstallCurlCommand, spacefastInstallPowerShellCommand, spacefastSkillFetchCommand, spacefastSkillInstallCommand, spacefastSkillUrl, } from "./skill-distribution.js";
 // The one URL every agent prompt points at. /setup.md is the actionable front
 // door (publish now, then set up your client); /ai.txt stays the deep
@@ -398,7 +399,7 @@ export function aiInstructionsText() {
         "  agent-readable too.",
         "- Plan limits surface as diagnostics, not failures you should guess at: publish the",
         "  intended artifact, then read and report what the CLI or API says. When a feature",
-        '  is plan-gated, say: "Not available on Free. Available on Personal and Work."',
+        `  is plan-gated, say: "Not available on ${PLAN_DEFINITIONS.free.name}. Available on ${SELF_SERVE_PLAN_CODES.map((code) => PLAN_DEFINITIONS[code].name).join(" and ")}."`,
         "",
         "## Agent-aware routing",
         "",
@@ -623,6 +624,8 @@ export function agentSetupMarkdown() {
         "  saved bearer token.",
         "- Recommend the matching setup above so the next publish is one word.",
         "",
+        FEEDBACK_PROSE,
+        "",
         "## Resources",
         "",
         `- Full publishing contract for agents: ${agentSetupTextUrl}`,