@spacefast/common 0.0.5 → 0.0.6

package/dist/contracts/activity.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-export declare const ACTIVITY_EVENT_CODES: readonly ["space.created", "space.claimed", "space.transferred", "space.moved", "space.expired", "space.disabled", "space.enabled", "space.deleted", "space.config_updated", "space.password_updated", "version.created", "version.ready", "version.warning", "version.failed", "version.expired", "version.canceled", "version.deleted", "version.retention_warning", "version.retention_deleted", "channel.promoted", "build.created", "build.succeeded", "build.failed", "build.canceled", "build.skipped", "domain.created", "domain.verified", "domain.verification_failed", "domain.control_lost", "domain.dns_updated", "domain.nameservers_updated", "domain.registration_purchased", "domain.registration_renewed", "domain.registration_expiring", "domain.registration_expired", "domain.transfer_in_started", "domain.transfer_out_started", "domain.deleted", "binding.created", "binding.activated", "binding.blocked", "binding.deleted", "transfer.requested", "transfer.confirmed", "transfer.completed", "transfer.canceled", "transfer.expired", "transfer.failed", "variable.updated", "variable.deleted", "api_key.created", "api_key.updated", "api_key.revoked", "webhook.created", "webhook.updated", "webhook.secret_rotated", "webhook.disabled", "team.updated", "team.member_added", "team.member_removed", "team.member_role_updated", "team.builds_deploys_quota_exceeded", "tenant.past_due", "tenant.suspended", "tenant.reactivated", "tenant.deleted", "export.ready", "export.failed", "import.ready", "import.failed", "annotation.token_minted", "annotation.created", "annotation.comment_created", "annotation.resolved", "annotation.reopened", "annotation.archived", "abuse_report.created", "abuse_report.updated", "claim.blocked_takedown", "user.created", "user.signed_in", "user.deleted", "user.impersonation_started", "user.impersonation_stopped", "user.two_factor_enabled", "user.two_factor_disabled"];
+export declare const ACTIVITY_EVENT_CODES: readonly ["space.created", "space.claimed", "feedback.lead_claim_pending", "space.transferred", "space.move_requested", "space.moved", "space.expired", "space.disabled", "space.enabled", "space.deleted", "space.config_updated", "space.password_updated", "site.provision_requested", "site.placement_hold_set", "site.placement_hold_cleared", "site.burst_toggled", "space.access_logout_all", "space.access_transfer_scrub", "space.access_operator_token", "space.sharing_updated", "space.share_link_created", "space.share_link_revoked", "space.invite_created", "space.invite_revoked", "space.access_request_created", "space.access_request_resolved", "space.firewall_updated", "team.access_defaults_updated", "team.service_token_created", "team.service_token_revoked", "team.access_connection_created", "team.access_connection_updated", "team.access_connection_revoked", "version.created", "version.ready", "version.warning", "version.failed", "version.expired", "version.canceled", "version.deleted", "version.retention_warning", "version.retention_deleted", "channel.promoted", "build.created", "build.succeeded", "build.failed", "build.canceled", "build.skipped", "domain.created", "domain.verified", "domain.verification_failed", "domain.control_lost", "domain.dns_updated", "domain.nameservers_updated", "domain.registration_purchased", "domain.registration_renewed", "domain.registration_expiring", "domain.registration_expired", "domain.transfer_in_started", "domain.transfer_out_started", "domain.deleted", "binding.created", "binding.activated", "binding.blocked", "binding.deleted", "transfer.requested", "transfer.confirmed", "transfer.completed", "transfer.canceled", "transfer.expired", "transfer.failed", "variable.updated", "variable.deleted", "api_key.created", "api_key.updated", "api_key.revoked", "webhook.created", "webhook.updated", "webhook.secret_rotated", "webhook.disabled", "webhook.deleted", "team.updated", "team.member_added", "team.member_removed", "team.member_role_updated", "team.builds_deploys_quota_exceeded", "tenant.past_due", "tenant.suspended", "tenant.reactivated", "tenant.deleted", "export.ready", "export.failed", "import.ready", "import.failed", "annotation.token_minted", "annotation.created", "annotation.comment_created", "annotation.resolved", "annotation.reopened", "annotation.archived", "abuse_report.created", "abuse_report.updated", "claim.blocked_takedown", "user.created", "user.signed_in", "user.deleted", "user.impersonation_started", "user.impersonation_stopped", "user.two_factor_enabled", "user.two_factor_disabled"];
 export type ActivityEventCode = (typeof ACTIVITY_EVENT_CODES)[number];
 export declare function isActivityEventCode(value: string): value is ActivityEventCode;
 export declare function isValidActivityEventFilter(filter: string): boolean;

