@crowdedkingdoms/crowdyjs 17.10.0-dev.1 → 17.11.0-dev.1

package/dist/domains/exec.d.ts

@@ -1,7 +1,7 @@
 import type { DecoderOptions } from '@msgpack/msgpack';
 import type { GraphQLClient } from '../client.js';
 import { CrowdyError } from '../errors.js';
-import { type ExecAppStatusFieldsFragment, type ExecInstancesQuery, type ExecLogsQuery, type ExecVersionsQuery } from '../generated/graphql.js';
+import { type ExecAppStatusFieldsFragment, type ExecBuildFieldsFragment, type ExecInstancesQuery, type ExecLogsQuery, type ExecVersionsQuery } from '../generated/graphql.js';
 /**
  * ck-exec, the hub-and-spoke execution service (dev-tier preview).
  *
@@ -181,7 +181,9 @@ export declare class ExecConnection {
 export interface ExecNodeTypeInput {
     kind: 'hub' | 'spoke';
     /** The compiled module (`wasm32-unknown-unknown`, built with `ckx-sdk`). */
-    wasm: Uint8Array;
+    wasm?: Uint8Array;
+    /** Instead of `wasm`: a crate of the deploy's `buildId`. */
+    crate?: string;
     /** The type that owns this one; none for the root. */
     parent?: string;
     /** Clients may call it through the gateway. */
@@ -196,6 +198,40 @@ export interface ExecDeployOptions {
     /** The root hub's type name. */
     root: string;
     types: Record<string, ExecNodeTypeInput>;
+    /** A succeeded {@link ExecAPI.build} of this app whose crates the types may name. */
+    buildId?: string;
+}
+/** One crate for {@link ExecAPI.build}: its files by path (`Cargo.toml`, `src/lib.rs`, ...). */
+export interface ExecCrate {
+    name: string;
+    files: Record<string, string> | ExecSourceFile[];
+}
+export interface ExecSourceFile {
+    path: string;
+    content: string;
+}
+/** A build: `queued`, `building`, `succeeded` or `failed`, its log, and one module per crate. */
+export type ExecBuild = Omit<ExecBuildFieldsFragment, '__typename' | 'artifacts'> & {
+    artifacts: Array<{
+        crate: string;
+        digest: string;
+        sizeBytes: number;
+    }>;
+};
+/** A starter crate, with its files ready for {@link ExecAPI.build}. */
+export interface ExecStarter {
+    crate: string;
+    nodeType: string;
+    description: string;
+    files: ExecSourceFile[];
+}
+/** The starter packs, and the manifest that deploys them as one app, its types naming their crates. */
+export interface ExecStarterPack {
+    manifest: {
+        root: string;
+        types: Record<string, ExecNodeTypeInput>;
+    };
+    starters: ExecStarter[];
 }
 /** One guest log line (`ctx.log`); `level` is 0 error, 1 warn, 2 info, 3 debug. */
 export type ExecLogLine = Omit<ExecLogsQuery['execLogs'][number], '__typename'>;
