@crowdedkingdoms/crowdyjs 18.0.4-dev.1 → 18.2.0-dev.1

package/dist/domains/gameApps.d.ts

@@ -1,5 +1,5 @@
 import type { GraphQLClient } from '../client.js';
-import { type GridOwnershipQuery, type AssignGridOwnershipMutation, type TransferGridOwnershipMutation, type GridUserPermissionsQuery, type NearbyGridPermissionsQuery, type NearbyGridsQuery, type GridPermissionLimitsQuery, type GridGroupGrantsQuery, type CreateGridMutation, type DeleteGridMutation, type GrantGridPermissionsMutation, type RevokeGridPermissionsMutation, type SetGridPermissionLimitsMutation, type AssignGroupToGridMutation, type RevokeGroupFromGridMutation, type AssignGridOwnershipInput, type TransferGridOwnershipInput, type NearbyGridPermissionsInput, type NearbyGridsInput, type CreateGridInput, type DeleteGridInput, type GrantGridPermissionsInput, type RevokeGridPermissionsInput, type SetGridPermissionLimitsInput, type AssignGroupToGridInput, type RevokeGroupFromGridInput } from '../generated/graphql.js';
+import { type GridOwnershipQuery, type AssignGridOwnershipMutation, type TransferGridOwnershipMutation, type GridUserPermissionsQuery, type NearbyGridPermissionsQuery, type NearbyGridsQuery, type GridPermissionLimitsQuery, type GridOpenPermissionsQuery, type GridGroupGrantsQuery, type CreateGridMutation, type DeleteGridMutation, type GrantGridPermissionsMutation, type RevokeGridPermissionsMutation, type SetGridPermissionLimitsMutation, type SetGridOpenPermissionsMutation, type AssignGroupToGridMutation, type RevokeGroupFromGridMutation, type AssignGridOwnershipInput, type TransferGridOwnershipInput, type NearbyGridPermissionsInput, type NearbyGridsInput, type CreateGridInput, type DeleteGridInput, type GrantGridPermissionsInput, type RevokeGridPermissionsInput, type SetGridPermissionLimitsInput, type SetGridOpenPermissionsInput, type AssignGroupToGridInput, type RevokeGroupFromGridInput } from '../generated/graphql.js';
 /**
  * App grids + grid runtime-permission administration — exposed as
  * `client.gameApps` (and grouped under `client.admin`).
@@ -65,6 +65,15 @@ export declare class GameAppsAPI {
      * @returns The grid's permission limits.
      */
     permissionLimits(appId: string, gridId: string): Promise<GridPermissionLimitsQuery['gridPermissionLimits']>;
+    /**
+     * Read the keys a grid grants every player with active access to the app
+     * (an open build area, a public arena). Empty means the grid is not open.
+     *
+     * @param appId - App that owns the grid.
+     * @param gridId - Grid whose open keys to read.
+     * @returns The grid's open keys.
+     */
+    openPermissions(appId: string, gridId: string): Promise<GridOpenPermissionsQuery['gridOpenPermissions']>;
     /**
      * List a group's grants on a grid (rows of the group-grants input table).
      *
@@ -119,6 +128,22 @@ export declare class GameAppsAPI {
      * @returns The grid's updated permission limits.
      */
     setPermissionLimits(input: SetGridPermissionLimitsInput): Promise<SetGridPermissionLimitsMutation['setGridPermissionLimits']>;
