@crowdedkingdoms/crowdyjs 8.8.0 → 8.9.0

package/MIGRATION.md

@@ -1,3 +1,46 @@
+# CrowdyJS v8.9 Notes
+
+## Added
+
+**Realtime + live-ops surfaces** — the Wave 3 close-out of the game-kit
+catalog. Additive; capability-detected; model-only deployments unchanged.
+
+- **`kit.abilities`** (new) — `defineAbility` (admin), `cast(abilityId,
+  targetX, targetZ)` (your position is your live pose — unspoofable),
+  `loadout`, `book` (resource + cooldowns), type-94 cast/impact parsing.
+- **`kit.movement`** (new) — the movement-warden (observe/flag):
+  `violations`, `config`, `defineConfig` (admin), type-95 parsing. The
+  warden never corrects; client prediction stays yours.
+- **`kit.territory`** (new) — `points` (live capture state), `factions`,
+  admin map CRUD (`defineFaction`/`enroll`/`definePoint`), type-96 parsing.
+- **`kit.racing`** (new) — `defineCourse` (admin), `enter`, `raceStatus`,
+  `best`, `ghostPlay` (record replay on the actor lane), type-97 parsing;
+  plus the possession ball: `joinMatch`/`claim`/`pass`/`shoot`/`matchState`.
+- **`kit.liveops`** (new) + `liveopsBlueprint` — event windows (scheduler-
+  aware `activeWindows`), seasons with battle-pass composition
+  (`pass_track` + `pass_features`), type-98 zone-change parsing.
+- **`kit.moderation`** (new) + `moderationBlueprint` — reports, the admin
+  escalation queue, resolve dispositions, personal mutes.
+- **`kit.telemetry`** (new) + `telemetryBlueprint` — `track(name, props)`
+  fire-and-forget over sampled counters.
+- **`kit.loot` engine path** — `engineAvailable`/`enginePull`/`enginePity`/
+  `engineAudit` route big-table pity rolls through a loot module; the
+  blueprint's weighted model rolls stay for small tables.
+- **`client.compute.templates()` / `deployTemplate()`** — the platform's
+  server-side engine-template registry (`computeDeployTemplate`): deploy a
+  canonical engine by name, no client-held Rust.
+- **`kit.deploy({ engines: [...] })`** — blueprints + engine templates in
+  one call (`'template'` or `'template:moduleName'` entries).
+- **`kit/wire`** — reserved event types 94 (ability), 95 (movement
+  violation), 96 (control point), 97 (race timing), 98 (zone change) with
+  parsers.
+
+## Server compatibility
+
+The new surfaces need a `cks-game-api` from the Wave 3 dev line (engine
+event types 94–98, `computeDeployTemplate`). Without the engines deployed,
+`engineAvailable()` is false everywhere and 8.8 behavior is unchanged.
+
 # CrowdyJS v8.8 Notes
 
 ## Added

package/README.md

@@ -12,7 +12,7 @@ npm install @crowdedkingdoms/crowdyjs
 
 CrowdyJS v4 targets browsers by default and uses native `fetch`, `WebSocket`, `crypto`, `btoa`, and `atob`. Node tools can still use the SDK, but must provide browser-compatible globals when opening realtime connections.
 
