@spacefast/common 0.0.5 → 0.0.6

package/dist/contracts/tags.d.ts

@@ -1,8 +1,8 @@
 import { z } from "zod";
 export declare const tagVersionStatusSchema: z.ZodEnum<{
     approved: "approved";
-    draft: "draft";
     publishing: "publishing";
+    draft: "draft";
     in_review: "in_review";
     published: "published";
     abandoned: "abandoned";
@@ -142,8 +142,8 @@ export declare const tagVersionSchema: z.ZodObject<{
     baseVersionId: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
         approved: "approved";
-        draft: "draft";
         publishing: "publishing";
+        draft: "draft";
         in_review: "in_review";
         published: "published";
         abandoned: "abandoned";
@@ -197,8 +197,8 @@ export declare const tagVersionListQuerySchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<{
         approved: "approved";
-        draft: "draft";
         publishing: "publishing";
+        draft: "draft";
         in_review: "in_review";
         published: "published";
         abandoned: "abandoned";
@@ -212,8 +212,8 @@ export declare const tagVersionListResponseSchema: z.ZodObject<{
         baseVersionId: z.ZodNullable<z.ZodString>;
         status: z.ZodEnum<{
             approved: "approved";
-            draft: "draft";
             publishing: "publishing";
+            draft: "draft";
             in_review: "in_review";
             published: "published";
             abandoned: "abandoned";
@@ -275,8 +275,8 @@ export declare const tagVersionResponseSchema: z.ZodObject<{
         baseVersionId: z.ZodNullable<z.ZodString>;
         status: z.ZodEnum<{
             approved: "approved";
-            draft: "draft";
             publishing: "publishing";
+            draft: "draft";
             in_review: "in_review";
             published: "published";
             abandoned: "abandoned";
@@ -591,8 +591,8 @@ export declare const tagApplyResponseSchema: z.ZodObject<{
             baseVersionId: z.ZodNullable<z.ZodString>;
             status: z.ZodEnum<{
                 approved: "approved";
-                draft: "draft";
                 publishing: "publishing";
+                draft: "draft";
                 in_review: "in_review";
                 published: "published";
                 abandoned: "abandoned";
@@ -825,9 +825,9 @@ export declare const tagTemplateDefinitionSchema: z.ZodObject<{
         label: z.ZodString;
         kind: z.ZodDefault<z.ZodEnum<{
             boolean: "boolean";
+            text: "text";
             url: "url";
             secret: "secret";
-            text: "text";
             textarea: "textarea";
         }>>;
         required: z.ZodDefault<z.ZodBoolean>;
@@ -934,9 +934,9 @@ export declare const tagTemplateListResponseSchema: z.ZodObject<{
                 label: z.ZodString;
                 kind: z.ZodDefault<z.ZodEnum<{
                     boolean: "boolean";
+                    text: "text";
                     url: "url";
                     secret: "secret";
-                    text: "text";
                     textarea: "textarea";
                 }>>;
                 required: z.ZodDefault<z.ZodBoolean>;
@@ -1084,7 +1084,7 @@ export declare function listTagTemplates(): {
         fields: {
             key: string;
             label: string;
-            kind: "boolean" | "url" | "secret" | "text" | "textarea";
+            kind: "boolean" | "text" | "url" | "secret" | "textarea";
             required: boolean;
             placeholder?: string | undefined;
             help?: string | undefined;
@@ -1101,6 +1101,7 @@ export declare function listTagTemplates(): {
     }[];
 };
 export declare function tagTemplateById(id: string): TagTemplateDefinition | null;
+export declare function safeTagIdPart(value: string): string;
 export declare function tagPresetTriggers(ids: TagTriggerPreset[]): {
     id: string;
     type: "page_view" | "outbound_click" | "form_submit" | "file_download" | "scroll_depth";

package/dist/contracts/tags.js

@@ -698,7 +698,7 @@ function templateFieldValue(config, key) {
     const value = config[key];
     return typeof value === "string" ? value.trim() : "";
 }
-function safeTagIdPart(value) {
+export function safeTagIdPart(value) {
     return value
         .trim()
         .toLowerCase()
@@ -966,6 +966,7 @@ export function tagGraphFromTemplateSelection(input) {
     const tags = [
         {
             ...common,
+            templateConfig: selection.config,
             id: idBase,
             name: selection.name ?? template.name,
             triggerIds: template.id === "custom-javascript"

package/dist/contracts/teams.d.ts

@@ -1,16 +1,15 @@
 import { z } from "zod";
 export declare const TEAM_ROLE_VALUES: readonly ["owner", "admin", "member"];
-export declare const PLAN_FEATURE_VALUES: readonly ["version-diagnostics"];
 export declare const teamMemberRole: z.ZodEnum<{
-    owner: "owner";
     admin: "admin";
+    owner: "owner";
     member: "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>;
@@ -35,8 +34,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;
@@ -45,10 +44,10 @@ export declare const TeamInvitationSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const teamPlanCode: z.ZodEnum<{
     free: "free";
-    personal: "personal";
+    internal: "internal";
     work: "work";
+    personal: "personal";
     enterprise: "enterprise";
-    internal: "internal";
 }>;
 export declare const TeamSummarySchema: z.ZodObject<{
     id: z.ZodString;
@@ -56,16 +55,16 @@ 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<{
         free: "free";
-        personal: "personal";
+        internal: "internal";
         work: "work";
+        personal: "personal";
         enterprise: "enterprise";
-        internal: "internal";
     }>;
     defaultDataLocation: z.ZodString;
     createdAt: z.ZodString;
@@ -77,16 +76,16 @@ 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<{
         free: "free";
-        personal: "personal";
+        internal: "internal";
         work: "work";
+        personal: "personal";
         enterprise: "enterprise";
-        internal: "internal";
     }>;
     defaultDataLocation: z.ZodString;
     createdAt: z.ZodString;
@@ -102,16 +101,16 @@ 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<{
             free: "free";
-            personal: "personal";
+            internal: "internal";
             work: "work";
+            personal: "personal";
             enterprise: "enterprise";
-            internal: "internal";
         }>;
         defaultDataLocation: z.ZodString;
         createdAt: z.ZodString;
@@ -128,8 +127,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;
@@ -161,8 +160,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>;
@@ -173,8 +172,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;
@@ -199,10 +198,10 @@ export declare const teamSettingsResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
     wpCloudCapabilities: z.ZodObject<{
         status: z.ZodEnum<{
-            idle: "idle";
-            running: "running";
-            ready: "ready";
             failed: "failed";
+            ready: "ready";
+            running: "running";
+            idle: "idle";
         }>;
         degraded: z.ZodBoolean;
         lastSyncedAt: z.ZodNullable<z.ZodString>;
@@ -233,9 +232,9 @@ export declare const teamInvitationPreviewSchema: z.ZodObject<{
     teamName: z.ZodString;
     invitedEmail: z.ZodString;
     status: z.ZodEnum<{
-        pending: "pending";
         expired: "expired";
         closed: "closed";
+        pending: "pending";
     }>;
     expiresAt: z.ZodString;
 }, z.core.$strip>;

package/dist/contracts/teams.js

@@ -2,7 +2,6 @@ import { z } from "zod";
 import { CursorPaginationSchema, cursorListQuerySchema } from "./common.js";
 import { planCodeSchema, planLimitValueSchema } from "./features.js";
 export const TEAM_ROLE_VALUES = ["owner", "admin", "member"];
-export const PLAN_FEATURE_VALUES = ["version-diagnostics"];
 export const teamMemberRole = z.enum(TEAM_ROLE_VALUES);
 export const teamInvitationCreateSchema = z.object({
     email: z.string().trim().email().toLowerCase(),

package/dist/contracts/theme-json.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+export declare const themeJsonColorPaletteEntrySchema: z.ZodObject<{
+    slug: z.ZodString;
+    color: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const themeJsonFontFamilyEntrySchema: z.ZodObject<{
+    slug: z.ZodString;
+    fontFamily: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const themeJsonSchema: z.ZodObject<{
+    settings: z.ZodOptional<z.ZodObject<{
+        color: z.ZodOptional<z.ZodObject<{
+            palette: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                slug: z.ZodString;
+                color: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$loose>>;
+        typography: z.ZodOptional<z.ZodObject<{
+            fontFamilies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                slug: z.ZodString;
+                fontFamily: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+export type ThemeJson = z.infer<typeof themeJsonSchema>;

package/dist/contracts/theme-json.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+// WordPress `theme.json`-compatible subset (access-plan §8 tier 3, middle
+// precedence: `sf.theme.jsonc` > `theme.json` > `spacefast.jsonc "pages.theme"`).
+// Real WP theme.json carries dozens of unrelated keys (layout, blocks,
+// customTemplates, styles, ...); this schema accepts the file as a loose
+// object (`.passthrough()`) and only VALIDATES the two branches gate pages
+// actually consume: `settings.color.palette` and
+// `settings.typography.fontFamilies`. Everything else rides through
+// unvalidated and is simply never read — this is not a reimplementation of
+// WP_Theme_JSON, just the safe slice that reaches presentation-only gate
+// pages (access-plan §8).
+const presetSlug = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z0-9-]+$/, { message: "Preset slugs are lowercase alphanumerics and dashes." });
+export const themeJsonColorPaletteEntrySchema = z.object({
+    slug: presetSlug,
+    color: z.string().min(1).max(128),
+    name: z.string().min(1).max(128).optional(),
+});
+export const themeJsonFontFamilyEntrySchema = z.object({
+    slug: presetSlug,
+    fontFamily: z.string().min(1).max(256),
+    name: z.string().min(1).max(128).optional(),
+});
+export const themeJsonSchema = z
+    .object({
+    settings: z
+        .object({
+        color: z
+            .object({
+            palette: z.array(themeJsonColorPaletteEntrySchema).max(64).optional(),
+        })
+            .passthrough()
+            .optional(),
+        typography: z
+            .object({
+            fontFamilies: z.array(themeJsonFontFamilyEntrySchema).max(32).optional(),
+        })
+            .passthrough()
+            .optional(),
+    })
+        .passthrough()
+        .optional(),
+})
+    .passthrough()
+    .describe("WordPress theme.json-compatible file; only color.palette/typography.fontFamilies feed gate pages.");

package/dist/contracts/variables.d.ts

@@ -23,8 +23,6 @@ export declare const variableProvenanceSchema: z.ZodArray<z.ZodObject<{
     name: z.ZodString;
     valueHash: z.ZodString;
 }, z.core.$strip>>;
-export type VariableProvenance = z.infer<typeof variableProvenanceSchema>;
-export declare function variableResourceId(scope: z.infer<typeof variableScope>, name: string): string;
 export declare const SystemVariableSchema: z.ZodObject<{
     name: z.ZodString;
     value: z.ZodString;

package/dist/contracts/variables.js

@@ -39,11 +39,6 @@ export const variableProvenanceSchema = z
         .describe("sha256 of the resolved value at finalize time. Never the value itself."),
 }))
     .describe("Variable names + value hashes baked into this version at finalize. Never values.");
-// Operation `resources` entry id for a coalesced variable write
-// (internal-docs/platform.md "Debounce contract"): `{scope}/{name}`.
-export function variableResourceId(scope, name) {
-    return `${scope}/${name}`;
-}
 // Platform-provided, read-only values (SPACEFAST_*) surfaced alongside stored
 // variables on list reads. Not persistable and not a Variable scope.
 export const SystemVariableSchema = z.object({

package/dist/contracts/webhooks.d.ts

@@ -27,6 +27,7 @@ export declare const webhookSchema: z.ZodObject<{
     events: z.ZodArray<z.ZodString>;
     status: z.ZodEnum<{
         active: "active";
+        deleted: "deleted";
         disabled: "disabled";
         failing: "failing";
     }>;
@@ -56,6 +57,7 @@ export declare const webhookListResponseSchema: z.ZodObject<{
         events: z.ZodArray<z.ZodString>;
         status: z.ZodEnum<{
             active: "active";
+            deleted: "deleted";
             disabled: "disabled";
             failing: "failing";
         }>;

package/dist/contracts/webhooks.js

@@ -24,7 +24,7 @@ export const webhookSchema = z.object({
         .nullable(),
     url: z.string().url(),
     events: z.array(z.string()),
-    status: z.enum(["active", "disabled", "failing"]),
+    status: z.enum(["active", "disabled", "failing", "deleted"]),
     secret: z.string().optional(),
     secretPreview: z.string(),
     previousSecretExpiresAt: z.string().datetime().nullable(),

package/dist/contracts/zero.d.ts

@@ -245,8 +245,8 @@ export declare const zeroRuntimePublicRealtimeModeSchema: z.ZodEnum<{
     "local-websocket": "local-websocket";
 }>;
 export declare const zeroInspectPolicySchema: z.ZodEnum<{
-    private: "private";
     public: "public";
+    private: "private";
 }>;
 export declare const zeroRuntimePublicAuthConfigSchema: z.ZodObject<{
     provider: z.ZodDefault<z.ZodLiteral<"wpcom">>;
@@ -256,7 +256,6 @@ export declare const zeroRuntimePublicAuthConfigSchema: z.ZodObject<{
     signOutUrl: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     returnToParam: z.ZodDefault<z.ZodString>;
 }, z.core.$strict>;
-export type ZeroRuntimePublicAuthConfig = z.infer<typeof zeroRuntimePublicAuthConfigSchema>;
 export declare const zeroRuntimePublicRealtimeConfigSchema: z.ZodObject<{
     mode: z.ZodEnum<{
         "stattic-central": "stattic-central";
@@ -275,7 +274,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>;
@@ -782,8 +780,8 @@ export declare const zeroRuntimeFinalizePayloadSchema: z.ZodObject<{
     }, z.core.$strict>>;
     inspect: z.ZodDefault<z.ZodObject<{
         policy: z.ZodDefault<z.ZodEnum<{
-            private: "private";
             public: "public";
+            private: "private";
         }>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
@@ -1057,8 +1055,8 @@ export declare const zeroDeployMetadataSchema: z.ZodObject<{
         }, z.core.$strict>>;
         inspect: z.ZodDefault<z.ZodObject<{
             policy: z.ZodDefault<z.ZodEnum<{
-                private: "private";
                 public: "public";
+                private: "private";
             }>>;
         }, z.core.$strict>>;
     }, z.core.$strict>;
@@ -1073,8 +1071,8 @@ export declare const zeroInspectResponseSchema: z.ZodObject<{
         serverRuntime: z.ZodLiteral<"quickjs-rust">;
         inspect: z.ZodObject<{
             policy: z.ZodEnum<{
-                private: "private";
                 public: "public";
+                private: "private";
             }>;
         }, z.core.$strict>;
         install: z.ZodObject<{
@@ -1156,8 +1154,8 @@ export declare const zeroInspectPublicResponseSchema: z.ZodObject<{
             serverRuntime: z.ZodLiteral<"quickjs-rust">;
             inspect: z.ZodObject<{
                 policy: z.ZodEnum<{
-                    private: "private";
                     public: "public";
+                    private: "private";
                 }>;
             }, z.core.$strict>;
             install: z.ZodObject<{
@@ -1372,7 +1370,6 @@ export declare const zeroDbDumpQuerySchema: z.ZodObject<{
     table: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strict>;
-export type ZeroDbDumpQuery = z.infer<typeof zeroDbDumpQuerySchema>;
 export declare const zeroDbDumpTableSchema: z.ZodObject<{
     name: z.ZodString;
     rows: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -1447,12 +1444,10 @@ export declare const zeroRealtimeEventIntakeResponseSchema: z.ZodObject<{
     delivered: z.ZodDefault<z.ZodNumber>;
     duplicate: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
-export type ZeroRealtimeEventIntakeResponse = z.infer<typeof zeroRealtimeEventIntakeResponseSchema>;
 export declare const zeroRealtimeEventListQuerySchema: z.ZodObject<{
     afterEventId: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strict>;
-export type ZeroRealtimeEventListQuery = z.infer<typeof zeroRealtimeEventListQuerySchema>;
 export declare const zeroRealtimeEventListResponseSchema: z.ZodObject<{
     data: z.ZodArray<z.ZodObject<{
         eventId: z.ZodString;

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

@@ -1,9 +1,37 @@
-export declare const ARCHIVE_SECRET_GLOBS: readonly [".env*", ".npmrc", ".netrc", "*/.git/*", "*/.stattic/*", "*/.ssh/*", "*/.aws/*", "*/.kube/*", "*/.docker/*", "credentials.json", "*.pem", "*.key", "*.p12", "*.pfx", "*.crt", "*id_rsa*"];
+export declare const ARCHIVE_SECRET_GLOBS: readonly [".env*", ".npmrc", ".netrc", "*/.git/*", "*/.spacefast/*", "*/.ssh/*", "*/.aws/*", "*/.kube/*", "*/.docker/*", "credentials.json", "*.pem", "*.key", "*.p12", "*.pfx", "*.crt", "*id_rsa*"];
 /**
  * The credential rules every surface must repeat. Treat tokens as secrets, keep
  * them out of logs and transcripts, and never echo them back.
  */
 export declare const SECRET_RULES_PROSE: string;
+export declare const POSITIONING_PROSE: string;
+export declare const EXPLAIN_TO_USER_PROSE: string;
+export declare const FAILURE_CONDUCT_PROSE: string;
+export declare const LANE_PICKER_PROSE: string;
+export declare const HOW_TO_RESEARCH_PROSE: string;
+export declare const ENV_NOTES_PROSE: string;
+/**
+ * The CHECK verb: before ever creating a space, look for the one the project
+ * already has. This is what keeps a returning agent from pushing a duplicate
+ * anonymous space instead of a new version.
+ */
+export declare const CHECK_BEFORE_PUBLISH_PROSE: string;
+/**
+ * The SAVE verb: persist the space id and credential after a first publish so
+ * every later publish targets the same space. The CLI and On-Device MCP write
+ * this state automatically; curl-only agents write the same files themselves.
+ */
+export declare const SAVE_STATE_PROSE: string;
+/**
+ * The UPDATE verb: a new version to the SAME space. Never re-run the
+ * first-publish recipe when saved state exists.
+ */
+export declare const UPDATE_SPACE_PROSE: string;
+/**
+ * The CLAIM / CONTINUE verb: show the claim link, and after the user claims,
+ * self-correct by exchanging the claim token once for a durable credential.
+ */
+export declare const CONTINUE_AFTER_CLAIM_PROSE: string;
 /**
  * The zero-install publish sequence: one curl for a file, a secret-preflighted
  * zip for a folder. This is the load-bearing rung 0 — an agent that stops here
@@ -21,15 +49,27 @@ export declare const RECEIPT_SHAPE_PROSE: string;
  */
 export declare const SIGNED_UPLOAD_PROSE: string;
 /**
- * Named fragments for the skill-template generator. The template carries
+ * Named fragments for the skill-template generator. The templates carry
  * `{{prose.secretRules}}`, `{{prose.publishSequence}}`,
- * `{{prose.receiptShape}}`, and `{{prose.signedUpload}}` placeholders;
+ * `{{prose.receiptShape}}`, `{{prose.signedUpload}}`,
+ * `{{prose.checkBeforePublish}}`, `{{prose.saveState}}`,
+ * `{{prose.updateSpace}}`, and `{{prose.continueAfterClaim}}` placeholders;
  * generate-skill.mjs substitutes these.
  */
 export declare const AGENT_PROSE: {
+    readonly positioning: string;
     readonly secretRules: string;
+    readonly explainToUser: string;
+    readonly failureConduct: string;
     readonly publishSequence: string;
     readonly receiptShape: string;
     readonly signedUpload: string;
+    readonly checkBeforePublish: string;
+    readonly saveState: string;
+    readonly updateSpace: string;
+    readonly continueAfterClaim: string;
+    readonly lanePicker: string;
+    readonly howToResearch: string;
+    readonly envNotes: string;
 };
 export type AgentProseKey = keyof typeof AGENT_PROSE;