+    /**
+     * Open a grid to every player: replace the keys it grants each player with
+     * active access to the app, within its limits, then recompute the effective
+     * ACL for all of them. Players who gain access later get them too. The most
+     * specific grid covering a chunk decides a voxel write there, so a zone
+     * nested in the world grid that everyone may build in must grant
+     * `update_voxel_data` itself. An empty `permissionKeys` closes the grid.
+     *
+     * Refused with `BAD_REQUEST` for the app's world grid (open already), any of
+     * the four player-code keys, a key that is not an active grid key, and a
+     * 33rd open grid in one app.
+     *
+     * @param input - {@link SetGridOpenPermissionsInput}.
+     * @returns The grid's open keys after the change.
+     */
+    setOpenPermissions(input: SetGridOpenPermissionsInput): Promise<SetGridOpenPermissionsMutation['setGridOpenPermissions']>;
     /**
      * Grant permission keys to a group (optionally a single role) on a grid;
      * recomputes the effective ACL.

package/dist/domains/gameApps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gameApps.d.ts","sourceRoot":"","sources":["../../src/domains/gameApps.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gameApps.d.ts","sourceRoot":"","sources":["../../src/domains/gameApps.ts"],"names":[],"mappings":"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"}

package/dist/domains/gameApps.js

@@ -1,4 +1,4 @@
-import { GridOwnershipDocument, AssignGridOwnershipDocument, TransferGridOwnershipDocument, GridUserPermissionsDocument, NearbyGridPermissionsDocument, NearbyGridsDocument, GridPermissionLimitsDocument, GridGroupGrantsDocument, CreateGridDocument, DeleteGridDocument, GrantGridPermissionsDocument, RevokeGridPermissionsDocument, SetGridPermissionLimitsDocument, AssignGroupToGridDocument, RevokeGroupFromGridDocument, } from '../generated/graphql.js';
+import { GridOwnershipDocument, AssignGridOwnershipDocument, TransferGridOwnershipDocument, GridUserPermissionsDocument, NearbyGridPermissionsDocument, NearbyGridsDocument, GridPermissionLimitsDocument, GridOpenPermissionsDocument, GridGroupGrantsDocument, CreateGridDocument, DeleteGridDocument, GrantGridPermissionsDocument, RevokeGridPermissionsDocument, SetGridPermissionLimitsDocument, SetGridOpenPermissionsDocument, AssignGroupToGridDocument, RevokeGroupFromGridDocument, } from '../generated/graphql.js';
 /**
  * App grids + grid runtime-permission administration — exposed as
  * `client.gameApps` (and grouped under `client.admin`).
@@ -98,6 +98,21 @@ export class GameAppsAPI {
         });
         return data.gridPermissionLimits;
     }
+    /**
+     * Read the keys a grid grants every player with active access to the app
+     * (an open build area, a public arena). Empty means the grid is not open.
+     *
+     * @param appId - App that owns the grid.
+     * @param gridId - Grid whose open keys to read.
+     * @returns The grid's open keys.
+     */
+    async openPermissions(appId, gridId) {
+        const data = await this.graphql.request(GridOpenPermissionsDocument, {
+            appId,
+            gridId,
+        });
+        return data.gridOpenPermissions;
+    }
     /**
      * List a group's grants on a grid (rows of the group-grants input table).
      *
@@ -180,6 +195,27 @@ export class GameAppsAPI {
         });
         return data.setGridPermissionLimits;
     }
+    /**
+     * Open a grid to every player: replace the keys it grants each player with
+     * active access to the app, within its limits, then recompute the effective
+     * ACL for all of them. Players who gain access later get them too. The most
+     * specific grid covering a chunk decides a voxel write there, so a zone
+     * nested in the world grid that everyone may build in must grant
+     * `update_voxel_data` itself. An empty `permissionKeys` closes the grid.
+     *
+     * Refused with `BAD_REQUEST` for the app's world grid (open already), any of
+     * the four player-code keys, a key that is not an active grid key, and a
+     * 33rd open grid in one app.
+     *
+     * @param input - {@link SetGridOpenPermissionsInput}.
+     * @returns The grid's open keys after the change.
+     */
+    async setOpenPermissions(input) {
+        const data = await this.graphql.request(SetGridOpenPermissionsDocument, {
+            input,
+        });
+        return data.setGridOpenPermissions;
+    }
     /**
      * Grant permission keys to a group (optionally a single role) on a grid;
      * recomputes the effective ACL.

package/dist/generated/graphql.d.ts

@@ -916,7 +916,7 @@ export type App = {
     updatedAt: Scalars['DateTime']['output'];
     /** Marketplace discoverability (PUBLIC/UNLISTED/PRIVATE). See AppVisibility. */
     visibility: AppVisibility;
-    /** Whether players may write the app's wilderness: chunks that no grid but the app's world grid covers. True (the default) leaves those writes to the ordinary voxel permission; false refuses every voxel and chunk write there (updateVoxel, sendVoxelUpdate, updateChunk, ck-exec's world.set_voxels), whoever makes it. Set with updateApp (manage_apps). */
+    /** Whether players may write the app's wilderness: chunks that no grid but the app's world grid covers. True (the default) leaves those writes to the ordinary voxel permission; false refuses every voxel and chunk write there (updateVoxel, sendVoxelUpdate, updateChunk, ck-exec's world.set_voxels, and a client's voxel updates sent straight to the realtime servers), whoever makes it. Set with updateApp (manage_apps). */
     wildernessWritesOpen: Scalars['Boolean']['output'];
 };
 /** A free or purchasable access tier for an app, bundling a price and the set of runtime permission keys that granted users receive. */