package/dist/contracts/activity.js

@@ -9,7 +9,9 @@ export const ACTIVITY_EVENT_CODES = [
     // space
     "space.created",
     "space.claimed",
+    "feedback.lead_claim_pending",
     "space.transferred",
+    "space.move_requested",
     "space.moved",
     "space.expired",
     "space.disabled",
@@ -17,6 +19,30 @@ export const ACTIVITY_EVENT_CODES = [
     "space.deleted",
     "space.config_updated",
     "space.password_updated",
+    // site
+    "site.provision_requested",
+    "site.placement_hold_set",
+    "site.placement_hold_cleared",
+    "site.burst_toggled",
+    // access (internal-docs/access-plan.html): every access mutation emits an
+    // activity event; operator mints are audited and owner-visible (X-27).
+    "space.access_logout_all",
+    "space.access_transfer_scrub",
+    "space.access_operator_token",
+    "space.sharing_updated",
+    "space.share_link_created",
+    "space.share_link_revoked",
+    "space.invite_created",
+    "space.invite_revoked",
+    "space.access_request_created",
+    "space.access_request_resolved",
+    "space.firewall_updated",
+    "team.access_defaults_updated",
+    "team.service_token_created",
+    "team.service_token_revoked",
+    "team.access_connection_created",
+    "team.access_connection_updated",
+    "team.access_connection_revoked",
     // version
     "version.created",
     "version.ready",
@@ -68,12 +94,12 @@ export const ACTIVITY_EVENT_CODES = [
     "api_key.created",
     "api_key.updated",
     "api_key.revoked",
-    // webhook (DELETE is a soft-disable that emits webhook.disabled; there is no
-    // webhook.deleted event — internal-docs/platform.md "Webhook DELETE")
+    // webhook
     "webhook.created",
     "webhook.updated",
     "webhook.secret_rotated",
     "webhook.disabled",
+    "webhook.deleted",
     // team (builds_deploys_quota_exceeded is a shipped additive extension: the
     // pooled monthly builds+deploys meter is SOFT — it tracks, never blocks)
     "team.updated",

package/dist/contracts/annotations.d.ts

@@ -273,8 +273,8 @@ export declare const annotationPatchSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const annotationExportQuerySchema: z.ZodObject<{
     format: z.ZodDefault<z.ZodEnum<{
-        markdown: "markdown";
         json: "json";
+        markdown: "markdown";
     }>>;
     status: z.ZodOptional<z.ZodEnum<{
         open: "open";
@@ -314,14 +314,12 @@ export declare const annotationListResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const annotationExportResponseSchema: z.ZodObject<{
     format: z.ZodEnum<{
-        markdown: "markdown";
         json: "json";
+        markdown: "markdown";
     }>;
     content: z.ZodString;
 }, z.core.$strip>;
 export type CollaborationInvitedReviewer = z.infer<typeof collaborationInvitedReviewerSchema>;
 export type Collaboration = z.infer<typeof collaborationSchema>;
-export type OverlayConfig = z.infer<typeof overlayConfigSchema>;
 export type PublicOverlayConfig = z.infer<typeof publicOverlayConfigSchema>;
 export type AnnotationThread = z.infer<typeof annotationThreadSchema>;
-export type RealtimeToken = z.infer<typeof realtimeTokenResponseSchema>;

package/dist/contracts/api-keys.d.ts

@@ -61,7 +61,7 @@ export type ParsedStatticResource = {
 } | {
     kind: "space";
     tenantId: string;
-    siteId: string;
+    siteId: string | null;
     spaceId: string;
     wildcard: boolean;
 } | {
@@ -74,7 +74,7 @@ export type ParsedStatticResource = {
     domainGroupId: string;
 };
 export declare function parseStatticResource(value: string): ParsedStatticResource | null;
-export declare const StatticAccessPolicySchema: z.ZodObject<{
+export declare const ApiCredentialPolicySchema: z.ZodObject<{
     version: z.ZodLiteral<"2026-06-09">;
     statements: z.ZodArray<z.ZodObject<{
         effect: z.ZodEnum<{
@@ -135,7 +135,7 @@ export declare const StatticAccessPolicySchema: z.ZodObject<{
         }, z.core.$strict>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
-export type StatticAccessPolicy = z.infer<typeof StatticAccessPolicySchema>;
+export type ApiCredentialPolicy = z.infer<typeof ApiCredentialPolicySchema>;
 export declare const ApiKeyPresetSchema: z.ZodEnum<{
     ci_deploy: "ci_deploy";
     space_publisher: "space_publisher";
@@ -511,7 +511,6 @@ export declare const ApiKeyPatchRequestSchema: z.ZodObject<{
         }, z.core.$strict>>;
     }, z.core.$strict>>;
 }, z.core.$strip>;
-export type ApiKeyPatchRequest = z.infer<typeof ApiKeyPatchRequestSchema>;
 export declare const ApiKeyParamsSchema: z.ZodObject<{
     apiKeyId: z.ZodString;
 }, z.core.$strip>;

package/dist/contracts/api-keys.js

@@ -79,6 +79,9 @@ export function parseStatticResource(value) {
         }
         return null;
     }
+    if (head === "space" && isResourceSegment(a) && path.length === 2) {
+        return { kind: "space", tenantId, siteId: null, spaceId: a, wildcard };
+    }
     if (head === "domain" && isResourceSegment(a) && path.length === 2 && !wildcard) {
         return { kind: "domain", tenantId, domainId: a };
     }
@@ -91,10 +94,10 @@ const StatticResourceSchema = z
     .string()
     .max(512)
     .refine((value) => parseStatticResource(value) !== null, {
-    message: "Resource must be a stt:// URI from the StatticResource union (tenant, principal, site, site space, domain, or domain-group).",
+    message: "Resource must be a stt:// URI from the StatticResource union (tenant, principal, site, space, site space, domain, or domain-group).",
 })
-    .describe("A resource URI from the StatticResource union: stt://tenant/{t}, …/principal/(team|external)/{id}[/*], …/site/{id}[/*], …/site/{id}/space/{id}[/*], …/domain/{id}, or …/domain-group/{id}.");
-export const StatticAccessPolicySchema = z
+    .describe("A resource URI from the StatticResource union: stt://tenant/{t}, …/principal/(team|external)/{id}[/*], …/site/{id}[/*], …/space/{id}[/*], …/site/{id}/space/{id}[/*], …/domain/{id}, or …/domain-group/{id}.");
+export const ApiCredentialPolicySchema = z
     .object({
     version: z
         .literal(SPACEFAST_ACCESS_POLICY_VERSION)
@@ -161,7 +164,7 @@ export const ApiKeySchema = z.object({
     ownerPrincipal: ApiKeyOwnerPrincipalSchema.nullable().describe("Owning principal (ownership metadata, never the authorization gate)."),
     createdByUserId: z.string().describe("User who created the key."),
     preset: ApiKeyPresetSchema.nullable().describe("Preset the policy was compiled from, if any."),
-    policy: StatticAccessPolicySchema.nullable().describe("Effective access policy. A key authorizes by policy only."),
+    policy: ApiCredentialPolicySchema.nullable().describe("Effective access policy. A key authorizes by policy only."),
     metadata: AnyObjectSchema.describe("Caller-supplied metadata."),
     secretPreview: z.string().describe("Masked secret preview (prefix and last characters)."),
     secret: z.string().optional().describe("Full secret. Returned once, at creation only."),
@@ -196,7 +199,7 @@ export const ApiKeyCreateRequestSchema = z.object({
         .optional()
         .describe("Owning team for the new key. Defaults to the caller's own team; authorization is by the credential's policy, not key ownership."),
     preset: ApiKeyPresetSchema.optional(),
-    policy: StatticAccessPolicySchema.nullable()
+    policy: ApiCredentialPolicySchema.nullable()
         .optional()
         .describe("Explicit policy. Must be a subset of the calling credential's policy."),
     metadata: AnyObjectSchema.optional().describe("Caller-supplied metadata."),
@@ -225,7 +228,7 @@ export const ApiKeyPatchRequestSchema = z
         .nullable()
         .optional()
         .describe("Replacement activation instant."),
-    policy: StatticAccessPolicySchema.optional().describe("Replacement policy. Must be a subset of the calling credential's policy at mutation time."),
+    policy: ApiCredentialPolicySchema.optional().describe("Replacement policy. Must be a subset of the calling credential's policy at mutation time."),
 })
     .refine((value) => Object.keys(value).length > 0, {
     message: "At least one mutable API key field is required.",

package/dist/contracts/archives.d.ts

@@ -25,7 +25,10 @@ export declare const spaceExportSchema: z.ZodObject<{
         queued: "queued";
         running: "running";
     }>;
-    format: z.ZodLiteral<"stattic_export_v1">;
+    format: z.ZodEnum<{
+        spacefast_export_v1: "spacefast_export_v1";
+        stattic_export_v1: "stattic_export_v1";
+    }>;
     diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
@@ -67,7 +70,10 @@ export declare const spaceExportListResponseSchema: z.ZodObject<{
             queued: "queued";
             running: "running";
         }>;
-        format: z.ZodLiteral<"stattic_export_v1">;
+        format: z.ZodEnum<{
+            spacefast_export_v1: "spacefast_export_v1";
+            stattic_export_v1: "stattic_export_v1";
+        }>;
         diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{

package/dist/contracts/archives.js

@@ -18,7 +18,7 @@ export const spaceExportRequestSchema = z.object({
         .describe("Include explicit space config (the space access policy) in the archive. Version manifests are always included."),
 });
 export const spaceExportArchiveSchema = z.object({
-    // Zip-only contract: stattic_export_v1 archives are always zip (the spec
+    // Zip-only contract: spacefast_export_v1 archives are always zip (the spec
     // allows "zip or tar"; one format keeps the enum honest).
     contentType: z.literal("application/zip").describe("Archive media type. Always zip."),
     downloadUrl: z
@@ -40,7 +40,11 @@ export const spaceExportSchema = z.object({
     status: z
         .enum(["queued", "running", "ready", "failed", "expired"])
         .describe("Export lifecycle. `expired` means the archive download window has passed."),
-    format: z.literal("stattic_export_v1").describe("Archive format identifier."),
+    // Producers emit `spacefast_export_v1`; `stattic_export_v1` remains accepted
+    // for archives/handles minted before the rename (legacy read-compat).
+    format: z
+        .enum(["spacefast_export_v1", "stattic_export_v1"])
+        .describe("Archive format identifier. New exports are `spacefast_export_v1`."),
     diagnostics: z
         .array(baseDiagnosticSchema)
         .default([])
@@ -68,14 +72,17 @@ export const spaceImportSourceSchema = z
     }),
     z.object({
         kind: z.literal("url").describe("Fetch the archive from a public HTTPS URL."),
-        url: z.string().url().describe("Public HTTPS URL of a stattic_export_v1 archive."),
+        url: z
+            .string()
+            .url()
+            .describe("Public HTTPS URL of a spacefast_export_v1 (or legacy stattic_export_v1) archive."),
     }),
     z.object({
         kind: z.literal("export").describe("Import directly from an export on this control plane."),
         exportId: z.string().min(1).describe("Source export id (exp_…) accessible to the caller."),
     }),
 ])
-    .describe("Where the stattic_export_v1 archive comes from.");
+    .describe("Where the spacefast_export_v1 archive comes from.");
 export const spaceImportRequestSchema = z.object({
     source: spaceImportSourceSchema,
     publish: z

package/dist/contracts/billing.d.ts

@@ -6,7 +6,6 @@ export declare const billingProviderSchema: z.ZodEnum<{
     app_store: "app_store";
     google_play: "google_play";
 }>;
-export type BillingProvider = z.infer<typeof billingProviderSchema>;
 export declare const billingIntervalValues: readonly ["monthly", "yearly"];
 export declare const billingIntervalSchema: z.ZodEnum<{
     monthly: "monthly";
@@ -68,7 +67,6 @@ export declare const billingStoreAccountResponseSchema: z.ZodObject<{
     appStoreProducts: z.ZodArray<z.ZodString>;
     googlePlayBasePlans: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
-export type BillingStoreAccountResponse = z.infer<typeof billingStoreAccountResponseSchema>;
 export declare const appStoreVerifyRequestSchema: z.ZodObject<{
     transactionId: z.ZodString;
 }, z.core.$strip>;
@@ -88,7 +86,6 @@ export declare const storeSubscriptionResultSchema: z.ZodObject<{
     isActive: z.ZodBoolean;
     expiresAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
-export type StoreSubscriptionResult = z.infer<typeof storeSubscriptionResultSchema>;
 export declare const stripeCheckoutRequestSchema: z.ZodObject<{
     planCode: z.ZodDefault<z.ZodEnum<{
         free: "free";
@@ -104,17 +101,14 @@ export declare const stripeCheckoutRequestSchema: z.ZodObject<{
     successUrl: z.ZodString;
     cancelUrl: z.ZodString;
 }, z.core.$strip>;
-export type StripeCheckoutRequest = z.infer<typeof stripeCheckoutRequestSchema>;
 export declare const stripePortalRequestSchema: z.ZodObject<{
     returnUrl: z.ZodString;
 }, z.core.$strip>;
-export type StripePortalRequest = z.infer<typeof stripePortalRequestSchema>;
 export declare const billingLinkResponseSchema: z.ZodObject<{
     url: z.ZodString;
 }, z.core.$strip>;
 export type BillingLinkResponse = z.infer<typeof billingLinkResponseSchema>;
 export declare const stripeCancelSubscriptionRequestSchema: z.ZodDefault<z.ZodObject<{}, z.core.$strip>>;
-export type StripeCancelSubscriptionRequest = z.infer<typeof stripeCancelSubscriptionRequestSchema>;
 export declare const stripeChangePlanRequestSchema: z.ZodObject<{
     planCode: z.ZodEnum<{
         free: "free";
@@ -128,14 +122,12 @@ export declare const stripeChangePlanRequestSchema: z.ZodObject<{
         yearly: "yearly";
     }>>;
 }, z.core.$strip>;
-export type StripeChangePlanRequest = z.infer<typeof stripeChangePlanRequestSchema>;
 export declare const stripeSubscriptionActionResponseSchema: z.ZodObject<{
     provider: z.ZodLiteral<"stripe">;
     stripeSubscriptionId: z.ZodString;
     status: z.ZodString;
     cancelAtPeriodEnd: z.ZodNullable<z.ZodBoolean>;
 }, z.core.$strip>;
-export type StripeSubscriptionActionResponse = z.infer<typeof stripeSubscriptionActionResponseSchema>;
 export declare const billingAddressSchema: z.ZodObject<{
     line1: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     line2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -218,7 +210,6 @@ export declare const teamBillingSettingsUpdateSchema: z.ZodObject<{
     invoiceFooter: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     customFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strict>;
-export type TeamBillingSettingsResponse = z.infer<typeof teamBillingSettingsResponseSchema>;
 export type TeamBillingSettingsUpdate = z.infer<typeof teamBillingSettingsUpdateSchema>;
 export declare const billingCustomerRefSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/contracts/builds.d.ts

@@ -92,18 +92,22 @@ declare const InternalBuildExecutionSchema: z.ZodObject<{
     sandboxId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     region: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    phases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        phase: z.ZodString;
+        at: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export declare const BuildSchema: z.ZodObject<{
     id: z.ZodString;
     spaceId: z.ZodString;
     status: z.ZodEnum<{
         failed: "failed";
-        queued: "queued";
-        running: "running";
-        succeeded: "succeeded";
         canceled: "canceled";
         waiting_for_source: "waiting_for_source";
         uploading_source: "uploading_source";
+        queued: "queued";
+        running: "running";
+        succeeded: "succeeded";
         skipped: "skipped";
     }>;
     input: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -137,16 +141,16 @@ export declare const BuildSchema: z.ZodObject<{
     diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
+            info: "info";
             warning: "warning";
             error: "error";
-            info: "info";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            registrar: "registrar";
             wpcloud: "wpcloud";
             dns: "dns";
-            registrar: "registrar";
             runtime: "runtime";
         }>>>;
         details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -188,16 +192,16 @@ export declare const buildCreateRequestSchema: z.ZodObject<{
     diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
         code: z.ZodString;
         severity: z.ZodEnum<{
+            info: "info";
             warning: "warning";
             error: "error";
-            info: "info";
         }>;
         message: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            registrar: "registrar";
             wpcloud: "wpcloud";
             dns: "dns";
-            registrar: "registrar";
             runtime: "runtime";
         }>>>;
         details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -251,16 +255,16 @@ export declare const buildSourceArchiveUploadSchema: z.ZodObject<{
         diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
+                info: "info";
                 warning: "warning";
                 error: "error";
-                info: "info";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                registrar: "registrar";
                 wpcloud: "wpcloud";
                 dns: "dns";
-                registrar: "registrar";
                 runtime: "runtime";
             }>>>;
             details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -276,12 +280,12 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
             spaceId: z.ZodString;
             status: z.ZodEnum<{
                 failed: "failed";
-                queued: "queued";
-                running: "running";
-                succeeded: "succeeded";
                 canceled: "canceled";
                 waiting_for_source: "waiting_for_source";
                 uploading_source: "uploading_source";
+                queued: "queued";
+                running: "running";
+                succeeded: "succeeded";
                 skipped: "skipped";
             }>;
             input: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -315,16 +319,16 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
             diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 code: z.ZodString;
                 severity: z.ZodEnum<{
+                    info: "info";
                     warning: "warning";
                     error: "error";
-                    info: "info";
                 }>;
                 message: z.ZodString;
                 path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    registrar: "registrar";
                     wpcloud: "wpcloud";
                     dns: "dns";
-                    registrar: "registrar";
                     runtime: "runtime";
                 }>>>;
                 details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -380,16 +384,16 @@ export declare const buildCreateResponseSchema: z.ZodObject<{
                 diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     code: z.ZodString;
                     severity: z.ZodEnum<{
+                        info: "info";
                         warning: "warning";
                         error: "error";
-                        info: "info";
                     }>;
                     message: z.ZodString;
                     path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                     provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                        registrar: "registrar";
                         wpcloud: "wpcloud";
                         dns: "dns";
-                        registrar: "registrar";
                         runtime: "runtime";
                     }>>>;
                     details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
@@ -410,12 +414,12 @@ export declare const buildListResponseSchema: z.ZodObject<{
         spaceId: z.ZodString;
         status: z.ZodEnum<{
             failed: "failed";
-            queued: "queued";
-            running: "running";
-            succeeded: "succeeded";
             canceled: "canceled";
             waiting_for_source: "waiting_for_source";
             uploading_source: "uploading_source";
+            queued: "queued";
+            running: "running";
+            succeeded: "succeeded";
             skipped: "skipped";
         }>;
         input: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -449,16 +453,16 @@ export declare const buildListResponseSchema: z.ZodObject<{
         diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
             code: z.ZodString;
             severity: z.ZodEnum<{
+                info: "info";
                 warning: "warning";
                 error: "error";
-                info: "info";
             }>;
             message: z.ZodString;
             path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                registrar: "registrar";
                 wpcloud: "wpcloud";
                 dns: "dns";
-                registrar: "registrar";
                 runtime: "runtime";
             }>>>;
             details: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;

package/dist/contracts/builds.js

@@ -168,6 +168,14 @@ export const BuildCreateInputSchema = z
     }),
 ])
     .describe("What a new build should run against.");
+// One phase-timeline entry the build runner appends via recordBuildPhase
+// (apps/control-plane/src/builds/runner.ts BUILD_PHASES); `phase` stays a
+// plain string here since the runner's specific phase vocabulary is an
+// app-level concern, not a shared contract.
+const buildExecutionPhaseSchema = z.object({
+    phase: z.string().min(1).describe("Build phase name; see BUILD_PHASES in builds/runner.ts."),
+    at: z.string().datetime(),
+});
 const InternalBuildExecutionSchema = z
     .object({
     runner: z.string().nullable().default(null),
@@ -175,6 +183,10 @@ const InternalBuildExecutionSchema = z
     sandboxId: z.string().nullable().default(null),
     region: z.string().nullable().default(null),
     metadata: z.record(z.string(), z.unknown()).default({}),
+    phases: z
+        .array(buildExecutionPhaseSchema)
+        .optional()
+        .describe("Phase timeline the runner appends to via recordBuildPhase."),
 })
     .describe("Internal runner execution metadata surfaced only where appropriate.");
 export const BuildSchema = z.object({

package/dist/contracts/common.d.ts

@@ -110,9 +110,11 @@ export declare const ApiErrorResponseSchema: z.ZodObject<{
         docsUrl: z.ZodString;
         details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         suggestions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        next: z.ZodOptional<z.ZodArray<z.ZodString>>;
         requestId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export type ApiErrorResponse = z.infer<typeof ApiErrorResponseSchema>;
 export declare function dataEnvelope<T extends z.ZodType>(data: T): z.ZodObject<{
     data: T;
 }, z.core.$strip>;

package/dist/contracts/common.js

@@ -83,6 +83,10 @@ export const ApiErrorResponseSchema = z.object({
             .array(z.string())
             .optional()
             .describe("Actionable recovery steps safe to show in dashboards, SDKs, and CLI output."),
+        next: z
+            .array(z.string())
+            .optional()
+            .describe("Copy-pasteable commands or API requests an agent can run next."),
         requestId: z.string().optional().describe("Request id to quote when contacting support."),
     }),
 });

package/dist/contracts/continuation.d.ts

@@ -2,7 +2,6 @@ import { z } from "zod";
 export declare const RequiresActionTypeSchema: z.ZodEnum<{
     device_authorization: "device_authorization";
 }>;
-export type RequiresActionType = z.infer<typeof RequiresActionTypeSchema>;
 export declare const RequiresActionSchema: z.ZodObject<{
     actionType: z.ZodEnum<{
         device_authorization: "device_authorization";
@@ -27,11 +26,9 @@ export declare const RequiresActionEnvelopeSchema: z.ZodObject<{
         expiresAt: z.ZodString;
     }, z.core.$strict>;
 }, z.core.$strict>;
-export type RequiresActionEnvelope = z.infer<typeof RequiresActionEnvelopeSchema>;
 export declare const ActionResumeRequestSchema: z.ZodObject<{
     continuationToken: z.ZodString;
 }, z.core.$strict>;
-export type ActionResumeRequest = z.infer<typeof ActionResumeRequestSchema>;
 export declare const ActionResumeResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     status: z.ZodLiteral<"pending">;
     requiresAction: z.ZodObject<{

package/dist/contracts/countries.d.ts

@@ -0,0 +1,2 @@
+export declare const ISO_COUNTRY_CODES: readonly ["AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW"];
+export type IsoCountryCode = (typeof ISO_COUNTRY_CODES)[number];