@crowdedkingdoms/crowdyjs 8.7.0 → 8.9.0

package/dist/kit/blueprints/moderation.js

@@ -0,0 +1,140 @@
+import { toSnakeCase, trustedAuthorityFields } from './core.js';
+/** Compute the type/function names a moderation blueprint (and its runtime helper) uses. */
+export function moderationNames(typePrefix = '') {
+    const fnPrefix = typePrefix ? `${toSnakeCase(typePrefix)}_` : '';
+    return {
+        reportType: `${typePrefix}ModReport`,
+        muteType: `${typePrefix}ModMute`,
+        fileReportFn: `${fnPrefix}file_report`,
+        resolveReportFn: `${fnPrefix}resolve_report`,
+    };
+}
+/**
+ * Blueprint for **moderation** (matrix P6) — MODEL + CLIENT, no compute:
+ *
+ * - `ModReport` containers are the escalation queue: any player files one
+ *   against a subject (`file_report` is member-instantiable through the
+ *   runtime helper — the caller's own report row); app admins read the
+ *   open queue and `resolve_report` with a disposition.
+ * - `ModMute` containers are per-player mute lists (client-enforced: the
+ *   runtime helper filters chat client-side — mutes are personal, not
+ *   punitive).
+ * - ENFORCEMENT stays on existing platform surfaces: admins revoke access
+ *   tiers / grid permissions; nothing new to trust here.
+ *
+ * Runtime counterpart: `client.kit(appId).moderation`.
+ */
+export function moderationBlueprint(options = {}) {
+    const { typePrefix = '' } = options;
+    const names = moderationNames(typePrefix);
+    const propertyDefinitions = [
+        {
+            containerTypeName: names.reportType,
+            key: 'reporter_user_id',
+            valueType: 'string',
+            defaultValueJson: '""',
+            description: 'Who filed the report.',
+        },
+        {
+            containerTypeName: names.reportType,
+            key: 'subject_user_id',
+            valueType: 'string',
+            defaultValueJson: '""',
+            description: 'Who the report is about.',
+        },
+        {
+            containerTypeName: names.reportType,
+            key: 'reason',
+            valueType: 'string',
+            defaultValueJson: '""',
+            description: "App-defined category ('harassment', 'cheating', 'spam', ...).",
+        },
+        {
+            containerTypeName: names.reportType,
+            key: 'detail',
+            valueType: 'string',
+            defaultValueJson: '""',
+            description: 'Free-text context from the reporter (client-truncated).',
+        },
+        {
+            containerTypeName: names.reportType,
+            key: 'status',
+            valueType: 'string',
+            defaultValueJson: '"open"',
+            description: "Queue state: 'open' | 'actioned' | 'dismissed'.",
+        },
+        {
+            containerTypeName: names.reportType,
+            key: 'resolution',
+            valueType: 'string',
+            defaultValueJson: '""',
+            description: 'Admin note recorded by resolve_report.',
+        },
+        {
+            containerTypeName: names.reportType,
+            key: 'filed_at_ms',
+            valueType: 'int',
+            defaultValueJson: '0',
+            description: 'Client-reported epoch ms (informational; the event log holds server time).',
+        },
+        {
+            containerTypeName: names.muteType,
+            key: 'owner_user_id',
+            valueType: 'string',
+            defaultValueJson: '""',
+            description: 'Whose mute list this row belongs to (kit owner mirror).',
+        },
+        {
+            containerTypeName: names.muteType,
+            key: 'muted_user_id',
+            valueType: 'string',
+            defaultValueJson: '""',
+            description: 'The muted player (client-side chat filtering).',
+        },
+    ];
+    const functions = [
+        {
+            name: names.resolveReportFn,
+            containerTypeName: names.reportType,
+            returnType: 'string',
+            parameters: [
+                {
+                    name: 'status',
+                    valueType: 'string',
+                    required: true,
+                    description: "'actioned' or 'dismissed'.",
+                },
+                {
+                    name: 'resolution',
+                    valueType: 'string',
+                    required: true,
+                    description: 'Admin disposition note.',
+                },
+            ],
+            mutations: [
+                { target: 'self', property: 'status', expression: '$status' },
+                { target: 'self', property: 'resolution', expression: '$resolution' },
+            ],
+            returnExpression: 'self.status',
+            ...trustedAuthorityFields('server'),
+            description: 'Close a report with a disposition (app admins). Enforcement happens on platform surfaces (tier revocation, grid permissions).',
+        },
+    ];
+    return {
+        name: 'moderation',
+        containerTypes: [
+            {
+                typeName: names.reportType,
+                displayName: 'Moderation report',
+                description: 'One player report in the escalation queue (open/actioned/dismissed).',
+            },
+            {
+                typeName: names.muteType,
+                displayName: 'Moderation mute',
+                description: 'One personal mute entry (client-enforced chat filtering).',
+            },
+        ],
+        propertyDefinitions,
+        functions,
+    };
+}