@@ -216,8 +252,9 @@ export interface ExecLogsOptions {
     limit?: number;
 }
 /**
- * `client.exec`: connecting players to ck-exec, deploying an app's nodes, and operating
- * them (logs, instances, versions, rollback, the kill switch, developer connections).
+ * `client.exec`: connecting players to ck-exec, building and deploying an app's nodes (and
+ * the starter packs), and operating them (logs, instances, versions, rollback, the kill
+ * switch, developer connections).
  */
 export declare class ExecAPI {
     private readonly graphql;
@@ -259,6 +296,28 @@ export declare class ExecAPI {
      * `manage_compute`.
      */
     setEnabled(appId: string, enabled: boolean, nodeType?: string): Promise<ExecAppStatus>;
+    /**
+     * The starter packs, which replace the compute templates: a world tick (the root hub), a
+     * matchmaker, game sessions and an NPC and mob engine. Build them with {@link build} and
+     * deploy the build with `manifest`. Requires `manage_compute`.
+     */
+    starters(appId: string): Promise<ExecStarterPack>;
+    /**
+     * Builds crates into modules on the platform (`ckx-sdk`, `wasm32-unknown-unknown`), so you
+     * need no Rust toolchain. Returns at once with the build queued; wait with
+     * {@link waitForBuild}, then {@link deploy} with its `buildId`. Requires `manage_compute`.
+     */
+    build(appId: string, crates: ExecCrate[]): Promise<ExecBuild>;
+    /** A build's status, log and modules, or null. Requires `view_compute_diagnostics`. */
+    buildStatus(appId: string, buildId: string): Promise<ExecBuild | null>;
+    /**
+     * Polls a build until it succeeds or fails, and returns it either way; a failed build's
+     * `log` says why. Throws when it is not done in `timeoutMs` (default 10 minutes).
+     */
+    waitForBuild(appId: string, buildId: string, options?: {
+        intervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<ExecBuild>;
     /** A host for this player and its connect token (valid for about a minute). */
     endpoint(appId: string, options?: {
         nodeType?: string;
@@ -274,8 +333,9 @@ export declare class ExecAPI {
     connect(appId: string, options?: ExecConnectOptions): Promise<ExecConnection>;
     /**
      * Deploys a new version of the app's nodes and makes it active: the manifest, and
-     * each distinct module once. Running instances pick it up when they next start.
-     * Requires the org `manage_compute` permission.
+     * each distinct module once. A type gives its module as `wasm`, or names a `crate` of
+     * `buildId`, whose modules the platform already holds. Running instances pick it up
+     * when they next start. Requires the org `manage_compute` permission.
      */
     deploy(options: ExecDeployOptions): Promise<{
         version: number;

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

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

package/dist/domains/exec.js

@@ -1,6 +1,6 @@
 import { decode, encode } from '@msgpack/msgpack';
 import { CrowdyError } from '../errors.js';
-import { ExecActivateVersionDocument, ExecAppStatusDocument, ExecConnectAsDeveloperDocument, ExecConnectDocument, ExecDeployDocument, ExecInstancesDocument, ExecLogsDocument, ExecSetEnabledDocument, ExecVersionsDocument, } from '../generated/graphql.js';
+import { ExecActivateVersionDocument, ExecAppStatusDocument, ExecBuildDocument, ExecBuildStatusDocument, ExecConnectAsDeveloperDocument, ExecConnectDocument, ExecDeployDocument, ExecInstancesDocument, ExecLogsDocument, ExecSetEnabledDocument, ExecStartersDocument, ExecVersionsDocument, } from '../generated/graphql.js';
 /**
  * ck-exec, the hub-and-spoke execution service (dev-tier preview).
  *
@@ -516,9 +516,14 @@ function strip(v) {
     const { __typename: _, ...rest } = v;
     return rest;
 }
+function build(b) {
+    const { __typename: _, artifacts, ...rest } = b;
+    return { ...rest, artifacts: artifacts.map(strip) };
+}
 /**
- * `client.exec`: connecting players to ck-exec, deploying an app's nodes, and operating
- * them (logs, instances, versions, rollback, the kill switch, developer connections).
+ * `client.exec`: connecting players to ck-exec, building and deploying an app's nodes (and
+ * the starter packs), and operating them (logs, instances, versions, rollback, the kill
+ * switch, developer connections).
  */
 export class ExecAPI {
     constructor(graphql) {
@@ -585,6 +590,64 @@ export class ExecAPI {
         const data = await this.graphql.request(ExecSetEnabledDocument, { appId, enabled, nodeType });
         return strip(data.execSetEnabled);
     }
+    /**
+     * The starter packs, which replace the compute templates: a world tick (the root hub), a
+     * matchmaker, game sessions and an NPC and mob engine. Build them with {@link build} and
+     * deploy the build with `manifest`. Requires `manage_compute`.
+     */
+    async starters(appId) {
+        const data = await this.graphql.request(ExecStartersDocument, { appId });
+        return {
+            manifest: JSON.parse(data.execStarters.manifestJson),
+            starters: data.execStarters.starters.map((s) => ({
+                crate: s.crate,
+                nodeType: s.nodeType,
+                description: s.description,
+                files: s.files.map(strip),
+            })),
+        };
+    }
+    /**
+     * Builds crates into modules on the platform (`ckx-sdk`, `wasm32-unknown-unknown`), so you
+     * need no Rust toolchain. Returns at once with the build queued; wait with
+     * {@link waitForBuild}, then {@link deploy} with its `buildId`. Requires `manage_compute`.
+     */
+    async build(appId, crates) {
+        const data = await this.graphql.request(ExecBuildDocument, {
+            input: {
+                appId,
+                crates: crates.map((c) => ({
+                    name: c.name,
+                    files: Array.isArray(c.files)
+                        ? c.files
+                        : Object.entries(c.files).map(([path, content]) => ({ path, content })),
+                })),
+            },
+        });
+        return build(data.execBuild);
+    }
+    /** A build's status, log and modules, or null. Requires `view_compute_diagnostics`. */
+    async buildStatus(appId, buildId) {
+        const data = await this.graphql.request(ExecBuildStatusDocument, { appId, buildId });
+        return data.execBuildStatus ? build(data.execBuildStatus) : null;
+    }
+    /**
+     * Polls a build until it succeeds or fails, and returns it either way; a failed build's
+     * `log` says why. Throws when it is not done in `timeoutMs` (default 10 minutes).
+     */
+    async waitForBuild(appId, buildId, options = {}) {
+        const until = Date.now() + (options.timeoutMs ?? 600000);
+        for (;;) {
+            const b = await this.buildStatus(appId, buildId);
+            if (!b)
+                throw new CrowdyError({ message: `no build ${buildId} in app ${appId}` });
+            if (b.status === 'succeeded' || b.status === 'failed')
+                return b;
+            if (Date.now() > until)
+                throw new CrowdyError({ message: `build ${buildId} is still ${b.status}` });
+            await new Promise((r) => setTimeout(r, options.intervalMs ?? 2000));
+        }
+    }
     /** A host for this player and its connect token (valid for about a minute). */
     async endpoint(appId, options = {}) {
         const data = await this.graphql.request(ExecConnectDocument, {
@@ -606,14 +669,22 @@ export class ExecAPI {
     }
     /**
      * Deploys a new version of the app's nodes and makes it active: the manifest, and
-     * each distinct module once. Running instances pick it up when they next start.
-     * Requires the org `manage_compute` permission.
+     * each distinct module once. A type gives its module as `wasm`, or names a `crate` of
+     * `buildId`, whose modules the platform already holds. Running instances pick it up
+     * when they next start. Requires the org `manage_compute` permission.
      */
     async deploy(options) {
         const types = {};
         const artifacts = new Map();
         for (const [name, t] of Object.entries(options.types)) {
             const { wasm, ...spec } = t;
+            if (!wasm) {
+                if (!spec.crate || !options.buildId) {
+                    throw new CrowdyError({ message: `type '${name}' needs its wasm, or a crate of the deploy's buildId` });
+                }
+                types[name] = spec;
+                continue;
+            }
             const digest = await sha256Hex(wasm);
             if (!artifacts.has(digest))
                 artifacts.set(digest, base64(wasm));
@@ -624,6 +695,7 @@ export class ExecAPI {
                 appId: options.appId,
                 manifestJson: JSON.stringify({ root: options.root, types }),
                 artifacts: [...artifacts].map(([digest, wasmBase64]) => ({ digest, wasmBase64 })),
+                buildId: options.buildId,
             },
         });
         return data.execDeploy;

package/dist/generated/graphql.d.ts

@@ -3638,6 +3638,55 @@ export type ExecArtifactInput = {
     /** The WASM module (wasm32-unknown-unknown, built with ckx-sdk), base64. */
     wasmBase64: Scalars['String']['input'];
 };
+/** A ck-exec build (dev-tier preview): queued, building, succeeded or failed, with the compiler’s log and, once it succeeds, one module per crate. */
+export type ExecBuild = {
+    __typename?: 'ExecBuild';
+    /** The modules built so far, one per crate. */
+    artifacts: Array<ExecBuildArtifact>;
+    /** The build’s id, for `execBuildStatus` and `execDeploy`. */
+    buildId: Scalars['String']['output'];
+    /** When the build was requested. */
+    createdAt: Scalars['DateTime']['output'];
+    /** When it finished. */
+    finishedAt: Maybe<Scalars['DateTime']['output']>;
+    /** The compiler’s output once the build finishes, at most 64 KB (the end is kept). */
+    log: Maybe<Scalars['String']['output']>;
+    /** When it started compiling. */
+    startedAt: Maybe<Scalars['DateTime']['output']>;
+    /** `queued`, `building`, `succeeded` or `failed`. */
+    status: Scalars['String']['output'];
+};
+/** One module a ck-exec build produced. */
+export type ExecBuildArtifact = {
+    __typename?: 'ExecBuildArtifact';
+    /** The crate it was built from. */
+    crate: Scalars['String']['output'];
+    /** SHA-256 of the WASM: the `digest` a manifest names it by. */
+    digest: Scalars['String']['output'];
+    /** The module’s size in bytes. */
+    sizeBytes: Scalars['Int']['output'];
+};
+/** One crate of a ck-exec build: a `ckx-sdk` library with `[lib] crate-type = ["cdylib"]`, built into one module. */
+export type ExecBuildCrateInput = {
+    /** Its files, at most 64. `Cargo.toml` may have only [package], [lib] and [dependencies] from `ckx-sdk`, `serde` and `serde_json`. */
+    files: Array<ExecBuildFileInput>;
+    /** The crate’s name: lowercase letters, digits, `-` or `_`, at most 64 characters. The build reports each module under it. */
+    name: Scalars['String']['input'];
+};
+/** One source file of a ck-exec crate. */
+export type ExecBuildFileInput = {
+    /** The file’s contents, UTF-8. */
+    content: Scalars['String']['input'];
+    /** The path within the crate: `Cargo.toml`, `README.md`, or a `.rs` file under `src/`. */
+    path: Scalars['String']['input'];
+};
+/** Sources to build into ck-exec modules. */
+export type ExecBuildInput = {
+    /** The app to build for. */
+    appId: Scalars['BigInt']['input'];
+    /** The crates, at most 16, 2 MB of source in all; each becomes one module. */
+    crates: Array<ExecBuildCrateInput>;
+};
 /** Where and how a game client connects to ck-exec, the hub-and-spoke execution service (dev-tier preview). Open a WebSocket to `{gatewayUrl}/v1/connect?token={token}` before `expiresAt`. */
 export type ExecConnection = {
     __typename?: 'ExecConnection';
@@ -3656,7 +3705,9 @@ export type ExecDeployInput = {
     appId: Scalars['BigInt']['input'];
     /** Modules the manifest names that this app has not uploaded before (at most 64). A request body is limited to 10 MB, so about 7 MB of modules per call. */
     artifacts?: InputMaybe<Array<ExecArtifactInput>>;
-    /** The manifest as JSON: `{ "root": "<hub type>", "types": { "<name>": { "kind": "hub"|"spoke", "parent", "digest", "client", "calls", "scopes", ... } } }`. Every field and its platform bounds: https://docs.dev.crowdedkingdoms.com/exec/intro#the-manifest. */
+    /** A succeeded `execBuild` of this app whose modules to include, so a manifest can name them by digest without uploading them. */
+    buildId?: InputMaybe<Scalars['String']['input']>;
+    /** The manifest as JSON: `{ "root": "<hub type>", "types": { "<name>": { "kind": "hub"|"spoke", "parent", "digest", "client", "calls", "scopes", ... } } }`; with `buildId`, a type may give `"crate": "<name>"` instead of `digest`. Every field and its platform bounds: https://docs.dev.crowdedkingdoms.com/exec/intro#the-manifest. */
     manifestJson: Scalars['String']['input'];
 };
 /** The result of a ck-exec deploy. */
@@ -3704,6 +3755,34 @@ export type ExecLogLine = {
     /** The line, at most 1 KiB. */
     text: Scalars['String']['output'];
 };
+/** A starter crate: a ckx-sdk hub to build with `execBuild` as it is, or to change first. */
+export type ExecStarter = {
+    __typename?: 'ExecStarter';
+    /** The crate’s name, which the pack’s manifest names it by. */
+    crate: Scalars['String']['output'];
+    /** What it does. */
+    description: Scalars['String']['output'];
+    /** Its Cargo.toml and sources. */
+    files: Array<ExecStarterFile>;
+    /** The node type the pack’s manifest deploys it as. */
+    nodeType: Scalars['String']['output'];
+};
+/** One source file of a starter crate. */
+export type ExecStarterFile = {
+    __typename?: 'ExecStarterFile';
+    /** The file’s contents. */
+    content: Scalars['String']['output'];
+    /** The path within the crate, as `execBuild` takes it. */
+    path: Scalars['String']['output'];
+};
+/** The starter packs (dev-tier preview): four crates and a manifest that deploys them as one app. */
+export type ExecStarterPack = {
+    __typename?: 'ExecStarterPack';
+    /** The manifest for `execDeploy` with the build’s id: the root `world` hub, and `matchmaker`, `session` and `npcs` under it, each naming its crate. */
+    manifestJson: Scalars['String']['output'];
+    /** The crates. */
+    starters: Array<ExecStarter>;
+};
 /** A deployed version of an app’s ck-exec topology. */
 export type ExecVersion = {
     __typename?: 'ExecVersion';
@@ -5589,6 +5668,8 @@ export type Mutation = {
     exchangePortalCode: AppTokenResponse;
     /** Make an earlier ck-exec version active again, a rollback (dev-tier preview). Running instances pick it up when they next start, as after a deploy. Requires the org 'manage_compute' permission. */
     execActivateVersion: ExecAppStatus;
+    /** Build ck-exec modules from Rust source (dev-tier preview): each crate is compiled with the platform's pinned toolchain and `ckx-sdk`, for wasm32-unknown-unknown, and checked against the guest ABI. Returns at once with the build queued; poll `execBuildStatus`, then pass its id to `execDeploy`. Requires the org 'manage_compute' permission. */
+    execBuild: ExecBuild;
     /** Connect a player to ck-exec (dev-tier preview): the execution manager picks a host (the one running `nodeType`/`key` when given, placing it if needed) and this returns its gateway and a 60-second connect token bound to this player, this app and that host. Requires the app-scoped token of the app named. */
     execConnect: ExecConnection;
     /** Connect to an app's ck-exec code as one of its developers, for studio tools, manual runs and admin endpoints (dev-tier preview). The session's calls arrive as `Caller::Developer` with your user id and may reach any node type, not only `client` ones, but never the platform's `$` methods. Requires the org 'manage_compute' permission and your own session, not an app token. */
@@ -6212,6 +6293,9 @@ export type MutationExecActivateVersionArgs = {
     appId: Scalars['BigInt']['input'];
     version: Scalars['Int']['input'];
 };
+export type MutationExecBuildArgs = {
+    input: ExecBuildInput;
+};
 export type MutationExecConnectArgs = {
     appId: Scalars['BigInt']['input'];
     key?: InputMaybe<Scalars['String']['input']>;
@@ -8208,10 +8292,14 @@ export type Query = {
     emailDeliveryConfig: EmailDeliveryConfig;
     /** Whether an app's ck-exec code may run: its active version, kill switches and budget pause (dev-tier preview). Requires the org 'view_compute_diagnostics' permission. */
     execAppStatus: ExecAppStatus;
+    /** A ck-exec build's status, compiler log and modules (dev-tier preview); null when this app has no such build. Builds are kept for 7 days. Requires the org 'view_compute_diagnostics' permission. */
+    execBuildStatus: Maybe<ExecBuild>;
     /** What the execution manager has placed for an app: every instance, its phase and host (dev-tier preview). Requires the org 'view_compute_diagnostics' permission. */
     execInstances: Array<ExecInstance>;
     /** Guest log lines from an app's ck-exec instances (`ctx.log`), newest first, kept for 24 hours (dev-tier preview). Requires the org 'view_compute_diagnostics' permission. */
     execLogs: Array<ExecLogLine>;
+    /** The starter packs (dev-tier preview), which replace the compute templates: a world tick (the root hub: clock, weather, resource nodes, liveops events), a matchmaker, game sessions (lobby, host, turns, scores) and an NPC and mob engine, as ckx-sdk crates to pass to `execBuild` and a manifest for `execDeploy`. Requires the org 'manage_compute' permission. */
+    execStarters: ExecStarterPack;
     /** An app's deployed ck-exec versions, newest first, and which is active (dev-tier preview). Requires the org 'view_compute_diagnostics' permission. */
     execVersions: Array<ExecVersion>;
     /** Reports whether a free-play window is active now, a human-readable schedule description, and the ISO-8601 start of the next window. PUBLIC: no authentication required. Takes no arguments; computed from server config and the current clock. */
@@ -8791,6 +8879,10 @@ export type QueryEmailDeliverabilityArgs = {
 export type QueryExecAppStatusArgs = {
     appId: Scalars['BigInt']['input'];
 };
+export type QueryExecBuildStatusArgs = {
+    appId: Scalars['BigInt']['input'];
+    buildId: Scalars['String']['input'];
+};
 export type QueryExecInstancesArgs = {
     appId: Scalars['BigInt']['input'];
 };
@@ -8802,6 +8894,9 @@ export type QueryExecLogsArgs = {
     maxLevel?: InputMaybe<Scalars['Int']['input']>;
     nodeType?: InputMaybe<Scalars['String']['input']>;
 };
+export type QueryExecStartersArgs = {
+    appId: Scalars['BigInt']['input'];
+};
 export type QueryExecVersionsArgs = {
     appId: Scalars['BigInt']['input'];
 };
@@ -14200,6 +14295,85 @@ export type ExecSetEnabledMutation = {
         budgetPaused: boolean;
     };
 };
+export type ExecStartersQueryVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+}>;
+export type ExecStartersQuery = {
+    __typename?: 'Query';
+    execStarters: {
+        __typename?: 'ExecStarterPack';
+        manifestJson: string;
+        starters: Array<{
+            __typename?: 'ExecStarter';
+            crate: string;
+            nodeType: string;
+            description: string;
+            files: Array<{
+                __typename?: 'ExecStarterFile';
+                path: string;
+                content: string;
+            }>;
+        }>;
+    };
+};
+export type ExecBuildFieldsFragment = {
+    __typename?: 'ExecBuild';
+    buildId: string;
+    status: string;
+    log: string | null;
+    createdAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+    artifacts: Array<{
+        __typename?: 'ExecBuildArtifact';
+        crate: string;
+        digest: string;
+        sizeBytes: number;
+    }>;
+};
+export type ExecBuildMutationVariables = Exact<{
+    input: ExecBuildInput;
+}>;
+export type ExecBuildMutation = {
+    __typename?: 'Mutation';
+    execBuild: {
+        __typename?: 'ExecBuild';
+        buildId: string;
+        status: string;
+        log: string | null;
+        createdAt: string;
+        startedAt: string | null;
+        finishedAt: string | null;
+        artifacts: Array<{
+            __typename?: 'ExecBuildArtifact';
+            crate: string;
+            digest: string;
+            sizeBytes: number;
+        }>;
+    };
+};
+export type ExecBuildStatusQueryVariables = Exact<{
+    appId: Scalars['BigInt']['input'];
+    buildId: Scalars['String']['input'];
+}>;
+export type ExecBuildStatusQuery = {
+    __typename?: 'Query';
+    execBuildStatus: {
+        __typename?: 'ExecBuild';
+        buildId: string;
+        status: string;
+        log: string | null;
+        createdAt: string;
+        startedAt: string | null;
+        finishedAt: string | null;
+        artifacts: Array<{
+            __typename?: 'ExecBuildArtifact';
+            crate: string;
+            digest: string;
+            sizeBytes: number;
+        }>;
+    } | null;
+};
 export type GridOwnershipFieldsFragment = {
     __typename?: 'GridOwnership';
     gridOwnershipId: string;
@@ -20357,6 +20531,7 @@ export declare const ComputePolicyFieldsFragmentDoc: DocumentNode<ComputePolicyF
 export declare const ComputeRunFieldsFragmentDoc: DocumentNode<ComputeRunFieldsFragment, unknown>;
 export declare const CrowdyStudioProjectFieldsFragmentDoc: DocumentNode<CrowdyStudioProjectFieldsFragment, unknown>;
 export declare const ExecAppStatusFieldsFragmentDoc: DocumentNode<ExecAppStatusFieldsFragment, unknown>;
+export declare const ExecBuildFieldsFragmentDoc: DocumentNode<ExecBuildFieldsFragment, unknown>;
 export declare const GridOwnershipFieldsFragmentDoc: DocumentNode<GridOwnershipFieldsFragment, unknown>;
 export declare const GmAutomationFieldsFragmentDoc: DocumentNode<GmAutomationFieldsFragment, unknown>;
 export declare const GmAutomationTriggerFieldsFragmentDoc: DocumentNode<GmAutomationTriggerFieldsFragment, unknown>;
@@ -20507,6 +20682,9 @@ export declare const ExecVersionsDocument: DocumentNode<ExecVersionsQuery, ExecV
 export declare const ExecAppStatusDocument: DocumentNode<ExecAppStatusQuery, ExecAppStatusQueryVariables>;
 export declare const ExecActivateVersionDocument: DocumentNode<ExecActivateVersionMutation, ExecActivateVersionMutationVariables>;
 export declare const ExecSetEnabledDocument: DocumentNode<ExecSetEnabledMutation, ExecSetEnabledMutationVariables>;
+export declare const ExecStartersDocument: DocumentNode<ExecStartersQuery, ExecStartersQueryVariables>;
+export declare const ExecBuildDocument: DocumentNode<ExecBuildMutation, ExecBuildMutationVariables>;
+export declare const ExecBuildStatusDocument: DocumentNode<ExecBuildStatusQuery, ExecBuildStatusQueryVariables>;
 export declare const GridOwnershipDocument: DocumentNode<GridOwnershipQuery, GridOwnershipQueryVariables>;
 export declare const AssignGridOwnershipDocument: DocumentNode<AssignGridOwnershipMutation, AssignGridOwnershipMutationVariables>;
 export declare const TransferGridOwnershipDocument: DocumentNode<TransferGridOwnershipMutation, TransferGridOwnershipMutationVariables>;