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

package/dist/grid-mods/exec-client-halves.d.ts

@@ -1,5 +1,5 @@
 import type { ExecAPI, ExecClientCapabilitySummary, ExecGridClientMod } from '../domains/exec.js';
-import { type PlayerCodeBrokerOptions, type PlayerCodeGridBounds, type PlayerCodeHostCall, type PlayerCodePresentation } from '../player-runtime/player-code-broker.js';
+import { type PlayerCodeBrokerOptions, type PlayerCodeGridBounds, type PlayerCodeHostCall, type PlayerCodeLogLine, type PlayerCodePresentation } from '../player-runtime/player-code-broker.js';
 /** The grid a player stands in: its id and chunk box. */
 export type ExecClientHalvesGrid = PlayerCodeGridBounds & {
     gridId: string;
@@ -48,6 +48,10 @@ export interface ExecClientHalfError {
 export interface ExecClientHalfBroker {
     start(artifact: ArrayBuffer): Promise<void>;
     stop(): void;
+    /** `PlayerCodeBroker.invoke`: the module's `handle_invoke`. */
+    invoke?(payload: Uint8Array, options?: {
+        timeoutMs?: number;
+    }): Promise<Uint8Array>;
 }
 export interface ExecClientHalvesOptions {
     exec: Pick<ExecAPI, 'gridClientMods' | 'consentClientMod' | 'trustAuthor' | 'modClientArtifactBytes'>;
@@ -60,6 +64,11 @@ export interface ExecClientHalvesOptions {
      */
     onHostCall: (call: PlayerCodeHostCall, mod: ExecGridClientMod) => Promise<unknown>;
     onPresentation?: (presentation: PlayerCodePresentation, mod: ExecGridClientMod) => void;
+    /**
+     * Each CLIENT half's `crowdy::log` lines, bounded by the broker (see
+     * `PlayerCodeBrokerOptions.onLog`). The text is the mod author's: render it as text.
+     */
+    onLog?: (line: PlayerCodeLogLine, mod: ExecGridClientMod) => void;
     /**
      * Asks the player about CLIENT halves they neither consented to nor trust the author of; true
      * consents. Without it, only what the player already agreed to runs. A declined question is
@@ -100,8 +109,7 @@ export interface ExecClientHalvesOptions {
  * that filled the cache; consent and trust are the listing's, on every refresh.
  *
  * `NOT_FOUND` (not served to this player now) and `RATE_LIMITED` hold that CLIENT half back for
- * a while instead of fetching on every refresh. The legacy grid-attached client mods
- * (`marketplace.gridClientMods`) are not this runner's.
+ * a while instead of fetching on every refresh.
  */
 export declare class ExecClientHalves {
     private readonly options;
@@ -123,6 +131,14 @@ export declare class ExecClientHalves {
      * when the grid's CLIENT halves cannot be listed, and what runs keeps running.
      */
     refresh(): Promise<void>;
+    /**
+     * Calls the `handle_invoke` export of the running CLIENT half of mod `modId` with `payload`
+     * and resolves with its reply bytes (see `PlayerCodeBroker.invoke`). Rejects when that CLIENT
+     * half is not running.
+     */
+    invoke(modId: string, payload: Uint8Array, options?: {
+        timeoutMs?: number;
+    }): Promise<Uint8Array>;
     /** Stops every CLIENT half and leaves the grid; the module cache stays. */
     stop(): void;
     private reconcile;

package/dist/grid-mods/exec-client-halves.d.ts.map

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

package/dist/grid-mods/exec-client-halves.js

@@ -30,8 +30,7 @@ function refusal(error) {
  * that filled the cache; consent and trust are the listing's, on every refresh.
  *
  * `NOT_FOUND` (not served to this player now) and `RATE_LIMITED` hold that CLIENT half back for
- * a while instead of fetching on every refresh. The legacy grid-attached client mods
- * (`marketplace.gridClientMods`) are not this runner's.
+ * a while instead of fetching on every refresh.
  */
 export class ExecClientHalves {
     constructor(options) {
@@ -74,6 +73,21 @@ export class ExecClientHalves {
         this.inFlight = { generation, done };
         return done;
     }
+    /**
+     * Calls the `handle_invoke` export of the running CLIENT half of mod `modId` with `payload`
+     * and resolves with its reply bytes (see `PlayerCodeBroker.invoke`). Rejects when that CLIENT
+     * half is not running.
+     */
+    invoke(modId, payload, options) {
+        const worker = this.workers.get(modId);
+        if (!worker?.started) {
+            return Promise.reject(new Error(`the CLIENT half of mod ${modId} is not running`));
+        }
+        if (!worker.broker.invoke) {
+            return Promise.reject(new Error('this broker cannot invoke its module'));
+        }
+        return worker.broker.invoke(payload, options);
+    }
     /** Stops every CLIENT half and leaves the grid; the module cache stays. */
     stop() {
         this.stopAll('stopped');
@@ -262,6 +276,7 @@ export class ExecClientHalves {
             consentedHostCalls: consented.filter((fn) => served.includes(fn)),
             onHostCall: (call) => this.options.onHostCall(call, mod),
             onPresentation: (presentation) => this.options.onPresentation?.(presentation, mod),
+            ...(this.options.onLog ? { onLog: (line) => this.options.onLog?.(line, mod) } : {}),
             onCircuitOpen: () => {
                 if (this.workers.get(mod.modId)?.broker !== broker)
                     return;

package/dist/grid-mods/grid-host-calls.d.ts

@@ -1,19 +1,32 @@
-import type { GridScope } from '../grid-scope.js';
+import type { GridChunk, GridScope } from '../grid-scope.js';
 import type { PlayerCodeHostCall } from '../player-runtime/player-code-broker.js';
+import type { AvatarsAPI } from '../domains/avatars.js';
 import type { ChunksAPI } from '../domains/chunks.js';
 import type { VoxelsAPI } from '../domains/voxels.js';
 import type { StateAPI } from '../domains/state.js';
-import type { GameModelAPI } from '../domains/gameModel.js';
 /**
- * Game-local fast paths. A game that already holds the world in memory (a
- * chunk store, an actor store) answers reads from there instead of a round
- * trip; anything it leaves out falls through to the server path.
+ * Game-local fast paths and knowledge. A game that already holds the world in memory (a chunk
+ * store, an actor store) answers reads from there instead of a round trip; anything it leaves
+ * out falls through to the server path. The calls only the game can answer (`actors_list*`,
+ * `avatar_state_get`, `grid_permission_check`, `pointer_clicks`) are refused without their
+ * hook.
  */
 export interface GridHostLocal {
     chunkVoxels?(x: bigint, y: bigint, z: bigint): {
         voxelsBase64: string | null;
     } | null;
     actorsInChunk?(x: bigint, y: bigint, z: bigint): Array<Record<string, unknown>>;
+    /**
+     * The chunk of the avatar's live actor, from the game's actor store, or null when the game
+     * sees none. `avatar_state_get` answers only for an avatar whose actor is inside the grid.
+     */
+    avatarChunk?(avatarId: string): GridChunk | null | undefined | Promise<GridChunk | null | undefined>;
+    /**
+     * The runtime permission keys the visiting player holds on this grid, as the game knows them
+     * (where Crowdy Studio's `targetPermissions` come from). `grid_permission_check` answers from
+     * these, for that player and this grid only; the server still enforces the permissions.
+     */
+    gridPermissionKeys?(): Iterable<string> | Promise<Iterable<string>>;
     setVoxel?(input: {
         chunk: {
             x: number;
@@ -36,15 +49,15 @@ export interface GridHostCallsOptions {
         chunks: ChunksAPI;
         voxels: VoxelsAPI;
         state: StateAPI;
-        gameModel: GameModelAPI;
+        /** For `avatar_state_get`, a public read (`avatarAppState`). */
+        avatars?: Pick<AvatarsAPI, 'appState'>;
     };
     local?: GridHostLocal;
     /**
-     * Let mods call Studio model functions as the player (`model_invoke`, the
-     * ordinary player authority path). Off by default: a game opts in when its
-     * functions are meant to be scriptable by visitors' mods.
+     * The visiting player's user id. `grid_permission_check` answers only about them, so without
+     * it the call is refused.
      */
-    allowModelInvoke?: boolean;
+    userId?: string;
     /**
      * Channels a mod may post to. Default: the grid's own channels only (the
      * server rule for grid code). A game may widen it to channels the player
@@ -60,13 +73,12 @@ export declare class GridHostCallRefused extends Error {
     constructor(fn: string, reason?: string);
 }
 /**
- * The page-side answer to every CLIENT host call in the platform catalog,
- * through ordinary CrowdyJS confined to one grid (DN-10 §4). Hand the result
- * to `PlayerCodeBroker({ onHostCall })`; the broker has already applied the
- * allowlist, rate caps and chunk clamps, and answers `grid_info`, `emit_event`,
- * `hud_set` and `overlay_draw` itself. A ck-exec CLIENT half (`engine:
- * 'ck-exec'`) reaches only the crowdy-client-sdk calls: the model and sessions
- * cases below serve legacy CLIENT modules until 18.0.
+ * The page-side answer to a CLIENT half's host calls (`EXEC_CLIENT_HOST_CALLS`,
+ * what crowdy-client-sdk wraps), through ordinary CrowdyJS confined to one grid
+ * (DN-10 §4). Hand the result to `PlayerCodeBroker({ onHostCall })`; the broker
+ * has already applied the allowlist, the player's consent, rate caps and chunk
+ * clamps, and answers `grid_info`, `emit_event`, `hud_set` and `overlay_draw`
+ * itself.
  */
 export declare function createGridHostCalls(options: GridHostCallsOptions): (call: PlayerCodeHostCall) => Promise<unknown>;
 //# sourceMappingURL=grid-host-calls.d.ts.map

package/dist/grid-mods/grid-host-calls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grid-host-calls.d.ts","sourceRoot":"","sources":["../../src/grid-mods/grid-host-calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACtF,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChF,QAAQ,CAAC,CAAC,KAAK,EAAE;QACf,KAAK,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3C,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,kBAAkB,CAAC,IAAI,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,KAAK,EAAE,SAAS,CAAC;IACjB,wEAAwE;IACxE,MAAM,EAAE;QACN,MAAM,EAAE,SAAS,CAAC;QAClB,MAAM,EAAE,SAAS,CAAC;QAClB,KAAK,EAAE,QAAQ,CAAC;QAChB,SAAS,EAAE,YAAY,CAAC;KACzB,CAAC;IACF,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sEAAsE;AACtE,qBAAa,mBAAoB,SAAQ,KAAK;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM;gBAAV,EAAE,EAAE,MAAM,EAAE,MAAM,SAA+B;CAIvE;AAID;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,GAC5B,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CA+KhD"}
+{"version":3,"file":"grid-host-calls.d.ts","sourceRoot":"","sources":["../../src/grid-mods/grid-host-calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACtF,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChF;;;OAGG;IACH,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACrG;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,CAAC,KAAK,EAAE;QACf,KAAK,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3C,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,kBAAkB,CAAC,IAAI,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,KAAK,EAAE,SAAS,CAAC;IACjB,wEAAwE;IACxE,MAAM,EAAE;QACN,MAAM,EAAE,SAAS,CAAC;QAClB,MAAM,EAAE,SAAS,CAAC;QAClB,KAAK,EAAE,QAAQ,CAAC;QAChB,gEAAgE;QAChE,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;KACxC,CAAC;IACF,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sEAAsE;AACtE,qBAAa,mBAAoB,SAAQ,KAAK;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM;gBAAV,EAAE,EAAE,MAAM,EAAE,MAAM,SAA+B;CAIvE;AAID;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,GAC5B,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CA6JhD"}

package/dist/grid-mods/grid-host-calls.js

@@ -8,13 +8,12 @@ export class GridHostCallRefused extends Error {
 }
 const SPATIAL_KINDS = new Set(['actor', 'client_event', 'server_event', 'text']);
 /**
- * The page-side answer to every CLIENT host call in the platform catalog,
- * through ordinary CrowdyJS confined to one grid (DN-10 §4). Hand the result
- * to `PlayerCodeBroker({ onHostCall })`; the broker has already applied the
- * allowlist, rate caps and chunk clamps, and answers `grid_info`, `emit_event`,
- * `hud_set` and `overlay_draw` itself. A ck-exec CLIENT half (`engine:
- * 'ck-exec'`) reaches only the crowdy-client-sdk calls: the model and sessions
- * cases below serve legacy CLIENT modules until 18.0.
+ * The page-side answer to a CLIENT half's host calls (`EXEC_CLIENT_HOST_CALLS`,
+ * what crowdy-client-sdk wraps), through ordinary CrowdyJS confined to one grid
+ * (DN-10 §4). Hand the result to `PlayerCodeBroker({ onHostCall })`; the broker
+ * has already applied the allowlist, the player's consent, rate caps and chunk
+ * clamps, and answers `grid_info`, `emit_event`, `hud_set` and `overlay_draw`
+ * itself.
  */
 export function createGridHostCalls(options) {
     const { scope, client, local } = options;
@@ -134,44 +133,35 @@ export function createGridHostCalls(options) {
                 }
                 return scope.channels.send(channelId, uuid(args), String(args.payloadBase64 ?? ''));
             }
-            case 'container_create':
-                return scope.model.create({
-                    typeKey: typeof args.typeName === 'string' ? args.typeName : undefined,
-                    displayName: typeof args.displayName === 'string' ? args.displayName : undefined,
-                    stateJson: JSON.stringify(args.state ?? args.properties ?? {}),
-                });
-            case 'container_get':
-                return scope.model.container(String(args.containerId));
-            case 'container_get_by_key':
-                // Binding keys are a server game-model concept. Grid containers have none.
-                throw new GridHostCallRefused(fn, 'server-only');
-            case 'container_get_batch': {
-                const ids = Array.isArray(args.containerIds) ? args.containerIds.slice(0, 32) : [];
-                const found = await Promise.all(ids.map((id) => scope.model.container(String(id)).catch(() => null)));
-                return found.filter((c) => c != null);
+            case 'avatar_state_get': {
+                const avatarId = decimalId(args.avatarId);
+                if (!avatarId)
+                    throw new GridHostCallRefused(fn, 'needs an avatar id');
+                if (!local?.avatarChunk || !client.avatars)
+                    throw new GridHostCallRefused(fn);
+                const at = await local.avatarChunk(avatarId);
+                if (!at || !scope.contains(at)) {
+                    throw new GridHostCallRefused(fn, 'names an avatar with no live actor in this grid');
+                }
+                return client.avatars.appState(appId, avatarId);
             }
-            case 'containers_list':
-                return scope.model.containers();
-            case 'container_delete':
-                return scope.model.delete(String(args.containerId));
-            case 'property_set':
-                return scope.model.set({
-                    containerId: String(args.containerId),
-                    propertyKey: String(args.key),
-                    valueJson: JSON.stringify(args.value ?? null),
-                });
-            case 'model_invoke':
-                if (!options.allowModelInvoke)
+            case 'grid_permission_check': {
+                const player = decimalId(options.userId);
+                if (!local?.gridPermissionKeys || !player)
                     throw new GridHostCallRefused(fn);
-                return client.gameModel.invoke({
-                    appId,
-                    functionName: String(args.functionName),
-                    selfContainerId: String(args.selfContainerId),
-                    paramsJson: JSON.stringify(args.params ?? {}),
-                    ...(typeof args.sessionId === 'string' ? { sessionId: args.sessionId } : {}),
-                });
-            case 'sessions_list':
-                return scope.sessions.list(typeof args.status === 'string' ? { status: args.status } : {});
+                const gridId = decimalId(args.gridId);
+                if (!gridId || gridId !== decimalId(scope.gridId)) {
+                    throw new GridHostCallRefused(fn, 'names another grid');
+                }
+                if (decimalId(args.userId) !== player) {
+                    throw new GridHostCallRefused(fn, 'asks about another player');
+                }
+                const key = args.permissionKey;
+                if (typeof key !== 'string' || !PERMISSION_KEY.test(key)) {
+                    throw new GridHostCallRefused(fn, 'needs a permission key');
+                }
+                return new Set(await local.gridPermissionKeys()).has(key);
+            }
             case 'user_state_get':
                 return client.state.getOne(appId);
             case 'user_state_set':
@@ -184,13 +174,17 @@ export function createGridHostCalls(options) {
                     throw new GridHostCallRefused(fn);
                 return local.drainPointerClicks();
             default:
-                // edge_*, grid_state_*, avatar_state_get and grid_permission_check have
-                // no browser GraphQL surface yet: the server host answers them for
-                // SERVER mods.
                 throw new GridHostCallRefused(fn);
         }
     };
 }
+/** As the runtime permission keys (`runtimePermissions`): lowercase, digits and `_`. */
+const PERMISSION_KEY = /^[a-z][a-z0-9_]{0,63}$/;
+/** A positive decimal id (BigInt as a decimal string, or a safe integer), normalized; else null. */
+function decimalId(value) {
+    const text = typeof value === 'string' ? value : typeof value === 'number' && Number.isSafeInteger(value) ? String(value) : '';
+    return /^[1-9][0-9]{0,19}$/.test(text) ? text : null;
+}
 function coords(x, y, z) {
     return [BigInt(x), BigInt(y), BigInt(z)];
 }

package/dist/grid-mods/mod-runtime.d.ts

@@ -1,23 +1,23 @@
-import { type PlayerCodeEngine, type PlayerCodePresentation } from '../player-runtime/player-code-broker.js';
+import { type PlayerCodeEngine, type PlayerCodeLogLine, type PlayerCodePresentation } from '../player-runtime/player-code-broker.js';
 import type { GridProgramPort } from '../grid-program/protocol.js';
 import type { GridScope } from '../grid-scope.js';
 import { type GridHostCallsOptions, type GridHostLocal } from './grid-host-calls.js';
 /**
- * A Rust CLIENT mod: platform-built WASM run in the tokenless glue worker. A ck-exec mod's
- * CLIENT half is `engine: 'ck-exec'` with the `digest`, `fuelPerDispatch`, `tickIntervalMs` and
- * summary host calls of `exec.modClientArtifactBytes` (`ExecClientHalves` runs a whole grid's).
+ * A ck-exec mod's CLIENT half: platform-built WASM run in the tokenless glue worker, with the
+ * `digest` (as `artifactHash`), `fuelPerDispatch`, `tickIntervalMs` and summary host calls of
+ * `exec.modClientArtifactBytes` (`ExecClientHalves` runs a whole grid's).
  */
 export interface WasmGridModSpec {
     kind: 'wasm';
     moduleName: string;
     artifact: ArrayBuffer;
-    artifactHash?: string;
-    fuelPerDispatch?: bigint;
+    artifactHash: string;
+    fuelPerDispatch: bigint;
     tickIntervalMs?: number;
-    /** Default `'player-compute'`, a legacy CLIENT module. */
+    /** `'ck-exec'`, the only engine. */
     engine?: PlayerCodeEngine;
-    /** A CLIENT half's `capabilitySummary.hostFunctions`; required with `engine: 'ck-exec'`. */
-    consentedHostCalls?: readonly string[];
+    /** The CLIENT half's `capabilitySummary.hostFunctions` the player consented to. */
+    consentedHostCalls: readonly string[];
     /** The platform glue worker URL (`@crowdedkingdoms/crowdyjs/player-glue-worker`). */
     workerUrl: string | URL;
 }
@@ -40,18 +40,25 @@ export interface StartGridModOptions {
     graphqlUrl?: string;
     graphqlWsUrl?: string;
     local?: GridHostLocal;
-    allowModelInvoke?: boolean;
+    /** Forwarded to `createGridHostCalls`: the visiting player, for `grid_permission_check`. */
+    userId?: string;
     onPresentation?: (presentation: PlayerCodePresentation) => void;
+    /** A CLIENT half's `crowdy::log` lines, bounded by the broker. Render them as text. */
+    onLog?: (line: PlayerCodeLogLine) => void;
     onStopped?: (reason: string) => void;
 }
 export interface RunningGridMod {
     kind: GridModSpec['kind'];
     moduleName: string;
     stop(): void;
+    /** A CLIENT half's `handle_invoke` (`PlayerCodeBroker.invoke`); absent for a grid program. */
+    invoke?(payload: Uint8Array, options?: {
+        timeoutMs?: number;
+    }): Promise<Uint8Array>;
 }
 /**
  * One way to run player code inside a grid, whatever it is written in (DN-10
- * §4-5). Rust CLIENT mods get the full client host catalog through
+ * §4-5). A ck-exec CLIENT half gets the host calls it was consented through
  * {@link createGridHostCalls}; JS grid programs get real CrowdyJS through a
  * grid-token relay. Both are confined to `scope`'s grid, locally for UX and by
  * the server for authority.

package/dist/grid-mods/mod-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod-runtime.d.ts","sourceRoot":"","sources":["../../src/grid-mods/mod-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC5B,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,qFAAqF;IACrF,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,qFAAqF;IACrF,KAAK,EAAE,SAAS,CAAC;IACjB,iEAAiE;IACjE,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACvC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAChE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CA6CzB"}
+{"version":3,"file":"mod-runtime.d.ts","sourceRoot":"","sources":["../../src/grid-mods/mod-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC5B,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,mFAAmF;IACnF,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,qFAAqF;IACrF,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,qFAAqF;IACrF,KAAK,EAAE,SAAS,CAAC;IACjB,iEAAiE;IACjE,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACvC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAChE,uFAAuF;IACvF,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC1C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,IAAI,IAAI,CAAC;IACb,8FAA8F;IAC9F,MAAM,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACrF;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CA+CzB"}

package/dist/grid-mods/mod-runtime.js

@@ -3,7 +3,7 @@ import { hostGridProgram } from '../grid-program/host.js';
 import { createGridHostCalls, } from './grid-host-calls.js';
 /**
  * One way to run player code inside a grid, whatever it is written in (DN-10
- * §4-5). Rust CLIENT mods get the full client host catalog through
+ * §4-5). A ck-exec CLIENT half gets the host calls it was consented through
  * {@link createGridHostCalls}; JS grid programs get real CrowdyJS through a
  * grid-token relay. Both are confined to `scope`'s grid, locally for UX and by
  * the server for authority.
@@ -27,9 +27,10 @@ export async function startGridMod(options) {
                 scope,
                 client: options.client,
                 local: options.local,
-                allowModelInvoke: options.allowModelInvoke,
+                ...(options.userId !== undefined ? { userId: options.userId } : {}),
             }),
             onPresentation: options.onPresentation,
+            onLog: options.onLog,
             onCircuitOpen: (reason) => options.onStopped?.(reason),
         });
         await broker.start(spec.artifact);
@@ -37,6 +38,7 @@ export async function startGridMod(options) {
             kind: 'wasm',
             moduleName: spec.moduleName,
             stop: () => broker.stop(),
+            invoke: (payload, invokeOptions) => broker.invoke(payload, invokeOptions),
         };
     }
     if (!options.graphqlUrl || !options.graphqlWsUrl) {

package/dist/grid-scope.d.ts

@@ -1,11 +1,6 @@
 import type { GridsAPI, GridChannel, GridToken } from './domains/grids.js';
-import type { GameModelAPI } from './domains/gameModel.js';
-import type { PlayerModelAPI } from './domains/playerModel.js';
-import type { PlayerComputeAPI } from './domains/playerCompute.js';
 import type { ChannelsAPI } from './domains/channels.js';
 import type { UdpAPI } from './domains/udp.js';
-import type { MarketplaceAPI } from './domains/marketplace.js';
-import type { GameModelCreateSessionMutationVariables, PlayerComputeDeployMutationVariables, PlayerModelCreateContainerMutationVariables, PlayerModelSetPropertyMutationVariables } from './generated/graphql.js';
 /** A chunk address as CrowdyJS passes it on the wire (decimal strings). */
 export interface GridChunk {
     x: string | number | bigint;
@@ -27,12 +22,8 @@ export interface GridBox {
 /** The domain clients a GridScope binds (a CrowdyClient satisfies this). */
 export interface GridScopeClients {
     grids: GridsAPI;
-    gameModel: GameModelAPI;
-    playerModel: PlayerModelAPI;
-    playerCompute: PlayerComputeAPI;
     channels: ChannelsAPI;
     udp: UdpAPI;
-    marketplace: MarketplaceAPI;
 }
 /** Thrown locally, before any request, when a call would leave the grid. */
 export declare class GridScopeError extends Error {
@@ -102,186 +93,6 @@ export declare class GridScope {
         leave: (channelId: string) => Promise<boolean>;
         send: (channelId: string, uuid: string, payloadBase64: string) => Promise<boolean>;
     };
-    /** Sessions hosted inside this grid (games within the game). */
-    readonly sessions: {
-        list: (options?: {
-            status?: string;
-            limit?: number;
-        }) => Promise<{
-            __typename?: "GmSession";
-            sessionId: string;
-            appId: string;
-            name: string | null;
-            status: string;
-            createdByUserId: string | null;
-            currentTurnUserId: string | null;
-            metadataJson: string;
-            admission: string;
-            maxParticipants: number | null;
-            participantCount: number;
-            hostUserId: string | null;
-            hostTerm: number;
-            revision: string;
-            endedAt: string | null;
-            endReason: string | null;
-            createdAt: string;
-            presence: string;
-            gridId: string | null;
-            seededContainerCount: number | null;
-        }[]>;
-        create: (input?: Omit<GameModelCreateSessionMutationVariables["input"], "appId" | "gridId">) => Promise<{
-            __typename?: "GmSession";
-            sessionId: string;
-            appId: string;
-            name: string | null;
-            status: string;
-            createdByUserId: string | null;
-            currentTurnUserId: string | null;
-            metadataJson: string;
-            admission: string;
-            maxParticipants: number | null;
-            participantCount: number;
-            hostUserId: string | null;
-            hostTerm: number;
-            revision: string;
-            endedAt: string | null;
-            endReason: string | null;
-            createdAt: string;
-            presence: string;
-            gridId: string | null;
-            seededContainerCount: number | null;
-        }>;
-        join: (sessionId: string, options?: {
-            role?: string;
-            actorUuid?: string;
-        }) => Promise<{
-            __typename?: "GmSessionParticipant";
-            sessionId: string;
-            userId: string;
-            role: string;
-            state: string;
-            incarnation: number;
-            actorUuid: string | null;
-            joinedAt: string;
-            leftAt: string | null;
-            leftReason: string | null;
-        }>;
-        leave: (sessionId: string, incarnation: number) => Promise<{
-            __typename?: "GmSessionParticipant";
-            sessionId: string;
-            userId: string;
-            role: string;
-            state: string;
-            incarnation: number;
-            actorUuid: string | null;
-            joinedAt: string;
-            leftAt: string | null;
-            leftReason: string | null;
-        }>;
-    };
-    /** The player-tier Game Model of this grid. */
-    readonly model: {
-        containers: () => Promise<{
-            __typename?: "PlayerModelContainer";
-            containerId: string;
-            appId: string;
-            gridId: string;
-            ownerUserId: string;
-            typeKey: string;
-            displayName: string | null;
-            stateJson: string;
-            propertiesJson: string;
-            createdAt: string;
-            updatedAt: string;
-        }[]>;
-        container: (containerId: string) => Promise<{
-            __typename?: "PlayerModelContainer";
-            containerId: string;
-            appId: string;
-            gridId: string;
-            ownerUserId: string;
-            typeKey: string;
-            displayName: string | null;
-            stateJson: string;
-            propertiesJson: string;
-            createdAt: string;
-            updatedAt: string;
-        } | null>;
-        create: (input: Omit<PlayerModelCreateContainerMutationVariables["input"], "appId" | "gridId">) => Promise<{
-            __typename?: "PlayerModelContainer";
-            containerId: string;
-            appId: string;
-            gridId: string;
-            ownerUserId: string;
-            typeKey: string;
-            displayName: string | null;
-            stateJson: string;
-            propertiesJson: string;
-            createdAt: string;
-            updatedAt: string;
-        }>;
-        set: (input: Omit<PlayerModelSetPropertyMutationVariables["input"], "appId" | "gridId">) => Promise<{
-            __typename?: "PlayerModelContainer";
-            containerId: string;
-            appId: string;
-            gridId: string;
-            ownerUserId: string;
-            typeKey: string;
-            displayName: string | null;
-            stateJson: string;
-            propertiesJson: string;
-            createdAt: string;
-            updatedAt: string;
-        }>;
-        delete: (containerId: string) => Promise<boolean>;
-    };
-    /** Player compute on this grid (SERVER/CLIENT modules). */
-    readonly compute: {
-        deploy: (input: Omit<PlayerComputeDeployMutationVariables["input"], "appId" | "gridId">) => Promise<{
-            __typename?: "PlayerWasmModuleVersion";
-            versionId: string;
-            moduleId: string;
-            versionNo: number;
-            target: import("./index.js").PlayerComputeTarget;
-            sourceFilesJson: string | null;
-            openSource: boolean;
-            compileStatus: string;
-            compileLog: string | null;
-            compiledSizeBytes: string | null;
-            projectId: string | null;
-            sourceRevision: string | null;
-            githubCommitSha: string | null;
-            createdAt: string;
-        }>;
-        invoke: (moduleName: string, exportName: string, params?: unknown) => Promise<{
-            __typename?: "PlayerComputeInvokeResult";
-            resultBase64: string;
-            resultJson: string | null;
-            fuelUsed: string;
-            durationUs: number;
-        }>;
-        /** @deprecated Superseded by `client.exec.gridClientMods(appId, gridId)`; removed in 18.0. */
-        clientMods: () => Promise<{
-            __typename?: "GridClientMod";
-            attachmentId: string;
-            listingId: string | null;
-            listingName: string;
-            versionId: string | null;
-            sourceKind: string;
-            authorKind: import("./generated/graphql.js").PlayerCodeOwnerKind;
-            authorRef: string;
-            serverVersionId: string | null;
-            clientVersionId: string | null;
-            clientArtifactHash: string;
-            gridId: string;
-            capabilitySummaryJson: string;
-            capabilityHash: string;
-            authorCapabilitySummaryJson: string;
-            authorCapabilityHash: string;
-            callerConsented: boolean;
-            callerTrustsAuthor: boolean;
-        }[]>;
-    };
     /**
      * Replication that ORIGINATES in the grid. Each send checks its chunk
      * locally, then goes out as the ordinary udp call; reach still follows

package/dist/grid-scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grid-scope.d.ts","sourceRoot":"","sources":["../src/grid-scope.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"grid-scope.d.ts","sourceRoot":"","sources":["../src/grid-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,2EAA2E;AAC3E,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5B,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5B,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,WAAW,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,4EAA4E;AAC5E,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;GASG;AACH,qBAAa,SAAS;IAIlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM;IALzB,OAAO,CAAC,GAAG,CAAiB;gBAGT,OAAO,EAAE,gBAAgB,EACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACvB,GAAG,CAAC,EAAE,OAAO;IAKf,uEAAuE;IACvE,IAAI,MAAM,IAAI,OAAO,GAAG,IAAI,CAE3B;IAED,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAgBnC,6EAA6E;IAC7E,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAatC,mEAAmE;IAC7D,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAqBxD,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ;oBACL,OAAO,CAAC,WAAW,EAAE,CAAC;uBAGxB,MAAM,YACH;YAAE,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;YAAC,cAAc,CAAC,EAAE,OAAO,CAAA;SAAE;;;;;;;;;;;;;;0BAQtE,MAAM;;;;;;;;0BAkCim+jB,CAAC;;;;;;;;2BAjCvm+jB,MAAM;0BACP,MAAM,QAAQ,MAAM,iBAAiB,MAAM;MAM7D;IAEF;;;;OAIG;IACH,QAAQ,CAAC,IAAI;6BACU,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;6BAIvD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;sBAI9D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;6BAI/C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;MAI5E;CACH"}