package/dist/kit/decks.d.ts

@@ -1,8 +1,14 @@
 import type { GameModelAPI } from '../domains/gameModel.js';
+import type { EngineDetector } from './engine.js';
 import type { Scalars } from '../generated/graphql.js';
 import { type KitInvokeResult } from './shared.js';
 /** Options for {@link DecksKit}. Must match the deployed decks blueprint. */
 export interface DecksKitOptions {
+    /**
+     * The compute module holding hidden hands when the app runs a deck
+     * engine. Defaults to `'deck-engine'`.
+     */
+    engineModuleName?: string;
     /** The `typePrefix` the decks blueprint was deployed with. */
     typePrefix?: string;
 }
@@ -33,8 +39,34 @@ export interface KitCard {
 export declare class DecksKit {
     private readonly appId;
     private readonly gameModel;
+    private readonly engines?;
     private readonly names;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: DecksKitOptions);
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: DecksKitOptions, engines?: EngineDetector | undefined);
+    private readonly engineModuleName;
+    /**
+     * Is a deck compute engine deployed + enabled (cached per session)? When
+     * true, hands and deck order live in MODULE state (server-held secrets);
+     * the blueprint's owner-visibility hands remain for model-only apps.
+     */
+    engineAvailable(): Promise<boolean>;
+    /** Create an engine table with seeded shuffle + hidden deals (creator seats itself). */
+    engineNewTable(input: {
+        tableId: string;
+        players: string[];
+        handSize?: number;
+        deckDef?: string;
+    }): Promise<Record<string, unknown>>;
+    /** YOUR hidden hand (the only read path; opponents can never see it). */
+    engineHand(tableId: string): Promise<string[]>;
+    /** Draw one card into your hidden hand. */
+    engineDraw(tableId: string): Promise<Record<string, unknown>>;
+    /** Play (reveal) a card from your hand into a public zone. */
+    enginePlay(tableId: string, card: string, zone?: string): Promise<Record<string, unknown>>;
+    /** Collect a public zone to the discard (trick taken). */
+    engineTakeZone(tableId: string, zone: string): Promise<Record<string, unknown>>;
+    /** The public table view (counts + zones — never hidden hands). */
+    engineTable(tableId: string): Promise<Record<string, unknown>>;
+    private engineInvoke;
     /**
      * Deal a deck to a player: creates one CardInstance per card id (zone
      * `deck`), owned by the player. Run {@link shuffle} afterwards to deal

package/dist/kit/decks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decks.d.ts","sourceRoot":"","sources":["../../src/kit/decks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oEAAoE;AACpE,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IAIjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAGhB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,eAAoB;IAK/B;;;;OAIG;IACG,IAAI,CAAC,KAAK,EAAE;QAChB,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;;;;;;;;;;;IAwBD;;;;OAIG;IACG,OAAO;;;;;;;;;;;;;;;;;;;;;;IAOb,8DAA8D;IACxD,KAAK,CACT,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,EAC9C,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAClD,OAAO,CAAC,OAAO,EAAE,CAAC;IA2BrB,iEAAiE;IAC3D,MAAM,CACV,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACvC,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,OAAO,EAAE,CAAC;IAIrB,sDAAsD;IAChD,KAAK,CAAC,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIrE;;;;OAIG;IACG,IAAI,CACR,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACvC,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IASnC,yEAAyE;IACnE,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAUnC;;;OAGG;IACG,IAAI,CACR,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAUnC,8BAA8B;IACxB,OAAO,CACX,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAUrB,MAAM;CAsBrB"}
+{"version":3,"file":"decks.d.ts","sourceRoot":"","sources":["../../src/kit/decks.ts"],"names":[],"mappings":"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"}

package/dist/kit/decks.js

@@ -10,10 +10,58 @@ import { kitContainerProperties, kitInvoke, } from './shared.js';
  * Obtained via `client.kit(appId).decks`.
  */
 export class DecksKit {
-    constructor(appId, gameModel, options = {}) {
+    constructor(appId, gameModel, options = {}, engines) {
         this.appId = appId;
         this.gameModel = gameModel;
+        this.engines = engines;
         this.names = decksNames(options.typePrefix ?? '');
+        this.engineModuleName = options.engineModuleName ?? 'deck-engine';
+    }
+    // -- Engine path (Wave 2): true hidden information over the deck engine --
+    /**
+     * Is a deck compute engine deployed + enabled (cached per session)? When
+     * true, hands and deck order live in MODULE state (server-held secrets);
+     * the blueprint's owner-visibility hands remain for model-only apps.
+     */
+    engineAvailable() {
+        if (!this.engines)
+            return Promise.resolve(false);
+        return this.engines.has(this.engineModuleName);
+    }
+    /** Create an engine table with seeded shuffle + hidden deals (creator seats itself). */
+    async engineNewTable(input) {
+        return this.engineInvoke('new_table', input);
+    }
+    /** YOUR hidden hand (the only read path; opponents can never see it). */
+    async engineHand(tableId) {
+        const body = await this.engineInvoke('hand', { tableId });
+        return Array.isArray(body.hand) ? body.hand.map(String) : [];
+    }
+    /** Draw one card into your hidden hand. */
+    async engineDraw(tableId) {
+        return this.engineInvoke('draw', { tableId });
+    }
+    /** Play (reveal) a card from your hand into a public zone. */
+    async enginePlay(tableId, card, zone = 'table') {
+        return this.engineInvoke('play', { tableId, card, zone });
+    }
+    /** Collect a public zone to the discard (trick taken). */
+    async engineTakeZone(tableId, zone) {
+        return this.engineInvoke('take_zone', { tableId, zone });
+    }
+    /** The public table view (counts + zones — never hidden hands). */
+    async engineTable(tableId) {
+        return this.engineInvoke('table', { tableId });
+    }
+    async engineInvoke(exportName, params) {
+        if (!this.engines) {
+            throw new Error('deck engine unavailable: compute domain not wired');
+        }
+        const result = await this.engines.invoke(this.engineModuleName, exportName, params);
+        if (!result.success) {
+            throw new Error(`decks.${exportName} failed: ${result.reason ?? 'unknown'}`);
+        }
+        return result.body;
     }
     /**
      * Deal a deck to a player: creates one CardInstance per card id (zone

package/dist/kit/director.d.ts

@@ -0,0 +1,88 @@
+import type { GameModelAPI } from '../domains/gameModel.js';
+import type { Scalars } from '../generated/graphql.js';
+import type { EngineDetector } from './engine.js';
+/** Options for {@link DirectorKit}. */
+export interface DirectorKitOptions {
+    /** The director module name. Defaults to `'director'`. */
+    moduleName?: string;
+    /** The encounter-definition container type. Defaults to `'EncounterDef'`. */
+    defTypeName?: string;
+}
+/** One wave of an encounter definition. */
+export interface KitWaveSpec {
+    units: Array<{
+        mobId: string;
+        count: number;
+    }>;
+    delayMs?: number;
+    /** Boss wave: hp + phase thresholds (descending hp percentages). */
+    boss?: {
+        hp: number;
+        phases?: number[];
+    };
+}
+/** A director run's state. */
+export interface KitDirectorRun {
+    runId: string;
+    encounterId: string;
+    players: number;
+    phase: Record<string, unknown>;
+    pending: number;
+    wavesCleared: number;
+    wavesTotal: number;
+    boss: {
+        hp: number;
+        maxHp: number;
+        phase: number;
+        thresholds: number[];
+    } | null;
+    finished: boolean;
+    outcome: string;
+}
+/**
+ * Runtime helpers for the director engine (Wave 2): data-driven encounter
+ * direction — wave schedules, spawn budgets, boss phases, party scaling.
+ * The director emits `director_spawn` compute events; the mob layer
+ * simulates and reports kills back.
+ *
+ * Obtained via `client.kit(appId).director`.
+ */
+export declare class DirectorKit {
+    private readonly appId;
+    private readonly gameModel;
+    private readonly engines;
+    private readonly moduleName;
+    private readonly defTypeName;
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, engines: EngineDetector, options?: DirectorKitOptions);
+    /** Is the director deployed + enabled (cached per session)? */
+    engineAvailable(): Promise<boolean>;
+    /** STUDIO (admin) — create an encounter definition container. */
+    defineEncounter(input: {
+        encounterId: string;
+        displayName?: string;
+        waves: KitWaveSpec[];
+        spawnBudget?: number;
+    }): Promise<{
+        __typename?: "GmContainer";
+        containerId: string;
+        appId: string;
+        sessionId: string | null;
+        typeName: string;
+        displayName: string;
+        description: string | null;
+        ownerUserId: string | null;
+        metadataJson: string;
+    }>;
+    /** Start a run (party size scales unit counts server-side). */
+    startRun(encounterId: string, players?: number): Promise<KitDirectorRun>;
+    /** Report kills toward the live wave (trusted callers/engines). */
+    reportKill(runId: string, count?: number): Promise<KitDirectorRun>;
+    /** Report boss hp; phase transitions announce on the compute bus. */
+    reportBossHp(runId: string, hp: number): Promise<KitDirectorRun>;
+    /** Force-clear the live wave (run creator only). */
+    skipWave(runId: string): Promise<KitDirectorRun>;
+    /** One run's state (or engine totals without an id). */
+    runState(runId?: string): Promise<KitDirectorRun | Record<string, unknown>>;
+    private invoke;
+}
+//# sourceMappingURL=director.d.ts.map

package/dist/kit/director.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"director.d.ts","sourceRoot":"","sources":["../../src/kit/director.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC1C;AAED,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAChF,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAyBD;;;;;;;GAOG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAGlB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,cAAc,EACxC,OAAO,GAAE,kBAAuB;IAMlC,+DAA+D;IAC/D,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC,iEAAiE;IAC3D,eAAe,CAAC,KAAK,EAAE;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,WAAW,EAAE,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;;;;;;;;;;;IAeD,+DAA+D;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IAIzE,mEAAmE;IAC7D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IAInE,qEAAqE;IAC/D,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAItE,oDAAoD;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAItD,wDAAwD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAKnE,MAAM;CAOrB"}

package/dist/kit/director.js

@@ -0,0 +1,86 @@
+function toRun(body) {
+    const boss = body.boss;
+    return {
+        runId: String(body.runId ?? ''),
+        encounterId: String(body.encounterId ?? ''),
+        players: Number(body.players ?? 1),
+        phase: body.phase ?? {},
+        pending: Number(body.pending ?? 0),
+        wavesCleared: Number(body.wavesCleared ?? 0),
+        wavesTotal: Number(body.wavesTotal ?? 0),
+        boss: boss
+            ? {
+                hp: Number(boss.hp ?? 0),
+                maxHp: Number(boss.maxHp ?? 0),
+                phase: Number(boss.phase ?? 0),
+                thresholds: Array.isArray(boss.thresholds) ? boss.thresholds.map(Number) : [],
+            }
+            : null,
+        finished: body.finished === true,
+        outcome: String(body.outcome ?? ''),
+    };
+}
+/**
+ * Runtime helpers for the director engine (Wave 2): data-driven encounter
+ * direction — wave schedules, spawn budgets, boss phases, party scaling.
+ * The director emits `director_spawn` compute events; the mob layer
+ * simulates and reports kills back.
+ *
+ * Obtained via `client.kit(appId).director`.
+ */
+export class DirectorKit {
+    constructor(appId, gameModel, engines, options = {}) {
+        this.appId = appId;
+        this.gameModel = gameModel;
+        this.engines = engines;
+        this.moduleName = options.moduleName ?? 'director';
+        this.defTypeName = options.defTypeName ?? 'EncounterDef';
+    }
+    /** Is the director deployed + enabled (cached per session)? */
+    engineAvailable() {
+        return this.engines.has(this.moduleName);
+    }
+    /** STUDIO (admin) — create an encounter definition container. */
+    async defineEncounter(input) {
+        return this.gameModel.createContainer({
+            appId: this.appId,
+            typeName: this.defTypeName,
+            displayName: input.displayName ?? `Encounter ${input.encounterId}`,
+            properties: [
+                { key: 'encounter_id', valueType: 'string', valueJson: JSON.stringify(input.encounterId) },
+                { key: 'waves', valueType: 'string', valueJson: JSON.stringify(JSON.stringify(input.waves)) },
+                ...(input.spawnBudget !== undefined
+                    ? [{ key: 'spawn_budget', valueType: 'int', valueJson: String(input.spawnBudget) }]
+                    : []),
+            ],
+        });
+    }
+    /** Start a run (party size scales unit counts server-side). */
+    async startRun(encounterId, players = 1) {
+        return toRun(await this.invoke('start_run', { encounterId, players }));
+    }
+    /** Report kills toward the live wave (trusted callers/engines). */
+    async reportKill(runId, count = 1) {
+        return toRun(await this.invoke('report_kill', { runId, count }));
+    }
+    /** Report boss hp; phase transitions announce on the compute bus. */
+    async reportBossHp(runId, hp) {
+        return toRun(await this.invoke('report_boss_hp', { runId, hp }));
+    }
+    /** Force-clear the live wave (run creator only). */
+    async skipWave(runId) {
+        return toRun(await this.invoke('skip_wave', { runId }));
+    }
+    /** One run's state (or engine totals without an id). */
+    async runState(runId) {
+        const body = await this.invoke('run_state', runId ? { runId } : {});
+        return runId ? toRun(body) : body;
+    }
+    async invoke(exportName, params) {
+        const result = await this.engines.invoke(this.moduleName, exportName, params);
+        if (!result.success) {
+            throw new Error(`director.${exportName} failed: ${result.reason ?? 'unknown'}`);
+        }
+        return result.body;
+    }
+}

package/dist/kit/economy.d.ts

@@ -1,4 +1,5 @@
 import type { GameModelAPI } from '../domains/gameModel.js';
+import type { EngineDetector } from './engine.js';
 import type { Scalars, SeedPropertyInput } from '../generated/graphql.js';
 import { type KitInvokeResult } from './shared.js';
 /** Options for {@link EconomyKit}. Must match the deployed economy blueprint. */
@@ -7,6 +8,8 @@ export interface EconomyKitOptions {
     typePrefix?: string;
     /** The `currencies` the blueprint was deployed with. Defaults to `['gold']`. */
     currencies?: string[];
+    /** The order-book market engine module. Defaults to `'market-engine'`. */
+    marketModuleName?: string;
 }
 /** A parsed view of one wallet. */
 export interface KitWallet {
@@ -72,7 +75,14 @@ export declare class EconomyKit {
     private readonly names;
     private readonly typePrefix;
     private readonly currencies;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: EconomyKitOptions);
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: EconomyKitOptions, engines?: EngineDetector);
+    /**
+     * The order-book market (Wave 2 engine): bid/ask methods over the
+     * market-engine's escrowed order books. The model-side listing `market`
+     * on this kit keeps working without it (fixed-price stack listings);
+     * `orderBook` adds real price discovery when the engine is deployed.
+     */
+    readonly orderBook: MarketKit;
     private get defaultCurrency();
     /**
      * Find the player's wallet, creating it when absent (member-instantiable;
@@ -241,4 +251,39 @@ export declare class EconomyKit {
     private ensureSellerWallet;
     private toTrade;
 }
+/**
+ * Order-book market methods over the market-engine (Wave 2): price-time
+ * priority matching with escrowed settlement. Deposits/withdrawals bridge
+ * to the game's wallets via compute events the game layer consumes.
+ *
+ * Obtained via `client.kit(appId).economy.market`.
+ */
+export declare class MarketKit {
+    private readonly engines;
+    private readonly moduleName;
+    constructor(engines: EngineDetector | undefined, moduleName: string);
+    /** Is the market engine deployed + enabled (cached per session)? */
+    engineAvailable(): Promise<boolean>;
+    /** Move coins into your market account (escrow source for bids). */
+    depositCoins(amount: number): Promise<Record<string, unknown>>;
+    /** Move items into your market account (escrow source for asks). */
+    depositItems(item: string, quantity: number): Promise<Record<string, unknown>>;
+    /** Place a limit bid: locks coins at your limit; fills at maker price. */
+    bid(item: string, price: number, quantity: number): Promise<Record<string, unknown>>;
+    /** Place a limit ask: locks items until filled or cancelled. */
+    ask(item: string, price: number, quantity: number): Promise<Record<string, unknown>>;
+    /** Cancel a resting order (owner only); escrow refunds instantly. */
+    cancel(item: string, orderId: number): Promise<Record<string, unknown>>;
+    /** Book depth: best bids/asks as [price, quantity] levels. */
+    book(item: string): Promise<Record<string, unknown>>;
+    /** Your market account (settled + locked balances). */
+    account(): Promise<Record<string, unknown>>;
+    /** Withdraw settled balances back to the game layer. */
+    withdraw(input: {
+        coins?: number;
+        item?: string;
+        quantity?: number;
+    }): Promise<Record<string, unknown>>;
+    private invoke;
+}
 //# sourceMappingURL=economy.d.ts.map

package/dist/kit/economy.d.ts.map

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

package/dist/kit/economy.js

@@ -15,7 +15,7 @@ import { kitContainerProperties, kitInvoke, } from './shared.js';
  * Obtained via `client.kit(appId).economy`.
  */
 export class EconomyKit {
-    constructor(appId, gameModel, options = {}) {
+    constructor(appId, gameModel, options = {}, engines) {
         this.appId = appId;
         this.gameModel = gameModel;
         /** Shop (admin-priced listings; atomic buys). */
@@ -258,6 +258,7 @@ export class EconomyKit {
         this.typePrefix = options.typePrefix ?? '';
         this.names = economyNames(this.typePrefix);
         this.currencies = options.currencies ?? ['gold'];
+        this.orderBook = new MarketKit(engines, options.marketModuleName ?? 'market-engine');
     }
     get defaultCurrency() {
         return this.currencies[0];
@@ -363,3 +364,64 @@ export class EconomyKit {
         };
     }
 }
+/**
+ * Order-book market methods over the market-engine (Wave 2): price-time
+ * priority matching with escrowed settlement. Deposits/withdrawals bridge
+ * to the game's wallets via compute events the game layer consumes.
+ *
+ * Obtained via `client.kit(appId).economy.market`.
+ */
+export class MarketKit {
+    constructor(engines, moduleName) {
+        this.engines = engines;
+        this.moduleName = moduleName;
+    }
+    /** Is the market engine deployed + enabled (cached per session)? */
+    engineAvailable() {
+        if (!this.engines)
+            return Promise.resolve(false);
+        return this.engines.has(this.moduleName);
+    }
+    /** Move coins into your market account (escrow source for bids). */
+    async depositCoins(amount) {
+        return this.invoke('deposit_coins', { amount });
+    }
+    /** Move items into your market account (escrow source for asks). */
+    async depositItems(item, quantity) {
+        return this.invoke('deposit_items', { item, quantity });
+    }
+    /** Place a limit bid: locks coins at your limit; fills at maker price. */
+    async bid(item, price, quantity) {
+        return this.invoke('place', { item, side: 'buy', price, quantity });
+    }
+    /** Place a limit ask: locks items until filled or cancelled. */
+    async ask(item, price, quantity) {
+        return this.invoke('place', { item, side: 'sell', price, quantity });
+    }
+    /** Cancel a resting order (owner only); escrow refunds instantly. */
+    async cancel(item, orderId) {
+        return this.invoke('cancel', { item, orderId });
+    }
+    /** Book depth: best bids/asks as [price, quantity] levels. */
+    async book(item) {
+        return this.invoke('book', { item });
+    }
+    /** Your market account (settled + locked balances). */
+    async account() {
+        return this.invoke('account', {});
+    }
+    /** Withdraw settled balances back to the game layer. */
+    async withdraw(input) {
+        return this.invoke('withdraw', input);
+    }
+    async invoke(exportName, params) {
+        if (!this.engines) {
+            throw new Error('market engine unavailable: compute domain not wired');
+        }
+        const result = await this.engines.invoke(this.moduleName, exportName, params);
+        if (!result.success) {
+            throw new Error(`market.${exportName} failed: ${result.reason ?? 'unknown'}`);
+        }
+        return result.body;
+    }
+}