@spacefast/common 0.0.6 → 0.0.8

package/dist/contracts/api-keys.js

@@ -233,6 +233,71 @@ export const ApiKeyPatchRequestSchema = z
     .refine((value) => Object.keys(value).length > 0, {
     message: "At least one mutable API key field is required.",
 });
+// Target §5C contract (internal-docs/cli-ux-dx-improvement-plan-2026-07-12.html
+// "API key: finite permissions, no broad role"): key creation selects an
+// explicit, finite scope and permission set — never a team-wide role that
+// falls out of an omitted field. This is deliberately a DISJOINT shape from
+// `ApiKeyCreateRequestSchema` (no teamId/preset/policy): the legacy shape
+// stays valid only on the legacy route (api-keys/routes.ts); this is the only
+// request shape the public core contract (api-contracts/core/api-keys.ts)
+// accepts.
+export const ApiKeyScopeSchema = z
+    .discriminatedUnion("kind", [
+    z.object({ kind: z.literal("team"), teamId: z.string().min(1) }).strict(),
+    z.object({ kind: z.literal("space"), spaceId: z.string().min(1) }).strict(),
+])
+    .describe("Explicit, finite policy target. A space scope narrows the derived policy to exactly that space — never the owning team's whole tree.");
+export const ApiKeyScopedCreateRequestSchema = z
+    .object({
+    name: z.string().trim().min(1).max(255).optional().describe("Human-readable key name."),
+    scope: ApiKeyScopeSchema,
+    permissions: z
+        .array(DescribedStatticActionSchema)
+        .min(1)
+        .max(64)
+        .describe("Finite permission set the derived policy grants, and nothing beyond it."),
+    metadata: AnyObjectSchema.optional().describe("Caller-supplied metadata."),
+    ipAllowlist: z
+        .array(z.string().trim().min(1).max(255))
+        .max(100)
+        .nullable()
+        .optional()
+        .describe("CIDR/IP allowlist for the new key."),
+    expiresAt: z.string().datetime().nullable().optional().describe("Expiry instant."),
+    notBefore: z.string().datetime().nullable().optional().describe("Activation instant."),
+})
+    .strict();
+export const ApiKeyScopedPatchRequestSchema = z
+    .object({
+    scope: ApiKeyScopeSchema.optional().describe("Replacement policy target. Must be supplied together with permissions."),
+    permissions: z
+        .array(DescribedStatticActionSchema)
+        .min(1)
+        .max(64)
+        .optional()
+        .describe("Replacement finite permission set. Must be supplied together with scope."),
+    metadata: AnyObjectSchema.optional().describe("Replacement caller-supplied metadata."),
+    ipAllowlist: z
+        .array(z.string().trim().min(1).max(255))
+        .max(100)
+        .nullable()
+        .optional()
+        .describe("Replacement CIDR/IP allowlist."),
+    expiresAt: z.string().datetime().nullable().optional().describe("Replacement expiry instant."),
+    notBefore: z
+        .string()
+        .datetime()
+        .nullable()
+        .optional()
+        .describe("Replacement activation instant."),
+})
+    .strict()
+    .refine((value) => Object.keys(value).length > 0, {
+    message: "At least one mutable API key field is required.",
+})
+    .refine((value) => (value.scope === undefined) === (value.permissions === undefined), {
+    message: "scope and permissions must be set together, or both omitted.",
+});
 export const ApiKeyParamsSchema = z.object({
     apiKeyId: z.string().min(1).describe("API key id."),
 });

package/dist/contracts/builds.d.ts

@@ -86,11 +86,49 @@ export declare const BuildCreateInputSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     branch: z.ZodOptional<z.ZodString>;
     pullRequestNumber: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>], "kind">;
