@spacefast/common 0.0.5 → 0.0.6

package/dist/contracts/domains.js

@@ -209,12 +209,12 @@ export const spaceCustomDomainSchema = DomainSchema.extend({
 });
 export const spaceManagedDomainSchema = z.object({
     id: z.string().describe("Stable managed row id derived from the default hostname row."),
-    source: z.literal("managed_view_fast").describe("System-managed view.fast hostname row."),
+    source: z.literal("managed_view_fast").describe("System-managed hostname row."),
     managed: z.literal(true),
     deletable: z.literal(false),
     assignable: z.literal(false),
     primary: z.boolean().describe("True when no custom primary domain overrides the managed URL."),
-    name: z.string().describe("Managed view.fast hostname."),
+    name: z.string().describe("Managed hostname."),
     unicodeName: z.string().optional(),
     kind: z.literal("hostname"),
     publicName: z.string().describe("Left-hand public project label for the managed hostname."),
@@ -1027,7 +1027,7 @@ export const domainProviderConnectionCreateSchema = z
 });
 export const domainProviderConnectionOAuthCompleteSchema = z.object({
     teamId: z.string().min(1).optional(),
-    provider: z.literal("cloudflare"),
+    provider: z.enum(["cloudflare", "wpcom"]),
     label: z.string().trim().min(1).max(255).optional(),
 });
 export const domainProviderZoneSchema = z.object({
@@ -1047,6 +1047,22 @@ export const domainProviderZoneAttachSchema = z.object({
     providerZoneId: z.string().min(1).max(255),
     providerZoneName: z.string().trim().min(1).max(255).optional(),
 });
+export const domainConnectDiscoverySchema = z.object({
+    supported: z.boolean(),
+    gated: z.boolean().optional(),
+    provider: z
+        .object({
+        urlSyncUX: z.string().url().optional(),
+        urlAPI: z.string().url().optional(),
+        urlControlPanel: z.string().url().optional(),
+        providerName: z.string().optional(),
+    })
+        .optional(),
+    checkedAt: z.string().datetime(),
+});
+export const domainConnectDiscoveryResponseSchema = z.object({
+    data: domainConnectDiscoverySchema,
+});
 export const domainProviderSnapshotRefreshResponseSchema = mutationEnvelope(z.object({
     operationId: z.string(),
     snapshot: z.object({
@@ -1361,7 +1377,7 @@ export const domainDnsRecordBatchSchema = z
     puts: z
         .array(domainDnsRecordFields.extend({ id: z.string() }).superRefine(requireMxSrvPriority))
         .default([])
-        .describe("Full record upserts by id, applied third."),
+        .describe("Full replacements for existing records by id, applied third."),
     posts: z
         .array(domainDnsRecordFields.superRefine(requireMxSrvPriority))
         .default([])
@@ -1376,6 +1392,8 @@ export const domainHostnameDnsSnapshotSchema = z.object({
     a: z.array(z.string()).default([]),
     aaaa: z.array(z.string()).default([]),
     caa: z.array(z.string()).default([]),
+    cname: z.array(z.string()).default([]),
+    mx: z.array(z.string()).default([]),
     txt: z.array(z.string()).default([]),
 });
 export const domainHostnameSslBrokenRecordSchema = z.object({
@@ -1400,8 +1418,10 @@ export const domainHostnameDiagnosticsSchema = z.object({
         .default([])
         .describe("DNS records required for this hostname."),
     dns: z.object({
+        observedAt: z.string().datetime(),
         expectedTxtValue: z.string().nullable(),
         pointsToProvider: z.boolean().describe("Whether observed A records point at the provider."),
+        proxyDetected: z.boolean().nullable().describe("Whether observed A records look proxied."),
         txtVerified: z.boolean().nullable().describe("Whether the verification TXT is observed."),
         hasAaaaRecords: z.boolean(),
         hasCaaRecords: z.boolean(),
@@ -1409,6 +1429,8 @@ export const domainHostnameDiagnosticsSchema = z.object({
             a: z.array(z.string()).default([]),
             aaaa: z.array(z.string()).default([]),
             caa: z.array(z.string()).default([]),
+            cname: z.array(z.string()).default([]),
+            mx: z.array(z.string()).default([]),
             txt: z.array(z.string()).default([]),
         }),
         byResolver: z.array(domainHostnameDnsSnapshotSchema).default([]),

package/dist/contracts/enums.d.ts

@@ -8,12 +8,13 @@ export declare const spaceStatus: z.ZodEnum<{
     deleting: "deleting";
     failed: "failed";
 }>;
-export declare const spaceDisabledReasonCodeValues: readonly ["anonymous_expired", "abuse_takedown", "tenant_suspended", "site_suspended"];
+export declare const spaceDisabledReasonCodeValues: readonly ["anonymous_expired", "abuse_takedown", "tenant_suspended", "site_suspended", "visit_cap_exceeded"];
 export declare const spaceDisabledReasonCode: z.ZodEnum<{
     anonymous_expired: "anonymous_expired";
     abuse_takedown: "abuse_takedown";
     tenant_suspended: "tenant_suspended";
     site_suspended: "site_suspended";
+    visit_cap_exceeded: "visit_cap_exceeded";
 }>;
 export declare const spaceTransferStatusValues: readonly ["pending_confirmation", "confirming_domains", "moving", "completed", "canceled", "expired"];
 export declare const spaceTransferStatus: z.ZodEnum<{
@@ -61,12 +62,22 @@ export declare const siteStatus: z.ZodEnum<{
     ready_pool: "ready_pool";
     degraded: "degraded";
 }>;
-export declare const siteClassValues: readonly ["anonymous_pool", "shared_org", "dedicated_space"];
+export declare const siteClassValues: readonly ["shared", "dedicated", "shared_org", "anonymous_pool", "dedicated_space"];
 export declare const siteClass: z.ZodEnum<{
-    anonymous_pool: "anonymous_pool";
+    shared: "shared";
+    dedicated: "dedicated";
     shared_org: "shared_org";
+    anonymous_pool: "anonymous_pool";
     dedicated_space: "dedicated_space";
 }>;
+export declare const normalizedSiteClassValues: readonly ["shared", "dedicated"];
+export declare const normalizedSiteClass: z.ZodEnum<{
+    shared: "shared";
+    dedicated: "dedicated";
+}>;
+export declare function normalizeSiteClass(value: SiteClass): NormalizedSiteClass;
+export declare function siteClassIsShared(value: SiteClass): boolean;
+export declare function siteClassIsDedicated(value: SiteClass): boolean;
 export declare const publishSourceKindValues: readonly ["direct_upload", "cli", "dashboard", "api", "git", "import", "agent", "build", "variable_update", "config_update"];
 export declare const publishSourceKind: z.ZodEnum<{
     api: "api";
@@ -165,15 +176,6 @@ export declare const cachePurgeTarget: z.ZodEnum<{
     domain: "domain";
     path: "path";
 }>;
-export declare const bullJobStatus: z.ZodEnum<{
-    active: "active";
-    failed: "failed";
-    completed: "completed";
-    delayed: "delayed";
-    prioritized: "prioritized";
-    waiting: "waiting";
-    "waiting-children": "waiting-children";
-}>;
 export declare const operationStatus: z.ZodEnum<{
     failed: "failed";
     canceled: "canceled";
@@ -181,16 +183,13 @@ export declare const operationStatus: z.ZodEnum<{
     running: "running";
     succeeded: "succeeded";
 }>;
-export type VersionStatus = z.infer<typeof versionStatus>;
 export type GitProvider = z.infer<typeof gitProvider>;
 export type PublishSourceKind = z.infer<typeof publishSourceKind>;
 export type SiteIsolation = z.infer<typeof siteIsolation>;
-export type TenantKind = z.infer<typeof tenantKind>;
 export type TenantStatus = z.infer<typeof tenantStatus>;
-export type ProviderClientStatus = z.infer<typeof providerClientStatus>;
 export type SiteKind = z.infer<typeof siteKind>;
-export type SiteStatus = z.infer<typeof siteStatus>;
 export type SiteClass = z.infer<typeof siteClass>;
+export type NormalizedSiteClass = z.infer<typeof normalizedSiteClass>;
 export type OperationStatus = z.infer<typeof operationStatus>;
 export type SafetyCategory = z.infer<typeof safetyCategory>;
 export type EnforcementTier = z.infer<typeof enforcementTier>;

package/dist/contracts/enums.js

@@ -12,13 +12,16 @@ export const spaceStatusValues = [
 ];
 export const spaceStatus = z.enum(spaceStatusValues);
 // Serving-axis disable reasons (internal-docs/platform.md "Space"): exactly
-// these four. Malware takedowns are `abuse_takedown` with
-// `details.source = "malware_scan"`.
+// these five. Malware takedowns are `abuse_takedown` with
+// `details.source = "malware_scan"`. `visit_cap_exceeded` is the anonymous
+// visit-quota pause (ANONYMOUS_PUBLISH_CAPS.maxLifetimeViews): recoverable,
+// the claim token stays intact, and claiming the space restores serving.
 export const spaceDisabledReasonCodeValues = [
     "anonymous_expired",
     "abuse_takedown",
     "tenant_suspended",
     "site_suspended",
+    "visit_cap_exceeded",
 ];
 export const spaceDisabledReasonCode = z.enum(spaceDisabledReasonCodeValues);
 // SpaceTransfer status machine (internal-docs/platform.md "Transfer
@@ -72,10 +75,27 @@ export const siteStatusValues = [
     "deleted",
 ];
 export const siteStatus = z.enum(siteStatusValues);
-// Placement class for shared-pool sites: anonymous pool partition, one shared
-// site per team, or a site dedicated to a single space / tenant-created site.
-export const siteClassValues = ["anonymous_pool", "shared_org", "dedicated_space"];
+// Placement class for a WP.Cloud site. Deploy T accepts the legacy class
+// strings while new code writes the normalized shared/dedicated vocabulary.
+export const siteClassValues = [
+    "shared",
+    "dedicated",
+    "shared_org",
+    "anonymous_pool",
+    "dedicated_space",
+];
 export const siteClass = z.enum(siteClassValues);
+export const normalizedSiteClassValues = ["shared", "dedicated"];
+export const normalizedSiteClass = z.enum(normalizedSiteClassValues);
+export function normalizeSiteClass(value) {
+    return value === "dedicated" || value === "dedicated_space" ? "dedicated" : "shared";
+}
+export function siteClassIsShared(value) {
+    return normalizeSiteClass(value) === "shared";
+}
+export function siteClassIsDedicated(value) {
+    return normalizeSiteClass(value) === "dedicated";
+}
 // PublishSource.kind (internal-docs/platform.md "PublishSource"): the single
 // provenance axis for how a version came to exist. `variable_update` and
 // `config_update` versions are minted by cascades/config regeneration.
@@ -199,13 +219,4 @@ export const enforcementTierValues = ["record", "space_takedown", "account_suspe
 export const enforcementTier = z.enum(enforcementTierValues);
 export const cachePurgeAction = z.enum(["invalidate"]);
 export const cachePurgeTarget = z.enum(["space", "domain", "path"]);
-export const bullJobStatus = z.enum([
-    "active",
-    "completed",
-    "delayed",
-    "failed",
-    "prioritized",
-    "waiting",
-    "waiting-children",
-]);
 export const operationStatus = z.enum(["queued", "running", "succeeded", "failed", "canceled"]);

package/dist/contracts/error-code-meta.d.ts

@@ -4,6 +4,8 @@ export interface ErrorCodeMeta {
     retryable: boolean;
     /** The single actionable recovery hint for this code. */
     recovery: ErrorRecovery;
+    /** Copy-pasteable commands or requests an agent can run next. */
+    next?: readonly string[];
 }
 /** Safe default for codes outside the table (provider passthrough, future codes). */
 export declare const DEFAULT_ERROR_CODE_META: ErrorCodeMeta;
@@ -15,6 +17,7 @@ export declare const ERROR_CODE_META: {
     readonly abuse_report_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly abuse_takedown: {
         readonly retryable: false;
@@ -35,6 +38,7 @@ export declare const ERROR_CODE_META: {
     readonly anonymous_expired: {
         readonly retryable: false;
         readonly recovery: "re_auth";
+        readonly next: readonly ["sf publish", "MCP: call publish", "curl -sS -F archive=@site.zip https://api.spacefast.com/v1/publish"];
     };
     readonly anonymous_pool_unavailable: {
         readonly retryable: true;
@@ -43,6 +47,12 @@ export declare const ERROR_CODE_META: {
     readonly anonymous_publish_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds", "sf login", "sf publish"];
+    };
+    readonly anonymous_space_limit_reached: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+        readonly next: readonly ["sf login", "Claim or delete an existing anonymous space"];
     };
     readonly archive_body_required: {
         readonly retryable: false;
@@ -168,6 +178,16 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly continuation_unavailable: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+        readonly next: readonly ["Ask the owner to create an access token", "sf login", "sf publish --token <access-token>"];
+    };
+    readonly continuation_used: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+        readonly next: readonly ["Use the saved access token", "sf publish --token <access-token>", "Ask the owner to create an access token"];
+    };
     readonly credential_expired: {
         readonly retryable: false;
         readonly recovery: "re_auth";
@@ -192,6 +212,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "contact_support";
     };
+    readonly datacenters_unavailable: {
+        readonly retryable: true;
+        readonly recovery: "retry";
+    };
     readonly data_location_immutable: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -203,6 +227,7 @@ export declare const ERROR_CODE_META: {
     readonly device_verification_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly dns_export_required: {
         readonly retryable: false;
@@ -287,6 +312,7 @@ export declare const ERROR_CODE_META: {
     readonly dns_provider_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds", "sf domains check"];
     };
     readonly dns_provider_replace_all_requires_fresh_plan: {
         readonly retryable: false;
@@ -367,6 +393,7 @@ export declare const ERROR_CODE_META: {
     readonly domain_lookup_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly domain_not_bound: {
         readonly retryable: false;
@@ -415,6 +442,7 @@ export declare const ERROR_CODE_META: {
     readonly event_rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly expired_token: {
         readonly retryable: false;
@@ -632,6 +660,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "contact_support";
     };
+    readonly move_target_capacity_lost: {
+        readonly retryable: true;
+        readonly recovery: "retry";
+    };
     readonly managed_domain_protected: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -692,6 +724,14 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly placement_invalid_burstable: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly placement_mode_requires_plan: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly platform_tenant_immutable_client: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -779,6 +819,7 @@ export declare const ERROR_CODE_META: {
     readonly rate_limited: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly registration_expired: {
         readonly retryable: false;
@@ -907,15 +948,22 @@ export declare const ERROR_CODE_META: {
     readonly slow_down: {
         readonly retryable: true;
         readonly recovery: "wait";
+        readonly next: readonly ["Retry after the Retry-After seconds"];
     };
     readonly space_already_claimed: {
         readonly retryable: false;
         readonly recovery: "fix_input";
+        readonly next: readonly ["sf login", "sf publish --space <space-id>", "Ask the owner to create an access token"];
     };
     readonly space_claim_unavailable: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly space_claimed_credential_available: {
+        readonly retryable: false;
+        readonly recovery: "re_auth";
+        readonly next: readonly ["bash scripts/continue.sh", "MCP: call continue_space", "curl -sS -X POST -H 'Authorization: Bearer <claim-token>' https://api.spacefast.com/v1/anonymous-claim/exchange"];
+    };
     readonly space_disabled: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -992,6 +1040,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly storage_bucket_unavailable: {
+        readonly retryable: true;
+        readonly recovery: "retry";
+    };
     readonly storage_quota_exceeded: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1012,6 +1064,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: true;
         readonly recovery: "wait";
     };
+    readonly team_member_quota_exceeded: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly team_ref_required: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1076,6 +1132,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly transfer_push_failed: {
+        readonly retryable: true;
+        readonly recovery: "retry";
+    };
     readonly transfer_source_changed: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1084,6 +1144,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly transfer_verify_failed: {
+        readonly retryable: true;
+        readonly recovery: "retry";
+    };
     readonly unauthorized: {
         readonly retryable: false;
         readonly recovery: "re_auth";
@@ -1260,6 +1324,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_activating: {
+        readonly retryable: true;
+        readonly recovery: "wait";
+    };
     readonly zero_artifact_invalid: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1500,6 +1568,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_requires_dedicated_plan: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_run_operation_unsupported: {
         readonly retryable: false;
         readonly recovery: "fix_input";

package/dist/contracts/error-code-meta.js

@@ -5,14 +5,35 @@ export const DEFAULT_ERROR_CODE_META = {
 };
 export const ERROR_CODE_META = {
     abuse_report_invalid_transition: { retryable: false, recovery: "fix_input" },
-    abuse_report_rate_limited: { retryable: true, recovery: "wait" },
+    abuse_report_rate_limited: {
+        retryable: true,
+        recovery: "wait",
+        next: ["Retry after the Retry-After seconds"],
+    },
     abuse_takedown: { retryable: false, recovery: "contact_support" },
     access_denied: { retryable: false, recovery: "re_auth" },
     account_suspended: { retryable: false, recovery: "contact_support" },
     ambiguous_space_slug: { retryable: false, recovery: "fix_input" },
-    anonymous_expired: { retryable: false, recovery: "re_auth" },
+    anonymous_expired: {
+        retryable: false,
+        recovery: "re_auth",
+        next: [
+            "sf publish",
+            "MCP: call publish",
+            "curl -sS -F archive=@site.zip https://api.spacefast.com/v1/publish",
+        ],
+    },
     anonymous_pool_unavailable: { retryable: true, recovery: "retry" },
-    anonymous_publish_rate_limited: { retryable: true, recovery: "wait" },
+    anonymous_publish_rate_limited: {
+        retryable: true,
+        recovery: "wait",
+        next: ["Retry after the Retry-After seconds", "sf login", "sf publish"],
+    },
+    anonymous_space_limit_reached: {
+        retryable: false,
+        recovery: "re_auth",
+        next: ["sf login", "Claim or delete an existing anonymous space"],
+    },
     archive_body_required: { retryable: false, recovery: "fix_input" },
     archive_too_large: { retryable: false, recovery: "fix_input" },
     auth_code_required: { retryable: false, recovery: "re_auth" },
@@ -44,15 +65,38 @@ export const ERROR_CODE_META = {
     config_invalid: { retryable: false, recovery: "fix_input" },
     config_meta_too_long: { retryable: false, recovery: "fix_input" },
     config_templates_over_limit: { retryable: false, recovery: "fix_input" },
+    continuation_unavailable: {
+        retryable: false,
+        recovery: "re_auth",
+        next: [
+            "Ask the owner to create an access token",
+            "sf login",
+            "sf publish --token <access-token>",
+        ],
+    },
+    continuation_used: {
+        retryable: false,
+        recovery: "re_auth",
+        next: [
+            "Use the saved access token",
+            "sf publish --token <access-token>",
+            "Ask the owner to create an access token",
+        ],
+    },
     credential_expired: { retryable: false, recovery: "re_auth" },
     credential_not_yet_valid: { retryable: true, recovery: "wait" },
     credential_retired: { retryable: false, recovery: "re_auth" },
     credential_revoked: { retryable: false, recovery: "re_auth" },
     csam_blocked: { retryable: false, recovery: "contact_support" },
     csam_policy_floor: { retryable: false, recovery: "contact_support" },
+    datacenters_unavailable: { retryable: true, recovery: "retry" },
     data_location_immutable: { retryable: false, recovery: "fix_input" },
     device_authorization_failed: { retryable: false, recovery: "re_auth" },
-    device_verification_rate_limited: { retryable: true, recovery: "wait" },
+    device_verification_rate_limited: {
+        retryable: true,
+        recovery: "wait",
+        next: ["Retry after the Retry-After seconds"],
+    },
     dns_export_required: { retryable: false, recovery: "fix_input" },
     dns_field_conflict: { retryable: false, recovery: "fix_input" },
     dns_field_not_applicable: { retryable: false, recovery: "fix_input" },
@@ -73,7 +117,11 @@ export const ERROR_CODE_META = {
     dns_provider_not_connected: { retryable: false, recovery: "re_auth" },
     dns_provider_operation_failed: { retryable: true, recovery: "retry" },
     dns_provider_permission_denied: { retryable: false, recovery: "re_auth" },
-    dns_provider_rate_limited: { retryable: true, recovery: "wait" },
+    dns_provider_rate_limited: {
+        retryable: true,
+        recovery: "wait",
+        next: ["Retry after the Retry-After seconds", "sf domains check"],
+    },
     dns_provider_replace_all_requires_fresh_plan: { retryable: false, recovery: "fix_input" },
     dns_provider_replace_all_write_strategy: { retryable: false, recovery: "fix_input" },
     dns_provider_snapshot_stale: { retryable: false, recovery: "fix_input" },
@@ -93,7 +141,11 @@ export const ERROR_CODE_META = {
     domain_facet_not_applicable: { retryable: false, recovery: "fix_input" },
     domain_hostname_site_mismatch: { retryable: false, recovery: "fix_input" },
     domain_in_use: { retryable: false, recovery: "fix_input" },
-    domain_lookup_rate_limited: { retryable: true, recovery: "wait" },
+    domain_lookup_rate_limited: {
+        retryable: true,
+        recovery: "wait",
+        next: ["Retry after the Retry-After seconds"],
+    },
     domain_not_bound: { retryable: false, recovery: "fix_input" },
     domain_quota_exceeded: { retryable: false, recovery: "fix_input" },
     domain_registration_active: { retryable: false, recovery: "fix_input" },
@@ -105,7 +157,11 @@ export const ERROR_CODE_META = {
     download_required: { retryable: false, recovery: "fix_input" },
     duplicate_version_path: { retryable: false, recovery: "fix_input" },
     event_payload_too_large: { retryable: false, recovery: "fix_input" },
-    event_rate_limited: { retryable: true, recovery: "wait" },
+    event_rate_limited: {
+        retryable: true,
+        recovery: "wait",
+        next: ["Retry after the Retry-After seconds"],
+    },
     expired_token: { retryable: false, recovery: "re_auth" },
     export_archive_not_ready: { retryable: true, recovery: "wait" },
     export_version_not_found: { retryable: false, recovery: "fix_input" },
@@ -160,6 +216,7 @@ export const ERROR_CODE_META = {
     log_retention_clamped: { retryable: false, recovery: "fix_input" },
     lost_domain_control: { retryable: false, recovery: "fix_input" },
     malware_detected: { retryable: false, recovery: "contact_support" },
+    move_target_capacity_lost: { retryable: true, recovery: "retry" },
     managed_domain_protected: { retryable: false, recovery: "fix_input" },
     manifest_body_too_large: { retryable: false, recovery: "fix_input" },
     manifest_duplicate_path: { retryable: false, recovery: "fix_input" },
@@ -175,6 +232,8 @@ export const ERROR_CODE_META = {
     path_too_long: { retryable: false, recovery: "fix_input" },
     plan_grant_already_active: { retryable: false, recovery: "fix_input" },
     plan_grant_already_revoked: { retryable: false, recovery: "fix_input" },
+    placement_invalid_burstable: { retryable: false, recovery: "fix_input" },
+    placement_mode_requires_plan: { retryable: false, recovery: "fix_input" },
     platform_tenant_immutable_client: { retryable: false, recovery: "fix_input" },
     policy_exceeds_grantor: { retryable: false, recovery: "fix_input" },
     principal_space_mismatch: { retryable: false, recovery: "fix_input" },
@@ -196,7 +255,11 @@ export const ERROR_CODE_META = {
     publish_upload_failed: { retryable: true, recovery: "retry" },
     publish_verification_failed: { retryable: true, recovery: "retry" },
     queue_not_found: { retryable: false, recovery: "fix_input" },
-    rate_limited: { retryable: true, recovery: "wait" },
+    rate_limited: {
+        retryable: true,
+        recovery: "wait",
+        next: ["Retry after the Retry-After seconds"],
+    },
     registration_expired: { retryable: false, recovery: "fix_input" },
     registration_expiring: { retryable: false, recovery: "fix_input" },
     routing_rules_over_plan: { retryable: false, recovery: "fix_input" },
@@ -228,9 +291,26 @@ export const ERROR_CODE_META = {
     site_not_static: { retryable: false, recovery: "fix_input" },
     site_required: { retryable: false, recovery: "fix_input" },
     site_suspended: { retryable: false, recovery: "contact_support" },
-    slow_down: { retryable: true, recovery: "wait" },
-    space_already_claimed: { retryable: false, recovery: "fix_input" },
+    slow_down: {
+        retryable: true,
+        recovery: "wait",
+        next: ["Retry after the Retry-After seconds"],
+    },
+    space_already_claimed: {
+        retryable: false,
+        recovery: "fix_input",
+        next: ["sf login", "sf publish --space <space-id>", "Ask the owner to create an access token"],
+    },
     space_claim_unavailable: { retryable: false, recovery: "fix_input" },
+    space_claimed_credential_available: {
+        retryable: false,
+        recovery: "re_auth",
+        next: [
+            "bash scripts/continue.sh",
+            "MCP: call continue_space",
+            "curl -sS -X POST -H 'Authorization: Bearer <claim-token>' https://api.spacefast.com/v1/anonymous-claim/exchange",
+        ],
+    },
     space_disabled: { retryable: false, recovery: "fix_input" },
     space_expired: { retryable: false, recovery: "fix_input" },
     space_has_active_version: { retryable: false, recovery: "fix_input" },
@@ -250,11 +330,13 @@ export const ERROR_CODE_META = {
     static_control_file_not_supported: { retryable: false, recovery: "fix_input" },
     static_runtime_control_path_not_supported: { retryable: false, recovery: "fix_input" },
     static_runtime_required: { retryable: false, recovery: "fix_input" },
+    storage_bucket_unavailable: { retryable: true, recovery: "retry" },
     storage_quota_exceeded: { retryable: false, recovery: "fix_input" },
     storage_usage_unavailable: { retryable: true, recovery: "retry" },
     stripe_error: { retryable: true, recovery: "retry" },
     superseded_by_publish: { retryable: false, recovery: "fix_input" },
     takeover_notice_window: { retryable: true, recovery: "wait" },
+    team_member_quota_exceeded: { retryable: false, recovery: "fix_input" },
     team_ref_required: { retryable: false, recovery: "fix_input" },
     team_required: { retryable: false, recovery: "fix_input" },
     team_slug_conflict: { retryable: false, recovery: "fix_input" },
@@ -271,8 +353,10 @@ export const ERROR_CODE_META = {
     transfer_cross_tenant_unsupported: { retryable: false, recovery: "fix_input" },
     transfer_move_failed: { retryable: true, recovery: "retry" },
     transfer_not_cancelable: { retryable: false, recovery: "fix_input" },
+    transfer_push_failed: { retryable: true, recovery: "retry" },
     transfer_source_changed: { retryable: false, recovery: "fix_input" },
     transfer_target_same_as_source: { retryable: false, recovery: "fix_input" },
+    transfer_verify_failed: { retryable: true, recovery: "retry" },
     unauthorized: { retryable: false, recovery: "re_auth" },
     unsupported_publish_media_type: { retryable: false, recovery: "fix_input" },
     upload_hash_mismatch: { retryable: false, recovery: "fix_input" },
@@ -317,6 +401,7 @@ export const ERROR_CODE_META = {
     wp_cloud_team_shared_site_exists: { retryable: false, recovery: "fix_input" },
     wp_cloud_webhook_secret_not_configured: { retryable: false, recovery: "contact_support" },
     zero_artifact_abi_mismatch: { retryable: false, recovery: "fix_input" },
+    zero_activating: { retryable: true, recovery: "wait" },
     zero_artifact_invalid: { retryable: false, recovery: "fix_input" },
     zero_artifact_malformed: { retryable: false, recovery: "fix_input" },
     zero_artifact_path_invalid: { retryable: false, recovery: "fix_input" },
@@ -377,6 +462,7 @@ export const ERROR_CODE_META = {
     zero_replay_unavailable: { retryable: false, recovery: "fix_input" },
     zero_request_body_too_large: { retryable: false, recovery: "fix_input" },
     zero_response_too_large: { retryable: false, recovery: "fix_input" },
+    zero_requires_dedicated_plan: { retryable: false, recovery: "fix_input" },
     zero_run_operation_unsupported: { retryable: false, recovery: "fix_input" },
     zero_runner_envelope_invalid: { retryable: false, recovery: "fix_input" },
     zero_runner_failed: { retryable: false, recovery: "fix_input" },