@spacefast/common 0.0.13 → 0.0.18

package/dist/contracts/error-codes.js

@@ -1,26 +1,33 @@
 // The single error-code table (internal-docs/platform.md "Global API Conventions").
-// Every error envelope `code` the control plane emits is a member of this table, and
-// `docsUrl` is derived mechanically from the code (`https://spacefast.com/docs/errors/{code}`).
+// Every problem document `code` the control plane emits is a member of this table, and
+// the problem `type` is derived mechanically from the code
+// (`https://spacefast.com/docs/errors/{code}`).
 // The conformance suite asserts the derivation rule so links never rot, and error docs
 // pages are generated from this enum. Control-plane error constructors are typed against
 // `ErrorCode`, so emitting a code that is not in the table is a typecheck (CI) failure;
 // the remaining untyped string paths (low-level serializer, superadmin Better Auth
-// passthrough) fold into the typed envelope in the F2 envelope chunk.
+// passthrough) fold into the typed problem document in the F2 envelope chunk.
 // A code's meaning stays stable while it can be emitted. Retiring an API surface removes
 // its dead codes and generated references together. Diagnostic codes share this table so
 // every current diagnostic also carries a resolvable docs link.
-import { ERROR_DOCS_BASE_URL } from "../brand.js";
-export { ERROR_DOCS_BASE_URL };
-/** `docsUrl` derivation rule: docs origin + `/{code}`. Asserted by the conformance suite. */
+import { DOCS_BASE_URL } from "../config/domains.js";
+export const ERROR_DOCS_BASE_URL = `${DOCS_BASE_URL}/errors`;
+/** Media type of every 4xx/5xx response body (RFC 9457 problem details). */
+export const PROBLEM_CONTENT_TYPE = "application/problem+json";
+/** Problem `type` URI derivation rule: docs origin + `/{code}`. Asserted by the conformance suite. */
 export function errorDocsUrl(code) {
     return `${ERROR_DOCS_BASE_URL}/${code}`;
 }
