@crowdedkingdoms/crowdyjs 8.5.0 → 8.6.0

package/MIGRATION.md

@@ -1,3 +1,30 @@
+# CrowdyJS v8.6 Notes
+
+## Added
+
+**`client.compute` — Compute Modules** (server-side Rust/WebAssembly logic on
+the Game API). Additive; no breaking changes.
+
+- Authoring: `upsertModule`, `deployVersion({ appId, moduleName, sourceFiles })`
+  (stringifies the source map and defaults the SDK/ABI pins), `waitForCompile`
+  (polls the newest version until the compile settles), `setModuleEnabled`,
+  `deleteModule`, `upsertTrigger` (tick / event / invoke), `deleteTrigger`,
+  `setPolicy`.
+- Invoke: `invoke({ appId, moduleName, exportName, paramsJson })` — synchronous
+  RPC to a module's client-callable export.
+- Monitoring: `modules`, `module`, `moduleVersions`, `moduleTriggers`,
+  `modulePolicy`, `moduleRuns`, `moduleStats`, `moduleLogs`, `appDiagnostics`.
+- Exports: `ComputeAPI`, `COMPUTE_SDK_VERSION`, `COMPUTE_ABI_VERSION`.
+
+Modules execute **server-only**; the SDK manages, invokes, and observes them.
+Guide: https://docs.crowdedkingdoms.com/game-api/compute-modules
+
+## Server compatibility
+
+Requires a `cks-game-api` build that serves the `compute*` root fields
+(v0.13.13+ dev line). Older servers reject compute operations with a GraphQL
+validation error; every other sub-client is unaffected.
+
 # CrowdyJS v8 — Passwordless & federated sign-in (BREAKING)
 
 **Crowded Kingdoms is passwordless.** Email + password login is removed. Update

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.
+> **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.
 
 ## Standalone builds and schema refresh
 
@@ -95,6 +95,7 @@ If `managementUrl` is omitted, the SDK falls back to `httpUrl` for backwards-com
 | `client.teleport` | Teleport requests. |
 | `client.channels`, `client.teams` | Messaging channels and app-scoped player teams (membership + roles). |
 | `client.gameModel` | Abstract game model: containers, properties, functions (incl. model-driven `notify_*` effects), sessions, and **automations / NPCs** (`upsertAutomation`, `runAutomation`, `automationRuns`, `automationStats`, …). |
