@crowdedkingdoms/crowdyjs 8.6.0 → 8.8.0

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;
+    }
+}

package/dist/kit/engine.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Compute-engine capability detection + invoke envelope for the kit helpers.
+ * Games deploy engines (mob-engine, world-engine, bwf-mobs, ...) as compute
+ * modules; kit helpers probe once per module per session and route through
+ * the engine when it is present, falling back to the model/automation path
+ * when it is not — so the same client code works on model-only deployments.
+ */
+import type { ComputeAPI } from '../domains/compute.js';
+/** The `{success, ...}` envelope engine invoke exports resolve with. */
+export interface EngineInvokeResult<T = Record<string, unknown>> {
+    success: boolean;
+    /** The engine's denial reason when `success` is false. */
+    reason?: string;
+    /** The parsed result body (includes any extra fields the export returns). */
+    body: T & Record<string, unknown>;
+    fuelUsed?: string;
+    durationUs?: number;
+}
+/**
+ * Per-session cached probe of which compute modules an app has enabled.
+ * Obtained internally by kit helpers; share one via `kit.engines`.
+ */
+export declare class EngineDetector {
+    private readonly appId;
+    private readonly compute;
+    private readonly cache;
+    constructor(appId: string, compute: ComputeAPI | undefined);
+    /**
+     * Is `moduleName` deployed + enabled? Cached per module for the client's
+     * lifetime ({@link reset} to re-probe after deploys). Resolves false when
+     * the client has no compute domain wired.
+     */
+    has(moduleName: string): Promise<boolean>;
+    /** Drop cached probes (call after deploying/enabling modules). */
+    reset(): void;
+    /**
+     * Invoke an engine export and parse the `{success, ...}` envelope.
+     * Envelope failures (denials) resolve — only transport/user errors throw.
+     */
+    invoke<T = Record<string, unknown>>(moduleName: string, exportName: string, params?: Record<string, unknown>): Promise<EngineInvokeResult<T>>;
+    private probe;
+}
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/kit/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,wEAAwE;AACxE,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;gBAG1C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAAG,SAAS;IAGlD;;;;OAIG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUzC,kEAAkE;IAClE,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;YAwCnB,KAAK;CAmBpB"}

package/dist/kit/engine.js

@@ -0,0 +1,108 @@
+/**
+ * Compute-engine capability detection + invoke envelope for the kit helpers.
+ * Games deploy engines (mob-engine, world-engine, bwf-mobs, ...) as compute
+ * modules; kit helpers probe once per module per session and route through
+ * the engine when it is present, falling back to the model/automation path
+ * when it is not — so the same client code works on model-only deployments.
+ */
+import { CrowdyGraphQLError } from '../errors.js';
+/**
+ * Per-session cached probe of which compute modules an app has enabled.
+ * Obtained internally by kit helpers; share one via `kit.engines`.
+ */
+export class EngineDetector {
+    constructor(appId, compute) {
+        this.appId = appId;
+        this.compute = compute;
+        this.cache = new Map();
+    }
+    /**
+     * Is `moduleName` deployed + enabled? Cached per module for the client's
+     * lifetime ({@link reset} to re-probe after deploys). Resolves false when
+     * the client has no compute domain wired.
+     */
+    has(moduleName) {
+        if (!this.compute)
+            return Promise.resolve(false);
+        let probe = this.cache.get(moduleName);
+        if (!probe) {
+            probe = this.probe(moduleName);
+            this.cache.set(moduleName, probe);
+        }
+        return probe;
+    }
+    /** Drop cached probes (call after deploying/enabling modules). */
+    reset() {
+        this.cache.clear();
+    }
+    /**
+     * Invoke an engine export and parse the `{success, ...}` envelope.
+     * Envelope failures (denials) resolve — only transport/user errors throw.
+     */
+    async invoke(moduleName, exportName, params) {
+        if (!this.compute) {
+            return {
+                success: false,
+                reason: 'compute domain unavailable',
+                body: {},
+            };
+        }
+        try {
+            const result = await this.compute.invoke({
+                appId: this.appId,
+                moduleName,
+                exportName,
+                ...(params !== undefined ? { paramsJson: JSON.stringify(params) } : {}),
+            });
+            let body = {};
+            try {
+                body = JSON.parse(result.resultJson ?? '{}');
+            }
+            catch {
+                body = {};
+            }
+            return {
+                success: body.success !== false,
+                reason: typeof body.reason === 'string' ? body.reason : undefined,
+                body: body,
+                fuelUsed: result.fuelUsed != null ? String(result.fuelUsed) : undefined,
+                durationUs: result.durationUs != null ? Number(result.durationUs) : undefined,
+            };
+        }
+        catch (error) {
+            if (error instanceof CrowdyGraphQLError) {
+                return {
+                    success: false,
+                    reason: error.message,
+                    body: {},
+                };
+            }
+            throw error;
+        }
+    }
+    async probe(moduleName) {
+        if (!this.compute)
+            return false;
+        try {
+            const module = await this.compute.module({ appId: this.appId, name: moduleName });
+            return module != null && module.enabled === true;
+        }
+        catch (error) {
+            if (!(error instanceof CrowdyGraphQLError))
+                throw error;
+            if (error.code !== 'FORBIDDEN')
+                return false;
+        }
+        // Player tokens lack view_compute_diagnostics: probe via a status invoke
+        // (engines all export one). Missing modules reject; denials mean present.
+        try {
+            const result = await this.invoke(moduleName, 'status');
+            if (result.success)
+                return true;
+            return !/not found|no such module|not enabled/i.test(result.reason ?? '');
+        }
+        catch {
+            return false;
+        }
+    }
+}

