@crowdedkingdoms/crowdyjs 8.6.0 → 8.8.0

package/dist/kit/kit.d.ts

@@ -4,16 +4,24 @@ import type { GameModelAPI } from '../domains/gameModel.js';
 import type { TeamsAPI } from '../domains/teams.js';
 import type { UdpAPI } from '../domains/udp.js';
 import type { GameModelSeedMutation, GameModelUpsertAutomationMutation, GameModelUpsertAutomationTriggerMutation, Scalars } from '../generated/graphql.js';
+import type { ComputeAPI } from '../domains/compute.js';
 import { type KitBlueprint } from './blueprints/index.js';
 import { CombatKit, type CombatKitOptions } from './combat.js';
+import { DirectorKit, type DirectorKitOptions } from './director.js';
 import { DecksKit, type DecksKitOptions } from './decks.js';
 import { EconomyKit, type EconomyKitOptions } from './economy.js';
+import { EngineDetector } from './engine.js';
 import { FeaturesKit } from './features.js';
+import { InstancesKit, type InstancesKitOptions } from './instances.js';
 import { InventoryKit, type InventoryKitOptions } from './inventory.js';
 import { LeaderboardsKit, type LeaderboardsKitOptions } from './leaderboards.js';
 import { LootKit, type LootKitOptions } from './loot.js';
+import { MatchmakingKit, type MatchmakingKitOptions } from './matchmaking.js';
+import { MinigamesKit, type MinigamesKitOptions } from './minigames.js';
+import { MobsKit, type MobsKitOptions } from './mobs.js';
 import { NpcsKit, type NpcsKitOptions } from './npcs.js';
 import { ObjectsKit, type ObjectsKitOptions } from './objects.js';
+import { PetsKit, type PetsKitOptions } from './pets.js';
 import { PlotsKit, type PlotsKitOptions } from './plots.js';
 import { MatchesKit, type MatchesKitOptions } from './matches.js';
 import { ProgressionKit, type ProgressionKitOptions } from './progression.js';