+| `client.compute` | **Compute Modules** — server-side Rust/WASM logic: author + deploy source (`upsertModule`, `deployVersion`, `waitForCompile`), triggers + policy, synchronous `invoke`, and monitoring (`moduleRuns`, `moduleStats`, `moduleLogs`, `appDiagnostics`). Modules run server-only; see [Compute Modules docs](https://docs.crowdedkingdoms.com/game-api/compute-modules). |
 | `client.udp` | UDP proxy subscriptions + spatial mutations (`sendActorUpdate`, `sendVoxelUpdate`, `sendAudioPacket`, `sendTextPacket`, `sendClientEvent`). |
 | `client.realtime` | Connection status, manual `connect()` / `disconnect()`, `onStatus()` listener. |
 | `client.world(appId)` | Higher-level helpers for browser games (`actor.join`, `actor.sendState`, `actor.sendText`). |

package/dist/crowdy-client.d.ts

@@ -57,6 +57,7 @@ import { ChannelsAPI } from './domains/channels.js';
 import { TeamsAPI } from './domains/teams.js';
 import { UdpAPI } from './domains/udp.js';
 import { GameModelAPI } from './domains/gameModel.js';
+import { ComputeAPI } from './domains/compute.js';
 export interface CrowdyClientConfig {
     /** game-api HTTP root (e.g. `https://dev-game-api.crowdedkingdoms.com`). */
     httpUrl?: string;
@@ -187,6 +188,8 @@ export declare class CrowdyClient {
     readonly udp: UdpAPI;
     /** Abstract game model: containers, properties, functions, sessions. */
     readonly gameModel: GameModelAPI;
+    /** Compute Modules: server-side Rust/WASM logic (manage, invoke, observe). */
+    readonly compute: ComputeAPI;
     /** Durable avatars + per-app avatar state (owner-aware reads). */
     readonly avatars: AvatarsAPI;
     /** Game-host election + actor liveness heartbeat. */

package/dist/crowdy-client.d.ts.map

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

package/dist/crowdy-client.js

@@ -55,6 +55,7 @@ import { ChannelsAPI } from './domains/channels.js';
 import { TeamsAPI } from './domains/teams.js';
 import { UdpAPI } from './domains/udp.js';
 import { GameModelAPI } from './domains/gameModel.js';
+import { ComputeAPI } from './domains/compute.js';
 export class CrowdyClient {
     constructor(config = {}) {
         this.session = new AuthState(config.tokenStore);
@@ -109,6 +110,7 @@ export class CrowdyClient {
         this.teams = new TeamsAPI(this.graphql);
         this.udp = new UdpAPI(this.graphql, this.realtime, this.metrics);
         this.gameModel = new GameModelAPI(this.graphql);
+        this.compute = new ComputeAPI(this.graphql);
         this.avatars = new AvatarsAPI(this.graphql);
         this.host = new HostAPI(this.graphql);
         this.gameApps = new GameAppsAPI(this.graphql);

package/dist/domains/compute.d.ts

@@ -0,0 +1,175 @@
+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';
+/** 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. */
+export declare const COMPUTE_ABI_VERSION = 0;
+/** Options for {@link ComputeAPI.deployVersion}. */
+export interface DeployVersionOptions {
+    appId: ComputeSetModuleEnabledMutationVariables['appId'];
+    moduleName: string;
+    /**
+     * Relative path -> file contents. Must include `Cargo.toml` and
+     * `src/lib.rs`; only `.rs` files under `src/` plus `Cargo.toml` are
+     * accepted by the server (crate allowlist, size caps, no build-time code).
+     */
+    sourceFiles: Record<string, string>;
+    /** crowdy-compute-sdk version pin. Defaults to {@link COMPUTE_SDK_VERSION}. */
+    sdkVersion?: string;
+    /** Guest ABI version pin. Defaults to {@link COMPUTE_ABI_VERSION}. */
+    abiVersion?: number;
+}
+/** Options for {@link ComputeAPI.waitForCompile}. */
+export interface WaitForCompileOptions {
+    /** Total budget in ms before giving up (default 120_000). */
+    timeoutMs?: number;
+    /** Poll interval in ms (default 2_000). */
+    intervalMs?: number;
+}
+/**
+ * Typed client for **Compute Modules** — server-side Rust/WebAssembly logic
+ * on the Game API (`client.compute`). Studios upload Rust source; the
+ * platform compiles it to WASM and runs it sandboxed on the game servers with
+ * fuel metering, triggers (tick / event / invoke), an app-scoped host data
+ * API, and replication egress. Modules are **server-only**: this client
+ * manages, invokes, and observes them — nothing executes client-side.
+ *
+ * Authoring mutations require the org **`manage_compute`** permission;
+ * monitoring queries require **`view_compute_diagnostics`**. `invoke` is
+ * gated per-export by the invoke trigger's policy.
+ *
+ * Docs: https://docs.crowdedkingdoms.com/game-api/compute-modules
+ */
+export declare class ComputeAPI {
+    private gql;
+    constructor(gql: GraphQLClient);
+    /**
+     * Create or update a module's metadata (upsert key `(appId, name)`). New
+     * modules start disabled; enable after a successful compile. Set
+     * `alwaysOn: true` for world-simulation modules that must run without
+     * connected players (otherwise modules load lazily on realtime presence).
+     *
+     * Requires the org **`manage_compute`** permission.
+     *
+     * @throws {CrowdyGraphQLError} `FORBIDDEN` without the permission.
+     */
+    upsertModule(input: ComputeUpsertModuleMutationVariables['input']): Promise<ComputeUpsertModuleMutation['computeUpsertModule']>;
+    /**
+     * Upload an immutable source version and make it the deployed version. The
+     * source is validated server-side (Cargo.toml + `src/*.rs` only, dependency
+     * allowlist, size caps, no build-time code) and parked as
+     * `compileStatus: "pending"` until a game server compiles it — poll with
+     * {@link moduleVersions} or {@link waitForCompile}.
+     *
+     * Requires the org **`manage_compute`** permission.
+     *
+     * @param opts - App, module, `sourceFiles` map (stringified for you), and
+     *   optional SDK/ABI pins (defaulted to the current platform pins).
+     */
+    deployVersion(opts: DeployVersionOptions): Promise<ComputeDeployVersionMutation['computeDeployVersion']>;
+    /**
+     * Enable or disable a module. Enabling requires a successfully compiled
+     * deployed version and resets the failure circuit; disabling stops all
+     * scheduling. Requires the org **`manage_compute`** permission.
+     */
+    setModuleEnabled(variables: ComputeSetModuleEnabledMutationVariables): Promise<ComputeSetModuleEnabledMutation['computeSetModuleEnabled']>;
+    /**
+     * Delete a module and (via cascade) its versions, triggers, and lease. Run
+     * history is retained for auditing. **Destructive.** Requires the org
+     * **`manage_compute`** permission.
+     *
+     * @returns `true` if a module was deleted.
+     */
+    deleteModule(variables: ComputeDeleteModuleMutationVariables): Promise<ComputeDeleteModuleMutation['computeDeleteModule']>;
+    /**
+     * Bind a trigger to a module: a tick loop (`triggerType: "tick"` +
+     * `tickHz`, clamped by the app policy), an event subscription
+     * (`triggerType: "event"` + `onEvent`: `function_invoked` |
+     * `property_changed` | `container_created` | `compute_event`), or a
+     * client-callable export (`triggerType: "invoke"` + `exportName` +
+     * optional `invokePolicyJson` authority tree; null policy = compute admins
+     * only). Requires the org **`manage_compute`** permission.
+     */
+    upsertTrigger(input: ComputeUpsertTriggerMutationVariables['input']): Promise<ComputeUpsertTriggerMutation['computeUpsertTrigger']>;
+    /**
+     * Delete a trigger by id. Requires the org **`manage_compute`** permission.
+     *
+     * @returns `true` if a trigger was deleted.
+     */
+    deleteTrigger(variables: ComputeDeleteTriggerMutationVariables): Promise<ComputeDeleteTriggerMutation['computeDeleteTrigger']>;
+    /**
+     * Set the app's compute policy (guardrails: kill switch, module count,
+     * tick-rate / fuel / memory / runtime / host-op / egress ceilings, circuit
+     * tuning). Omitted fields keep their current values; values above the
+     * platform ceilings are rejected. Requires the org **`manage_compute`**
+     * permission.
+     */
+    setPolicy(input: ComputeSetPolicyMutationVariables['input']): Promise<ComputeSetPolicyMutation['computeSetPolicy']>;
+    /**
+     * Invoke a module's client-callable export (an `invoke` trigger) as a
+     * **synchronous RPC**: the module runs server-side and its result comes
+     * back directly — unlike the spatial send surface, a failure (policy
+     * denial, fuel exhaustion, trap) is a thrown error, not a silent drop.
+     *
+     * Authorization: the export's invoke policy, or `manage_compute` holders
+     * only when no policy is set.
+     *
+     * @returns The invoke result; `resultJson` is set when the module's bytes
+     *   parse as JSON (`resultBase64` always carries the raw bytes).
+     * @throws {CrowdyGraphQLError} `FORBIDDEN` on policy denial; `BAD_REQUEST`
+     *   when the module is disabled or the call fails inside the sandbox.
+     */
+    invoke(variables: ComputeInvokeMutationVariables): Promise<ComputeInvokeMutation['computeInvoke']>;
+    /** List the app's modules. Requires **`view_compute_diagnostics`**. */
+    modules(variables: ComputeModulesQueryVariables): Promise<ComputeModulesQuery['computeModules']>;
+    /** Read one module by name. Requires **`view_compute_diagnostics`**. */
+    module(variables: ComputeModuleQueryVariables): Promise<ComputeModuleQuery['computeModule']>;
+    /**
+     * List a module's source versions, newest first, including compile
+     * status/log. Requires **`view_compute_diagnostics`**.
+     */
+    moduleVersions(variables: ComputeModuleVersionsQueryVariables): Promise<ComputeModuleVersionsQuery['computeModuleVersions']>;
+    /**
+     * Poll {@link moduleVersions} until the newest version's compile settles
+     * (`succeeded` or `failed`). Resolves with the settled version; **rejects**
+     * on compile failure (message includes the compile log) or timeout.
+     *
+     * Requires **`view_compute_diagnostics`**.
+     */
+    waitForCompile(appId: ComputeModuleVersionsQueryVariables['appId'], moduleName: string, opts?: WaitForCompileOptions): Promise<ComputeModuleVersionsQuery['computeModuleVersions'][number]>;
+    /**
+     * List trigger bindings, optionally filtered to one module. Requires
+     * **`view_compute_diagnostics`**.
+     */
+    moduleTriggers(variables: ComputeModuleTriggersQueryVariables): Promise<ComputeModuleTriggersQuery['computeModuleTriggers']>;
+    /**
+     * Read the app's compute policy (platform defaults when unset). Requires
+     * **`view_compute_diagnostics`**.
+     */
+    modulePolicy(variables: ComputeModulePolicyQueryVariables): Promise<ComputeModulePolicyQuery['computeModulePolicy']>;
+    /**
+     * List runs, newest first (module loads/`init`, every failure, and circuit
+     * probes; healthy high-frequency ticks are aggregated into per-minute
+     * usage instead of one row per tick). Requires
+     * **`view_compute_diagnostics`**.
+     */
+    moduleRuns(variables: ComputeModuleRunsQueryVariables): Promise<ComputeModuleRunsQuery['computeModuleRuns']>;
+    /**
+     * Aggregate activity over a recent window (default 60 minutes): run and
+     * failure counts, fuel, egress, per-module breakdown. Requires
+     * **`view_compute_diagnostics`**.
+     */
+    moduleStats(variables: ComputeModuleStatsQueryVariables): Promise<ComputeModuleStatsQuery['computeModuleStats']>;
+    /**
+     * Diagnostic log lines (guest `log()` output + failure lines), newest
+     * first. Requires **`view_compute_diagnostics`**.
+     */
+    moduleLogs(variables: ComputeModuleLogsQueryVariables): Promise<ComputeModuleLogsQuery['computeModuleLogs']>;
+    /**
+     * Snapshot of the app's compute footprint: module/version/trigger counts,
+     * 24h run activity, most-active modules. Requires
+     * **`view_compute_diagnostics`**.
+     */
+    appDiagnostics(variables: ComputeAppDiagnosticsQueryVariables): Promise<ComputeAppDiagnosticsQuery['computeAppDiagnostics']>;
+}
+//# sourceMappingURL=compute.d.ts.map

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

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

package/dist/domains/compute.js

@@ -0,0 +1,232 @@
+import { ComputeUpsertModuleDocument, ComputeDeployVersionDocument, ComputeSetModuleEnabledDocument, ComputeDeleteModuleDocument, ComputeUpsertTriggerDocument, ComputeDeleteTriggerDocument, ComputeSetPolicyDocument, ComputeInvokeDocument, ComputeModulesDocument, ComputeModuleDocument, ComputeModuleVersionsDocument, ComputeModuleTriggersDocument, ComputeModulePolicyDocument, ComputeModuleRunsDocument, ComputeModuleStatsDocument, ComputeModuleLogsDocument, ComputeAppDiagnosticsDocument, } 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. */
+export const COMPUTE_ABI_VERSION = 0;
+/**
+ * Typed client for **Compute Modules** — server-side Rust/WebAssembly logic
+ * on the Game API (`client.compute`). Studios upload Rust source; the
+ * platform compiles it to WASM and runs it sandboxed on the game servers with
+ * fuel metering, triggers (tick / event / invoke), an app-scoped host data
+ * API, and replication egress. Modules are **server-only**: this client
+ * manages, invokes, and observes them — nothing executes client-side.
+ *
+ * Authoring mutations require the org **`manage_compute`** permission;
+ * monitoring queries require **`view_compute_diagnostics`**. `invoke` is
+ * gated per-export by the invoke trigger's policy.
+ *
+ * Docs: https://docs.crowdedkingdoms.com/game-api/compute-modules
+ */
+export class ComputeAPI {
+    constructor(gql) {
+        this.gql = gql;
+    }
+    // -- Authoring (manage_compute) ---------------------------------------------
+    /**
+     * Create or update a module's metadata (upsert key `(appId, name)`). New
+     * modules start disabled; enable after a successful compile. Set
+     * `alwaysOn: true` for world-simulation modules that must run without
+     * connected players (otherwise modules load lazily on realtime presence).
+     *
+     * Requires the org **`manage_compute`** permission.
+     *
+     * @throws {CrowdyGraphQLError} `FORBIDDEN` without the permission.
+     */
+    async upsertModule(input) {
+        const data = await this.gql.request(ComputeUpsertModuleDocument, { input });
+        return data.computeUpsertModule;
+    }
+    /**
+     * Upload an immutable source version and make it the deployed version. The
+     * source is validated server-side (Cargo.toml + `src/*.rs` only, dependency
+     * allowlist, size caps, no build-time code) and parked as
+     * `compileStatus: "pending"` until a game server compiles it — poll with
+     * {@link moduleVersions} or {@link waitForCompile}.
+     *
+     * Requires the org **`manage_compute`** permission.
+     *
+     * @param opts - App, module, `sourceFiles` map (stringified for you), and
+     *   optional SDK/ABI pins (defaulted to the current platform pins).
+     */
+    async deployVersion(opts) {
+        const data = await this.gql.request(ComputeDeployVersionDocument, {
+            input: {
+                appId: opts.appId,
+                moduleName: opts.moduleName,
+                sourceFilesJson: JSON.stringify(opts.sourceFiles),
+                sdkVersion: opts.sdkVersion ?? COMPUTE_SDK_VERSION,
+                abiVersion: opts.abiVersion ?? COMPUTE_ABI_VERSION,
+            },
+        });
+        return data.computeDeployVersion;
+    }
+    /**
+     * Enable or disable a module. Enabling requires a successfully compiled
+     * deployed version and resets the failure circuit; disabling stops all
+     * scheduling. Requires the org **`manage_compute`** permission.
+     */
+    async setModuleEnabled(variables) {
+        const data = await this.gql.request(ComputeSetModuleEnabledDocument, variables);
+        return data.computeSetModuleEnabled;
+    }
+    /**
+     * Delete a module and (via cascade) its versions, triggers, and lease. Run
+     * history is retained for auditing. **Destructive.** Requires the org
+     * **`manage_compute`** permission.
+     *
+     * @returns `true` if a module was deleted.
+     */
+    async deleteModule(variables) {
+        const data = await this.gql.request(ComputeDeleteModuleDocument, variables);
+        return data.computeDeleteModule;
+    }
+    /**
+     * Bind a trigger to a module: a tick loop (`triggerType: "tick"` +
+     * `tickHz`, clamped by the app policy), an event subscription
+     * (`triggerType: "event"` + `onEvent`: `function_invoked` |
+     * `property_changed` | `container_created` | `compute_event`), or a
+     * client-callable export (`triggerType: "invoke"` + `exportName` +
+     * optional `invokePolicyJson` authority tree; null policy = compute admins
+     * only). Requires the org **`manage_compute`** permission.
+     */
+    async upsertTrigger(input) {
+        const data = await this.gql.request(ComputeUpsertTriggerDocument, { input });
+        return data.computeUpsertTrigger;
+    }
+    /**
+     * Delete a trigger by id. Requires the org **`manage_compute`** permission.
+     *
+     * @returns `true` if a trigger was deleted.
+     */
+    async deleteTrigger(variables) {
+        const data = await this.gql.request(ComputeDeleteTriggerDocument, variables);
+        return data.computeDeleteTrigger;
+    }
+    /**
+     * Set the app's compute policy (guardrails: kill switch, module count,
+     * tick-rate / fuel / memory / runtime / host-op / egress ceilings, circuit
+     * tuning). Omitted fields keep their current values; values above the
+     * platform ceilings are rejected. Requires the org **`manage_compute`**
+     * permission.
+     */
+    async setPolicy(input) {
+        const data = await this.gql.request(ComputeSetPolicyDocument, { input });
+        return data.computeSetPolicy;
+    }
+    // -- Invoke ------------------------------------------------------------------
+    /**
+     * Invoke a module's client-callable export (an `invoke` trigger) as a
+     * **synchronous RPC**: the module runs server-side and its result comes
+     * back directly — unlike the spatial send surface, a failure (policy
+     * denial, fuel exhaustion, trap) is a thrown error, not a silent drop.
+     *
+     * Authorization: the export's invoke policy, or `manage_compute` holders
+     * only when no policy is set.
+     *
+     * @returns The invoke result; `resultJson` is set when the module's bytes
+     *   parse as JSON (`resultBase64` always carries the raw bytes).
+     * @throws {CrowdyGraphQLError} `FORBIDDEN` on policy denial; `BAD_REQUEST`
+     *   when the module is disabled or the call fails inside the sandbox.
+     */
+    async invoke(variables) {
+        const data = await this.gql.request(ComputeInvokeDocument, variables);
+        return data.computeInvoke;
+    }
+    // -- Monitoring (view_compute_diagnostics) ------------------------------------
+    /** List the app's modules. Requires **`view_compute_diagnostics`**. */
+    async modules(variables) {
+        const data = await this.gql.request(ComputeModulesDocument, variables);
+        return data.computeModules;
+    }
+    /** Read one module by name. Requires **`view_compute_diagnostics`**. */
+    async module(variables) {
+        const data = await this.gql.request(ComputeModuleDocument, variables);
+        return data.computeModule;
+    }
+    /**
+     * List a module's source versions, newest first, including compile
+     * status/log. Requires **`view_compute_diagnostics`**.
+     */
+    async moduleVersions(variables) {
+        const data = await this.gql.request(ComputeModuleVersionsDocument, variables);
+        return data.computeModuleVersions;
+    }
+    /**
+     * Poll {@link moduleVersions} until the newest version's compile settles
+     * (`succeeded` or `failed`). Resolves with the settled version; **rejects**
+     * on compile failure (message includes the compile log) or timeout.
+     *
+     * Requires **`view_compute_diagnostics`**.
+     */
+    async waitForCompile(appId, moduleName, opts = {}) {
+        const timeoutMs = opts.timeoutMs ?? 120000;
+        const intervalMs = opts.intervalMs ?? 2000;
+        const deadline = Date.now() + timeoutMs;
+        for (;;) {
+            const versions = await this.moduleVersions({ appId, moduleName, limit: 1 });
+            const latest = versions[0];
+            if (latest?.compileStatus === 'succeeded')
+                return latest;
+            if (latest?.compileStatus === 'failed') {
+                throw new Error(`compute module '${moduleName}' compile failed:\n${latest.compileLog ?? '(no log)'}`);
+            }
+            if (Date.now() + intervalMs > deadline) {
+                throw new Error(`compute module '${moduleName}' compile did not settle within ${timeoutMs}ms` +
+                    ` (status: ${latest?.compileStatus ?? 'no version found'})`);
+            }
+            await new Promise((r) => setTimeout(r, intervalMs));
+        }
+    }
+    /**
+     * List trigger bindings, optionally filtered to one module. Requires
+     * **`view_compute_diagnostics`**.
+     */
+    async moduleTriggers(variables) {
+        const data = await this.gql.request(ComputeModuleTriggersDocument, variables);
+        return data.computeModuleTriggers;
+    }
+    /**
+     * Read the app's compute policy (platform defaults when unset). Requires
+     * **`view_compute_diagnostics`**.
+     */
+    async modulePolicy(variables) {
+        const data = await this.gql.request(ComputeModulePolicyDocument, variables);
+        return data.computeModulePolicy;
+    }
+    /**
+     * List runs, newest first (module loads/`init`, every failure, and circuit
+     * probes; healthy high-frequency ticks are aggregated into per-minute
+     * usage instead of one row per tick). Requires
+     * **`view_compute_diagnostics`**.
+     */
+    async moduleRuns(variables) {
+        const data = await this.gql.request(ComputeModuleRunsDocument, variables);
+        return data.computeModuleRuns;
+    }
+    /**
+     * Aggregate activity over a recent window (default 60 minutes): run and
+     * failure counts, fuel, egress, per-module breakdown. Requires
+     * **`view_compute_diagnostics`**.
+     */
+    async moduleStats(variables) {
+        const data = await this.gql.request(ComputeModuleStatsDocument, variables);
+        return data.computeModuleStats;
+    }
+    /**
+     * Diagnostic log lines (guest `log()` output + failure lines), newest
+     * first. Requires **`view_compute_diagnostics`**.
+     */
+    async moduleLogs(variables) {
+        const data = await this.gql.request(ComputeModuleLogsDocument, variables);
+        return data.computeModuleLogs;
+    }
+    /**
+     * Snapshot of the app's compute footprint: module/version/trigger counts,
+     * 24h run activity, most-active modules. Requires
+     * **`view_compute_diagnostics`**.
+     */
+    async appDiagnostics(variables) {
+        const data = await this.gql.request(ComputeAppDiagnosticsDocument, variables);
+        return data.computeAppDiagnostics;
+    }
+}