package/dist/kit/index.d.ts

@@ -2,18 +2,26 @@ export { andPolicies, combatBlueprint, combatNames, composeBlueprints, decksBlue
 export { GameKitClient, type GameKitDomains, type GameKitOptions, type KitDeployResult, } from './kit.js';
 export { MatchesKit, type KitMatch, type KitMatchScore, type MatchesKitOptions, } from './matches.js';
 export { InventoryKit, type InventoryKitOptions, type KitItemStack } from './inventory.js';
-export { CombatKit, type CombatKitOptions, type KitCombatant, type KitStatusEffect, } from './combat.js';
+export { CombatKit, type CombatKitOptions, type KitCombatant, type KitRoutedAttack, type KitStatusEffect, } from './combat.js';
 export { DecksKit, type DecksKitOptions, type KitCard } from './decks.js';
 export { FeaturesKit } from './features.js';
-export { EconomyKit, type EconomyKitOptions, type KitMarketListing, type KitShopListing, type KitTradeOffer, type KitWallet, } from './economy.js';
+export { EconomyKit, MarketKit, type EconomyKitOptions, type KitMarketListing, type KitShopListing, type KitTradeOffer, type KitWallet, } from './economy.js';
 export { LeaderboardsKit, type KitLeaderboardEntry, type LeaderboardsKitOptions, } from './leaderboards.js';
 export { LootKit, type KitLootRoll, type LootKitOptions } from './loot.js';
 export { ObjectsKit, type ObjectsKitOptions } from './objects.js';
-export { NpcsKit, type NpcsKitOptions, type KitNpc } from './npcs.js';
+export { NpcsKit, type KitNpc, type LiveNpcPose, type NpcsKitOptions, } from './npcs.js';
+export { MobsKit, type KitAttackResult, type KitMobDef, type KitMobSlot, type MobsKitOptions, } from './mobs.js';
+export { PetsKit, type KitPet, type KitPetResult, type PetsKitOptions, } from './pets.js';
+export { EngineDetector, type EngineInvokeResult } from './engine.js';
+export { InstancesKit, type InstancesKitOptions, type KitInstance, } from './instances.js';
+export { DirectorKit, type DirectorKitOptions, type KitDirectorRun, type KitWaveSpec, } from './director.js';
+export { MatchmakingKit, type KitQueueStatus, type MatchmakingKitOptions, } from './matchmaking.js';
+export { MinigamesKit, type MinigamesKitOptions } from './minigames.js';
+export { EVENT_CONTACT_DAMAGE, EVENT_WEATHER, FLAG_GROUNDED, FLAG_MOB, FLAG_NPC, FLAG_RESERVED3, POSE_BYTES, decodeEnginePose, encodeEnginePose, engineLanes, enginePoseCodec, parseContactDamage, parseEngineEvent, parseProposalEvent, parseScoreEvent, parseTurnEvent, parseWeatherEvent, poseSuffix, EVENT_PROPOSAL, EVENT_SCORE, EVENT_TURN, type ContactDamageEvent, type EnginePose, type ProposalEvent, type ScoreEvent, type TurnEvent, type WeatherEvent, } from './wire.js';
 export { PlotsKit, type PlotsKitOptions, type KitPlot } from './plots.js';
 export { QuestsKit, type KitQuestDef, type KitQuestProgress, type QuestsKitOptions, } from './quests.js';
 export { ProgressionKit, type KitAchievementDef, type KitAchievementUnlock, type KitProgress, type KitSkillDef, type KitSkillRank, type ProgressionKitOptions, } from './progression.js';
 export { SocialKit, type KitChatMessage, type KitGroupWithChannel, type SocialKitOptions, } from './social.js';
-export { WorldsimKit, type KitCrop, type KitResourceNode, type KitWaveSpawner, type KitWorldState, type WorldsimKitOptions, } from './worldsim.js';
+export { WorldsimKit, type KitCrop, type KitForecast, type KitResourceNode, type KitWaveSpawner, type KitWorldState, type WorldsimKitOptions, } from './worldsim.js';
 export { kitInvoke, toKitInvokeResult, type KitInvokeResult, type RawInvokeResult, } from './shared.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/kit/index.js

@@ -5,11 +5,19 @@ export { InventoryKit } from './inventory.js';
 export { CombatKit, } from './combat.js';
 export { DecksKit } from './decks.js';
 export { FeaturesKit } from './features.js';
-export { EconomyKit, } from './economy.js';
+export { EconomyKit, MarketKit, } from './economy.js';
 export { LeaderboardsKit, } from './leaderboards.js';
 export { LootKit } from './loot.js';
 export { ObjectsKit } from './objects.js';
-export { NpcsKit } from './npcs.js';
+export { NpcsKit, } from './npcs.js';
+export { MobsKit, } from './mobs.js';
+export { PetsKit, } from './pets.js';
+export { EngineDetector } from './engine.js';
+export { InstancesKit, } from './instances.js';
+export { DirectorKit, } from './director.js';
+export { MatchmakingKit, } from './matchmaking.js';
+export { MinigamesKit } from './minigames.js';
+export { EVENT_CONTACT_DAMAGE, EVENT_WEATHER, FLAG_GROUNDED, FLAG_MOB, FLAG_NPC, FLAG_RESERVED3, POSE_BYTES, decodeEnginePose, encodeEnginePose, engineLanes, enginePoseCodec, parseContactDamage, parseEngineEvent, parseProposalEvent, parseScoreEvent, parseTurnEvent, parseWeatherEvent, poseSuffix, EVENT_PROPOSAL, EVENT_SCORE, EVENT_TURN, } from './wire.js';
 export { PlotsKit } from './plots.js';
 export { QuestsKit, } from './quests.js';
 export { ProgressionKit, } from './progression.js';

package/dist/kit/instances.d.ts

@@ -0,0 +1,52 @@
+import type { Scalars } from '../generated/graphql.js';
+import type { EngineDetector } from './engine.js';
+/** Options for {@link InstancesKit}. */
+export interface InstancesKitOptions {
+    /** The instance-engine module name. Defaults to `'instance-engine'`. */
+    moduleName?: string;
+}
+/** A parsed instance (private world slice). */
+export interface KitInstance {
+    instanceId: string;
+    name: string;
+    creator: string;
+    members: string[];
+    /** Decimal string (u64 seeds exceed JS safe integers). */
+    seed: string;
+    status: string;
+    outcome: string;
+    sessionId: string;
+    containerId: string;
+    /** Reserved chunk-volume corner [x, y, z]. */
+    chunkBase: [number, number, number];
+    volumeChunks: number;
+}
+/**
+ * Runtime helpers for the instance-engine (Wave 2): private world slices
+ * with lifecycle (open/join/complete), per-run seeds for deterministic
+ * procedural content, and reserved disjoint chunk volumes. v1 spatial
+ * isolation is by-convention (disjoint volumes + distance-scoped emits).
+ *
+ * Obtained via `client.kit(appId).instances`.
+ */
+export declare class InstancesKit {
+    private readonly engines;
+    private readonly moduleName;
+    constructor(_appId: Scalars['BigInt']['input'], engines: EngineDetector, options?: InstancesKitOptions);
+    /** Is the instance engine deployed + enabled (cached per session)? */
+    engineAvailable(): Promise<boolean>;
+    /** Open a new instance (caller becomes creator + first member). */
+    open(input?: {
+        name?: string;
+        seed?: string;
+        sessionId?: string;
+    }): Promise<KitInstance>;
+    /** Join an open instance. */
+    join(instanceId: string): Promise<KitInstance>;
+    /** Complete an instance (member-only; announces `instance_completed`). */
+    complete(instanceId: string, outcome?: string): Promise<KitInstance>;
+    /** One instance's state (or the engine's totals without an id). */
+    state(instanceId?: string): Promise<KitInstance | Record<string, unknown>>;
+    private invoke;
+}
+//# sourceMappingURL=instances.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/kit/instances.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,aAAa,CAAC;AAEtE,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;CACtB;AAsBD;;;;;;;GAOG;AACH,qBAAa,YAAY;IAKrB,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,mBAAwB;IAKnC,sEAAsE;IACtE,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAInC,mEAAmE;IAC7D,IAAI,CAAC,KAAK,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAKlG,6BAA6B;IACvB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAKpD,0EAA0E;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAK1E,mEAAmE;IAC7D,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAKlE,MAAM;CAUrB"}

package/dist/kit/instances.js

@@ -0,0 +1,60 @@
+function toInstance(body) {
+    return {
+        instanceId: String(body.instanceId ?? ''),
+        name: String(body.name ?? ''),
+        creator: String(body.creator ?? ''),
+        members: Array.isArray(body.members) ? body.members.map(String) : [],
+        seed: String(body.seed ?? '0'),
+        status: String(body.status ?? ''),
+        outcome: String(body.outcome ?? ''),
+        sessionId: String(body.sessionId ?? ''),
+        containerId: String(body.containerId ?? ''),
+        chunkBase: (Array.isArray(body.chunkBase) ? body.chunkBase : [0, 0, 0]).map(Number),
+        volumeChunks: Number(body.volumeChunks ?? 0),
+    };
+}
+/**
+ * Runtime helpers for the instance-engine (Wave 2): private world slices
+ * with lifecycle (open/join/complete), per-run seeds for deterministic
+ * procedural content, and reserved disjoint chunk volumes. v1 spatial
+ * isolation is by-convention (disjoint volumes + distance-scoped emits).
+ *
+ * Obtained via `client.kit(appId).instances`.
+ */
+export class InstancesKit {
+    constructor(_appId, engines, options = {}) {
+        this.engines = engines;
+        this.moduleName = options.moduleName ?? 'instance-engine';
+    }
+    /** Is the instance engine deployed + enabled (cached per session)? */
+    engineAvailable() {
+        return this.engines.has(this.moduleName);
+    }
+    /** Open a new instance (caller becomes creator + first member). */
+    async open(input = {}) {
+        const result = await this.invoke('open', input);
+        return toInstance(result.body);
+    }
+    /** Join an open instance. */
+    async join(instanceId) {
+        const result = await this.invoke('join', { instanceId });
+        return toInstance(result.body);
+    }
+    /** Complete an instance (member-only; announces `instance_completed`). */
+    async complete(instanceId, outcome) {
+        const result = await this.invoke('complete', { instanceId, outcome });
+        return toInstance(result.body);
+    }
+    /** One instance's state (or the engine's totals without an id). */
+    async state(instanceId) {
+        const result = await this.invoke('state', instanceId ? { instanceId } : {});
+        return instanceId ? toInstance(result.body) : result.body;
+    }
+    async invoke(exportName, params) {
+        const result = await this.engines.invoke(this.moduleName, exportName, params);
+        if (!result.success) {
+            throw new Error(`instances.${exportName} failed: ${result.reason ?? 'unknown'}`);
+        }
+        return result;
+    }
+}