@@ -36,16 +44,24 @@ export interface GameKitOptions {
     worldsim?: WorldsimKitOptions;
     social?: SocialKitOptions;
     leaderboards?: LeaderboardsKitOptions;
+    mobs?: MobsKitOptions;
+    pets?: PetsKitOptions;
+    instances?: InstancesKitOptions;
+    director?: DirectorKitOptions;
+    matchmaking?: MatchmakingKitOptions;
+    minigames?: MinigamesKitOptions;
 }
 /**
  * The extra (non-model) domains some kit helpers compose: channels + udp for
- * matches (notify-to-pull) and social chat, teams for parties/guilds.
+ * matches (notify-to-pull) and social chat, teams for parties/guilds, and
+ * compute for the engine-backed helpers (mobs/pets, capability detection).
  * `client.kit(appId)` wires them automatically.
  */
 export interface GameKitDomains {
     channels?: ChannelsAPI;
     teams?: TeamsAPI;
     udp?: UdpAPI;
+    compute?: ComputeAPI;
 }
 /** The result of {@link GameKitClient.deploy}: the seed outcome plus each automation/trigger upserted. */
 export interface KitDeployResult {
@@ -126,6 +142,20 @@ export declare class GameKitClient {
     readonly leaderboards: LeaderboardsKit;
     /** Monetization helpers (feature keys, tier grants, featureGate policies). */
     readonly features: FeaturesKit;
+    /** Mob-engine helpers (defs/slots, refereed attacks, contact events). */
+    readonly mobs: MobsKit;
+    /** Instance helpers (private world slices, seeded runs). */
+    readonly instances: InstancesKit;
+    /** Director helpers (encounter defs, run state, kill/boss reports). */
+    readonly director: DirectorKit;
+    /** Matchmaking helpers (queues, proposals, rating). */
+    readonly matchmaking: MatchmakingKit;
+    /** Minigame helpers (thin invoke wrapper for invoke-loop games). */
+    readonly minigames: MinigamesKit;
+    /** Pet helpers (adopt/summon/dismiss/rename over the npc engine). */
+    readonly pets: PetsKit;
+    /** Compute-engine capability detection shared by the engine-aware kits. */
+    readonly engines: EngineDetector;
     constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, gameApps: GameAppsAPI, options?: GameKitOptions, domains?: GameKitDomains);
     /**
      * Helpers for an additional lockable object type deployed under a different

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

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

package/dist/kit/kit.js

@@ -1,13 +1,20 @@
 import { mergeBlueprints } from './blueprints/index.js';
 import { CombatKit } from './combat.js';
+import { DirectorKit } from './director.js';
 import { DecksKit } from './decks.js';
 import { EconomyKit } from './economy.js';
+import { EngineDetector } from './engine.js';
 import { FeaturesKit } from './features.js';
+import { InstancesKit } from './instances.js';
 import { InventoryKit } from './inventory.js';
 import { LeaderboardsKit } from './leaderboards.js';
 import { LootKit } from './loot.js';
+import { MatchmakingKit } from './matchmaking.js';
+import { MinigamesKit } from './minigames.js';
+import { MobsKit } from './mobs.js';
 import { NpcsKit } from './npcs.js';
 import { ObjectsKit } from './objects.js';
+import { PetsKit } from './pets.js';
 import { PlotsKit } from './plots.js';
 import { MatchesKit } from './matches.js';
 import { ProgressionKit } from './progression.js';
@@ -56,20 +63,27 @@ export class GameKitClient {
     constructor(appId, gameModel, gameApps, options = {}, domains = {}) {
         this.appId = appId;
         this.gameModel = gameModel;
+        this.engines = new EngineDetector(String(appId), domains.compute);
         this.inventory = new InventoryKit(appId, gameModel, options.inventory);
         this.objects = new ObjectsKit(appId, gameModel, options.objects);
-        this.npcs = new NpcsKit(appId, gameModel, options.npcs);
+        this.npcs = new NpcsKit(appId, gameModel, options.npcs, this.engines);
         this.plots = new PlotsKit(appId, gameModel, gameApps, options.plots);
-        this.economy = new EconomyKit(appId, gameModel, options.economy);
+        this.economy = new EconomyKit(appId, gameModel, options.economy, this.engines);
         this.progression = new ProgressionKit(appId, gameModel, options.progression);
         this.loot = new LootKit(appId, gameModel, options.loot);
         this.quests = new QuestsKit(appId, gameModel, options.quests);
-        this.combat = new CombatKit(appId, gameModel, options.combat);
-        this.matches = new MatchesKit(appId, gameModel, domains.channels, domains.udp, options.matches);
-        this.decks = new DecksKit(appId, gameModel, options.decks);
-        this.worldsim = new WorldsimKit(appId, gameModel, options.worldsim);
+        this.combat = new CombatKit(appId, gameModel, options.combat, this.engines);
+        this.matches = new MatchesKit(appId, gameModel, domains.channels, domains.udp, options.matches, this.engines);
+        this.decks = new DecksKit(appId, gameModel, options.decks, this.engines);
+        this.worldsim = new WorldsimKit(appId, gameModel, options.worldsim, this.engines);
+        this.mobs = new MobsKit(appId, gameModel, this.engines, options.mobs);
+        this.pets = new PetsKit(appId, gameModel, this.engines, options.pets);
+        this.instances = new InstancesKit(appId, this.engines, options.instances);
+        this.director = new DirectorKit(appId, gameModel, this.engines, options.director);
+        this.matchmaking = new MatchmakingKit(appId, this.engines, options.matchmaking);
+        this.minigames = new MinigamesKit(appId, this.engines, options.minigames);
         this.social = new SocialKit(appId, domains.teams, domains.channels, domains.udp, gameApps, options.social);
-        this.leaderboards = new LeaderboardsKit(appId, gameModel, options.leaderboards);
+        this.leaderboards = new LeaderboardsKit(appId, gameModel, options.leaderboards, this.engines);
         this.features = new FeaturesKit(appId, gameModel);
     }
     /**

package/dist/kit/leaderboards.d.ts

@@ -1,8 +1,11 @@
 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 LeaderboardsKit}. Must match the deployed blueprint. */
 export interface LeaderboardsKitOptions {
+    /** The board engine module for server-computed rankings. Defaults to `'board-engine'`. */
+    engineModuleName?: string;
     /** The `typePrefix` the leaderboards blueprint was deployed with. */
     typePrefix?: string;
 }
@@ -29,8 +32,25 @@ export interface KitLeaderboardEntry {
 export declare class LeaderboardsKit {
     private readonly appId;
     private readonly gameModel;
+    private readonly engines?;
     private readonly names;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: LeaderboardsKitOptions);
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, options?: LeaderboardsKitOptions, engines?: EngineDetector | undefined);
+    private readonly engineModuleName;
+    /**
+     * Is a board compute engine deployed + enabled (cached per session)? When
+     * true, rankings are computed SERVER-side (tie-aware ranks, percentiles,
+     * pages) instead of the blueprint's client-sorted reads.
+     */
+    engineAvailable(): Promise<boolean>;
+    /** A server-ranked page (rank/percentile computed module-side). */
+    engineTop(boardId: string, page?: number, perPage?: number): Promise<Record<string, unknown>>;
+    /** Your (or a subject's) server-computed ranked row. */
+    engineRankOf(boardId: string, subjectId?: string): Promise<Record<string, unknown>>;
+    /** Submit YOUR OWN score (personal-best semantics) to an engine board. */
+    engineSubmitSelf(boardId: string, score: number): Promise<Record<string, unknown>>;
+    /** Frozen season snapshots (top rows per rolled season). */
+    engineSeasons(boardId: string): Promise<Record<string, unknown>>;
+    private engineInvoke;
     /** Find-or-create a player's entry on a board. */
     ensureEntry(ownerUserId: Scalars['BigInt']['input'], boardId: string, options?: {
         displayName?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"leaderboards.d.ts","sourceRoot":"","sources":["../../src/kit/leaderboards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAKvD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAGvB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,sBAA2B;IAKtC,kDAAkD;IAC5C,WAAW,CACf,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;IAqBxC;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAS/E,0EAA0E;IACpE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA6B5D,oDAAoD;IAC9C,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,SAAK,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAIlE;;;OAGG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAClC,MAAM,SAAI,GACT,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAOjC,gFAAgF;IAC1E,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAI/C"}
+{"version":3,"file":"leaderboards.d.ts","sourceRoot":"","sources":["../../src/kit/leaderboards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAKvD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAN3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAGvB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjC,SAAS,EAAE,YAAY,EACxC,OAAO,GAAE,sBAA2B,EACnB,OAAO,CAAC,EAAE,cAAc,YAAA;IAM3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAI1C;;;;OAIG;IACH,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAKnC,mEAAmE;IAC7D,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,SAAI,EAAE,OAAO,SAAK;IAIvD,wDAAwD;IAClD,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAItD,0EAA0E;IACpE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAIrD,4DAA4D;IACtD,aAAa,CAAC,OAAO,EAAE,MAAM;YAIrB,YAAY;IAW1B,kDAAkD;IAC5C,WAAW,CACf,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO;;;;;;;;;;;IAqBxC;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAS/E,0EAA0E;IACpE,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA6B5D,oDAAoD;IAC9C,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,SAAK,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAIlE;;;OAGG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAClC,MAAM,SAAI,GACT,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAOjC,gFAAgF;IAC1E,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAI/C"}

package/dist/kit/leaderboards.js

@@ -10,10 +10,49 @@ import { kitContainerProperties, kitInvoke, } from './shared.js';
  * Obtained via `client.kit(appId).leaderboards`.
  */
 export class LeaderboardsKit {
-    constructor(appId, gameModel, options = {}) {
+    constructor(appId, gameModel, options = {}, engines) {
         this.appId = appId;
         this.gameModel = gameModel;
+        this.engines = engines;
         this.names = leaderboardsNames(options.typePrefix ?? '');
+        this.engineModuleName = options.engineModuleName ?? 'board-engine';
+    }
+    // -- Engine path (Wave 2): server-computed rankings --------------------------
+    /**
+     * Is a board compute engine deployed + enabled (cached per session)? When
+     * true, rankings are computed SERVER-side (tie-aware ranks, percentiles,
+     * pages) instead of the blueprint's client-sorted reads.
+     */
+    engineAvailable() {
+        if (!this.engines)
+            return Promise.resolve(false);
+        return this.engines.has(this.engineModuleName);
+    }
+    /** A server-ranked page (rank/percentile computed module-side). */
+    async engineTop(boardId, page = 0, perPage = 10) {
+        return this.engineInvoke('top', { boardId, page, perPage });
+    }
+    /** Your (or a subject's) server-computed ranked row. */
+    async engineRankOf(boardId, subjectId) {
+        return this.engineInvoke('rank_of', subjectId ? { boardId, subjectId } : { boardId });
+    }
+    /** Submit YOUR OWN score (personal-best semantics) to an engine board. */
+    async engineSubmitSelf(boardId, score) {
+        return this.engineInvoke('submit_self', { boardId, score });
+    }
+    /** Frozen season snapshots (top rows per rolled season). */
+    async engineSeasons(boardId) {
+        return this.engineInvoke('seasons', { boardId });
+    }
+    async engineInvoke(exportName, params) {
+        if (!this.engines) {
+            throw new Error('board engine unavailable: compute domain not wired');
+        }
+        const result = await this.engines.invoke(this.engineModuleName, exportName, params);
+        if (!result.success) {
+            throw new Error(`leaderboards.${exportName} failed: ${result.reason ?? 'unknown'}`);
+        }
+        return result.body;
     }
     /** Find-or-create a player's entry on a board. */
     async ensureEntry(ownerUserId, boardId, options = {}) {

package/dist/kit/matches.d.ts

@@ -1,10 +1,16 @@
 import type { ChannelsAPI } from '../domains/channels.js';
+import type { EngineDetector } from './engine.js';
 import type { GameModelAPI } from '../domains/gameModel.js';
 import type { UdpAPI } from '../domains/udp.js';
 import type { Scalars } from '../generated/graphql.js';
 import { type KitInvokeResult } from './shared.js';
 /** Options for {@link MatchesKit}. Must match the deployed matches blueprint. */
 export interface MatchesKitOptions {
+    /**
+     * The compute module driving server-side match lifecycle when the app
+     * runs an engine. Defaults to `'match-engine'`.
+     */
+    engineModuleName?: string;
     /** The `typePrefix` the matches blueprint was deployed with. */
     typePrefix?: string;
     /**
@@ -52,9 +58,11 @@ export declare class MatchesKit {
     private readonly gameModel;
     private readonly channels;
     private readonly udp;
+    private readonly engines?;
     private readonly names;
     private readonly actorUuid;
-    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, channels: ChannelsAPI | undefined, udp: UdpAPI | undefined, options?: MatchesKitOptions);
+    private readonly engineModuleName;
+    constructor(appId: Scalars['BigInt']['input'], gameModel: GameModelAPI, channels: ChannelsAPI | undefined, udp: UdpAPI | undefined, options?: MatchesKitOptions, engines?: EngineDetector | undefined);
     private requireChannels;
     private requireUdp;
     /**
@@ -136,5 +144,29 @@ export declare class MatchesKit {
      */
     onMatchChanged(match: KitMatch, callback: (match: KitMatch) => void): () => void;
     private toMatch;
+    /**
+     * Is a match compute engine deployed + enabled (cached per session)? When
+     * true the engine owns transitions (ready checks, turn order + timeouts,
+     * authoritative scoring); the blueprint's creator-driven functions remain
+     * for model-only deployments.
+     */
+    engineAvailable(): Promise<boolean>;
+    /**
+     * Declare ready on an engine match (a MatchMeta container id). The match
+     * starts server-side once every expected player is ready.
+     */
+    engineReady(matchId: string): Promise<Record<string, unknown>>;
+    /** Submit your move (the engine validates the turn + resolves). */
+    engineSubmitMove(matchId: string, params?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** Forfeit an engine match. */
+    engineForfeit(matchId: string): Promise<Record<string, unknown>>;
+    /** The engine's live view: turn holder, timers, standings, summary. */
+    engineStatus(matchId: string): Promise<Record<string, unknown>>;
+    /**
+     * Resolve a matchmaking proposal to the match the engine created for it
+     * (poll after everyone accepts; see `kit.matchmaking`).
+     */
+    findByProposal(proposalId: string): Promise<string | null>;
+    private engineInvoke;
 }
 //# sourceMappingURL=matches.d.ts.map

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

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

package/dist/kit/matches.js

@@ -12,12 +12,14 @@ import { kitContainerProperties, kitInvoke, } from './shared.js';
  * Obtained via `client.kit(appId).matches`.
  */
 export class MatchesKit {
-    constructor(appId, gameModel, channels, udp, options = {}) {
+    constructor(appId, gameModel, channels, udp, options = {}, engines) {
         this.appId = appId;
         this.gameModel = gameModel;
         this.channels = channels;
         this.udp = udp;
+        this.engines = engines;
         this.names = matchesNames(options.typePrefix ?? '');
+        this.engineModuleName = options.engineModuleName ?? 'match-engine';
         this.actorUuid = options.actorUuid ?? generateCrowdyUuid();
     }
     requireChannels() {
@@ -250,4 +252,57 @@ export class MatchesKit {
                 : {}),
         };
     }
+    // -- Engine path (Wave 2): server-driven lifecycle over the match engine --
+    /**
+     * Is a match compute engine deployed + enabled (cached per session)? When
+     * true the engine owns transitions (ready checks, turn order + timeouts,
+     * authoritative scoring); the blueprint's creator-driven functions remain
+     * for model-only deployments.
+     */
+    engineAvailable() {
+        if (!this.engines)
+            return Promise.resolve(false);
+        return this.engines.has(this.engineModuleName);
+    }
+    /**
+     * Declare ready on an engine match (a MatchMeta container id). The match
+     * starts server-side once every expected player is ready.
+     */
+    async engineReady(matchId) {
+        return this.engineInvoke('ready', { matchId });
+    }
+    /** Submit your move (the engine validates the turn + resolves). */
+    async engineSubmitMove(matchId, params = {}) {
+        return this.engineInvoke('submit_move', { matchId, ...params });
+    }
+    /** Forfeit an engine match. */
+    async engineForfeit(matchId) {
+        return this.engineInvoke('forfeit', { matchId });
+    }
+    /** The engine's live view: turn holder, timers, standings, summary. */
+    async engineStatus(matchId) {
+        return this.engineInvoke('status', { matchId });
+    }
+    /**
+     * Resolve a matchmaking proposal to the match the engine created for it
+     * (poll after everyone accepts; see `kit.matchmaking`).
+     */
+    async findByProposal(proposalId) {
+        if (!this.engines)
+            return null;
+        const result = await this.engines.invoke(this.engineModuleName, 'find_by_proposal', {
+            proposalId,
+        });
+        return result.success ? String(result.body.matchId ?? '') || null : null;
+    }
+    async engineInvoke(exportName, params) {
+        if (!this.engines) {
+            throw new Error('match engine unavailable: compute domain not wired');
+        }
+        const result = await this.engines.invoke(this.engineModuleName, exportName, params);
+        if (!result.success) {
+            throw new Error(`matches.${exportName} failed: ${result.reason ?? 'unknown'}`);
+        }
+        return result.body;
+    }
 }

package/dist/kit/matchmaking.d.ts

@@ -0,0 +1,57 @@
+import type { Scalars } from '../generated/graphql.js';
+import type { EngineDetector } from './engine.js';
+/** Options for {@link MatchmakingKit}. */
+export interface MatchmakingKitOptions {
+    /** The matchmaking module name. Defaults to `'matchmaking'`. */
+    moduleName?: string;
+}
+/** Your queue status: where you are queued and any live proposal. */
+export interface KitQueueStatus {
+    queuedIn: string | null;
+    proposal: {
+        proposalId: string;
+        mode: string;
+        players: string[];
+        accepted: string[];
+        handedOff: boolean;
+    } | null;
+    queueDepth: number;
+    rating: number;
+}
+/**
+ * Runtime helpers for the matchmaking engine (Wave 2): rating-bucketed
+ * queues with widening windows, party blocks, and accept-gated proposals
+ * that hand off to the match layer over compute events. After everyone
+ * accepts, resolve the created match with `kit.matches.findByProposal`.
+ *
+ * Obtained via `client.kit(appId).matchmaking`.
+ */
+export declare class MatchmakingKit {
+    private readonly engines;
+    private readonly moduleName;
+    constructor(_appId: Scalars['BigInt']['input'], engines: EngineDetector, options?: MatchmakingKitOptions);
+    /** Is the matchmaking engine deployed + enabled (cached per session)? */
+    engineAvailable(): Promise<boolean>;
+    /**
+     * Join a queue (optionally with a party block that must match together,
+     * and an explicit rating for games that keep rating on the progression
+     * layer).
+     */
+    queueJoin(input?: {
+        mode?: string;
+        rating?: number;
+        party?: string[];
+    }): Promise<Record<string, unknown>>;
+    /** Leave your queue (all modes, or one with `mode`). */
+    queueLeave(mode?: string): Promise<Record<string, unknown>>;
+    /** Your queue/proposal status. */
+    queueStatus(mode?: string): Promise<KitQueueStatus>;
+    /** Accept a proposal; when everyone has, the match handoff fires. */
+    accept(proposalId: string): Promise<Record<string, unknown>>;
+    /** Report the decided result (Elo-lite rating update + proposal close). */
+    reportResult(proposalId: string, winnerUserId: string): Promise<Record<string, unknown>>;
+    /** Engine totals (queues/proposals/rated players). */
+    status(): Promise<Record<string, unknown>>;
+    private invoke;
+}
+//# sourceMappingURL=matchmaking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matchmaking.d.ts","sourceRoot":"","sources":["../../src/kit/matchmaking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGlC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjB,OAAO,EAAE,cAAc,EACxC,OAAO,GAAE,qBAA0B;IAKrC,yEAAyE;IACzE,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC;;;;OAIG;IACG,SAAS,CAAC,KAAK,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO;IAIhF,wDAAwD;IAClD,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM;IAI9B,kCAAkC;IAC5B,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAUzD,qEAAqE;IAC/D,MAAM,CAAC,UAAU,EAAE,MAAM;IAI/B,2EAA2E;IACrE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAI3D,sDAAsD;IAChD,MAAM;YAIE,MAAM;CAOrB"}

package/dist/kit/matchmaking.js

@@ -0,0 +1,59 @@
+/**
+ * Runtime helpers for the matchmaking engine (Wave 2): rating-bucketed
+ * queues with widening windows, party blocks, and accept-gated proposals
+ * that hand off to the match layer over compute events. After everyone
+ * accepts, resolve the created match with `kit.matches.findByProposal`.
+ *
+ * Obtained via `client.kit(appId).matchmaking`.
+ */
+export class MatchmakingKit {
+    constructor(_appId, engines, options = {}) {
+        this.engines = engines;
+        this.moduleName = options.moduleName ?? 'matchmaking';
+    }
+    /** Is the matchmaking engine deployed + enabled (cached per session)? */
+    engineAvailable() {
+        return this.engines.has(this.moduleName);
+    }
+    /**
+     * Join a queue (optionally with a party block that must match together,
+     * and an explicit rating for games that keep rating on the progression
+     * layer).
+     */
+    async queueJoin(input = {}) {
+        return this.invoke('queue_join', input);
+    }
+    /** Leave your queue (all modes, or one with `mode`). */
+    async queueLeave(mode) {
+        return this.invoke('queue_leave', mode ? { mode } : {});
+    }
+    /** Your queue/proposal status. */
+    async queueStatus(mode) {
+        const body = await this.invoke('queue_status', mode ? { mode } : {});
+        return {
+            queuedIn: body.queuedIn != null ? String(body.queuedIn) : null,
+            proposal: body.proposal ?? null,
+            queueDepth: Number(body.queueDepth ?? 0),
+            rating: Number(body.rating ?? 0),
+        };
+    }
+    /** Accept a proposal; when everyone has, the match handoff fires. */
+    async accept(proposalId) {
+        return this.invoke('accept', { proposalId });
+    }
+    /** Report the decided result (Elo-lite rating update + proposal close). */
+    async reportResult(proposalId, winnerUserId) {
+        return this.invoke('report_result', { proposalId, winnerUserId });
+    }
+    /** Engine totals (queues/proposals/rated players). */
+    async status() {
+        return this.invoke('status', {});
+    }
+    async invoke(exportName, params) {
+        const result = await this.engines.invoke(this.moduleName, exportName, params);
+        if (!result.success) {
+            throw new Error(`matchmaking.${exportName} failed: ${result.reason ?? 'unknown'}`);
+        }
+        return result.body;
+    }
+}

package/dist/kit/minigames.d.ts

@@ -0,0 +1,30 @@
+import type { Scalars } from '../generated/graphql.js';
+import type { EngineDetector, EngineInvokeResult } from './engine.js';
+/** Options for {@link MinigamesKit}. */
+export interface MinigamesKitOptions {
+    /** Default module when calls omit one (e.g. your scaffolded game). */
+    defaultModuleName?: string;
+}
+/**
+ * A thin invoke wrapper for invoke-loop minigames (the Wave 2 `minigame`
+ * scaffold pattern): synchronous `play` RPCs with server-bound caller
+ * identity, server-held secrets, and per-caller records. Every method
+ * resolves the engine envelope — denials come back as
+ * `{success: false, reason}` rather than throwing.
+ *
+ * Obtained via `client.kit(appId).minigames`.
+ */
+export declare class MinigamesKit {
+    private readonly engines;
+    private readonly defaultModuleName?;
+    constructor(_appId: Scalars['BigInt']['input'], engines: EngineDetector, options?: MinigamesKitOptions);
+    /** Is a minigame module deployed + enabled (cached per session)? */
+    engineAvailable(moduleName?: string): Promise<boolean>;
+    /** One round: invoke the game's `play` export with your move. */
+    play(params: Record<string, unknown>, moduleName?: string): Promise<EngineInvokeResult>;
+    /** Your per-caller record. */
+    record(moduleName?: string): Promise<EngineInvokeResult>;
+    /** Any other export the game defines (typed result envelope). */
+    invoke(exportName: string, params?: Record<string, unknown>, moduleName?: string): Promise<EngineInvokeResult>;
+}
+//# sourceMappingURL=minigames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"minigames.d.ts","sourceRoot":"","sources":["../../src/kit/minigames.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtE,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAKrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAS;gBAG1C,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EACjB,OAAO,EAAE,cAAc,EACxC,OAAO,GAAE,mBAAwB;IAKnC,oEAAoE;IACpE,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtD,iEAAiE;IAC3D,IAAI,CACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC;IAI9B,8BAA8B;IACxB,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI9D,iEAAiE;IAC3D,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC;CAO/B"}

package/dist/kit/minigames.js

@@ -0,0 +1,38 @@
+/**
+ * A thin invoke wrapper for invoke-loop minigames (the Wave 2 `minigame`
+ * scaffold pattern): synchronous `play` RPCs with server-bound caller
+ * identity, server-held secrets, and per-caller records. Every method
+ * resolves the engine envelope — denials come back as
+ * `{success: false, reason}` rather than throwing.
+ *
+ * Obtained via `client.kit(appId).minigames`.
+ */
+export class MinigamesKit {
+    constructor(_appId, engines, options = {}) {
+        this.engines = engines;
+        this.defaultModuleName = options.defaultModuleName;
+    }
+    /** Is a minigame module deployed + enabled (cached per session)? */
+    engineAvailable(moduleName) {
+        const name = moduleName ?? this.defaultModuleName;
+        if (!name)
+            return Promise.resolve(false);
+        return this.engines.has(name);
+    }
+    /** One round: invoke the game's `play` export with your move. */
+    async play(params, moduleName) {
+        return this.invoke('play', params, moduleName);
+    }
+    /** Your per-caller record. */
+    async record(moduleName) {
+        return this.invoke('record', {}, moduleName);
+    }
+    /** Any other export the game defines (typed result envelope). */
+    async invoke(exportName, params = {}, moduleName) {
+        const name = moduleName ?? this.defaultModuleName;
+        if (!name) {
+            return { success: false, reason: 'no minigame module configured', body: {} };
+        }
+        return this.engines.invoke(name, exportName, params);
+    }
+}