@@ -1096,7 +1096,7 @@ export type AppMarketplaceFilterInput = {
 /** Per-player usage row for studio diagnostics (top spenders / quota utilization): one (player, app) aggregate over a window. */
 export type AppPlayerUsageRow = {
     __typename?: 'AppPlayerUsageRow';
-    /** Player automation units used. */
+    /** Legacy: the removed engines' player automation units. Always 0 for usage since the legacy engines were removed; kept for the API shape until the migration. */
     automationUnits: Scalars['BigInt']['output'];
     /**
      * DEPRECATED. chargedMicrousd / 10,000 truncated toward zero.
@@ -1105,7 +1105,7 @@ export type AppPlayerUsageRow = {
     chargedCents: Scalars['BigInt']['output'];
     /** Micro-USD charged to the player for this app in the window (exact). */
     chargedMicrousd: Scalars['BigInt']['output'];
-    /** Compile submissions. */
+    /** Legacy: compile submissions of the removed player-compute engine (mod builds are not counted). Always 0 for usage since the legacy engines were removed; kept for the API shape until the migration. */
     compileCount: Scalars['Int']['output'];
     /** Player compute units used. */
     computeUnits: Scalars['BigInt']['output'];
@@ -1219,11 +1219,11 @@ export type AppUsageSummary = {
     __typename?: 'AppUsageSummary';
     /** App id (as a string). */
     appId: Scalars['String']['output'];
-    /** Billed autonomous-process compute units over the window (string counter). */
+    /** Legacy: billed compute units of the removed automation engine over the window (string counter). Always 0 for usage since the legacy engines were removed; kept for the API shape until the migration. */
     automationComputeUnits: Scalars['String']['output'];
-    /** Autonomous-process function invocations over the window (string counter). */
+    /** Legacy: function invocations of the removed automation engine over the window (string counter). Always 0 for usage since the legacy engines were removed; kept for the API shape until the migration. */
     automationInvocations: Scalars['String']['output'];
-    /** Autonomous-process (NPC) runs over the window (string counter). */
+    /** Legacy: runs of the removed automation engine over the window (string counter). Always 0 for usage since the legacy engines were removed; kept for the API shape until the migration. */
     automationRuns: Scalars['String']['output'];
     /** Total GraphQL bytes received (string counter). */
     graphqlRecvBytes: Scalars['String']['output'];
@@ -1611,7 +1611,7 @@ export declare enum CheckoutPurpose {
     Donation = "DONATION",
     /** Add funds to an organization wallet. Requires orgId and amountCents, and the caller must hold the org "manage_billing" permission. Credits the org wallet on completion. */
     OrgWalletTopup = "ORG_WALLET_TOPUP",
-    /** Add funds to the caller's own player wallet (player compute P2). Requires amountCents only — any authenticated user may fund their own wallet; no org permission is involved. Credits the player wallet idempotently on completion. */
+    /** Add funds to the caller's own player wallet, which pays for their mods past the monthly trial (see PlayerWallet). Requires amountCents only — any authenticated user may fund their own wallet; no org permission is involved. Credits the player wallet idempotently on completion. */
     PlayerWalletTopup = "PLAYER_WALLET_TOPUP",
     /**
      * Deprecated. Historically a purchase of in-world property tokens. No longer purchasable and rejected at runtime by createCheckout.
@@ -3241,7 +3241,7 @@ export type DefineAppFeatureInput = {
     appId: Scalars['BigInt']['input'];
     /** Optional description of the feature. */
     description?: InputMaybe<Scalars['String']['input']>;
-    /** The feature key (referenced by tier_feature authority rules). */
+    /** The feature key, as ck-exec code reads it among a player's features. */
     featureKey: Scalars['String']['input'];
 };
 /** Identifies a studio-created grid to delete. The default open-by-default world grid and grids that still contain nested child grids cannot be removed. */
@@ -3833,14 +3833,14 @@ export type GetVoxelListInput = {
     /** Address of the chunk whose voxel edits to list. */
     coordinates: ChunkCoordinatesInput;
 };
-/** An app feature key that functions can gate on and tiers can grant. */
+/** An app feature key that access tiers can grant. ck-exec code reads the keys a player's tier grants with `ctx.players().features(player)`. */
 export type GmAppFeature = {
     __typename?: 'GmAppFeature';
     /** The app (tenant) that defines the feature. */
     appId: Scalars['BigInt']['output'];
     /** Optional description of the feature. */
     description: Maybe<Scalars['String']['output']>;
-    /** The feature key (referenced by tier_feature authority rules). */
+    /** The feature key, as ck-exec code reads it among a player's features. */
     featureKey: Scalars['String']['output'];
 };
 /** A grant of a feature key to an access tier. */
@@ -3999,6 +3999,16 @@ export type GridGroupGrant = {
     /** The runtime permission key string granted to the group/role. */
     permissionKey: Scalars['String']['output'];
 };
+/** The permission keys a grid grants every player with active access to the app (the grid_open_permissions input table). */
+export type GridOpenPermissions = {
+    __typename?: 'GridOpenPermissions';
+    /** The app (tenant) that owns the grid. */
+    appId: Scalars['BigInt']['output'];
+    /** The grid. */
+    gridId: Scalars['BigInt']['output'];
+    /** The keys every player with active access holds on this grid (its limits still cap them). Empty means the grid is not open. */
+    permissionKeys: Array<Scalars['String']['output']>;
+};
 /** Kind of principal holding grid title. P1 can assign USER owners; GROUP and ORG are schema-reserved for future shared ownership. */
 export declare enum GridOwnerKind {
     Group = "GROUP",
@@ -4345,7 +4355,7 @@ export type Mutation = {
     claimFreeAppAccess: AppUserAccess;
     /** Claim the hosting slug for an app (idempotent; the same app re-claiming its slug is a no-op, a different slug MOVES the game). Registers https://<games host>/<slug>/ and https://<slug>.<content host> as the app's redirect URIs and sets launch_url to the former. Requires manage_apps on the app and a SESSION token. Refuses a slug that is not a DNS label, is reserved, or belongs to another app (HOSTED_SLUG_UNAVAILABLE), and answers CONTENT_HOSTING_DISABLED on a tier without a content CDN. */
     claimGameHosting: HostedGame;
-    /** Claim one currently unclaimed chunk as a new player-owned grid. Requires an ordinary app-scoped player token and active app access, but never manage_apps. The app's policy must be SELF_CLAIM. The server validates the app's grid assignment and peer-overlap rules, then atomically creates a one-chunk grid, assigns current-user ownership, grants access/update_voxel_data/use_voice_chat/teleport plus the player-code keys and use_video_chat where the caller's tier already carries them, and materializes the effective ACL. Conflicts and policy denials throw GraphQL errors; no partial grid, ownership, or grant rows remain. */
+    /** Claim one wilderness chunk (a chunk no grid but the app's world grid covers) as a new player-owned grid. Requires an ordinary app-scoped player token and active app access, but never manage_apps. The app's policy must be SELF_CLAIM. A chunk inside another grid (a plot, a zone or another claim) is refused FORBIDDEN (GRID_NOT_CLAIMABLE): the claim would be the most specific grid there and take the chunk from whoever that grid grants. The server validates the app's grid assignment and peer-overlap rules, then atomically creates a one-chunk grid, assigns current-user ownership, grants access/update_voxel_data/use_voice_chat/teleport plus the player-code keys and use_video_chat where the caller's tier already carries them, and materializes the effective ACL. Conflicts and policy denials throw GraphQL errors; no partial grid, ownership, or grant rows remain. */
     claimGridChunk: ChunkClaimResult;
     /** Claim grid ownership under the app's claim policy (D4, server-authorized — no client manage_apps involved). SELF_CLAIM assigns ownership immediately; APPROVAL creates a pending request for designated approvers; INVITE requires a standing invite (consumed on use); MARKETPLACE_ONLY refuses. The grid must exist and have no current owner; game rules gate who may attempt a claim. */
     claimGridOwnership: GridClaimResult;
@@ -4503,9 +4513,9 @@ export type Mutation = {
     forceLogoutUser: Scalars['Boolean']['output'];
     /** Operator only (is_operator). Deletes the stored deliverability rows for one address (email_status and email_events) and returns how many rows went. Exists so a verification run is not reading the previous run's events, and so an address suppressed by a bounce that has since been fixed can be given another chance. Returns 0 when there was nothing stored. */
     forgetEmailDeliverability: Scalars['Int']['output'];
-    /** Define an app feature key that functions can gate on (via a tier_feature authority rule) and that access tiers can be granted. Idempotent on (app, featureKey). Requires app-admin ('manage_apps'). */
+    /** Define an app feature key that access tiers can be granted. ck-exec code reads the keys a player's tier grants with `ctx.players().features(player)` (scope `players.read`) and gates on them itself. The `gameModel` prefix is a legacy name. Idempotent on (app, featureKey). Requires app-admin ('manage_apps'). */
     gameModelDefineFeature: GmAppFeature;
-    /** Grant a feature key to an access tier, so users on that tier satisfy tier_feature authority checks for it. Requires app-admin ('manage_apps'). */
+    /** Grant a feature key to an access tier, so it is among the features ck-exec code reads with `ctx.players().features(player)` for every player with active access on that tier. The `gameModel` prefix is a legacy name. Requires app-admin ('manage_apps'). */
     gameModelGrantTierFeature: GmTierFeature;
     /** Revoke a feature key from an access tier. Requires app-admin ('manage_apps'). Returns true if a grant was removed. */
     gameModelRevokeTierFeature: Scalars['Boolean']['output'];
@@ -4603,7 +4613,7 @@ export type Mutation = {
     sendTextPacket: Scalars['Boolean']['output'];
     /** Send ONE webcam video fragment, fanned out to nearby actors as a ClientVideoNotification (Buddy v0.25.0). Requires a bearer game token and the use_video_chat runtime permission at app AND grid level -- without it the game server responds asynchronously with a GenericErrorResponse (errorCode UNAUTHORIZED). A datagram carries at most ~1117 bytes of videoData, so an encoded frame is split by the SDK into fragments (6-byte header: version, codec, frameId, fragIndex, fragCount; at most 16 per frame) and reassembled by receivers; this is a mutation PER FRAGMENT and sustained video belongs on the binary realtime relay. Every receiver in range pays the egress bytes: keep distance small and frames few. Opens a UDP proxy session automatically if none exists. Returns Boolean! that is true only when the datagram was ACCEPTED FOR SENDING -- NOT that it was delivered; the sender receives no echo, only errors (GenericErrorResponse, correlated by sequenceNumber) on udpNotifications. */
     sendVideoPacket: Scalars['Boolean']['output'];
-    /** Send a single voxel (block) update for spatial replication to nearby chunks. Requires a bearer game token; opens a UDP proxy session automatically if none exists. Returns Boolean! that is true only when the datagram was ACCEPTED FOR SENDING to the game server — NOT confirmation that the world applied the change. There is NO separate per-request success response: the change fans out to nearby clients (the sender included) as a VoxelUpdateNotification carrying the same sequenceNumber (VoxelUpdateResponse is legacy and is never emitted). Failures arrive ASYNCHRONOUSLY as a GenericErrorResponse; both are correlated by the request sequenceNumber (correlation only — not an idempotency key; the server does not dedupe replays). Throws FORBIDDEN synchronously for a chunk only the app's world grid covers while the app's wilderness is closed (App.wildernessWritesOpen false). */
+    /** Send a single voxel (block) update for spatial replication to nearby chunks. Requires a bearer game token; opens a UDP proxy session automatically if none exists. Returns Boolean! that is true only when the datagram was ACCEPTED FOR SENDING to the game server — NOT confirmation that the world applied the change. There is NO separate per-request success response: the change fans out to nearby clients (the sender included) as a VoxelUpdateNotification carrying the same sequenceNumber (VoxelUpdateResponse is legacy and is never emitted). Failures arrive ASYNCHRONOUSLY as a GenericErrorResponse; both are correlated by the request sequenceNumber (correlation only — not an idempotency key; the server does not dedupe replays). Throws FORBIDDEN synchronously, before anything is sent, without the voxel edit permission updateVoxel checks for the chunk (app access, the tier's update_voxel_data, and update_voxel_data on the most specific grid covering the chunk), and for a chunk only the app's world grid covers while the app's wilderness is closed (App.wildernessWritesOpen false). */
     sendVoxelUpdate: Scalars['Boolean']['output'];
     /** Creates or updates an app's monthly spend cap (idempotent upsert keyed by org + app) and returns the resulting budget. This only records the cap used to monitor/limit overspend; it does not move money, charge a card, or alter the wallet balance. Requires the 'manage_billing' app permission. */
     setAppBudget: AppBudget;
@@ -4633,6 +4643,8 @@ export type Mutation = {
     setCrowdyStudioAgentPolicy: CrowdyStudioAgentPolicy;
     /** Sets the per-user early-access override flag, forcing early access on or off regardless of the global free-play window. Requires a super-admin bearer game token (and the management API enabled). */
     setEarlyAccessOverride: User;
+    /** Open a grid to every player: replace the permission keys it grants each player with active access to the app (writes the `grid_open_permissions` input table), then recompute the grid's materialized effective ACL for all of them. The most specific grid covering a chunk decides a voxel write there, so a zone inside the world grid that everyone may build in must grant `update_voxel_data` itself. The grid's limits still cap these keys; players who get access later receive them when they connect. Pass an empty array to close the grid. Refuses the app's world grid (already open), the four player-code keys, and a 33rd open grid in one app. Requires app-admin ('manage_apps'). */
+    setGridOpenPermissions: GridOpenPermissions;
     /** Replace the whitelist of permission keys allowed on a grid (writes the `grid_permission_limits` input table), then recompute the grid's materialized effective ACL so any keys no longer on the whitelist are dropped for all users. Pass an empty array to remove all limits. Requires app-admin ('manage_apps'). DESTRUCTIVE: narrowing the whitelist can strip effective permissions from existing users on the grid. */
     setGridPermissionLimits: GridPermissionLimits;
     /** Developer switch: DISABLED (the shell says "disabled by its developer") or back to LIVE. A TAKEN_DOWN game is refused (HOSTED_GAME_TAKEN_DOWN). Requires manage_apps and a SESSION token. */
@@ -4697,7 +4709,7 @@ export type Mutation = {
     updateChannel: Group;
     /** Update a channel role's name, rank, and/or permission keys (system roles cannot be renamed/re-ranked). When permissions are supplied they REPLACE the role's existing keys. Requires the 'manage_roles' channel permission (app admins bypass). Note: changing send_messages here does not re-push Buddy until affected members' roles are re-applied via setChannelMemberRoles. */
     updateChannelRole: GroupRole;
-    /** Creates or replaces a chunk's dense voxel grid and/or per-voxel states for the given app and coordinates, records each provided voxel state as an individual voxel update, and asynchronously uploads the chunk to the CDN. WRITES world state. Leaves chunkState and LODs untouched. Requires an app token for the app and either the 'manage_apps' permission on the app (resolved via its org; super admins bypass) or the voxel edit permission for this chunk that updateVoxel checks (app access, the tier's update_voxel_data, and update_voxel_data on a grid covering the chunk). Throws FORBIDDEN otherwise, and for a chunk only the app's world grid covers while the app's wilderness is closed (App.wildernessWritesOpen false). */
+    /** Creates or replaces a chunk's dense voxel grid and/or per-voxel states for the given app and coordinates, records each provided voxel state as an individual voxel update, and asynchronously uploads the chunk to the CDN. WRITES world state. Leaves chunkState and LODs untouched. Requires an app token for the app and either the 'manage_apps' permission on the app (resolved via its org; super admins bypass) or the voxel edit permission for this chunk that updateVoxel checks (app access, the tier's update_voxel_data, and update_voxel_data on the most specific grid covering the chunk). Throws FORBIDDEN otherwise, and for a chunk only the app's world grid covers while the app's wilderness is closed (App.wildernessWritesOpen false). */
     updateChunk: Chunk;
     /** Replaces the level-of-detail (LOD) set for a chunk, preserving voxels, per-voxel states, chunk state and owner; returns the updated chunk (or null if it could not be written). WRITES world state. Requires a valid bearer token AND the `manage_apps` permission on the org that owns input.appId (super admins bypass). */
     updateChunkLods: Maybe<Chunk>;
@@ -4721,7 +4733,7 @@ export type Mutation = {
     updateUserState: User;
     /** Sets the target user’s account `user_type` (e.g. "direct", "deleted"). Requires a super-admin bearer game token (and the management API enabled). */
     updateUserType: User;
-    /** Records (upserts) a single voxel edit in the voxel_updates log for one chunk and returns the resulting Voxel. WRITES world state; a background maintenance job later folds these edits into the chunk's packed grid. Requires a valid bearer token AND voxel-edit permission for the target region: the user must have active app access, the `update_voxel_data` tier permission, and (when grids cover the chunk) `update_voxel_data` on a covering grid. A chunk only the app's world grid covers is refused while the app's wilderness is closed (App.wildernessWritesOpen false). */
+    /** Records (upserts) a single voxel edit in the voxel_updates log for one chunk and returns the resulting Voxel. WRITES world state; a background maintenance job later folds these edits into the chunk's packed grid. Requires a valid bearer token AND voxel-edit permission for the target region: the user must have active app access, the `update_voxel_data` tier permission, and `update_voxel_data` on the most specific grid covering the chunk (the smallest by volume; of equal ones the lowest grid id), so a claim, a plot or a safe zone decides its chunks and the app's world grid decides only the wilderness. A chunk no grid covers is refused, and so is a chunk only the app's world grid covers while the app's wilderness is closed (App.wildernessWritesOpen false). */
     updateVoxel: Voxel;
 };
 export type MutationAbandonGamePublishArgs = {
@@ -5287,6 +5299,9 @@ export type MutationSetEarlyAccessOverrideArgs = {
     userId: Scalars['BigInt']['input'];
     value: Scalars['Boolean']['input'];
 };
+export type MutationSetGridOpenPermissionsArgs = {
+    input: SetGridOpenPermissionsInput;
+};
 export type MutationSetGridPermissionLimitsArgs = {
     input: SetGridPermissionLimitsInput;
 };
@@ -6088,7 +6103,7 @@ export type PlayerUsageCharge = {
     /** The owning player user id. */
     userId: Scalars['BigInt']['output'];
 };
-/** The caller's player wallet (player compute P2, DN-5): a platform-scoped balance funding that player's grid compute across every org/app they play in. Out-of-band from org wallets — player usage never touches an org's money. */
+/** The caller's player wallet: one platform-scoped balance, across every org and app they play in, that pays for the player's mods past their monthly trial (250,000 compute units in each app) and for any Agentic Studio model requests charged to them. Out-of-band from org wallets — player usage never touches an org's money. */
 export type PlayerWallet = {
     __typename?: 'PlayerWallet';
     /**
@@ -6285,7 +6300,7 @@ export type Query = {
     appPlayerMarkupAccrued: Scalars['BigInt']['output'];
     /** Total player rate-card markup credited to this app's org wallet (`markup_payout` rows, mirrored as CREDIT events on the ledger), in micro-USD, exact. Cents-era accruals from before the ledger are included. Requires 'view_billing'. */
     appPlayerMarkupAccruedMicrousd: Scalars['BigInt']['output'];
-    /** Per-player usage aggregate for an app over a trailing window (top spenders / quota utilization, 06 §5): compute units, automation units, compiles, and cents charged per player. Requires 'view_compute_diagnostics'. */
+    /** Per-player usage aggregate for an app over a trailing window (top spenders / quota utilization): the compute units each player's mods used, and what the player was charged for this app. automationUnits and compileCount are legacy and always 0 for usage since the legacy engines were removed. Requires 'view_compute_diagnostics'. */
     appPlayerUsage: Array<AppPlayerUsageRow>;
     /** Shared-environment runtime gate decision plus current hour/day billing-window usage for an app. Read this to learn why an app is not running (runtimeDenialReason). Caller must be a member of the app's org. */
     appRuntimeState: AppRuntimeState;
@@ -6445,6 +6460,8 @@ export type Query = {
     gridClaimRequests: Array<GridClaimRequest>;
     /** List the group/role -> permission-key grants configured on a grid for one group (rows of the `grid_group_grants` input table). These are inputs to the effective ACL, not the materialized result — use `gridUserPermissions` for a specific user's effective keys. Requires app-admin ('manage_apps'). */
     gridGroupGrants: Array<GridGroupGrant>;
+    /** Read the permission keys a grid grants every player with active access to the app (an open build area, a public arena). An empty list means the grid is not open. Requires app-admin ('manage_apps'). */
+    gridOpenPermissions: GridOpenPermissions;
     /** Read the current first-class ownership record for a grid. Requires authentication. Returns null when the grid has no current/unexpired owner. Player server code always resolves its execution identity from this record. */
     gridOwnership: Maybe<GridOwnership>;
     /** Read the permission-key whitelist configured for a grid. An empty list means there is no limit (every active runtime permission may be granted on the grid). Requires app-admin ('manage_apps'). */
@@ -6545,7 +6562,7 @@ export type Query = {
     playerSpendCaps: Array<PlayerSpendCap>;
     /** The caller's posted hourly player-usage charges, newest first, optionally filtered by app. Each charge splits platformCents (base rate card) from markupCents (the studio's configured markup) with a per-metric snapshot — players always see what the platform charges and what the studio adds. */
     playerUsageCharges: Array<PlayerUsageCharge>;
-    /** The caller's player wallet, created empty on first access (never null). Platform-scoped: one wallet funds the player's grid compute across every org/app (DN-5); org billing never touches it. Fund it via createCheckout purpose PLAYER_WALLET_TOPUP. */
+    /** The caller's player wallet, created empty on first access (never null). Platform-scoped: one wallet, across every org and app, pays for the player's mods past their monthly trial and any Agentic Studio model requests charged to them; org billing never touches it. Fund it via createCheckout purpose PLAYER_WALLET_TOPUP. */
     playerWalletBalance: PlayerWallet;
     /** The caller's player-wallet ledger, newest first: top-ups, hourly usage debits (per app), auto-recharges, refunds, and adjustments. Usage-debit hours are broken down by playerUsageCharges, whose snapshot splits the platform and studio-markup components. */
     playerWalletTransactions: Array<PlayerWalletTransaction>;
@@ -6956,6 +6973,10 @@ export type QueryGridGroupGrantsArgs = {
     gridId: Scalars['BigInt']['input'];
     groupId: Scalars['BigInt']['input'];
 };
+export type QueryGridOpenPermissionsArgs = {
+    appId: Scalars['BigInt']['input'];
+    gridId: Scalars['BigInt']['input'];
+};
 export type QueryGridOwnershipArgs = {
     appId: Scalars['BigInt']['input'];
     gridId: Scalars['BigInt']['input'];
@@ -7713,6 +7734,15 @@ export type SetCrowdyStudioProviderConsentInput = {
     /** True to accept, false to revoke. */
     consented: Scalars['Boolean']['input'];
 };
+/** Set the permission keys a grid grants every player with active access to the app (writes the grid_open_permissions input table): an open build area, a public arena. */
+export type SetGridOpenPermissionsInput = {
+    /** The app (tenant) that owns the grid. */
+    appId: Scalars['BigInt']['input'];
+    /** The grid to open (or close). Not the app's world grid, which is open by default. */
+    gridId: Scalars['BigInt']['input'];
+    /** The keys every player with active access holds on this grid, capped by its limits. Empty array closes it (players keep only what they are granted directly or through a group). Each must be an active grid permission key, unique, at most 64 chars, and not one of the four player-code keys. */
+    permissionKeys: Array<Scalars['String']['input']>;
+};
 /** Set the per-grid permission-key whitelist (writes the grid_permission_limits input table). */
 export type SetGridPermissionLimitsInput = {
     /** The app (tenant) that owns the grid. */
@@ -8058,7 +8088,7 @@ export type UpdateAppInput = {
     status?: InputMaybe<AppStatus>;
     /** New visibility (PUBLIC/UNLISTED/PRIVATE). Omit to leave unchanged. */
     visibility?: InputMaybe<AppVisibility>;
-    /** Open (true) or close (false) the app's wilderness to voxel and chunk writes: chunks that no grid but the app's world grid covers. Closing refuses every write there, whoever makes it; each game API replica acts on the change within 15 seconds. Omit to leave unchanged. */
+    /** Open (true) or close (false) the app's wilderness to voxel and chunk writes: chunks that no grid but the app's world grid covers. Closing refuses every write there, whoever makes it; each game API replica, and each realtime server for a client's direct voxel updates, acts on the change within about 15 seconds. Omit to leave unchanged. */
     wildernessWritesOpen?: InputMaybe<Scalars['Boolean']['input']>;
 };
 export type UpdateAvatarAppStateInput = {
@@ -8345,13 +8375,13 @@ export type VoxelCoordinates = {
     /** Local voxel Z within the chunk (0-15 for in-bounds voxels). */
     z: Scalars['Int']['output'];
 };
-/** Input form of a voxel position LOCAL to its chunk (see VoxelCoordinates). Signed 16-bit integers; in-bounds positions are 0-15 on each axis for a 16x16x16 chunk. */
+/** Input form of a voxel position LOCAL to its chunk (see VoxelCoordinates). Each coordinate is 0-15 on a 16x16x16 chunk, and the voxel writes (updateVoxel, sendVoxelUpdate, updateChunk's voxelStates) refuse any other value. Teleport's voxelAddress, which is not a write, takes any signed 16-bit value. */
 export type VoxelCoordinatesInput = {
-    /** Local voxel X within the chunk (0-15 for in-bounds voxels). */
+    /** Local voxel X within the chunk, 0-15; voxel writes refuse other values. */
     x: Scalars['Int']['input'];
-    /** Local voxel Y within the chunk (0-15 for in-bounds voxels). */
+    /** Local voxel Y within the chunk, 0-15; voxel writes refuse other values. */
     y: Scalars['Int']['input'];
-    /** Local voxel Z within the chunk (0-15 for in-bounds voxels). */
+    /** Local voxel Z within the chunk, 0-15; voxel writes refuse other values. */
     z: Scalars['Int']['input'];
 };
 /** A single voxel's state override stored on a chunk: its local position, its voxel type, and an opaque base64-encoded state blob. */
@@ -11473,6 +11503,19 @@ export type GridPermissionLimitsQuery = {
         permissionKeys: Array<string>;
     };
 };
+export type GridOpenPermissionsQueryVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+    gridId: Scalars['BigInt']['input'];
+}>;
+export type GridOpenPermissionsQuery = {
+    __typename?: 'Query';
+    gridOpenPermissions: {
+        __typename?: 'GridOpenPermissions';
+        appId: string;
+        gridId: string;
+        permissionKeys: Array<string>;
+    };
+};
 export type GridGroupGrantsQueryVariables = Exact<{
     appId: Scalars['BigInt']['input'];
     gridId: Scalars['BigInt']['input'];
@@ -11566,6 +11609,18 @@ export type SetGridPermissionLimitsMutation = {
         permissionKeys: Array<string>;
     };
 };
+export type SetGridOpenPermissionsMutationVariables = Exact<{
+    input: SetGridOpenPermissionsInput;
+}>;
+export type SetGridOpenPermissionsMutation = {
+    __typename?: 'Mutation';
+    setGridOpenPermissions: {
+        __typename?: 'GridOpenPermissions';
+        appId: string;
+        gridId: string;
+        permissionKeys: Array<string>;
+    };
+};
 export type AssignGroupToGridMutationVariables = Exact<{
     input: AssignGroupToGridInput;
 }>;
@@ -14486,12 +14541,14 @@ export declare const GridUserPermissionsDocument: DocumentNode<GridUserPermissio
 export declare const NearbyGridPermissionsDocument: DocumentNode<NearbyGridPermissionsQuery, NearbyGridPermissionsQueryVariables>;
 export declare const NearbyGridsDocument: DocumentNode<NearbyGridsQuery, NearbyGridsQueryVariables>;
 export declare const GridPermissionLimitsDocument: DocumentNode<GridPermissionLimitsQuery, GridPermissionLimitsQueryVariables>;
+export declare const GridOpenPermissionsDocument: DocumentNode<GridOpenPermissionsQuery, GridOpenPermissionsQueryVariables>;
 export declare const GridGroupGrantsDocument: DocumentNode<GridGroupGrantsQuery, GridGroupGrantsQueryVariables>;
 export declare const CreateGridDocument: DocumentNode<CreateGridMutation, CreateGridMutationVariables>;
 export declare const DeleteGridDocument: DocumentNode<DeleteGridMutation, DeleteGridMutationVariables>;
 export declare const GrantGridPermissionsDocument: DocumentNode<GrantGridPermissionsMutation, GrantGridPermissionsMutationVariables>;
 export declare const RevokeGridPermissionsDocument: DocumentNode<RevokeGridPermissionsMutation, RevokeGridPermissionsMutationVariables>;
 export declare const SetGridPermissionLimitsDocument: DocumentNode<SetGridPermissionLimitsMutation, SetGridPermissionLimitsMutationVariables>;
+export declare const SetGridOpenPermissionsDocument: DocumentNode<SetGridOpenPermissionsMutation, SetGridOpenPermissionsMutationVariables>;
 export declare const AssignGroupToGridDocument: DocumentNode<AssignGroupToGridMutation, AssignGroupToGridMutationVariables>;
 export declare const RevokeGroupFromGridDocument: DocumentNode<RevokeGroupFromGridMutation, RevokeGroupFromGridMutationVariables>;
 export declare const CreateGridChannelDocument: DocumentNode<CreateGridChannelMutation, CreateGridChannelMutationVariables>;