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

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

@@ -0,0 +1,140 @@
+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';
+/** The grid a player stands in: its id and chunk box. */
+export type ExecClientHalvesGrid = PlayerCodeGridBounds & {
+    gridId: string;
+};
+/**
+ * One question for the player. `author`: trust every CLIENT half of `authorId` on the grid, at
+ * the hash of their union (`exec.trustAuthor`). `mod`: consent to one CLIENT half at its hash
+ * (`exec.consentClientMod`).
+ */
+export interface ExecClientHalfPrompt {
+    kind: 'author' | 'mod';
+    gridId: string;
+    authorId: string;
+    /** What a yes consents to: the author's `authorCapabilityHash`, or the mod's `capabilityHash`. */
+    capabilityHash: string;
+    /** The summary to show: the author's union, or the one CLIENT half's. */
+    capabilitySummaryJson: string;
+    capabilitySummary: ExecClientCapabilitySummary | null;
+    /** The CLIENT halves a yes covers now. */
+    mods: readonly ExecGridClientMod[];
+}
+/**
+ * Why a CLIENT half stopped: no longer listed (`removed`), a new digest, capability hash or tick
+ * interval (`changed`), listed without the player's consent or trust (`unconsented`), refused by
+ * `filter` (`filtered`), the runner left the grid (`left-grid`) or was stopped (`stopped`), or
+ * the broker's circuit breaker tripped (`circuit-open`).
+ */
+export type ExecClientHalfStopReason = 'removed' | 'changed' | 'unconsented' | 'filtered' | 'left-grid' | 'stopped' | 'circuit-open';
+/** A consent, fetch or start that failed, and when that CLIENT half is tried again. */
+export interface ExecClientHalfError {
+    mod: ExecGridClientMod;
+    stage: 'consent' | 'fetch' | 'start';
+    /**
+     * `not-found`: not served to the player now (every refusal of the artifact, and a trust while
+     * not standing in the grid); `rate-limited`: 12 fetches a minute per player and mod;
+     * `conflict`: the hash moved on; `refused`: the served module was, for bytes that differ from
+     * its digest, an unknown CLIENT ABI or a capability summary that does not parse; `failed`:
+     * anything else.
+     */
+    reason: 'not-found' | 'rate-limited' | 'conflict' | 'refused' | 'failed';
+    error: unknown;
+    /** When the runner fetches or starts it again (epoch ms); absent for a consent. */
+    retryAt?: number;
+}
+/** The part of `PlayerCodeBroker` the runner drives. */
+export interface ExecClientHalfBroker {
+    start(artifact: ArrayBuffer): Promise<void>;
+    stop(): void;
+}
+export interface ExecClientHalvesOptions {
+    exec: Pick<ExecAPI, 'gridClientMods' | 'consentClientMod' | 'trustAuthor' | 'modClientArtifactBytes'>;
+    appId: string;
+    /** The platform glue worker (`@crowdedkingdoms/crowdyjs/player-glue-worker`), same origin. */
+    workerUrl: string | URL;
+    /**
+     * Answers the host calls a CLIENT half makes that the broker does not answer itself, for
+     * example with `createGridHostCalls` over the grid's scope.
+     */
+    onHostCall: (call: PlayerCodeHostCall, mod: ExecGridClientMod) => Promise<unknown>;
+    onPresentation?: (presentation: PlayerCodePresentation, 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
+     * not asked again on this grid until its hash changes.
+     */
+    confirm?: (prompt: ExecClientHalfPrompt) => boolean | Promise<boolean>;
+    /** `author` (the default): one question per author; `mod`: one per CLIENT half. */
+    ask?: 'author' | 'mod';
+    /** Leaves out the CLIENT halves it returns false for, e.g. the one Crowdy Studio previews. */
+    filter?: (mod: ExecGridClientMod) => boolean;
+    onStarted?: (mod: ExecGridClientMod) => void;
+    onStopped?: (mod: ExecGridClientMod, reason: ExecClientHalfStopReason) => void;
+    onError?: (error: ExecClientHalfError) => void;
+    /** How long a CLIENT half waits after `NOT_FOUND` before it is fetched again. Default 15 s. */
+    notFoundRetryMs?: number;
+    /** How long after `RATE_LIMITED`. Default 60 s, the limit's window. */
+    rateLimitedRetryMs?: number;
+    /** How long after any other failure, refused bytes included. Default 60 s. */
+    failedRetryMs?: number;
+    /** Modules kept by digest, across grids. Default 16. */
+    cacheSize?: number;
+    now?: () => number;
+    brokerFactory?: (options: PlayerCodeBrokerOptions) => ExecClientHalfBroker;
+}
+/**
+ * Runs the CLIENT halves of ck-exec mods that the grid a player stands in serves, the way a game
+ * should: tell it the grid ({@link enterGrid}) and call {@link refresh} on a cadence (every 10 s
+ * or so). Each refresh lists the grid's CLIENT halves (`exec.gridClientMods`), stops the workers
+ * whose mod is gone or whose `modId`, `digest`, `capabilityHash` or tick interval changed, asks
+ * the player once per author (or per CLIENT half) about the rest, fetches each consented one
+ * (`exec.modClientArtifactBytes`, which refuses bytes that differ from their digest) and runs it
+ * in a `PlayerCodeBroker` with `engine: 'ck-exec'`, its fuel budget and tick interval, bounded
+ * to the host calls of the capability summary the player consented to.
+ *
+ * Modules are cached by digest, since a digest never changes its bytes and the artifact query
+ * allows 12 fetches a minute per player and mod. A cached module starts without a fetch, so the
+ * serve checks that query makes (`run_client_code`, standing in the grid) are those of the fetch
+ * 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.
+ */
+export declare class ExecClientHalves {
+    private readonly options;
+    private grid;
+    private generation;
+    private readonly workers;
+    private readonly cache;
+    private readonly retryAt;
+    private readonly declined;
+    private readonly approved;
+    private inFlight;
+    constructor(options: ExecClientHalvesOptions);
+    /** The grid the player stands in, or null. Any change stops every CLIENT half of the old one. */
+    enterGrid(grid: ExecClientHalvesGrid | null): void;
+    /** The CLIENT halves running now. */
+    get running(): readonly ExecGridClientMod[];
+    /**
+     * One reconcile of the current grid; a call while one runs for the same grid joins it. Rejects
+     * when the grid's CLIENT halves cannot be listed, and what runs keeps running.
+     */
+    refresh(): Promise<void>;
+    /** Stops every CLIENT half and leaves the grid; the module cache stays. */
+    stop(): void;
+    private reconcile;
+    private stopStale;
+    /** Asks about what the player has not agreed to; true when a consent or trust went through. */
+    private askAbout;
+    private start;
+    private fail;
+    private remember;
+    private wanted;
+    private stopWorker;
+    private stopAll;
+    private now;
+}
+//# sourceMappingURL=exec-client-halves.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,341 @@
+import { CrowdyGraphQLError, CrowdyProtocolError } from '../errors.js';
+import { PlayerCodeBroker, } from '../player-runtime/player-code-broker.js';
+const identity = (m) => `${m.modId}\u0000${m.digest}\u0000${m.capabilityHash}\u0000${m.tickIntervalMs}`;
+function refusal(error) {
+    if (error instanceof CrowdyProtocolError)
+        return 'refused';
+    if (error instanceof CrowdyGraphQLError) {
+        if (error.code === 'NOT_FOUND')
+            return 'not-found';
+        if (error.code === 'RATE_LIMITED')
+            return 'rate-limited';
+        if (error.code === 'CONFLICT')
+            return 'conflict';
+    }
+    return 'failed';
+}
+/**
+ * Runs the CLIENT halves of ck-exec mods that the grid a player stands in serves, the way a game
+ * should: tell it the grid ({@link enterGrid}) and call {@link refresh} on a cadence (every 10 s
+ * or so). Each refresh lists the grid's CLIENT halves (`exec.gridClientMods`), stops the workers
+ * whose mod is gone or whose `modId`, `digest`, `capabilityHash` or tick interval changed, asks
+ * the player once per author (or per CLIENT half) about the rest, fetches each consented one
+ * (`exec.modClientArtifactBytes`, which refuses bytes that differ from their digest) and runs it
+ * in a `PlayerCodeBroker` with `engine: 'ck-exec'`, its fuel budget and tick interval, bounded
+ * to the host calls of the capability summary the player consented to.
+ *
+ * Modules are cached by digest, since a digest never changes its bytes and the artifact query
+ * allows 12 fetches a minute per player and mod. A cached module starts without a fetch, so the
+ * serve checks that query makes (`run_client_code`, standing in the grid) are those of the fetch
+ * 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.
+ */
+export class ExecClientHalves {
+    constructor(options) {
+        this.options = options;
+        this.grid = null;
+        this.generation = 0;
+        this.workers = new Map();
+        this.cache = new Map();
+        this.retryAt = new Map();
+        this.declined = new Set();
+        this.approved = new Set();
+        this.inFlight = null;
+    }
+    /** The grid the player stands in, or null. Any change stops every CLIENT half of the old one. */
+    enterGrid(grid) {
+        if (sameGrid(this.grid, grid))
+            return;
+        this.stopAll('left-grid');
+        this.grid = grid ? { ...grid } : null;
+        this.generation++;
+        this.declined.clear();
+        this.approved.clear();
+    }
+    /** The CLIENT halves running now. */
+    get running() {
+        return [...this.workers.values()].filter((w) => w.started).map((w) => w.mod);
+    }
+    /**
+     * One reconcile of the current grid; a call while one runs for the same grid joins it. Rejects
+     * when the grid's CLIENT halves cannot be listed, and what runs keeps running.
+     */
+    refresh() {
+        if (this.inFlight?.generation === this.generation)
+            return this.inFlight.done;
+        const generation = this.generation;
+        const done = this.reconcile(generation).finally(() => {
+            if (this.inFlight?.done === done)
+                this.inFlight = null;
+        });
+        this.inFlight = { generation, done };
+        return done;
+    }
+    /** Stops every CLIENT half and leaves the grid; the module cache stays. */
+    stop() {
+        this.stopAll('stopped');
+        this.grid = null;
+        this.generation++;
+        this.declined.clear();
+        this.approved.clear();
+    }
+    async reconcile(generation) {
+        const grid = this.grid;
+        if (!grid)
+            return;
+        const { exec, appId } = this.options;
+        const current = () => generation === this.generation;
+        let listed = await exec.gridClientMods(appId, grid.gridId);
+        if (!current())
+            return;
+        this.stopStale(listed);
+        if (await this.askAbout(listed, grid, current)) {
+            if (!current())
+                return;
+            listed = await exec.gridClientMods(appId, grid.gridId);
+            if (!current())
+                return;
+            this.stopStale(listed);
+        }
+        for (const mod of listed) {
+            if (!current())
+                return;
+            if (!this.wanted(mod) || !(mod.callerConsented || mod.callerTrustsAuthor))
+                continue;
+            if (this.workers.has(mod.modId))
+                continue;
+            if ((this.retryAt.get(identity(mod)) ?? 0) > this.now())
+                continue;
+            await this.start(mod, grid, current);
+        }
+    }
+    stopStale(listed) {
+        const byId = new Map(listed.map((m) => [m.modId, m]));
+        for (const [modId, worker] of [...this.workers]) {
+            const next = byId.get(modId);
+            const reason = !next
+                ? 'removed'
+                : identity(next) !== identity(worker.mod)
+                    ? 'changed'
+                    : !this.wanted(next)
+                        ? 'filtered'
+                        : !(next.callerConsented || next.callerTrustsAuthor)
+                            ? 'unconsented'
+                            : null;
+            if (reason)
+                this.stopWorker(modId, reason);
+        }
+    }
+    /** Asks about what the player has not agreed to; true when a consent or trust went through. */
+    async askAbout(listed, grid, current) {
+        const pending = listed.filter((m) => this.wanted(m) && !m.callerConsented && !m.callerTrustsAuthor);
+        if (pending.length === 0)
+            return false;
+        const prompts = [];
+        if ((this.options.ask ?? 'author') === 'author') {
+            for (const authorId of new Set(pending.map((m) => m.authorId))) {
+                const theirs = listed.filter((m) => m.authorId === authorId);
+                const [first] = theirs;
+                prompts.push({
+                    key: `author\u0000${authorId}\u0000${first.authorCapabilityHash}`,
+                    prompt: {
+                        kind: 'author',
+                        gridId: grid.gridId,
+                        authorId,
+                        capabilityHash: first.authorCapabilityHash,
+                        capabilitySummaryJson: first.authorCapabilitySummaryJson,
+                        capabilitySummary: first.authorCapabilitySummary,
+                        mods: theirs,
+                    },
+                });
+            }
+        }
+        else {
+            for (const mod of pending) {
+                prompts.push({
+                    key: `mod\u0000${mod.modId}\u0000${mod.capabilityHash}`,
+                    prompt: {
+                        kind: 'mod',
+                        gridId: grid.gridId,
+                        authorId: mod.authorId,
+                        capabilityHash: mod.capabilityHash,
+                        capabilitySummaryJson: mod.capabilitySummaryJson,
+                        capabilitySummary: mod.capabilitySummary,
+                        mods: [mod],
+                    },
+                });
+            }
+        }
+        let agreed = false;
+        for (const { key, prompt } of prompts) {
+            if (!current())
+                return agreed;
+            if (this.declined.has(key))
+                continue;
+            if (!this.approved.has(key)) {
+                if (!this.options.confirm)
+                    continue;
+                const yes = await this.options.confirm(prompt);
+                if (!current())
+                    return agreed;
+                if (!yes) {
+                    this.declined.add(key);
+                    continue;
+                }
+                // Kept until it goes through: a trust refused while the player's presence is not yet
+                // registered is retried on the next refresh without asking again.
+                this.approved.add(key);
+            }
+            try {
+                const { exec, appId } = this.options;
+                if (prompt.kind === 'author') {
+                    await exec.trustAuthor(appId, grid.gridId, prompt.authorId, prompt.capabilityHash);
+                }
+                else {
+                    await exec.consentClientMod(appId, prompt.mods[0].modId, prompt.capabilityHash);
+                }
+                this.approved.delete(key);
+                agreed = true;
+            }
+            catch (error) {
+                const reason = refusal(error);
+                // The hash moved on: the next listing brings the new one, and a new question.
+                if (reason === 'conflict')
+                    this.approved.delete(key);
+                this.options.onError?.({ mod: prompt.mods[0], stage: 'consent', reason, error });
+            }
+        }
+        return agreed;
+    }
+    async start(mod, grid, current) {
+        // What the player consented to, and what the served artifact itself lists, bound the
+        // module's host calls in the broker.
+        const consented = mod.capabilitySummary?.hostFunctions;
+        if (!Array.isArray(consented)) {
+            this.fail(mod, 'start', new CrowdyProtocolError({
+                message: `CLIENT half of mod ${mod.modId}: its capability summary does not parse`,
+            }));
+            return;
+        }
+        let module = this.cache.get(mod.digest);
+        if (module) {
+            this.cache.delete(mod.digest);
+            this.cache.set(mod.digest, module);
+        }
+        else {
+            try {
+                const a = await this.options.exec.modClientArtifactBytes(this.options.appId, mod.modId);
+                module = {
+                    bytes: a.bytes,
+                    fuelPerDispatch: a.fuelPerDispatch,
+                    hostFunctions: a.capabilitySummary.hostFunctions,
+                };
+                this.remember(a.digest, module);
+                if (!current())
+                    return;
+                // Changed between the listing and the fetch: the next listing starts the new one.
+                if (a.digest !== mod.digest ||
+                    a.capabilityHash !== mod.capabilityHash ||
+                    a.tickIntervalMs !== mod.tickIntervalMs) {
+                    return;
+                }
+            }
+            catch (error) {
+                if (!current())
+                    return;
+                this.fail(mod, 'fetch', error);
+                return;
+            }
+        }
+        const served = module.hostFunctions;
+        const broker = (this.options.brokerFactory ?? ((o) => new PlayerCodeBroker(o)))({
+            engine: 'ck-exec',
+            workerUrl: this.options.workerUrl,
+            grid: { low: grid.low, high: grid.high, gridId: grid.gridId },
+            moduleName: mod.name,
+            artifactHash: mod.digest,
+            fuelPerDispatch: module.fuelPerDispatch,
+            tickIntervalMs: mod.tickIntervalMs,
+            consentedHostCalls: consented.filter((fn) => served.includes(fn)),
+            onHostCall: (call) => this.options.onHostCall(call, mod),
+            onPresentation: (presentation) => this.options.onPresentation?.(presentation, mod),
+            onCircuitOpen: () => {
+                if (this.workers.get(mod.modId)?.broker !== broker)
+                    return;
+                this.retryAt.set(identity(mod), this.now() + (this.options.failedRetryMs ?? 60000));
+                this.stopWorker(mod.modId, 'circuit-open');
+            },
+        });
+        const worker = { mod, broker, started: false };
+        this.workers.set(mod.modId, worker);
+        try {
+            await broker.start(module.bytes);
+        }
+        catch (error) {
+            if (this.workers.get(mod.modId) !== worker)
+                return;
+            this.workers.delete(mod.modId);
+            broker.stop();
+            if (current())
+                this.fail(mod, 'start', error);
+            return;
+        }
+        if (this.workers.get(mod.modId) !== worker)
+            return;
+        worker.started = true;
+        this.options.onStarted?.(mod);
+    }
+    fail(mod, stage, error) {
+        const reason = refusal(error);
+        const wait = reason === 'not-found'
+            ? (this.options.notFoundRetryMs ?? 15000)
+            : reason === 'rate-limited'
+                ? (this.options.rateLimitedRetryMs ?? 60000)
+                : (this.options.failedRetryMs ?? 60000);
+        const retryAt = this.now() + wait;
+        this.retryAt.set(identity(mod), retryAt);
+        this.options.onError?.({ mod, stage, reason, error, retryAt });
+    }
+    remember(digest, module) {
+        this.cache.set(digest, module);
+        const limit = Math.max(1, this.options.cacheSize ?? 16);
+        for (const oldest of this.cache.keys()) {
+            if (this.cache.size <= limit)
+                break;
+            this.cache.delete(oldest);
+        }
+    }
+    wanted(mod) {
+        return this.options.filter ? this.options.filter(mod) : true;
+    }
+    stopWorker(modId, reason) {
+        const worker = this.workers.get(modId);
+        if (!worker)
+            return;
+        this.workers.delete(modId);
+        worker.broker.stop();
+        if (worker.started)
+            this.options.onStopped?.(worker.mod, reason);
+    }
+    stopAll(reason) {
+        for (const modId of [...this.workers.keys()])
+            this.stopWorker(modId, reason);
+    }
+    now() {
+        return (this.options.now ?? Date.now)();
+    }
+}
+function sameGrid(a, b) {
+    if (!a || !b)
+        return a === b;
+    return (a.gridId === b.gridId &&
+        a.low.x === b.low.x &&
+        a.low.y === b.low.y &&
+        a.low.z === b.low.z &&
+        a.high.x === b.high.x &&
+        a.high.y === b.high.y &&
+        a.high.z === b.high.z);
+}

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

@@ -64,7 +64,9 @@ export declare class GridHostCallRefused extends Error {
  * 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.
+ * `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.
  */
 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;;;;;;GAMG;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,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"}

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

@@ -12,7 +12,9 @@ const SPATIAL_KINDS = new Set(['actor', 'client_event', 'server_event', 'text'])
  * 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.
+ * `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.
  */
 export function createGridHostCalls(options) {
     const { scope, client, local } = options;

package/dist/grid-mods/index.d.ts

@@ -1,3 +1,4 @@
 export { createGridHostCalls, GridHostCallRefused, type GridHostCallsOptions, type GridHostLocal, } from './grid-host-calls.js';
 export { startGridMod, type GridModSpec, type WasmGridModSpec, type ProgramGridModSpec, type RunningGridMod, type StartGridModOptions, } from './mod-runtime.js';
+export { ExecClientHalves, type ExecClientHalvesGrid, type ExecClientHalvesOptions, type ExecClientHalfBroker, type ExecClientHalfError, type ExecClientHalfPrompt, type ExecClientHalfStopReason, } from './exec-client-halves.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/grid-mods/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grid-mods/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grid-mods/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC"}

package/dist/grid-mods/index.js

@@ -1,2 +1,3 @@
 export { createGridHostCalls, GridHostCallRefused, } from './grid-host-calls.js';
 export { startGridMod, } from './mod-runtime.js';
+export { ExecClientHalves, } from './exec-client-halves.js';

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

@@ -1,8 +1,12 @@
-import { type PlayerCodePresentation } from '../player-runtime/player-code-broker.js';
+import { type PlayerCodeEngine, 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 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).
+ */
 export interface WasmGridModSpec {
     kind: 'wasm';
     moduleName: string;
@@ -10,6 +14,10 @@ export interface WasmGridModSpec {
     artifactHash?: string;
     fuelPerDispatch?: bigint;
     tickIntervalMs?: number;
+    /** Default `'player-compute'`, a legacy CLIENT module. */
+    engine?: PlayerCodeEngine;
+    /** A CLIENT half's `capabilitySummary.hostFunctions`; required with `engine: 'ck-exec'`. */
+    consentedHostCalls?: readonly string[];
     /** The platform glue worker URL (`@crowdedkingdoms/crowdyjs/player-glue-worker`). */
     workerUrl: string | URL;
 }

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,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,+EAA+E;AAC/E,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,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,CA2CzB"}
+{"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"}

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

@@ -15,6 +15,8 @@ export async function startGridMod(options) {
     const box = scope.bounds;
     if (spec.kind === 'wasm') {
         const broker = new PlayerCodeBroker({
+            engine: spec.engine,
+            consentedHostCalls: spec.consentedHostCalls,
             workerUrl: spec.workerUrl,
             grid: { low: box.low, high: box.high, gridId: scope.gridId },
             moduleName: spec.moduleName,

package/dist/grid-scope.d.ts

@@ -260,6 +260,7 @@ export declare class GridScope {
             fuelUsed: string;
             durationUs: number;
         }>;
+        /** @deprecated Superseded by `client.exec.gridClientMods(appId, gridId)`; removed in 18.0. */
         clientMods: () => Promise<{
             __typename?: "GridClientMod";
             attachmentId: string;

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":"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"}

package/dist/grid-scope.js

@@ -101,6 +101,7 @@ export class GridScope {
                 exportName,
                 ...(params !== undefined ? { paramsJson: JSON.stringify(params) } : {}),
             }),
+            /** @deprecated Superseded by `client.exec.gridClientMods(appId, gridId)`; removed in 18.0. */
             clientMods: () => this.clients.marketplace.gridClientMods({
                 appId: this.appId,
                 gridId: this.gridId,