@crowdedkingdoms/crowdyjs 17.12.0-dev.1 → 17.14.0-dev.1

package/dist/crowdy-studio/controller.js

@@ -1,4 +1,5 @@
 import { PlayerCodeBroker, } from '../player-runtime/player-code-broker.js';
+import { CrowdyError, CrowdyGraphQLError } from '../errors.js';
 import { digestCanonicalJson, sha256Digest, } from '../player-host/json-schema.js';
 import { parseRustcDiagnostics } from './diagnostics.js';
 import { githubNewRepositoryUrl, githubRepositorySlug } from './github/new-repo.js';
@@ -7,6 +8,9 @@ import { parseClientTickIntervalMs } from './client-tick-interval.js';
 import { createCrowdyStudioStarterProject, } from './starter-projects.js';
 /** As ck-exec's mod names. */
 const MOD_NAME = /^[a-z0-9_-]{1,48}$/;
+/** As a ck-exec build's crate names. */
+const CRATE_NAME = /^[a-z][a-z0-9_-]{0,63}$/;
+const LOG_LEVELS = ['error', 'warn', 'info', 'debug'];
 class OperationCancelledError extends Error {
 }
 /**
@@ -18,6 +22,7 @@ export class CrowdyStudioController {
     constructor(options) {
         this.options = options;
         this.state = {
+            serverEngine: 'player-compute',
             projects: [],
             project: null,
             personalLibraryFiles: [],
@@ -55,8 +60,15 @@ export class CrowdyStudioController {
         this.surfaceTimers = new Map();
         this.pageVisible = true;
         this.destroyed = false;
+        this.modConnection = null;
         // ----- GitHub repository card ------------------------------------------
         this.githubStatusGeneration = 0;
+        const serverEngine = options.serverEngine ?? (options.mods ? 'ck-exec' : 'player-compute');
+        if (serverEngine === 'ck-exec' && !options.mods) {
+            throw new Error("serverEngine 'ck-exec' needs the mods option (client.exec)");
+        }
+        this.mods = serverEngine === 'ck-exec' ? options.mods : null;
+        this.state = { ...this.state, serverEngine };
         if (options.onStateChange)
             this.listeners.add(options.onStateChange);
     }
@@ -186,9 +198,14 @@ export class CrowdyStudioController {
         if (this.state.project && !(await this.saveNow())) {
             throw new Error('Resolve or retry the current project save before creating another');
         }
+        const modStarter = this.mods && projectTargets(options.kind).includes('SERVER')
+            ? await this.mods.modStarter(this.options.appId)
+            : undefined;
         const input = createCrowdyStudioStarterProject({
             ...options,
             ...this.scope(),
+            ...(modStarter ? { modStarter } : {}),
+            engine: this.state.serverEngine,
         });
         const project = await this.options.projectProvider.createProject(input);
         this.installProject(project);
@@ -254,6 +271,7 @@ export class CrowdyStudioController {
         this.stopSurfacePolling();
         this.broker?.stop();
         this.broker = null;
+        this.closeModConnection();
         this.clearSaveTimers();
         this.editGeneration = 0;
         this.persistedGeneration = 0;
@@ -890,7 +908,7 @@ export class CrowdyStudioController {
                 }
                 this.checkOperation(operation);
                 // A mod has no client pairing: its players call it by name.
-                if (!this.options.mods) {
+                if (!this.mods) {
                     const requiredClientName = project.metadata.pairingPreference === 'REQUIRED'
                         ? client.name
                         : null;
@@ -966,8 +984,10 @@ export class CrowdyStudioController {
                 message: `Submitting ${name}`,
             },
         });
-        if (target === 'SERVER' && this.options.mods) {
-            return this.buildMod(name, files, operation);
+        if (this.mods) {
+            return target === 'SERVER'
+                ? this.buildMod(name, files, operation)
+                : this.buildClientHalf(name, files, operation);
         }
         // The server resolves the source from the project itself: the saved
         // files at the project revision, or — for a GITHUB project — the rust at
@@ -1019,37 +1039,75 @@ export class CrowdyStudioController {
         return null;
     }
     /**
-     * The SERVER target as a ck-exec mod: the project's server files are the crate, built on
-     * the platform, then deployed to this grid (switched off until {@link enableServer}).
+     * The SERVER target as a ck-exec mod: the project's server crate files, built on the
+     * platform, then deployed to this grid (switched off until {@link enableServer}). Other
+     * project files, such as grid program assets, are not part of the crate.
      */
     async buildMod(name, files, operation) {
-        const mods = this.options.mods;
-        if (!MOD_NAME.test(name)) {
-            throw new Error(`The server module name '${name}' must be 1-48 lowercase letters, digits, - or _ to run as a mod`);
-        }
+        const mods = this.mods;
+        const problem = modNameProblem(this.requireProject());
+        if (problem)
+            throw new Error(problem);
         const { appId, gridId } = this.scope();
         const queued = await mods.modBuild(appId, {
-            name,
-            files: files.map((file) => ({ path: file.path, content: file.content })),
+            name: crateName(name),
+            files: crateFiles(files),
+        });
+        this.checkOperation(operation);
+        const built = await this.awaitModBuild('SERVER', name, queued.buildId, operation);
+        if (!built)
+            return null;
+        const mod = await mods.modDeploy(appId, gridId, name, built.buildId);
+        this.checkOperation(operation);
+        return { target: 'SERVER', name, versionId: String(mod.version) };
+    }
+    /**
+     * The CLIENT target as a ck-exec mod's CLIENT half: the project's `crowdy-client-sdk` crate,
+     * built on the platform (`modClientBuild`, a build of `kind` `client`). It is attached to the
+     * project's mod when the project runs ({@link attachClientHalf}).
+     */
+    async buildClientHalf(name, files, operation) {
+        const problem = modNameProblem(this.requireProject());
+        if (problem)
+            throw new Error(problem);
+        const cargo = files.find((file) => file.path === 'Cargo.toml')?.content ?? '';
+        if (/^\s*crowdy-compute-sdk\s*=/m.test(cargo)) {
+            this.recordBuild('CLIENT', LEGACY_CLIENT_CRATE);
+            this.update({
+                runtime: {
+                    phase: 'COMPILE_FAILED',
+                    target: 'CLIENT',
+                    message: `${name} is a legacy player compute crate; a CLIENT half builds on crowdy-client-sdk`,
+                },
+            });
+            return null;
+        }
+        const queued = await this.mods.modClientBuild(this.options.appId, {
+            name: crateName(name),
+            files: crateFiles(files),
         });
         this.checkOperation(operation);
+        const built = await this.awaitModBuild('CLIENT', name, queued.buildId, operation);
+        return built ? { target: 'CLIENT', name, versionId: built.buildId } : null;
+    }
+    /** Polls a mod build, a mod's or a CLIENT half's, recording its log; null when it did not succeed. */
+    async awaitModBuild(target, name, buildId, operation) {
+        const mods = this.mods;
         const limit = this.options.compilePollLimit ?? 60;
         const pollMs = this.options.compilePollMs ?? 1500;
         for (let attempt = 0; attempt < limit; attempt++) {
-            const b = await mods.modBuildStatus(appId, queued.buildId);
+            const b = await mods.modBuildStatus(this.options.appId, buildId);
             this.checkOperation(operation);
             if (b.status === 'succeeded') {
-                this.recordBuild('SERVER', b.log ?? '');
-                const mod = await mods.modDeploy(appId, gridId, name, b.buildId);
-                this.checkOperation(operation);
-                return { target: 'SERVER', name, versionId: String(mod.version) };
+                this.recordBuild(target, b.log ?? '');
+                return b;
             }
             if (b.status === 'failed') {
-                this.recordBuild('SERVER', b.log ?? 'Compilation failed without output');
+                this.recordBuild(target, b.log ?? 'Compilation failed without output');
                 this.update({
                     runtime: {
                         phase: 'COMPILE_FAILED',
-                        target: 'SERVER',
+                        target,
                         message: `${name} failed to compile`,
                     },
                 });
@@ -1059,12 +1117,106 @@ export class CrowdyStudioController {
             this.checkOperation(operation);
         }
         const timeout = `Compilation timed out after ${limit} polls`;
-        this.recordBuild('SERVER', timeout);
+        this.recordBuild(target, timeout);
         this.update({
-            runtime: { phase: 'COMPILE_FAILED', target: 'SERVER', message: timeout },
+            runtime: { phase: 'COMPILE_FAILED', target, message: timeout },
         });
         return null;
     }
+    /**
+     * Attaches a built CLIENT half to the project's mod, consents to it as its author (the API
+     * serves a CLIENT half only to a player who consented or trusts its author, the author too) and
+     * fetches the served module for this browser's preview. A CLIENT-only project first makes sure
+     * the mod it rides is the player's and switched on.
+     */
+    async attachClientHalf(compiled, operation) {
+        const mods = this.mods;
+        const { appId, gridId } = this.scope();
+        const project = this.requireProject();
+        const modName = projectModName(project);
+        if (!projectTargets(project.kind).includes('SERVER')) {
+            await this.ensureClientOnlyMod(modName, operation);
+        }
+        this.update({
+            runtime: { phase: 'ENABLING', target: 'CLIENT', message: `Attaching ${compiled.name} to ${modName}` },
+        });
+        const attached = await mods.modClientDeploy(appId, gridId, modName, compiled.versionId);
+        this.checkOperation(operation);
+        await mods.consentClientMod(appId, attached.modId, attached.capabilityHash);
+        this.checkOperation(operation);
+        this.recordNote('CLIENT', `Attached to mod '${modName}' as CLIENT version ${attached.clientVersion} (capabilities ` +
+            `${attached.capabilityHash}; ticks every ${attached.tickIntervalMs} ms). Visitors of grid ` +
+            `${gridId} run it once they consent to it or trust you; you consented to it as its author.`);
+        let artifact;
+        try {
+            artifact = await mods.modClientArtifactBytes(appId, attached.modId);
+        }
+        catch (error) {
+            if (error instanceof CrowdyGraphQLError && error.code === 'NOT_FOUND') {
+                throw new CrowdyError({
+                    message: `${compiled.name} is attached to mod '${modName}', but its preview did not load: the ` +
+                        'API serves a CLIENT half only while its mod is switched on and not held, to a player ' +
+                        `with run_client_code who stands in grid ${gridId}`,
+                    cause: error,
+                });
+            }
+            if (error instanceof CrowdyGraphQLError && error.code === 'RATE_LIMITED') {
+                throw new CrowdyError({
+                    message: `${compiled.name} is attached to mod '${modName}', but its preview was fetched too ` +
+                        'often (12 a minute); deploy again in a minute',
+                    cause: error,
+                });
+            }
+            throw error;
+        }
+        this.checkOperation(operation);
+        if (artifact.digest !== attached.digest || artifact.clientVersion !== attached.clientVersion) {
+            throw new Error('The served CLIENT half is not the one just attached; deploy again');
+        }
+        return artifact;
+    }
+    /**
+     * A CLIENT half rides a mod: without a mod of this name running as the player on the grid,
+     * the mod starter's server half is deployed under it first, and the log says so. The mod is
+     * switched on, since only a running mod's CLIENT half is served.
+     */
+    async ensureClientOnlyMod(name, operation) {
+        const mods = this.mods;
+        const { appId, gridId } = this.scope();
+        const mine = (await mods.myMods(appId)).find((mod) => String(mod.gridId) === gridId && mod.name === name);
+        this.checkOperation(operation);
+        if (!mine) {
+            if (!this.canTarget('SERVER', 'write') || !this.canTarget('SERVER', 'run')) {
+                throw new Error(`A CLIENT half rides a mod, and grid ${gridId} has no mod '${name}' of yours; deploying one needs SERVER write and run permissions here`);
+            }
+            this.update({
+                runtime: { phase: 'COMPILING', target: 'SERVER', message: `Deploying the mod starter as ${name}` },
+            });
+            const starter = await mods.modStarter(appId);
+            this.checkOperation(operation);
+            const queued = await mods.modBuild(appId, { name: crateName(name), files: starter.files });
+            this.checkOperation(operation);
+            const built = await this.awaitModBuild('SERVER', name, queued.buildId, operation);
+            if (!built) {
+                throw new Error(`The mod starter did not build, so the CLIENT half has no mod '${name}' to ride`);
+            }
+            await mods.modDeploy(appId, gridId, name, built.buildId);
+            this.checkOperation(operation);
+            this.recordNote('SERVER', `Grid ${gridId} had no mod '${name}' of yours, and a CLIENT half rides a mod: deployed the ` +
+                `ck-exec mod starter (${starter.crate}) as '${name}', its server half.`);
+        }
+        if (!mine?.enabled) {
+            await mods.modSetEnabled(appId, gridId, name, true);
+            this.checkOperation(operation);
+            if (mine)
+                this.recordNote('SERVER', `Switched mod '${name}' on, so its CLIENT half is served.`);
+        }
+    }
+    recordNote(target, note) {
+        this.update({
+            buildOutput: [this.state.buildOutput, `## ${target}\n${note}`].filter(Boolean).join('\n\n'),
+        });
+    }
     recordBuild(target, log) {
         const section = `## ${target}\n${log || 'Compiled successfully.'}`;
         const authoritativeDiagnostics = [
@@ -1087,9 +1239,9 @@ export class CrowdyStudioController {
         this.checkOperation(operation);
     }
     async setServerEnabled(name, enabled) {
-        if (this.options.mods) {
+        if (this.mods) {
             const { appId, gridId } = this.scope();
-            await this.options.mods.modSetEnabled(appId, gridId, name, enabled);
+            await this.mods.modSetEnabled(appId, gridId, name, enabled);
             return;
         }
         await this.options.playerCompute.setEnabled({
@@ -1103,28 +1255,47 @@ export class CrowdyStudioController {
             throw new Error(`${compiled.name} compiled successfully, but run_client_code is unavailable on this grid`);
         }
         const runtime = this.clientRuntimeOptions();
-        const artifact = await this.options.playerCompute.artifactBytes({
-            ...this.scope(),
-            name: compiled.name,
-            versionId: compiled.versionId,
-        });
-        this.checkOperation(operation);
-        if (artifact.versionId !== compiled.versionId ||
-            !artifact.artifactHash ||
-            artifact.bytes.byteLength === 0) {
-            throw new Error('Client artifact did not match the compiled project version');
-        }
-        const brokerOptions = {
-            ...runtime,
-            artifactHash: artifact.artifactHash,
-            fuelPerDispatch: artifact.fuelPerDispatch,
-            onPresentation: this.options.onPresentation,
-            tickIntervalMs: this.options.clientTickIntervalMs ??
-                parseClientTickIntervalMs(this.requireProject().files.find((file) => file.target === 'CLIENT' && file.path === 'Cargo.toml')?.content),
-        };
+        let brokerOptions;
+        let bytes;
+        if (this.mods) {
+            const half = await this.attachClientHalf(compiled, operation);
+            bytes = half.bytes;
+            brokerOptions = {
+                ...runtime,
+                engine: 'ck-exec',
+                moduleName: half.name,
+                artifactHash: half.digest,
+                fuelPerDispatch: half.fuelPerDispatch,
+                consentedHostCalls: half.capabilitySummary.hostFunctions,
+                onPresentation: this.options.onPresentation,
+                tickIntervalMs: this.options.clientTickIntervalMs ?? half.tickIntervalMs,
+            };
+        }
+        else {
+            const artifact = await this.options.playerCompute.artifactBytes({
+                ...this.scope(),
+                name: compiled.name,
+                versionId: compiled.versionId,
+            });
+            this.checkOperation(operation);
+            if (artifact.versionId !== compiled.versionId ||
+                !artifact.artifactHash ||
+                artifact.bytes.byteLength === 0) {
+                throw new Error('Client artifact did not match the compiled project version');
+            }
+            bytes = artifact.bytes;
+            brokerOptions = {
+                ...runtime,
+                artifactHash: artifact.artifactHash,
+                fuelPerDispatch: artifact.fuelPerDispatch,
+                onPresentation: this.options.onPresentation,
+                tickIntervalMs: this.options.clientTickIntervalMs ??
+                    parseClientTickIntervalMs(this.requireProject().files.find((file) => file.target === 'CLIENT' && file.path === 'Cargo.toml')?.content),
+            };
+        }
         const broker = this.options.brokerFactory?.(brokerOptions) ??
             new PlayerCodeBroker(brokerOptions);
-        await broker.start(artifact.bytes);
+        await broker.start(bytes);
         this.checkOperation(operation);
         const previous = this.broker;
         this.broker = broker;
@@ -1151,10 +1322,12 @@ export class CrowdyStudioController {
                 this.broker = null;
             }
         }
-        if (projectTargets(project.kind).includes('SERVER')) {
+        // On ck-exec a CLIENT-only project's CLIENT half rides a mod too: switched off, it is no
+        // longer served to visitors.
+        if (projectTargets(project.kind).includes('SERVER') || this.mods) {
             serverStopped = false;
             try {
-                await this.setServerEnabled(moduleNameFor(project, 'SERVER'), false);
+                await this.setServerEnabled(this.mods ? projectModName(project) : moduleNameFor(project, 'SERVER'), false);
                 serverStopped = true;
             }
             catch (error) {
@@ -1182,6 +1355,12 @@ export class CrowdyStudioController {
         if (!projectTargets(project.kind).includes('SERVER')) {
             throw new Error('Invoke requires a SERVER target');
         }
+        if (this.mods) {
+            const result = await this.callMod(moduleNameFor(project, 'SERVER'), exportName.trim() || 'state', paramsJson);
+            this.checkAgentOperation(agentOperation);
+            this.update({ invokeResult: result });
+            return result;
+        }
         const result = await this.options.playerCompute.invoke({
             ...this.scope(),
             moduleName: moduleNameFor(project, 'SERVER'),
@@ -1214,10 +1393,65 @@ export class CrowdyStudioController {
         else
             this.stopSurfacePolling();
     }
+    /**
+     * The mod's endpoint `method` with `paramsJson` as its arguments, through one exec
+     * connection to the mod (`mod:<name>`, keyed by the grid) that later calls reuse.
+     */
+    async callMod(name, method, paramsJson) {
+        const text = paramsJson?.trim();
+        let args = null;
+        if (text) {
+            try {
+                args = JSON.parse(text);
+            }
+            catch {
+                throw new Error('The call arguments must be JSON');
+            }
+        }
+        if (this.modConnection?.name !== name) {
+            this.closeModConnection();
+            const connection = this.mods.connect(this.options.appId, {
+                nodeType: modNodeType(name),
+                key: this.options.gridId,
+            });
+            connection.catch(() => {
+                if (this.modConnection?.connection === connection)
+                    this.modConnection = null;
+            });
+            this.modConnection = { name, connection };
+        }
+        const connection = await this.modConnection.connection;
+        const started = Date.now();
+        const value = await connection.call(modNodeType(name), this.options.gridId, method, args);
+        return {
+            resultJson: JSON.stringify(value ?? null, (_key, v) => typeof v === 'bigint' ? v.toString() : v),
+            durationUs: (Date.now() - started) * 1000,
+        };
+    }
+    closeModConnection() {
+        const open = this.modConnection;
+        this.modConnection = null;
+        void open?.connection.then((connection) => connection.close(), () => { });
+    }
     async refreshSurface(surface) {
         if (!this.state.project)
             return;
         const serverName = this.state.project.metadata.serverModuleName;
+        if (this.mods && surface !== 'usage') {
+            // ck-exec records no runs; a mod's log is its own `ctx.log` lines.
+            if (surface === 'runs') {
+                this.update({ runs: [] });
+                return;
+            }
+            const modName = projectModNameOrNull(this.state.project);
+            const lines = modName
+                ? await this.mods.modLogs(this.options.appId, this.options.gridId, modName, {
+                    limit: 50,
+                })
+                : [];
+            this.update({ logs: lines.map((line) => modLogRow(modName, line)) });
+            return;
+        }
         if (surface === 'runs') {
             this.update({
                 runs: await this.options.playerCompute.runs({
@@ -1239,11 +1473,14 @@ export class CrowdyStudioController {
             });
             return;
         }
+        // Player compute's units and compile quota, which nothing spends on ck-exec.
         const [usage, wallet] = await Promise.all([
-            this.options.playerCompute.usage({ appId: this.options.appId }),
+            !this.mods
+                ? this.options.playerCompute.usage({ appId: this.options.appId })
+                : Promise.resolve(null),
             this.options.playerWallet?.balance() ?? Promise.resolve(null),
         ]);
-        this.update({ usage: normalizeUsage(usage), wallet });
+        this.update({ usage: usage ? normalizeUsage(usage) : null, wallet });
     }
     destroy() {
         if (this.destroyed)
@@ -1254,6 +1491,7 @@ export class CrowdyStudioController {
         this.stopSurfacePolling();
         this.broker?.stop();
         this.broker = null;
+        this.closeModConnection();
         this.listeners.clear();
         this.humanEditListeners.clear();
     }
@@ -1499,6 +1737,67 @@ function sameFileRef(a, b) {
 function compareProjectFile(a, b) {
     return crowdyStudioFileKey(a.target, a.path).localeCompare(crowdyStudioFileKey(b.target, b.path));
 }
+/** The node type players call a mod by, as `execModType`. */
+function modNodeType(name) {
+    return `mod:${name}`;
+}
+/** What a mod build takes: `Cargo.toml`, `README.md` and Rust under `src/`. */
+function isModCrateFile(path) {
+    return (path === 'Cargo.toml' ||
+        path === 'README.md' ||
+        (path.startsWith('src/') && path.endsWith('.rs')));
+}
+function crateFiles(files) {
+    return files
+        .filter((file) => isModCrateFile(file.path))
+        .map((file) => ({ path: file.path, content: file.content }));
+}
+/** A build's crate name for a module: its own when it is one, else `mod-<name>`. */
+function crateName(name) {
+    return CRATE_NAME.test(name) ? name : `mod-${name}`;
+}
+/**
+ * The mod a ck-exec project runs as: its SERVER module's name, or for a CLIENT-only project the
+ * CLIENT module's, which names the mod its CLIENT half rides.
+ */
+function projectModName(project) {
+    return moduleNameFor(project, projectTargets(project.kind).includes('SERVER') ? 'SERVER' : 'CLIENT');
+}
+function projectModNameOrNull(project) {
+    try {
+        return projectModName(project);
+    }
+    catch {
+        return null;
+    }
+}
+/** Why a ck-exec project's mod name cannot be a mod's, or null. */
+function modNameProblem(project) {
+    const name = projectModName(project);
+    if (MOD_NAME.test(name))
+        return null;
+    return projectTargets(project.kind).includes('SERVER')
+        ? `The server module name '${name}' must be 1-48 lowercase letters, digits, - or _ to run as a mod`
+        : `The CLIENT module name '${name}' names the mod its CLIENT half rides, so it must be 1-48 lowercase letters, digits, - or _`;
+}
+const LEGACY_CLIENT_CRATE = 'This CLIENT crate depends on crowdy-compute-sdk, legacy player compute. On ck-exec a CLIENT ' +
+    'target is a mod\u2019s CLIENT half, one crowdy-client-sdk crate: in Cargo.toml replace the ' +
+    'crowdy-compute-sdk line with crowdy-client-sdk = "0.1.0", and in src/ use crowdy_client_sdk ' +
+    'in place of crowdy_compute_sdk. Its host calls are the same, less the Game Model and sessions.';
+function modLogRow(moduleName, line) {
+    const level = LOG_LEVELS[line.level] ?? 'debug';
+    return {
+        runId: line.id,
+        moduleName,
+        triggerSource: level,
+        startedAt: line.at,
+        durationUs: 0,
+        fuelUsed: '0',
+        success: level !== 'error',
+        errorMessage: line.text,
+        level,
+    };
+}
 function moduleNameFor(project, target) {
     const name = target === 'SERVER'
         ? project.metadata.serverModuleName

package/dist/crowdy-studio/dom-shell.d.ts.map

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

package/dist/crowdy-studio/dom-shell.js

@@ -274,12 +274,13 @@ export class CrowdyStudioDomShell {
             clientModuleName: this.clientModuleName.value,
         }));
         this.pairing.addEventListener('change', () => this.controller.setPairingPreference(this.pairing.value));
-        this.invokeExport = input('Export name');
-        this.invokeExport.value = 'invoke';
+        const onMod = controller.getState().serverEngine === 'ck-exec';
+        this.invokeExport = input(onMod ? 'Endpoint' : 'Export name');
+        this.invokeExport.value = onMod ? 'state' : 'invoke';
         this.invokeParams = document.createElement('textarea');
         this.invokeParams.placeholder = '{"example": true}';
-        this.invokeParams.setAttribute('aria-label', 'Invoke JSON parameters');
-        const invokeButton = button('Invoke server export');
+        this.invokeParams.setAttribute('aria-label', onMod ? 'Call arguments (JSON)' : 'Invoke JSON parameters');
+        const invokeButton = button(onMod ? 'Call mod endpoint' : 'Invoke server export');
         this.invokeResult = document.createElement('pre');
         const invokeControls = element('div', 'ck-crowdy-studio-invoke');
         invokeControls.append(this.invokeExport, this.invokeParams, invokeButton);
@@ -310,7 +311,9 @@ export class CrowdyStudioDomShell {
         this.renderProblems(state);
         this.renderBuild(state);
         this.renderRuntimeRows(this.logsPanel, state.logs);
-        this.renderRuntimeRows(this.runsPanel, state.runs);
+        this.renderRuntimeRows(this.runsPanel, state.runs, state.serverEngine === 'ck-exec'
+            ? 'A mod keeps no run records; its log lines are under Logs.'
+            : undefined);
         this.invokeResult.textContent = state.invokeResult
             ? formatInvokeResult(state.invokeResult)
             : '';
@@ -900,7 +903,9 @@ export class CrowdyStudioDomShell {
         setInputUnlessFocused(this.clientModuleName, project.metadata.clientModuleName ?? '');
         this.serverModuleName.disabled = !projectTargets(project.kind).includes('SERVER');
         this.clientModuleName.disabled = !projectTargets(project.kind).includes('CLIENT');
-        this.pairing.disabled = project.kind !== 'FULL_STACK';
+        // A mod has no pairing: its CLIENT half rides it.
+        this.pairing.disabled =
+            project.kind !== 'FULL_STACK' || state.serverEngine === 'ck-exec';
         this.pairing.value = project.metadata.pairingPreference;
     }
     renderProblems(state) {
@@ -959,15 +964,17 @@ export class CrowdyStudioDomShell {
         output.textContent = state.buildOutput || 'No build has run.';
         this.buildPanel.append(output);
     }
-    renderRuntimeRows(panel, rows) {
+    renderRuntimeRows(panel, rows, emptyText = 'No runtime records.') {
         panel.replaceChildren();
         if (rows.length === 0) {
-            panel.append(empty('No runtime records.'));
+            panel.append(empty(emptyText));
             return;
         }
         for (const row of rows) {
             const line = document.createElement('pre');
-            line.textContent = `${row.success ? '✓' : '✗'} ${row.startedAt} ${row.moduleName} ${row.triggerSource} · ${row.durationUs}µs · ${row.fuelUsed} fuel${row.errorMessage ? `\n${row.errorMessage}` : ''}`;
+            line.textContent = row.level
+                ? `${row.success ? '·' : '✗'} ${row.startedAt} ${row.moduleName} ${row.level}\n${row.errorMessage ?? ''}`
+                : `${row.success ? '✓' : '✗'} ${row.startedAt} ${row.moduleName} ${row.triggerSource} · ${row.durationUs}µs · ${row.fuelUsed} fuel${row.errorMessage ? `\n${row.errorMessage}` : ''}`;
             panel.append(line);
         }
     }

package/dist/crowdy-studio/embed/hud-layer.d.ts

@@ -1,5 +1,6 @@
 /**
- * A persistent, game-owned HUD layer for player-compute CLIENT mods. A
+ * A persistent, game-owned HUD layer for CLIENT mods (ck-exec CLIENT halves
+ * and legacy player-compute CLIENT modules). A
  * running client mod never touches the game DOM; it emits `hud_set` payloads
  * that the broker forwards here. This layer lives outside the studio panel so
  * a mod's HUD survives panel re-renders and keeps rendering after the coding

package/dist/crowdy-studio/embed/hud-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hud-layer.d.ts","sourceRoot":"","sources":["../../../src/crowdy-studio/embed/hud-layer.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,OAAO,CAAC,UAAU;IAUlB,+DAA+D;IAC/D,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAKtC,oEAAoE;IACpE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI;IAShE,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,SAAS;IAajB,mEAAmE;IACnE,OAAO,CAAC,QAAQ;CAQjB"}
+{"version":3,"file":"hud-layer.d.ts","sourceRoot":"","sources":["../../../src/crowdy-studio/embed/hud-layer.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,OAAO,CAAC,UAAU;IAUlB,+DAA+D;IAC/D,GAAG,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAKtC,oEAAoE;IACpE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI;IAShE,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,SAAS;IAajB,mEAAmE;IACnE,OAAO,CAAC,QAAQ;CAQjB"}