+declare const buildExecutionLaunchSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        started: "started";
+        starting: "starting";
+        rejected: "rejected";
+    }>;
+    requestedAt: z.ZodString;
+    startedAt: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    rejectedReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const buildExecutionSupervisionSchema: z.ZodObject<{
+    generation: z.ZodNumber;
+    owner: z.ZodString;
+    leaseExpiresAt: z.ZodString;
+}, z.core.$strip>;
 declare const InternalBuildExecutionSchema: z.ZodObject<{
     runner: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     runnerJobId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     sandboxId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     region: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    logOffset: z.ZodOptional<z.ZodNumber>;
+    exitCode: z.ZodOptional<z.ZodNumber>;
+    terminationReason: z.ZodOptional<z.ZodEnum<{
+        command: "command";
+        timeout: "timeout";
+    }>>;
+    launch: z.ZodOptional<z.ZodObject<{
+        state: z.ZodEnum<{
+            started: "started";
+            starting: "starting";
+            rejected: "rejected";
+        }>;
+        requestedAt: z.ZodString;
+        startedAt: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodNumber>;
+        rejectedReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    supervision: z.ZodOptional<z.ZodObject<{
+        generation: z.ZodNumber;
+        owner: z.ZodString;
+        leaseExpiresAt: z.ZodString;
+    }, z.core.$strip>>;
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     phases: z.ZodOptional<z.ZodArray<z.ZodObject<{
         phase: z.ZodString;
@@ -503,6 +541,8 @@ export type InternalBuildSource = z.infer<typeof InternalBuildSourceSchema>;
 export type BuildSettings = z.infer<typeof BuildSettingsSchema>;
 export type BuildTarget = z.infer<typeof BuildTargetSchema>;
 export type InternalBuildExecution = z.infer<typeof InternalBuildExecutionSchema>;
+export type InternalBuildExecutionLaunch = z.infer<typeof buildExecutionLaunchSchema>;
+export type InternalBuildExecutionSupervision = z.infer<typeof buildExecutionSupervisionSchema>;
 export type BuildCreateRequest = z.infer<typeof buildCreateRequestSchema>;
 export type BuildCreateResponse = z.infer<typeof buildCreateResponseSchema>;
 export {};

package/dist/contracts/builds.js

@@ -176,12 +176,29 @@ 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 buildExecutionLaunchSchema = z.object({
+    state: z.enum(["starting", "started", "rejected"]),
+    requestedAt: z.string().datetime(),
+    startedAt: z.string().datetime().optional(),
+    pid: z.number().int().optional(),
+    rejectedReason: z.string().optional(),
+});
+const buildExecutionSupervisionSchema = z.object({
+    generation: z.number().int().positive(),
+    owner: z.string().min(1),
+    leaseExpiresAt: z.string().datetime(),
+});
 const InternalBuildExecutionSchema = z
     .object({
     runner: z.string().nullable().default(null),
     runnerJobId: z.string().nullable().default(null),
     sandboxId: z.string().nullable().default(null),
     region: z.string().nullable().default(null),
+    logOffset: z.number().int().nonnegative().optional(),
+    exitCode: z.number().int().min(0).max(255).optional(),
+    terminationReason: z.enum(["command", "timeout"]).optional(),
+    launch: buildExecutionLaunchSchema.optional(),
+    supervision: buildExecutionSupervisionSchema.optional(),
     metadata: z.record(z.string(), z.unknown()).default({}),
     phases: z
         .array(buildExecutionPhaseSchema)

package/dist/contracts/enums.js

@@ -12,10 +12,11 @@ export const spaceStatusValues = [
 ];
 export const spaceStatus = z.enum(spaceStatusValues);
 // Serving-axis disable reasons (internal-docs/platform.md "Space"): exactly
-// 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.
+// these five. Confirmed scan takedowns use `abuse_takedown`; infected state and
+// claim invalidation are explicit enforcement effects, not reason metadata.
+// `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",

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

@@ -54,6 +54,10 @@ export declare const ERROR_CODE_META: {
         readonly recovery: "re_auth";
         readonly next: readonly ["sf login", "Claim or delete an existing anonymous space"];
     };
+    readonly api_key_scope_underivable: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly archive_body_required: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -435,6 +439,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly enforcement_policy_overlap: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly event_payload_too_large: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -788,6 +796,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly publish_base_changed: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly publish_config_unsupported: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -950,6 +962,18 @@ export declare const ERROR_CODE_META: {
         readonly recovery: "wait";
         readonly next: readonly ["Retry after the Retry-After seconds"];
     };
+    readonly slug_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly slug_reserved: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly slug_unavailable: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly space_already_claimed: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -976,6 +1000,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly space_hostname_identity_missing: {
+        readonly retryable: false;
+        readonly recovery: "contact_support";
+    };
     readonly space_import_archive_invalid: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1320,14 +1348,18 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "contact_support";
     };
-    readonly zero_artifact_abi_mismatch: {
-        readonly retryable: false;
-        readonly recovery: "fix_input";
-    };
     readonly zero_activating: {
         readonly retryable: true;
         readonly recovery: "wait";
     };
+    readonly zero_ai_unavailable: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly zero_artifact_abi_mismatch: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_artifact_invalid: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1336,6 +1368,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_artifact_missing: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_artifact_path_invalid: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1344,6 +1380,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_artifact_untrusted: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_auth_unavailable: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1384,6 +1424,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_capabilities_encode_failed: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_client_bundle_not_loaded: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1456,6 +1500,22 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_endpoint_compile_failed: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly zero_endpoint_conflict: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly zero_endpoint_duplicate: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly zero_endpoint_id_duplicate: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_endpoint_index_invalid: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1472,6 +1532,10 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_endpoint_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_endpoint_mismatch: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1480,6 +1544,14 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_endpoints_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly zero_endpoints_too_many: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_envelope_encode_failed: {
         readonly retryable: true;
         readonly recovery: "retry";
@@ -1512,10 +1584,18 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_lookup_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_method_not_allowed: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_migration_failed: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_query_name_missing: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1572,6 +1652,22 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_routes_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly zero_run_compile_failed: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly zero_run_duplicate: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly zero_run_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_run_operation_unsupported: {
         readonly retryable: false;
         readonly recovery: "fix_input";
@@ -1616,6 +1712,22 @@ export declare const ERROR_CODE_META: {
         readonly retryable: false;
         readonly recovery: "fix_input";
     };
+    readonly zero_runs_invalid: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly zero_runs_require_runtime_compiler: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly zero_runs_too_many: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
+    readonly zero_shopify_unavailable: {
+        readonly retryable: false;
+        readonly recovery: "fix_input";
+    };
     readonly zero_source_compile_failed: {
         readonly retryable: false;
         readonly recovery: "fix_input";

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

@@ -34,6 +34,7 @@ export const ERROR_CODE_META = {
         recovery: "re_auth",
         next: ["sf login", "Claim or delete an existing anonymous space"],
     },
+    api_key_scope_underivable: { retryable: false, recovery: "fix_input" },
     archive_body_required: { retryable: false, recovery: "fix_input" },
     archive_too_large: { retryable: false, recovery: "fix_input" },
     auth_code_required: { retryable: false, recovery: "re_auth" },
@@ -156,6 +157,7 @@ export const ERROR_CODE_META = {
     domain_wildcard_not_enabled: { retryable: false, recovery: "fix_input" },
     download_required: { retryable: false, recovery: "fix_input" },
     duplicate_version_path: { retryable: false, recovery: "fix_input" },
+    enforcement_policy_overlap: { retryable: false, recovery: "fix_input" },
     event_payload_too_large: { retryable: false, recovery: "fix_input" },
     event_rate_limited: {
         retryable: true,
@@ -248,6 +250,7 @@ export const ERROR_CODE_META = {
     publish_archive_expanded_size_exceeded: { retryable: false, recovery: "fix_input" },
     publish_archive_file_count_exceeded: { retryable: false, recovery: "fix_input" },
     publish_archive_too_large: { retryable: false, recovery: "fix_input" },
+    publish_base_changed: { retryable: false, recovery: "fix_input" },
     publish_config_unsupported: { retryable: false, recovery: "fix_input" },
     publish_failed: { retryable: false, recovery: "fix_input" },
     publish_file_missing: { retryable: false, recovery: "fix_input" },
@@ -296,6 +299,9 @@ export const ERROR_CODE_META = {
         recovery: "wait",
         next: ["Retry after the Retry-After seconds"],
     },
+    slug_invalid: { retryable: false, recovery: "fix_input" },
+    slug_reserved: { retryable: false, recovery: "fix_input" },
+    slug_unavailable: { retryable: false, recovery: "fix_input" },
     space_already_claimed: {
         retryable: false,
         recovery: "fix_input",
@@ -314,6 +320,7 @@ export const ERROR_CODE_META = {
     space_disabled: { retryable: false, recovery: "fix_input" },
     space_expired: { retryable: false, recovery: "fix_input" },
     space_has_active_version: { retryable: false, recovery: "fix_input" },
+    space_hostname_identity_missing: { retryable: false, recovery: "contact_support" },
     space_import_archive_invalid: { retryable: false, recovery: "fix_input" },
     space_import_archive_too_large: { retryable: false, recovery: "fix_input" },
     space_import_config_only_archive: { retryable: false, recovery: "fix_input" },
@@ -400,12 +407,15 @@ export const ERROR_CODE_META = {
     wp_cloud_site_still_assigned: { retryable: false, recovery: "fix_input" },
     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_ai_unavailable: { retryable: false, recovery: "fix_input" },
+    zero_artifact_abi_mismatch: { retryable: false, recovery: "fix_input" },
     zero_artifact_invalid: { retryable: false, recovery: "fix_input" },
     zero_artifact_malformed: { retryable: false, recovery: "fix_input" },
+    zero_artifact_missing: { retryable: false, recovery: "fix_input" },
     zero_artifact_path_invalid: { retryable: false, recovery: "fix_input" },
     zero_artifact_unreadable: { retryable: false, recovery: "fix_input" },
+    zero_artifact_untrusted: { retryable: false, recovery: "fix_input" },
     zero_auth_unavailable: { retryable: false, recovery: "fix_input" },
     zero_blob_key_invalid: { retryable: false, recovery: "fix_input" },
     zero_blob_store_full: { retryable: false, recovery: "fix_input" },
@@ -416,6 +426,7 @@ export const ERROR_CODE_META = {
     zero_bytecode_invalid: { retryable: false, recovery: "fix_input" },
     zero_bytecode_path_invalid: { retryable: false, recovery: "fix_input" },
     zero_bytecode_unreadable: { retryable: false, recovery: "fix_input" },
+    zero_capabilities_encode_failed: { retryable: false, recovery: "fix_input" },
     zero_client_bundle_not_loaded: { retryable: false, recovery: "fix_input" },
     zero_db_connect_failed: { retryable: true, recovery: "retry" },
     zero_db_execute_failed: { retryable: false, recovery: "fix_input" },
@@ -434,12 +445,19 @@ export const ERROR_CODE_META = {
     zero_db_url_missing: { retryable: false, recovery: "fix_input" },
     zero_dev_endpoint_failed: { retryable: false, recovery: "fix_input" },
     zero_dump_query_invalid: { retryable: false, recovery: "fix_input" },
+    zero_endpoint_compile_failed: { retryable: false, recovery: "fix_input" },
+    zero_endpoint_conflict: { retryable: false, recovery: "fix_input" },
+    zero_endpoint_duplicate: { retryable: false, recovery: "fix_input" },
+    zero_endpoint_id_duplicate: { retryable: false, recovery: "fix_input" },
     zero_endpoint_index_invalid: { retryable: false, recovery: "fix_input" },
     zero_endpoint_index_malformed: { retryable: false, recovery: "fix_input" },
     zero_endpoint_index_path_invalid: { retryable: false, recovery: "fix_input" },
     zero_endpoint_index_unreadable: { retryable: false, recovery: "fix_input" },
+    zero_endpoint_invalid: { retryable: false, recovery: "fix_input" },
     zero_endpoint_mismatch: { retryable: false, recovery: "fix_input" },
     zero_endpoint_not_found: { retryable: false, recovery: "fix_input" },
+    zero_endpoints_invalid: { retryable: false, recovery: "fix_input" },
+    zero_endpoints_too_many: { retryable: false, recovery: "fix_input" },
     zero_envelope_encode_failed: { retryable: true, recovery: "retry" },
     zero_js_context_init_failed: { retryable: true, recovery: "retry" },
     zero_js_execution_failed: { retryable: false, recovery: "fix_input" },
@@ -448,7 +466,9 @@ export const ERROR_CODE_META = {
     zero_js_response_malformed: { retryable: false, recovery: "fix_input" },
     zero_js_runtime_init_failed: { retryable: true, recovery: "retry" },
     zero_log_query_invalid: { retryable: false, recovery: "fix_input" },
+    zero_lookup_invalid: { retryable: false, recovery: "fix_input" },
     zero_method_not_allowed: { retryable: false, recovery: "fix_input" },
+    zero_migration_failed: { retryable: false, recovery: "fix_input" },
     zero_query_name_missing: { retryable: false, recovery: "fix_input" },
     zero_realtime_forbidden: { retryable: false, recovery: "re_auth" },
     zero_realtime_message_invalid: { retryable: false, recovery: "fix_input" },
@@ -463,6 +483,10 @@ export const ERROR_CODE_META = {
     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_routes_invalid: { retryable: false, recovery: "fix_input" },
+    zero_run_compile_failed: { retryable: false, recovery: "fix_input" },
+    zero_run_duplicate: { retryable: false, recovery: "fix_input" },
+    zero_run_invalid: { 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" },
@@ -474,6 +498,10 @@ export const ERROR_CODE_META = {
     zero_runner_stdin_invalid: { retryable: true, recovery: "retry" },
     zero_runner_stdin_too_large: { retryable: false, recovery: "fix_input" },
     zero_runner_unavailable: { retryable: false, recovery: "fix_input" },
+    zero_runs_invalid: { retryable: false, recovery: "fix_input" },
+    zero_runs_require_runtime_compiler: { retryable: false, recovery: "fix_input" },
+    zero_runs_too_many: { retryable: false, recovery: "fix_input" },
+    zero_shopify_unavailable: { retryable: false, recovery: "fix_input" },
     zero_source_compile_failed: { retryable: false, recovery: "fix_input" },
     zero_source_hash_mismatch: { retryable: false, recovery: "fix_input" },
     zero_source_invalid: { retryable: false, recovery: "fix_input" },

package/dist/contracts/error-codes.d.ts

@@ -2,7 +2,7 @@ import { ERROR_DOCS_BASE_URL } from "../brand.js";
 export { ERROR_DOCS_BASE_URL };
 /** `docsUrl` derivation rule: docs origin + `/{code}`. Asserted by the conformance suite. */
 export declare function errorDocsUrl(code: string): string;
-export declare const ERROR_CODES: readonly ["abuse_report_invalid_transition", "abuse_report_rate_limited", "abuse_takedown", "access_denied", "account_suspended", "ambiguous_space_slug", "anonymous_expired", "anonymous_pool_unavailable", "anonymous_publish_rate_limited", "anonymous_space_limit_reached", "archive_body_required", "archive_too_large", "auth_code_required", "authorization_pending", "billing_receipt_invalid", "billing_receipt_not_bound_to_team", "billing_store_not_configured", "billing_subscription_conflict", "billing_unknown_product", "build_command_missing", "build_execution_unavailable", "build_failed", "build_install_failed", "build_no_index_html", "build_not_created", "build_oom", "build_output_dir_missing", "build_timeout", "cache_purge_domain_required", "cache_purge_path_required", "channel_name_reserved", "channel_pointer_moved", "channel_unsupported", "claim_blocked_takedown", "claim_target_not_found", "claimed_space_quota_exceeded", "cli_upgrade_required", "config_file_too_large", "config_invalid", "config_meta_too_long", "config_templates_over_limit", "continuation_unavailable", "continuation_used", "credential_expired", "credential_not_yet_valid", "credential_retired", "credential_revoked", "csam_blocked", "csam_policy_floor", "data_location_immutable", "datacenters_unavailable", "device_authorization_failed", "device_verification_rate_limited", "dns_export_required", "dns_field_conflict", "dns_field_not_applicable", "dns_import_partial_visibility", "dns_provider_auth_expired", "dns_provider_batch_unsupported", "dns_provider_change_pending", "dns_provider_conflict", "dns_provider_connection_in_use", "dns_provider_connection_unavailable", "dns_provider_controlled_desired_state", "dns_provider_credentials_expired", "dns_provider_feature_descriptors", "dns_provider_feature_unavailable", "dns_provider_field_unsupported", "dns_provider_future_authoritative_backend", "dns_provider_missing_permission", "dns_provider_not_connected", "dns_provider_operation_failed", "dns_provider_permission_denied", "dns_provider_rate_limited", "dns_provider_replace_all_requires_fresh_plan", "dns_provider_replace_all_write_strategy", "dns_provider_snapshot_stale", "dns_provider_snapshot_unavailable", "dns_provider_temporarily_unavailable", "dns_provider_timeout", "dns_provider_validation_failed", "dns_provider_workflow_templates", "dns_provider_zone_not_found", "dns_record_conflicts_with_managed", "dns_record_managed", "dns_record_not_found", "domain_already_exists", "domain_bound", "domain_facet_already_managed", "domain_facet_external", "domain_facet_not_applicable", "domain_hostname_site_mismatch", "domain_in_use", "domain_lookup_rate_limited", "domain_not_bound", "domain_quota_exceeded", "domain_registration_active", "domain_registration_not_renewable", "domain_reserved_suffix", "domain_transfer_active", "domain_wildcard_label", "domain_wildcard_not_enabled", "download_required", "duplicate_version_path", "event_payload_too_large", "event_rate_limited", "expired_token", "export_archive_not_ready", "export_version_not_found", "feature_unavailable", "files_mode_does_not_support_spa", "forbidden", "free_external_proxy_disabled", "free_headers_basic_auth_disabled", "idempotency_conflict_in_progress", "idempotency_key_reused", "immutable_version_requires_login", "import_archive_not_uploaded", "import_not_cancelable", "import_not_waiting_for_archive", "incumbent_controls_dns", "inject_invalid", "inject_snippet_too_large", "internal_error", "invalid_claim_token", "invalid_continuation_token", "invalid_data_location", "invalid_device_code", "invalid_domain", "invalid_domain_name", "invalid_file_path", "invalid_grant", "invalid_publish_archive", "invalid_publish_path", "invalid_publish_payload", "invalid_request", "invalid_runtime_event", "invalid_space", "invalid_space_mode", "invalid_user_code", "invalid_version_path", "invalid_webhook_events", "invalid_webhook_payload", "invalid_webhook_signature", "invalid_webhook_url", "invalid_zero_realtime_event", "invalid_zero_realtime_replay_query", "invitation_already_exists", "invitation_email_mismatch", "invitation_expired", "invitation_not_pending", "ip_blocked", "job_not_found", "job_not_promotable", "job_not_removable", "job_not_retryable", "last_owner", "log_retention_clamped", "lost_domain_control", "malware_detected", "managed_domain_protected", "manifest_body_too_large", "manifest_duplicate_path", "manifest_too_many_files", "member_already_exists", "missing_route_param", "move_target_capacity_lost", "nameserver_delegation_required", "nameserver_divergence", "noop_publish", "not_enrolled", "not_found", "path_case_collision", "path_too_long", "placement_invalid_burstable", "placement_mode_requires_plan", "plan_grant_already_active", "plan_grant_already_revoked", "platform_tenant_immutable_client", "policy_exceeds_grantor", "principal_space_mismatch", "provider_error", "provider_job_failed", "provider_job_timeout", "provider_runtime_feature_unsupported", "provider_site_id_required", "proxy_upstream_denied", "proxy_upstream_unresolved", "publish_archive_compression_ratio_exceeded", "publish_archive_expanded_size_exceeded", "publish_archive_file_count_exceeded", "publish_archive_too_large", "publish_config_unsupported", "publish_failed", "publish_file_missing", "publish_setup_failed", "publish_upload_failed", "publish_verification_failed", "queue_not_found", "rate_limited", "registration_expired", "registration_expiring", "routing_rules_over_plan", "runtime_action_forbidden", "runtime_api_not_found", "runtime_callback_forbidden", "runtime_engine_zip_missing", "runtime_hostname_unassigned", "runtime_instance_mismatch", "runtime_jti_missing", "runtime_jti_replayed", "runtime_jwks_key_missing", "runtime_logs_unavailable", "runtime_management_unavailable", "runtime_not_provisioned", "runtime_operation_missing", "runtime_scope_forbidden", "runtime_token_bad_signature", "runtime_token_expired", "runtime_token_invalid", "runtime_unauthorized", "runtime_upload_operation_not_supported", "runtime_upload_required", "scan_pending", "secret_variable_in_template", "site_already_deleted", "site_capacity_exceeded", "site_has_live_spaces", "site_not_static", "site_required", "site_suspended", "slow_down", "space_already_claimed", "space_claim_unavailable", "space_claimed_credential_available", "space_disabled", "space_expired", "space_has_active_version", "space_import_archive_invalid", "space_import_archive_too_large", "space_import_config_only_archive", "space_import_runtime_schema_unsupported", "space_moving", "space_no_live_version", "space_not_disabled", "space_not_restorable", "space_ref_ambiguous", "space_ref_required", "space_transferring", "space_unclaimed", "ssl_renewal_blocked", "static_control_file_not_supported", "static_runtime_control_path_not_supported", "static_runtime_required", "storage_bucket_unavailable", "storage_quota_exceeded", "storage_usage_unavailable", "stripe_error", "superseded_by_publish", "takeover_notice_window", "team_member_quota_exceeded", "team_ref_required", "team_required", "team_slug_conflict", "template_file_too_large", "template_not_in_version", "template_variable_unresolved", "tenant_id_mismatch", "tenant_not_found", "tenant_not_granted", "tenant_past_due", "tenant_selection_required", "tenant_suspended", "theme_value_invalid", "transfer_cross_tenant_unsupported", "transfer_move_failed", "transfer_not_cancelable", "transfer_push_failed", "transfer_source_changed", "transfer_target_same_as_source", "transfer_verify_failed", "unauthorized", "unsupported_publish_media_type", "upload_hash_mismatch", "upload_path_not_canonical", "upload_path_not_declared", "upload_session_cap_exceeded", "upload_size_mismatch", "user_banned", "validation_error", "variable_cascade_failed", "verification_required", "version_already_live", "version_artifact_not_found", "version_busy", "version_canceled", "version_closed", "version_expired", "version_failed", "version_file_count_exceeded", "version_file_not_found", "version_file_too_large", "version_files_missing", "version_in_use", "version_live", "version_no_publishable_files", "version_not_finalizable", "version_not_found", "version_not_prepared", "version_not_promotable", "version_not_ready", "version_quota_exceeded", "version_total_bytes_exceeded", "webhook_delivery_budget_exceeded", "whois_unavailable", "wp_cloud_anonymous_pool_required", "wp_cloud_assignment_kind_mismatch", "wp_cloud_assignment_space_mismatch", "wp_cloud_assignment_team_mismatch", "wp_cloud_client_in_use", "wp_cloud_client_not_found", "wp_cloud_site_still_assigned", "wp_cloud_team_shared_site_exists", "wp_cloud_webhook_secret_not_configured", "zero_activating", "zero_artifact_abi_mismatch", "zero_artifact_invalid", "zero_artifact_malformed", "zero_artifact_path_invalid", "zero_artifact_unreadable", "zero_auth_unavailable", "zero_blob_key_invalid", "zero_blob_store_full", "zero_blob_too_large", "zero_blob_value_invalid", "zero_bootstrap_encode_failed", "zero_bytecode_hash_mismatch", "zero_bytecode_invalid", "zero_bytecode_path_invalid", "zero_bytecode_unreadable", "zero_client_bundle_not_loaded", "zero_db_connect_failed", "zero_db_execute_failed", "zero_db_host_install_failed", "zero_db_operation_invalid", "zero_db_operation_too_large", "zero_db_param_invalid", "zero_db_query_failed", "zero_db_row_invalid", "zero_db_sql_invalid", "zero_db_too_many_params", "zero_db_transaction_commit_failed", "zero_db_transaction_invalid", "zero_db_transaction_start_failed", "zero_db_url_invalid", "zero_db_url_missing", "zero_dev_endpoint_failed", "zero_dump_query_invalid", "zero_endpoint_index_invalid", "zero_endpoint_index_malformed", "zero_endpoint_index_path_invalid", "zero_endpoint_index_unreadable", "zero_endpoint_mismatch", "zero_endpoint_not_found", "zero_envelope_encode_failed", "zero_js_context_init_failed", "zero_js_execution_failed", "zero_js_execution_timeout", "zero_js_globals_failed", "zero_js_response_malformed", "zero_js_runtime_init_failed", "zero_log_query_invalid", "zero_method_not_allowed", "zero_query_name_missing", "zero_realtime_forbidden", "zero_realtime_message_invalid", "zero_realtime_operation_unsupported", "zero_realtime_query_invalid", "zero_realtime_space_required", "zero_realtime_unavailable", "zero_realtime_websocket_forbidden", "zero_replay_failed", "zero_replay_query_invalid", "zero_replay_unavailable", "zero_request_body_too_large", "zero_requires_dedicated_plan", "zero_response_too_large", "zero_run_operation_unsupported", "zero_runner_envelope_invalid", "zero_runner_failed", "zero_runner_invalid_body", "zero_runner_invalid_response", "zero_runner_invalid_status", "zero_runner_protocol_unsupported", "zero_runner_response_encode_failed", "zero_runner_stdin_invalid", "zero_runner_stdin_too_large", "zero_runner_unavailable", "zero_source_compile_failed", "zero_source_hash_mismatch", "zero_source_invalid", "zero_source_path_invalid", "zero_source_unreadable"];
+export declare const ERROR_CODES: readonly ["abuse_report_invalid_transition", "abuse_report_rate_limited", "abuse_takedown", "access_denied", "account_suspended", "ambiguous_space_slug", "anonymous_expired", "anonymous_pool_unavailable", "anonymous_publish_rate_limited", "anonymous_space_limit_reached", "api_key_scope_underivable", "archive_body_required", "archive_too_large", "auth_code_required", "authorization_pending", "billing_receipt_invalid", "billing_receipt_not_bound_to_team", "billing_store_not_configured", "billing_subscription_conflict", "billing_unknown_product", "build_command_missing", "build_execution_unavailable", "build_failed", "build_install_failed", "build_no_index_html", "build_not_created", "build_oom", "build_output_dir_missing", "build_timeout", "cache_purge_domain_required", "cache_purge_path_required", "channel_name_reserved", "channel_pointer_moved", "channel_unsupported", "claim_blocked_takedown", "claim_target_not_found", "claimed_space_quota_exceeded", "cli_upgrade_required", "config_file_too_large", "config_invalid", "config_meta_too_long", "config_templates_over_limit", "continuation_unavailable", "continuation_used", "credential_expired", "credential_not_yet_valid", "credential_retired", "credential_revoked", "csam_blocked", "csam_policy_floor", "data_location_immutable", "datacenters_unavailable", "device_authorization_failed", "device_verification_rate_limited", "dns_export_required", "dns_field_conflict", "dns_field_not_applicable", "dns_import_partial_visibility", "dns_provider_auth_expired", "dns_provider_batch_unsupported", "dns_provider_change_pending", "dns_provider_conflict", "dns_provider_connection_in_use", "dns_provider_connection_unavailable", "dns_provider_controlled_desired_state", "dns_provider_credentials_expired", "dns_provider_feature_descriptors", "dns_provider_feature_unavailable", "dns_provider_field_unsupported", "dns_provider_future_authoritative_backend", "dns_provider_missing_permission", "dns_provider_not_connected", "dns_provider_operation_failed", "dns_provider_permission_denied", "dns_provider_rate_limited", "dns_provider_replace_all_requires_fresh_plan", "dns_provider_replace_all_write_strategy", "dns_provider_snapshot_stale", "dns_provider_snapshot_unavailable", "dns_provider_temporarily_unavailable", "dns_provider_timeout", "dns_provider_validation_failed", "dns_provider_workflow_templates", "dns_provider_zone_not_found", "dns_record_conflicts_with_managed", "dns_record_managed", "dns_record_not_found", "domain_already_exists", "domain_bound", "domain_facet_already_managed", "domain_facet_external", "domain_facet_not_applicable", "domain_hostname_site_mismatch", "domain_in_use", "domain_lookup_rate_limited", "domain_not_bound", "domain_quota_exceeded", "domain_registration_active", "domain_registration_not_renewable", "domain_reserved_suffix", "domain_transfer_active", "domain_wildcard_label", "domain_wildcard_not_enabled", "download_required", "duplicate_version_path", "enforcement_policy_overlap", "event_payload_too_large", "event_rate_limited", "expired_token", "export_archive_not_ready", "export_version_not_found", "feature_unavailable", "files_mode_does_not_support_spa", "forbidden", "free_external_proxy_disabled", "free_headers_basic_auth_disabled", "idempotency_conflict_in_progress", "idempotency_key_reused", "immutable_version_requires_login", "import_archive_not_uploaded", "import_not_cancelable", "import_not_waiting_for_archive", "incumbent_controls_dns", "inject_invalid", "inject_snippet_too_large", "internal_error", "invalid_claim_token", "invalid_continuation_token", "invalid_data_location", "invalid_device_code", "invalid_domain", "invalid_domain_name", "invalid_file_path", "invalid_grant", "invalid_publish_archive", "invalid_publish_path", "invalid_publish_payload", "invalid_request", "invalid_runtime_event", "invalid_space", "invalid_space_mode", "invalid_user_code", "invalid_version_path", "invalid_webhook_events", "invalid_webhook_payload", "invalid_webhook_signature", "invalid_webhook_url", "invalid_zero_realtime_event", "invalid_zero_realtime_replay_query", "invitation_already_exists", "invitation_email_mismatch", "invitation_expired", "invitation_not_pending", "ip_blocked", "job_not_found", "job_not_promotable", "job_not_removable", "job_not_retryable", "last_owner", "log_retention_clamped", "lost_domain_control", "malware_detected", "managed_domain_protected", "manifest_body_too_large", "manifest_duplicate_path", "manifest_too_many_files", "member_already_exists", "missing_route_param", "move_target_capacity_lost", "nameserver_delegation_required", "nameserver_divergence", "noop_publish", "not_enrolled", "not_found", "path_case_collision", "path_too_long", "placement_invalid_burstable", "placement_mode_requires_plan", "plan_grant_already_active", "plan_grant_already_revoked", "platform_tenant_immutable_client", "policy_exceeds_grantor", "principal_space_mismatch", "provider_error", "provider_job_failed", "provider_job_timeout", "provider_runtime_feature_unsupported", "provider_site_id_required", "proxy_upstream_denied", "proxy_upstream_unresolved", "publish_archive_compression_ratio_exceeded", "publish_archive_expanded_size_exceeded", "publish_archive_file_count_exceeded", "publish_archive_too_large", "publish_base_changed", "publish_config_unsupported", "publish_failed", "publish_file_missing", "publish_setup_failed", "publish_upload_failed", "publish_verification_failed", "queue_not_found", "rate_limited", "registration_expired", "registration_expiring", "routing_rules_over_plan", "runtime_action_forbidden", "runtime_api_not_found", "runtime_callback_forbidden", "runtime_engine_zip_missing", "runtime_hostname_unassigned", "runtime_instance_mismatch", "runtime_jti_missing", "runtime_jti_replayed", "runtime_jwks_key_missing", "runtime_logs_unavailable", "runtime_management_unavailable", "runtime_not_provisioned", "runtime_operation_missing", "runtime_scope_forbidden", "runtime_token_bad_signature", "runtime_token_expired", "runtime_token_invalid", "runtime_unauthorized", "runtime_upload_operation_not_supported", "runtime_upload_required", "scan_pending", "secret_variable_in_template", "site_already_deleted", "site_capacity_exceeded", "site_has_live_spaces", "site_not_static", "site_required", "site_suspended", "slow_down", "slug_invalid", "slug_reserved", "slug_unavailable", "space_already_claimed", "space_claim_unavailable", "space_claimed_credential_available", "space_disabled", "space_expired", "space_has_active_version", "space_hostname_identity_missing", "space_import_archive_invalid", "space_import_archive_too_large", "space_import_config_only_archive", "space_import_runtime_schema_unsupported", "space_moving", "space_no_live_version", "space_not_disabled", "space_not_restorable", "space_ref_ambiguous", "space_ref_required", "space_transferring", "space_unclaimed", "ssl_renewal_blocked", "static_control_file_not_supported", "static_runtime_control_path_not_supported", "static_runtime_required", "storage_bucket_unavailable", "storage_quota_exceeded", "storage_usage_unavailable", "stripe_error", "superseded_by_publish", "takeover_notice_window", "team_member_quota_exceeded", "team_ref_required", "team_required", "team_slug_conflict", "template_file_too_large", "template_not_in_version", "template_variable_unresolved", "tenant_id_mismatch", "tenant_not_found", "tenant_not_granted", "tenant_past_due", "tenant_selection_required", "tenant_suspended", "theme_value_invalid", "transfer_cross_tenant_unsupported", "transfer_move_failed", "transfer_not_cancelable", "transfer_push_failed", "transfer_source_changed", "transfer_target_same_as_source", "transfer_verify_failed", "unauthorized", "unsupported_publish_media_type", "upload_hash_mismatch", "upload_path_not_canonical", "upload_path_not_declared", "upload_session_cap_exceeded", "upload_size_mismatch", "user_banned", "validation_error", "variable_cascade_failed", "verification_required", "version_already_live", "version_artifact_not_found", "version_busy", "version_canceled", "version_closed", "version_expired", "version_failed", "version_file_count_exceeded", "version_file_not_found", "version_file_too_large", "version_files_missing", "version_in_use", "version_live", "version_no_publishable_files", "version_not_finalizable", "version_not_found", "version_not_prepared", "version_not_promotable", "version_not_ready", "version_quota_exceeded", "version_total_bytes_exceeded", "webhook_delivery_budget_exceeded", "whois_unavailable", "wp_cloud_anonymous_pool_required", "wp_cloud_assignment_kind_mismatch", "wp_cloud_assignment_space_mismatch", "wp_cloud_assignment_team_mismatch", "wp_cloud_client_in_use", "wp_cloud_client_not_found", "wp_cloud_site_still_assigned", "wp_cloud_team_shared_site_exists", "wp_cloud_webhook_secret_not_configured", "zero_activating", "zero_ai_unavailable", "zero_artifact_abi_mismatch", "zero_artifact_invalid", "zero_artifact_malformed", "zero_artifact_missing", "zero_artifact_path_invalid", "zero_artifact_unreadable", "zero_artifact_untrusted", "zero_auth_unavailable", "zero_blob_key_invalid", "zero_blob_store_full", "zero_blob_too_large", "zero_blob_value_invalid", "zero_bootstrap_encode_failed", "zero_bytecode_hash_mismatch", "zero_bytecode_invalid", "zero_bytecode_path_invalid", "zero_bytecode_unreadable", "zero_capabilities_encode_failed", "zero_client_bundle_not_loaded", "zero_db_connect_failed", "zero_db_execute_failed", "zero_db_host_install_failed", "zero_db_operation_invalid", "zero_db_operation_too_large", "zero_db_param_invalid", "zero_db_query_failed", "zero_db_row_invalid", "zero_db_sql_invalid", "zero_db_too_many_params", "zero_db_transaction_commit_failed", "zero_db_transaction_invalid", "zero_db_transaction_start_failed", "zero_db_url_invalid", "zero_db_url_missing", "zero_dev_endpoint_failed", "zero_dump_query_invalid", "zero_endpoint_compile_failed", "zero_endpoint_conflict", "zero_endpoint_duplicate", "zero_endpoint_id_duplicate", "zero_endpoint_index_invalid", "zero_endpoint_index_malformed", "zero_endpoint_index_path_invalid", "zero_endpoint_index_unreadable", "zero_endpoint_invalid", "zero_endpoint_mismatch", "zero_endpoint_not_found", "zero_endpoints_invalid", "zero_endpoints_too_many", "zero_envelope_encode_failed", "zero_js_context_init_failed", "zero_js_execution_failed", "zero_js_execution_timeout", "zero_js_globals_failed", "zero_js_response_malformed", "zero_js_runtime_init_failed", "zero_log_query_invalid", "zero_lookup_invalid", "zero_method_not_allowed", "zero_migration_failed", "zero_query_name_missing", "zero_realtime_forbidden", "zero_realtime_message_invalid", "zero_realtime_operation_unsupported", "zero_realtime_query_invalid", "zero_realtime_space_required", "zero_realtime_unavailable", "zero_realtime_websocket_forbidden", "zero_replay_failed", "zero_replay_query_invalid", "zero_replay_unavailable", "zero_request_body_too_large", "zero_requires_dedicated_plan", "zero_response_too_large", "zero_routes_invalid", "zero_run_compile_failed", "zero_run_duplicate", "zero_run_invalid", "zero_run_operation_unsupported", "zero_runner_envelope_invalid", "zero_runner_failed", "zero_runner_invalid_body", "zero_runner_invalid_response", "zero_runner_invalid_status", "zero_runner_protocol_unsupported", "zero_runner_response_encode_failed", "zero_runner_stdin_invalid", "zero_runner_stdin_too_large", "zero_runner_unavailable", "zero_runs_invalid", "zero_runs_require_runtime_compiler", "zero_runs_too_many", "zero_shopify_unavailable", "zero_source_compile_failed", "zero_source_hash_mismatch", "zero_source_invalid", "zero_source_path_invalid", "zero_source_unreadable"];
 export type ErrorCode = (typeof ERROR_CODES)[number];
 export declare function isErrorCode(value: string): value is ErrorCode;
 /**