-> **Server compatibility:** v5.2+ targets environments on release **v0.1.19 or later** (`cks-game-api >= v0.10.3`, `cks-management-api >= v0.1.70`). The destructive mutations send an `idempotencyKey` argument that older servers don't define. v6.1's `client.gameApps.deleteGrid` additionally requires release **v0.1.33+** (`cks-game-api >= v0.12.3`). The game-model **permission effects** fields (`permissionEffects` on `gameModel.upsertFunction`/`seed`, `permissionEffectsAppliedJson` on events) require a `cks-game-api` build with the `2026-07-17-model-permission-effects` migration (v0.13.11+); older servers reject queries/mutations that include them (omit the fields and everything else keeps working). The **permission-read** surface (the `has_grid_permission`/`grid_at`/`has_chunk_permission` expression builtins the kit's `chunkPermission` locks compile to, and selector `*PermissionWhere` predicates) additionally requires `cks-game-api` **v0.13.12+**. Older `cks-game-api` builds report game-model **invoke policy denials** as `FORBIDDEN` GraphQL errors instead of resolving with `success: false`; as of this version the kit's invoke helpers map that error onto the documented `{ success: false, errorMessage }` result, so kit callers behave identically against both server generations. v8.6's **`client.compute`** (Compute Modules — server-side Rust/WASM logic) requires a `cks-game-api` build with the compute surface (the `compute*` root fields, v0.13.13+ dev line); older servers reject these operations with a GraphQL validation error, and everything else keeps working. v8.8's **session-genre engine surfaces** (`kit.instances`/`director`/`matchmaking`/`minigames`, the engine paths on matches/decks/leaderboards, `economy.orderBook`, and the type-91/92/93 event parsers) talk to the Wave 2 engine templates; capability detection keeps model-only deployments on today's behavior. v8.7's **engine kit surfaces** (`kit.mobs`, `kit.pets`, `kit.combat.attackRouted`, `kit.worldsim.forecast`, and the `kit/wire` pose/lane registry) talk to compute-module game engines built on the Wave 0/1 `cks-game-api` dev line (`crowdy-game-kit` crates); capability detection makes them degrade gracefully — model-only deployments keep today's behavior.
+> **Server compatibility:** v5.2+ targets environments on release **v0.1.19 or later** (`cks-game-api >= v0.10.3`, `cks-management-api >= v0.1.70`). The destructive mutations send an `idempotencyKey` argument that older servers don't define. v6.1's `client.gameApps.deleteGrid` additionally requires release **v0.1.33+** (`cks-game-api >= v0.12.3`). The game-model **permission effects** fields (`permissionEffects` on `gameModel.upsertFunction`/`seed`, `permissionEffectsAppliedJson` on events) require a `cks-game-api` build with the `2026-07-17-model-permission-effects` migration (v0.13.11+); older servers reject queries/mutations that include them (omit the fields and everything else keeps working). The **permission-read** surface (the `has_grid_permission`/`grid_at`/`has_chunk_permission` expression builtins the kit's `chunkPermission` locks compile to, and selector `*PermissionWhere` predicates) additionally requires `cks-game-api` **v0.13.12+**. Older `cks-game-api` builds report game-model **invoke policy denials** as `FORBIDDEN` GraphQL errors instead of resolving with `success: false`; as of this version the kit's invoke helpers map that error onto the documented `{ success: false, errorMessage }` result, so kit callers behave identically against both server generations. v8.6's **`client.compute`** (Compute Modules — server-side Rust/WASM logic) requires a `cks-game-api` build with the compute surface (the `compute*` root fields, v0.13.13+ dev line); older servers reject these operations with a GraphQL validation error, and everything else keeps working. v8.9's **realtime + live-ops surfaces** (`kit.abilities`/`movement`/`territory`/`racing`/`liveops`/`moderation`/`telemetry`, the loot engine path, `client.compute.deployTemplate` + `kit.deploy({engines})`, and the type-94..98 event parsers) complete the 30-abstraction catalog; v8.8's **session-genre engine surfaces** (`kit.instances`/`director`/`matchmaking`/`minigames`, the engine paths on matches/decks/leaderboards, `economy.orderBook`, and the type-91/92/93 event parsers) talk to the Wave 2 engine templates; capability detection keeps model-only deployments on today's behavior. v8.7's **engine kit surfaces** (`kit.mobs`, `kit.pets`, `kit.combat.attackRouted`, `kit.worldsim.forecast`, and the `kit/wire` pose/lane registry) talk to compute-module game engines built on the Wave 0/1 `cks-game-api` dev line (`crowdy-game-kit` crates); capability detection makes them degrade gracefully — model-only deployments keep today's behavior.
 
 ## Standalone builds and schema refresh
 

package/dist/domains/compute.d.ts

@@ -1,5 +1,5 @@
 import type { GraphQLClient } from '../client.js';
-import { type ComputeUpsertModuleMutation, type ComputeUpsertModuleMutationVariables, type ComputeDeployVersionMutation, type ComputeSetModuleEnabledMutation, type ComputeSetModuleEnabledMutationVariables, type ComputeDeleteModuleMutation, type ComputeDeleteModuleMutationVariables, type ComputeUpsertTriggerMutation, type ComputeUpsertTriggerMutationVariables, type ComputeDeleteTriggerMutation, type ComputeDeleteTriggerMutationVariables, type ComputeSetPolicyMutation, type ComputeSetPolicyMutationVariables, type ComputeInvokeMutation, type ComputeInvokeMutationVariables, type ComputeModulesQuery, type ComputeModulesQueryVariables, type ComputeModuleQuery, type ComputeModuleQueryVariables, type ComputeModuleVersionsQuery, type ComputeModuleVersionsQueryVariables, type ComputeModuleTriggersQuery, type ComputeModuleTriggersQueryVariables, type ComputeModulePolicyQuery, type ComputeModulePolicyQueryVariables, type ComputeModuleRunsQuery, type ComputeModuleRunsQueryVariables, type ComputeModuleStatsQuery, type ComputeModuleStatsQueryVariables, type ComputeModuleLogsQuery, type ComputeModuleLogsQueryVariables, type ComputeAppDiagnosticsQuery, type ComputeAppDiagnosticsQueryVariables } from '../generated/graphql.js';
+import { type ComputeUpsertModuleMutation, type ComputeUpsertModuleMutationVariables, type ComputeDeployVersionMutation, type ComputeSetModuleEnabledMutation, type ComputeSetModuleEnabledMutationVariables, type ComputeDeleteModuleMutation, type ComputeDeleteModuleMutationVariables, type ComputeUpsertTriggerMutation, type ComputeUpsertTriggerMutationVariables, type ComputeDeleteTriggerMutation, type ComputeDeleteTriggerMutationVariables, type ComputeSetPolicyMutation, type ComputeSetPolicyMutationVariables, type ComputeInvokeMutation, type ComputeInvokeMutationVariables, type ComputeModulesQuery, type ComputeModulesQueryVariables, type ComputeModuleQuery, type ComputeModuleQueryVariables, type ComputeModuleVersionsQuery, type ComputeModuleVersionsQueryVariables, type ComputeModuleTriggersQuery, type ComputeModuleTriggersQueryVariables, type ComputeModulePolicyQuery, type ComputeModulePolicyQueryVariables, type ComputeModuleRunsQuery, type ComputeModuleRunsQueryVariables, type ComputeModuleStatsQuery, type ComputeModuleStatsQueryVariables, type ComputeModuleLogsQuery, type ComputeModuleLogsQueryVariables, type ComputeDeployTemplateMutation, type ComputeDeployTemplateMutationVariables, type ComputeTemplatesQuery, type ComputeTemplatesQueryVariables, type ComputeAppDiagnosticsQuery, type ComputeAppDiagnosticsQueryVariables } from '../generated/graphql.js';
 /** The crowdy-compute-sdk version the platform toolchain currently pins. */
 export declare const COMPUTE_SDK_VERSION = "0.1.0";
 /** The guest ABI version the platform currently supports. */
@@ -129,6 +129,17 @@ export declare class ComputeAPI {
      * status/log. Requires **`view_compute_diagnostics`**.
      */
     moduleVersions(variables: ComputeModuleVersionsQueryVariables): Promise<ComputeModuleVersionsQuery['computeModuleVersions']>;
+    /**
+     * The platform's engine-template registry: ready-made engines deployable
+     * by name with {@link deployTemplate}.
+     */
+    templates(variables: ComputeTemplatesQueryVariables): Promise<ComputeTemplatesQuery['computeTemplates']>;
+    /**
+     * Deploy a named engine template from the platform registry — one call
+     * instead of the upsert/deploy/trigger/enable sequence. Compilation runs
+     * asynchronously; follow with {@link waitForCompile}.
+     */
+    deployTemplate(variables: ComputeDeployTemplateMutationVariables): Promise<ComputeDeployTemplateMutation['computeDeployTemplate']>;
     /**
      * Poll {@link moduleVersions} until the newest version's compile settles
      * (`succeeded` or `failed`). Resolves with the settled version; **rejects**

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

@@ -1 +1 @@
-{"version":3,"file":"compute.d.ts","sourceRoot":"","sources":["../../src/domains/compute.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compute.d.ts","sourceRoot":"","sources":["../../src/domains/compute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,oCAAoC,EAEzC,KAAK,4BAA4B,EAEjC,KAAK,+BAA+B,EACpC,KAAK,wCAAwC,EAE7C,KAAK,2BAA2B,EAChC,KAAK,oCAAoC,EAEzC,KAAK,4BAA4B,EACjC,KAAK,qCAAqC,EAE1C,KAAK,4BAA4B,EACjC,KAAK,qCAAqC,EAE1C,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EAEtC,KAAK,qBAAqB,EAC1B,KAAK,8BAA8B,EAEnC,KAAK,mBAAmB,EACxB,KAAK,4BAA4B,EAEjC,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAEhC,KAAK,0BAA0B,EAC/B,KAAK,mCAAmC,EAExC,KAAK,0BAA0B,EAC/B,KAAK,mCAAmC,EAExC,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EAEtC,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EAEpC,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,EAErC,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EAGpC,KAAK,6BAA6B,EAClC,KAAK,sCAAsC,EAE3C,KAAK,qBAAqB,EAC1B,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,mCAAmC,EACzC,MAAM,yBAAyB,CAAC;AAEjC,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAC3C,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,wCAAwC,CAAC,OAAO,CAAC,CAAC;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAItC;;;;;;;;;OASG;IACG,YAAY,CAChB,KAAK,EAAE,oCAAoC,CAAC,OAAO,CAAC,GACnD,OAAO,CAAC,2BAA2B,CAAC,qBAAqB,CAAC,CAAC;IAK9D;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,4BAA4B,CAAC,sBAAsB,CAAC,CAAC;IAahE;;;;OAIG;IACG,gBAAgB,CACpB,SAAS,EAAE,wCAAwC,GAClD,OAAO,CAAC,+BAA+B,CAAC,yBAAyB,CAAC,CAAC;IAKtE;;;;;;OAMG;IACG,YAAY,CAChB,SAAS,EAAE,oCAAoC,GAC9C,OAAO,CAAC,2BAA2B,CAAC,qBAAqB,CAAC,CAAC;IAK9D;;;;;;;;OAQG;IACG,aAAa,CACjB,KAAK,EAAE,qCAAqC,CAAC,OAAO,CAAC,GACpD,OAAO,CAAC,4BAA4B,CAAC,sBAAsB,CAAC,CAAC;IAKhE;;;;OAIG;IACG,aAAa,CACjB,SAAS,EAAE,qCAAqC,GAC/C,OAAO,CAAC,4BAA4B,CAAC,sBAAsB,CAAC,CAAC;IAKhE;;;;;;OAMG;IACG,SAAS,CACb,KAAK,EAAE,iCAAiC,CAAC,OAAO,CAAC,GAChD,OAAO,CAAC,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;IAOxD;;;;;;;;;;;;;OAaG;IACG,MAAM,CACV,SAAS,EAAE,8BAA8B,GACxC,OAAO,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;IAOlD,uEAAuE;IACjE,OAAO,CACX,SAAS,EAAE,4BAA4B,GACtC,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAKjD,wEAAwE;IAClE,MAAM,CACV,SAAS,EAAE,2BAA2B,GACrC,OAAO,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAK/C;;;OAGG;IACG,cAAc,CAClB,SAAS,EAAE,mCAAmC,GAC7C,OAAO,CAAC,0BAA0B,CAAC,uBAAuB,CAAC,CAAC;IAK/D;;;OAGG;IACG,SAAS,CACb,SAAS,EAAE,8BAA8B,GACxC,OAAO,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;IAKrD;;;;OAIG;IACG,cAAc,CAClB,SAAS,EAAE,sCAAsC,GAChD,OAAO,CAAC,6BAA6B,CAAC,uBAAuB,CAAC,CAAC;IAKlE;;;;;;OAMG;IACG,cAAc,CAClB,KAAK,EAAE,mCAAmC,CAAC,OAAO,CAAC,EACnD,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,0BAA0B,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;IAuBvE;;;OAGG;IACG,cAAc,CAClB,SAAS,EAAE,mCAAmC,GAC7C,OAAO,CAAC,0BAA0B,CAAC,uBAAuB,CAAC,CAAC;IAK/D;;;OAGG;IACG,YAAY,CAChB,SAAS,EAAE,iCAAiC,GAC3C,OAAO,CAAC,wBAAwB,CAAC,qBAAqB,CAAC,CAAC;IAK3D;;;;;OAKG;IACG,UAAU,CACd,SAAS,EAAE,+BAA+B,GACzC,OAAO,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IAKvD;;;;OAIG;IACG,WAAW,CACf,SAAS,EAAE,gCAAgC,GAC1C,OAAO,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,CAAC;IAKzD;;;OAGG;IACG,UAAU,CACd,SAAS,EAAE,+BAA+B,GACzC,OAAO,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IAKvD;;;;OAIG;IACG,cAAc,CAClB,SAAS,EAAE,mCAAmC,GAC7C,OAAO,CAAC,0BAA0B,CAAC,uBAAuB,CAAC,CAAC;CAIhE"}

package/dist/domains/compute.js

@@ -1,4 +1,4 @@
-import { ComputeUpsertModuleDocument, ComputeDeployVersionDocument, ComputeSetModuleEnabledDocument, ComputeDeleteModuleDocument, ComputeUpsertTriggerDocument, ComputeDeleteTriggerDocument, ComputeSetPolicyDocument, ComputeInvokeDocument, ComputeModulesDocument, ComputeModuleDocument, ComputeModuleVersionsDocument, ComputeModuleTriggersDocument, ComputeModulePolicyDocument, ComputeModuleRunsDocument, ComputeModuleStatsDocument, ComputeModuleLogsDocument, ComputeAppDiagnosticsDocument, } from '../generated/graphql.js';
+import { ComputeUpsertModuleDocument, ComputeDeployVersionDocument, ComputeSetModuleEnabledDocument, ComputeDeleteModuleDocument, ComputeUpsertTriggerDocument, ComputeDeleteTriggerDocument, ComputeSetPolicyDocument, ComputeInvokeDocument, ComputeModulesDocument, ComputeModuleDocument, ComputeModuleVersionsDocument, ComputeModuleTriggersDocument, ComputeModulePolicyDocument, ComputeModuleRunsDocument, ComputeModuleStatsDocument, ComputeModuleLogsDocument, ComputeAppDiagnosticsDocument, ComputeDeployTemplateDocument, ComputeTemplatesDocument, } from '../generated/graphql.js';
 /** The crowdy-compute-sdk version the platform toolchain currently pins. */
 export const COMPUTE_SDK_VERSION = '0.1.0';
 /** The guest ABI version the platform currently supports. */
@@ -151,6 +151,23 @@ export class ComputeAPI {
         const data = await this.gql.request(ComputeModuleVersionsDocument, variables);
         return data.computeModuleVersions;
     }
+    /**
+     * The platform's engine-template registry: ready-made engines deployable
+     * by name with {@link deployTemplate}.
+     */
+    async templates(variables) {
+        const data = await this.gql.request(ComputeTemplatesDocument, variables);
+        return data.computeTemplates;
+    }
+    /**
+     * Deploy a named engine template from the platform registry — one call
+     * instead of the upsert/deploy/trigger/enable sequence. Compilation runs
+     * asynchronously; follow with {@link waitForCompile}.
+     */
+    async deployTemplate(variables) {
+        const data = await this.gql.request(ComputeDeployTemplateDocument, variables);
+        return data.computeDeployTemplate;
+    }
     /**
      * Poll {@link moduleVersions} until the newest version's compile settles
      * (`succeeded` or `failed`). Resolves with the settled version; **rejects**

package/dist/generated/graphql.d.ts

@@ -1356,6 +1356,16 @@ export type ComputeInvokeResult = {
     /** The response decoded as JSON text when it parses as JSON; null otherwise. */
     resultJson: Maybe<Scalars['String']['output']>;
 };
+/** One entry in the platform's engine-template registry (deployable by name via computeDeployTemplate). */
+export type ComputeTemplateInfo = {
+    __typename?: 'ComputeTemplateInfo';
+    /** What the template does (from its deploy manifest). */
+    description: Scalars['String']['output'];
+    /** The invoke exports the template binds (its client surface). */
+    exports: Array<Scalars['String']['output']>;
+    /** The template name (e.g. 'mob-engine', 'matchmaking'). */
+    name: Scalars['String']['output'];
+};
 /** Relay-style pagination metadata for a connection. */
 export type ConnectionPageInfo = {
     __typename?: 'ConnectionPageInfo';
@@ -3091,6 +3101,8 @@ export type Mutation = {
     computeDeleteModule: Scalars['Boolean']['output'];
     /** Delete a compute-module trigger by id. Returns true when a trigger was deleted. Requires the org 'manage_compute' permission. */
     computeDeleteTrigger: Scalars['Boolean']['output'];
+    /** Deploy a named engine template from the platform registry: upserts the module, publishes the template source (deduped by hash), binds its triggers, and enables it — one call instead of the upsert/deploy/trigger/enable sequence. Compilation proceeds asynchronously; poll computeModuleVersions for compile status. Templates are data-driven (behavior comes from model containers such as MobDef/EncounterDef/Course), so most games parameterize rather than fork. Requires the org 'manage_compute' permission. */
+    computeDeployTemplate: WasmModule;
     /** Upload a new immutable source version of a compute module and make it the deployed version. The source map is validated (Cargo.toml + src/*.rs only, size caps, platform crate allowlist, no build-time code) and parked as compile_status=pending; a game-api instance compiles it before it can run. Requires the org 'manage_compute' permission. */
     computeDeployVersion: WasmModuleVersion;
     /** Invoke a compute module's client-callable export (a trigger with triggerType=invoke). Synchronous RPC: the module runs and returns its result directly (unlike the spatial send surface's dual-success model). Authorization: the export's invoke policy (authority tree) — or holders of 'manage_compute' only when no policy is set. Requires a valid app token. */
@@ -3467,6 +3479,11 @@ export type MutationComputeDeleteTriggerArgs = {
     appId: Scalars['BigInt']['input'];
     triggerId: Scalars['String']['input'];
 };
+export type MutationComputeDeployTemplateArgs = {
+    appId: Scalars['BigInt']['input'];
+    moduleName?: InputMaybe<Scalars['String']['input']>;
+    templateName: Scalars['String']['input'];
+};
 export type MutationComputeDeployVersionArgs = {
     input: DeployComputeVersionInput;
 };
@@ -4490,6 +4507,8 @@ export type Query = {
     computeModuleVersions: Array<WasmModuleVersion>;
     /** List the compute modules defined for an app. Requires the org 'view_compute_diagnostics' permission. */
     computeModules: Array<WasmModule>;
+    /** The platform's engine-template registry: ready-made compute engines (mob/world/match/deck/instance/director/matchmaking/market/board/minigame/abilities/movement-warden/territory/racing/...) deployable by name with computeDeployTemplate. Requires the org 'manage_compute' permission. */
+    computeTemplates: Array<ComputeTemplateInfo>;
     /** Operator only (is_operator). Most recent operator audit entries, newest first, optionally filtered by environment. */
     cpAudit: Array<CpAuditEntry>;
     /** Operator only (is_operator). One change order with its tasks and steps. Null when the id is not found. */
@@ -4888,6 +4907,9 @@ export type QueryComputeModuleVersionsArgs = {
 export type QueryComputeModulesArgs = {
     appId: Scalars['BigInt']['input'];
 };
+export type QueryComputeTemplatesArgs = {
+    appId: Scalars['BigInt']['input'];
+};
 export type QueryCpAuditArgs = {
     environmentId?: InputMaybe<Scalars['String']['input']>;
     limit?: Scalars['Int']['input'];
@@ -8901,6 +8923,42 @@ export type ComputeAppDiagnosticsQuery = {
         }>;
     };
 };
+export type ComputeTemplatesQueryVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+}>;
+export type ComputeTemplatesQuery = {
+    __typename?: 'Query';
+    computeTemplates: Array<{
+        __typename?: 'ComputeTemplateInfo';
+        name: string;
+        description: string;
+        exports: Array<string>;
+    }>;
+};
+export type ComputeDeployTemplateMutationVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+    templateName: Scalars['String']['input'];
+    moduleName?: InputMaybe<Scalars['String']['input']>;
+}>;
+export type ComputeDeployTemplateMutation = {
+    __typename?: 'Mutation';
+    computeDeployTemplate: {
+        __typename?: 'WasmModule';
+        moduleId: string;
+        appId: string;
+        name: string;
+        description: string | null;
+        enabled: boolean;
+        alwaysOn: boolean;
+        currentVersionId: string | null;
+        circuitState: string;
+        consecutiveFailures: number;
+        cooldownUntil: string | null;
+        lastError: string | null;
+        createdAt: string;
+        updatedAt: string;
+    };
+};
 export type CpEnvironmentsQueryVariables = Exact<{
     page?: InputMaybe<Scalars['Int']['input']>;
     pageSize?: InputMaybe<Scalars['Int']['input']>;
@@ -13347,6 +13405,8 @@ export declare const ComputeModuleRunsDocument: DocumentNode<ComputeModuleRunsQu
 export declare const ComputeModuleStatsDocument: DocumentNode<ComputeModuleStatsQuery, ComputeModuleStatsQueryVariables>;
 export declare const ComputeModuleLogsDocument: DocumentNode<ComputeModuleLogsQuery, ComputeModuleLogsQueryVariables>;
 export declare const ComputeAppDiagnosticsDocument: DocumentNode<ComputeAppDiagnosticsQuery, ComputeAppDiagnosticsQueryVariables>;
+export declare const ComputeTemplatesDocument: DocumentNode<ComputeTemplatesQuery, ComputeTemplatesQueryVariables>;
+export declare const ComputeDeployTemplateDocument: DocumentNode<ComputeDeployTemplateMutation, ComputeDeployTemplateMutationVariables>;
 export declare const CpEnvironmentsDocument: DocumentNode<CpEnvironmentsQuery, CpEnvironmentsQueryVariables>;
 export declare const CpEnvironmentDocument: DocumentNode<CpEnvironmentQuery, CpEnvironmentQueryVariables>;
 export declare const CpChangeOrdersDocument: DocumentNode<CpChangeOrdersQuery, CpChangeOrdersQueryVariables>;