+/** Problem `title` derivation rule: the snake_case code as a sentence ("version_not_found" → "Version not found"). */
+export function errorTitle(code) {
+    const words = code.replaceAll("_", " ");
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
 export const ERROR_CODES = [
     "abuse_report_invalid_transition",
     "abuse_report_rate_limited",
     "abuse_takedown",
     "access_denied",
-    "access_scope_suggestion",
     "account_suspended",
     "agent_handoff_declined",
     "agent_handoff_limit_reached",
@@ -60,8 +67,12 @@ export const ERROR_CODES = [
     "cli_upgrade_required",
     "comment_screenshot_rate_limited",
     "config_file_too_large",
+    "config_functions_key_removed",
     "config_invalid",
     "config_meta_too_long",
+    "config_name_too_long",
+    "config_runtime_entry_missing",
+    "config_runtime_invalid_kind",
     "config_templates_over_limit",
     "continuation_unavailable",
     "continuation_used",
@@ -73,6 +84,7 @@ export const ERROR_CODES = [
     "csam_policy_floor",
     "custom_certificates_require_dedicated_site",
     "data_location_immutable",
+    "db_not_available",
     "device_authorization_failed",
     "device_verification_rate_limited",
     "dns_export_required",
@@ -189,10 +201,11 @@ export const ERROR_CODES = [
     "manifest_body_too_large",
     "manifest_duplicate_path",
     "manifest_too_many_files",
-    "mcp_acted_for_team_deleted",
     "member_already_exists",
+    "method_not_allowed",
     "missing_route_param",
     "move_target_capacity_lost",
+    "name_managed_by_config",
     "nameserver_delegation_required",
     "nameserver_divergence",
     "noop_publish",
@@ -228,7 +241,6 @@ export const ERROR_CODES = [
     "publish_not_cancelable",
     "publish_path_collision",
     "publish_path_invalid",
-    "publish_reference_missing",
     "publish_setup_failed",
     "publish_snapshot_empty",
     "publish_upload_failed",
@@ -237,16 +249,19 @@ export const ERROR_CODES = [
     "rate_limited",
     "registration_expired",
     "registration_expiring",
+    "resource_revision_changed",
     "routing_rules_over_plan",
     "runtime_action_forbidden",
     "runtime_api_not_found",
     "runtime_callback_forbidden",
+    "runtime_dev_unsupported",
     "runtime_engine_zip_missing",
     "runtime_hostname_unassigned",
     "runtime_instance_mismatch",
     "runtime_jti_missing",
     "runtime_jti_replayed",
     "runtime_jwks_key_missing",
+    "runtime_kind_mismatch",
     "runtime_management_unavailable",
     "runtime_not_provisioned",
     "runtime_operation_missing",
@@ -259,6 +274,7 @@ export const ERROR_CODES = [
     "runtime_upload_required",
     "scan_pending",
     "secret_variable_in_template",
+    "service_booting",
     "service_signature_invalid",
     "site_already_deleted",
     "site_has_live_spaces",
@@ -290,23 +306,29 @@ export const ERROR_CODES = [
     "space_no_live_version",
     "space_not_disabled",
     "space_not_restorable",
+    "space_person_already_member",
+    "space_person_invitation_pending",
+    "space_person_self_invite",
     "space_ref_ambiguous",
     "space_ref_required",
     "space_transferring",
     "space_unclaimed",
     "ssl_renewal_blocked",
     "static_control_file_not_supported",
-    "static_mount_path_conflict",
-    "static_mount_source_not_ready",
-    "static_mount_target_forbidden",
-    "static_mount_target_in_use",
-    "static_mount_target_not_live",
-    "static_mount_target_not_ready",
-    "static_mount_target_not_static",
     "static_runtime_control_path_not_supported",
     "static_runtime_required",
+    "storage_auth_required",
     "storage_bucket_unavailable",
+    "storage_content_blocked",
+    "storage_delete_forbidden",
+    "storage_empty_file",
+    "storage_file_too_large",
+    "storage_key_invalid",
+    "storage_object_not_found",
+    "storage_quota_already_unlimited",
+    "storage_quota_decrease_not_supported",
     "storage_quota_exceeded",
+    "storage_unavailable",
     "storage_usage_unavailable",
     "stripe_error",
     "superseded_by_publish",
@@ -395,6 +417,12 @@ export const ERROR_CODES = [
     "zero_client_bundle_not_loaded",
     "zero_db_connect_failed",
     "zero_db_execute_failed",
+    "zero_db_export_cursor_invalid",
+    "zero_db_export_failed",
+    "zero_db_export_page_too_large",
+    "zero_db_export_query_invalid",
+    "zero_db_export_schema_changed",
+    "zero_db_export_schema_unavailable",
     "zero_db_host_install_failed",
     "zero_db_operation_invalid",
     "zero_db_operation_too_large",
@@ -402,6 +430,8 @@ export const ERROR_CODES = [
     "zero_db_query_failed",
     "zero_db_row_invalid",
     "zero_db_sql_invalid",
+    "zero_db_target_denied",
+    "zero_db_tls_required",
     "zero_db_too_many_params",
     "zero_db_transaction_active",
     "zero_db_transaction_commit_failed",
@@ -471,11 +501,6 @@ export const ERROR_CODES = [
     "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",
 ];
 const ERROR_CODE_SET = new Set(ERROR_CODES);
 export function isErrorCode(value) {

package/dist/contracts/events.d.ts

@@ -51,11 +51,18 @@ export declare const EVENT_CATALOG: {
         }, z.core.$strict>;
     };
     "client.error.observed": {
-        sources: ("www" | "dashboard" | "cli" | "other")[];
-        actors: ("analytics_id" | "anonymous_id" | "anonymous_machine")[];
+        sources: ("www" | "dashboard")[];
+        actors: ("analytics_id" | "anonymous_id")[];
         properties: z.ZodObject<{
+            kind: z.ZodEnum<{
+                uncaught_exception: "uncaught_exception";
+                unhandled_rejection: "unhandled_rejection";
+            }>;
             error_class: z.ZodString;
-            path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            message: z.ZodNullable<z.ZodString>;
+            frames: z.ZodNullable<z.ZodString>;
+            fingerprint: z.ZodString;
+            path: z.ZodString;
         }, z.core.$strict>;
     };
     "cli.command.completed": {

package/dist/contracts/events.js

@@ -9,7 +9,7 @@ const occurredAtSchema = z
     .string()
     .datetime()
     .optional()
-    .describe("Client-side event time; the server receive time is authoritative when omitted.");
+    .describe("Client-side event time; server receipt time is authoritative when omitted.");
 const pathSchema = z
     .string()
     .min(1)
@@ -68,10 +68,38 @@ const webVitalPropertiesSchema = z
     path: pathSchema,
 })
     .strict();
+// An uncaught browser error is not a single label — `error.name` is "Error" for
+// almost every application throw, so a one-field shape both fails to attribute
+// and (because it feeds the sender's dedupe key) suppresses genuinely distinct
+// errors. Model the fingerprint instead: signal kind, thrown-value class,
+// redacted message, top frames, and a deterministic grouping key. Every string
+// stays within `propertyValueSchema`'s 512-char cap — the generic property bag
+// validates alongside this schema, so a longer field would 400 at ingest.
 const clientErrorPropertiesSchema = z
     .object({
-    error_class: z.string().min(1).max(128),
-    path: pathSchema.nullable().optional(),
+    kind: z
+        .enum(["uncaught_exception", "unhandled_rejection"])
+        .describe("Which browser signal produced this — orthogonal to what was thrown."),
+    error_class: z
+        .string()
+        .min(1)
+        .max(128)
+        .describe("Constructor name, or `NonError:<typeof>` when a non-Error was thrown."),
+    message: z
+        .string()
+        .max(512)
+        .nullable()
+        .describe("Redacted, truncated message; null when the thrown value carries none."),
+    frames: z
+        .string()
+        .max(512)
+        .nullable()
+        .describe("Top stack frames, newest first, origin-relative, ' | '-joined."),
+    fingerprint: z
+        .string()
+        .regex(/^[0-9a-z]{1,16}$/)
+        .describe("Deterministic dedupe/group key over kind, class, normalized message, top frame."),
+    path: pathSchema,
 })
     .strict();
 const cliCommandPropertiesSchema = z
@@ -184,8 +212,8 @@ export const EVENT_CATALOG = {
         properties: webVitalPropertiesSchema,
     },
     "client.error.observed": {
-        sources: ["dashboard", "www", "cli", "other"],
-        actors: ["analytics_id", "anonymous_id", "anonymous_machine"],
+        sources: ["dashboard", "www"],
+        actors: ["analytics_id", "anonymous_id"],
         properties: clientErrorPropertiesSchema,
     },
     "cli.command.completed": {

package/dist/contracts/execution.d.ts

@@ -30,10 +30,36 @@ export declare const runtimeKindSchema: z.ZodEnum<{
     static: "static";
 }>;
 export type RuntimeKind = z.infer<typeof runtimeKindSchema>;
+/**
+ * How a live runtime delivers realtime invalidations.
+ *
+ * One vocabulary end to end: the finalize payload, the client config a serving
+ * runtime hands the browser, and every API response all name the transport
+ * with these three values. `central` is the hosted relay, `cast` is the
+ * collaboration service, and `local` is a dev machine serving its own socket —
+ * a distinction a customer can act on, unlike the component names the transports
+ * used to be called after.
+ */
+export declare const RUNTIME_REALTIME_MODES: readonly ["central", "cast", "local"];
+export declare const runtimeRealtimeModeSchema: z.ZodEnum<{
+    local: "local";
+    cast: "cast";
+    central: "central";
+}>;
+export type RuntimeRealtimeMode = z.infer<typeof runtimeRealtimeModeSchema>;
 export declare const EXECUTION_ENV_MAX_KEYS = 64;
 export declare const EXECUTION_ENV_NAME_MAX_BYTES = 128;
 export declare const EXECUTION_ENV_VALUE_MAX_BYTES: number;
 export declare const EXECUTION_ENV_TOTAL_VALUE_MAX_BYTES: number;
+/**
+ * Server-only variables for whichever runtime this version declares. Publish
+ * syncs the file into the space's variables as secrets; the shared publish
+ * denylist (`.env.*`) keeps the file itself out of every artifact, so the
+ * values reach the runtime through variables and never through content.
+ */
+export declare const SERVER_ENV_FILE = ".env.server";
+/** Lakebed's documented server-only env filename, accepted for capsule portability. */
+export declare const LAKEBED_SERVER_ENV_FILE = ".env.lakebed.server";
 /**
  * Names the platform reserves for itself in the tenant environment. Tenant
  * code cannot set these, so it cannot spoof the values the broker trusts.

package/dist/contracts/execution.js

@@ -25,10 +25,31 @@ import { z } from "zod";
  * name a product.
  */
 export const runtimeKindSchema = z.enum(["static", "zero", "functions"]);
+/**
+ * How a live runtime delivers realtime invalidations.
+ *
+ * One vocabulary end to end: the finalize payload, the client config a serving
+ * runtime hands the browser, and every API response all name the transport
+ * with these three values. `central` is the hosted relay, `cast` is the
+ * collaboration service, and `local` is a dev machine serving its own socket —
+ * a distinction a customer can act on, unlike the component names the transports
+ * used to be called after.
+ */
+export const RUNTIME_REALTIME_MODES = ["central", "cast", "local"];
+export const runtimeRealtimeModeSchema = z.enum(RUNTIME_REALTIME_MODES);
 export const EXECUTION_ENV_MAX_KEYS = 64;
 export const EXECUTION_ENV_NAME_MAX_BYTES = 128;
 export const EXECUTION_ENV_VALUE_MAX_BYTES = 16 * 1024;
 export const EXECUTION_ENV_TOTAL_VALUE_MAX_BYTES = 64 * 1024;
+/**
+ * Server-only variables for whichever runtime this version declares. Publish
+ * syncs the file into the space's variables as secrets; the shared publish
+ * denylist (`.env.*`) keeps the file itself out of every artifact, so the
+ * values reach the runtime through variables and never through content.
+ */
+export const SERVER_ENV_FILE = ".env.server";
+/** Lakebed's documented server-only env filename, accepted for capsule portability. */
+export const LAKEBED_SERVER_ENV_FILE = ".env.lakebed.server";
 /**
  * Names the platform reserves for itself in the tenant environment. Tenant
  * code cannot set these, so it cannot spoof the values the broker trusts.

package/dist/contracts/feature-lifecycle.d.ts

@@ -247,7 +247,7 @@ declare const featureEntries: readonly [{
     readonly assignmentScopes: readonly ["team", "global"];
     readonly docs: {
         readonly channel: "public";
-        readonly slug: "/docs/domains/proxy-bindings";
+        readonly slug: "/docs/spaces/proxy-routes";
         readonly feedbackUrl: null;
     };
     readonly owner: "team:domains";
@@ -301,9 +301,9 @@ declare const featureEntries: readonly [{
     readonly key: "sites.dedicated_runtime";
     readonly name: "Dedicated runtime sites";
     readonly description: "Allows teams to create dedicated WP.Cloud sites and place team spaces on them.";
-    readonly stage: "internal";
+    readonly stage: "ga";
     readonly surface: true;
-    readonly defaultEnabled: false;
+    readonly defaultEnabled: true;
     readonly runtime: {
         readonly enabledInDevelopment: true;
         readonly enabledForA8c: true;
@@ -311,16 +311,16 @@ declare const featureEntries: readonly [{
     };
     readonly assignmentScopes: readonly ["team", "global"];
     readonly docs: {
-        readonly channel: "handbook";
-        readonly slug: "/features/sites/dedicated-runtime";
+        readonly channel: "public";
+        readonly slug: "/docs/apps";
         readonly feedbackUrl: null;
     };
     readonly owner: "team:runtime";
     readonly requires: readonly [];
     readonly lifecycleAdoptedAt: "2026-07-12";
-    readonly reviewAfter: "2026-08-11";
-    readonly removeAfter: "2026-10-10";
-    readonly gaAt: null;
+    readonly reviewAfter: null;
+    readonly removeAfter: "2026-11-01";
+    readonly gaAt: "2026-08-05";
     readonly allowedActorPolicies: readonly ["request_actor", "resource_team"];
     readonly downRamp: {
         readonly code: "dedicated_runtime_stop";
@@ -397,28 +397,25 @@ declare const featureEntries: readonly [{
     readonly key: "zero";
     readonly name: "Spacefast Zero";
     readonly description: "Enables Spacefast Zero command surfaces and hosted Zero app workflows.";
-    readonly stage: "internal";
+    readonly stage: "ga";
     readonly surface: true;
-    readonly defaultEnabled: false;
+    readonly defaultEnabled: true;
     readonly runtime: {
         readonly enabledForA8c: true;
-        readonly planDefaults: {
-            readonly enterprise: true;
-            readonly internal: true;
-        };
+        readonly planDefaults: {};
     };
     readonly assignmentScopes: readonly ["team", "global"];
     readonly docs: {
-        readonly channel: "handbook";
-        readonly slug: "/features/zero";
+        readonly channel: "public";
+        readonly slug: "/docs/apps/zero";
         readonly feedbackUrl: null;
     };
     readonly owner: "team:zero";
     readonly requires: readonly ["sites.dedicated_runtime"];
     readonly lifecycleAdoptedAt: "2026-07-12";
-    readonly reviewAfter: "2026-08-11";
-    readonly removeAfter: "2026-10-10";
-    readonly gaAt: null;
+    readonly reviewAfter: null;
+    readonly removeAfter: "2026-11-01";
+    readonly gaAt: "2026-08-05";
     readonly allowedActorPolicies: readonly ["resource_team"];
     readonly downRamp: {
         readonly code: "zero_stop";
@@ -429,7 +426,7 @@ declare const featureEntries: readonly [{
     readonly key: "functions";
     readonly name: "Spacefast Functions";
     readonly description: string;
-    readonly stage: "internal";
+    readonly stage: "private_beta";
     readonly surface: true;
     readonly defaultEnabled: false;
     readonly runtime: {
@@ -438,15 +435,15 @@ declare const featureEntries: readonly [{
     };
     readonly assignmentScopes: readonly ["team", "global"];
     readonly docs: {
-        readonly channel: "handbook";
-        readonly slug: "/features/functions";
+        readonly channel: "public";
+        readonly slug: "/docs/apps/functions";
         readonly feedbackUrl: null;
     };
     readonly owner: "team:zero";
     readonly requires: readonly [];
     readonly lifecycleAdoptedAt: "2026-07-27";
-    readonly reviewAfter: "2026-08-26";
-    readonly removeAfter: "2026-10-25";
+    readonly reviewAfter: "2026-09-02";
+    readonly removeAfter: "2026-11-01";
     readonly gaAt: null;
     readonly allowedActorPolicies: readonly ["resource_team"];
     readonly downRamp: {

package/dist/contracts/feature-lifecycle.js

@@ -244,7 +244,7 @@ const featureEntries = Object.freeze([
         assignmentScopes: ["team", "global"],
         docs: {
             channel: "public",
-            slug: "/docs/domains/proxy-bindings",
+            slug: "/docs/spaces/proxy-routes",
             feedbackUrl: null,
         },
         owner: "team:domains",
@@ -301,9 +301,12 @@ const featureEntries = Object.freeze([
         key: "sites.dedicated_runtime",
         name: "Dedicated runtime sites",
         description: "Allows teams to create dedicated WP.Cloud sites and place team spaces on them.",
-        stage: "internal",
+        // Availability and billing are separate decisions: the public surface is
+        // on, while the dedicatedRuntime entitlement still decides which teams may
+        // allocate the isolated infrastructure it exposes.
+        stage: "ga",
         surface: true,
-        defaultEnabled: false,
+        defaultEnabled: true,
         runtime: {
             enabledInDevelopment: true,
             enabledForA8c: true,
@@ -311,16 +314,16 @@ const featureEntries = Object.freeze([
         },
         assignmentScopes: ["team", "global"],
         docs: {
-            channel: "handbook",
-            slug: "/features/sites/dedicated-runtime",
+            channel: "public",
+            slug: "/docs/apps",
             feedbackUrl: null,
         },
         owner: "team:runtime",
         requires: [],
         lifecycleAdoptedAt: "2026-07-12",
-        reviewAfter: "2026-08-11",
-        removeAfter: "2026-10-10",
-        gaAt: null,
+        reviewAfter: null,
+        removeAfter: "2026-11-01",
+        gaAt: "2026-08-05",
         allowedActorPolicies: ["request_actor", "resource_team"],
         downRamp: {
             code: "dedicated_runtime_stop",
@@ -401,30 +404,27 @@ const featureEntries = Object.freeze([
         key: "zero",
         name: "Spacefast Zero",
         description: "Enables Spacefast Zero command surfaces and hosted Zero app workflows.",
-        stage: "internal",
+        // Zero is public. The flag remains only as the canonical operational
+        // down-ramp; dedicatedRuntime is the one customer eligibility decision.
+        stage: "ga",
         surface: true,
-        defaultEnabled: false,
+        defaultEnabled: true,
         runtime: {
             enabledForA8c: true,
-            // Zero capsules can only run on a dedicated site, so the plans that grant
-            // `dedicatedRuntime` ARE the ones allowed to use it. Leaving these false
-            // made the entitlement and the flag two independent switches for one
-            // decision, and a team that paid for dedicated runtime still got
-            // `zero_requires_dedicated_plan` at finalize.
-            planDefaults: { enterprise: true, internal: true },
+            planDefaults: {},
         },
         assignmentScopes: ["team", "global"],
         docs: {
-            channel: "handbook",
-            slug: "/features/zero",
+            channel: "public",
+            slug: "/docs/apps/zero",
             feedbackUrl: null,
         },
         owner: "team:zero",
         requires: ["sites.dedicated_runtime"],
         lifecycleAdoptedAt: "2026-07-12",
-        reviewAfter: "2026-08-11",
-        removeAfter: "2026-10-10",
-        gaAt: null,
+        reviewAfter: null,
+        removeAfter: "2026-11-01",
+        gaAt: "2026-08-05",
         allowedActorPolicies: ["resource_team"],
         downRamp: {
             code: "zero_stop",
@@ -437,7 +437,9 @@ const featureEntries = Object.freeze([
         name: "Spacefast Functions",
         description: "Dispatches a version's dynamic requests to the execution host. Compiling the worker at publish is not gated: " +
             "the CLI always ships the bundle, and this flag decides whether anything runs it.",
-        stage: "internal",
+        // Functions remains a private beta: public docs carry the badge and this
+        // flag still decides who dispatches.
+        stage: "private_beta",
         surface: true,
         defaultEnabled: false,
         runtime: {
@@ -446,8 +448,8 @@ const featureEntries = Object.freeze([
         },
         assignmentScopes: ["team", "global"],
         docs: {
-            channel: "handbook",
-            slug: "/features/functions",
+            channel: "public",
+            slug: "/docs/apps/functions",
             feedbackUrl: null,
         },
         owner: "team:zero",
@@ -457,8 +459,8 @@ const featureEntries = Object.freeze([
         // way it is not for a capsule.
         requires: [],
         lifecycleAdoptedAt: "2026-07-27",
-        reviewAfter: "2026-08-26",
-        removeAfter: "2026-10-25",
+        reviewAfter: "2026-09-02",
+        removeAfter: "2026-11-01",
         gaAt: null,
         allowedActorPolicies: ["resource_team"],
         downRamp: {

package/dist/contracts/features.js

@@ -13,7 +13,7 @@ export const FEATURE_OVERRIDE_STATES = ["enabled", "disabled", "kill_switch"];
 export const featureOverrideStateSchema = z.enum(FEATURE_OVERRIDE_STATES);
 export const planLimitValueSchema = z
     .union([z.number().int().nonnegative(), z.literal("unlimited")])
-    .describe('Plan limit value; "unlimited" when the plan does not bound this axis.');
+    .describe('Plan limit value; "unlimited" when the plan does not limit this axis.');
 // Named plan limit table (internal-docs/platform.md "Plans And Limits",
 // Free/Personal/Work columns verbatim). Keys mirror `PlanPolicyResponse.limits`
 // so plan policy is a projection of this data, never a re-derivation.
@@ -234,7 +234,7 @@ export const PLAN_DEFINITIONS = {
 export const FEATURE_DEFINITIONS = FEATURE_RUNTIME_DEFINITIONS;
 export const featureStateSourceSchema = z
     .enum(["kill_switch", "env", "override", "default"])
-    .describe("Layer that decided the flag: kill_switch (emergency off), env (SPACEFAST_FLAG_* variable), " +
+    .describe("Layer that decides the flag: kill_switch (emergency off), env (SPACEFAST_FLAG_* variable), " +
     "override (feature_overrides row), default (plan/code default).");
 export const FeatureStateSchema = z.object({
     key: featureKeySchema,
@@ -242,10 +242,10 @@ export const FeatureStateSchema = z.object({
     source: featureStateSourceSchema,
 });
 export const FeatureStateResponseSchema = z.object({
-    planCode: planCodeSchema.describe("Plan the flags were evaluated against."),
+    planCode: planCodeSchema.describe("Plan used to evaluate the flags."),
     features: z
         .record(featureKeySchema, FeatureStateSchema)
-        .describe("Evaluated state for every known feature flag."),
+        .describe("Evaluated state of every known feature flag."),
 });
 export function normalizePlanCode(planCode) {
     if (!planCode) {