@forgeax/engine-devkit 0.0.0-dev.8d955ade1c79

package/dist/sdk-install.d.ts

@@ -0,0 +1,7 @@
+import type { CommandResult } from './types.js';
+export interface SdkInstallOptions {
+    readonly root: string;
+    readonly version?: string;
+}
+export declare function sdkInstallCommand(options: SdkInstallOptions): Promise<CommandResult<unknown>>;
+//# sourceMappingURL=sdk-install.d.ts.map

package/dist/sdk-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-install.d.ts","sourceRoot":"","sources":["../src/sdk-install.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAUD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAsFjC"}

package/dist/sdk-update.d.ts

@@ -0,0 +1,23 @@
+declare const UPDATE_MIGRATION_RISK = "Install a newer SDK in a separate directory. Existing games remain pinned and are not migrated automatically; review release notes and migrate and test each game before changing its Engine version.";
+export type SdkUpdateStatus = {
+    readonly status: 'available';
+    readonly currentVersion: string;
+    readonly latestVersion: string;
+    readonly migrationRisk: typeof UPDATE_MIGRATION_RISK;
+} | {
+    readonly status: 'current';
+    readonly currentVersion: string;
+    readonly latestVersion: string;
+} | {
+    readonly status: 'skipped';
+    readonly currentVersion: string;
+    readonly reason: 'offline' | 'disabled';
+} | {
+    readonly status: 'unavailable';
+    readonly currentVersion: string;
+    readonly reason: string;
+};
+export declare function newerSdkVersion(currentVersion: string, latestVersion: string): boolean;
+export declare function checkSdkUpdate(currentVersion: string): Promise<SdkUpdateStatus>;
+export {};
+//# sourceMappingURL=sdk-update.d.ts.map

package/dist/sdk-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-update.d.ts","sourceRoot":"","sources":["../src/sdk-update.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,qBAAqB,0MAC8K,CAAC;AAE1M,MAAM,MAAM,eAAe,GACvB;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,qBAAqB,CAAC;CACtD,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;CACzC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAyDN,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CActF;AAMD,wBAAsB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmCrF"}

package/dist/sdk.d.ts

@@ -0,0 +1,74 @@
+export interface SdkPackage {
+    readonly name: string;
+    readonly version: string;
+    readonly root: string;
+    readonly fileCount: number;
+    readonly byteCount: number;
+}
+export interface SdkTemplate {
+    readonly id: string;
+    readonly root: string;
+    readonly default: boolean;
+}
+export interface SdkSkill {
+    readonly id: string;
+    readonly root: string;
+    readonly fileCount: number;
+    readonly byteCount: number;
+}
+export interface SdkSourceWasm {
+    readonly package: string;
+    readonly root: string;
+    readonly files: readonly string[];
+}
+export interface SdkResource {
+    readonly id: string;
+    readonly package: string;
+    readonly sourceRoot: string;
+    readonly packageRoot: string;
+    readonly files: readonly string[];
+}
+export interface SdkTemplateResource {
+    readonly id: string;
+    readonly root: string;
+    readonly files: readonly string[];
+}
+export interface SdkSource {
+    readonly root: 'source/engine';
+    readonly format: 'git-archive-public-snapshot';
+    readonly excluded: readonly ['.gitmodules', 'forgeax-engine-assets'];
+    readonly fileCount: number;
+    readonly byteCount: number;
+    readonly prebuiltWasm: readonly SdkSourceWasm[];
+}
+export interface SdkManifest {
+    readonly schemaVersion: '1.6.0';
+    readonly sdkVersion: string;
+    readonly engineCommit: string;
+    readonly requirements: {
+        readonly node: string;
+        readonly pnpm: string;
+        readonly pnpmStoreFormat: string;
+    };
+    readonly capabilities: readonly string[];
+    readonly packages: readonly SdkPackage[];
+    readonly templates: readonly SdkTemplate[];
+    readonly skills: readonly SdkSkill[];
+    readonly resources: readonly SdkResource[];
+    readonly templateResources: readonly SdkTemplateResource[];
+    readonly source: SdkSource;
+}
+export interface SdkContext {
+    readonly root: string;
+    readonly manifest: SdkManifest;
+    /**
+     * The full ZIP carries an immutable offline store. The npm carrier is a
+     * deliberately smaller online surface and omits it, so consumers fall back
+     * to the registry when this path is absent.
+     */
+    readonly store?: string;
+    readonly templates: ReadonlyMap<string, string>;
+    readonly defaultTemplate: string;
+}
+export declare function findSdkContext(): Promise<SdkContext | undefined>;
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAC;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,aAAa,EAAE,CAAC;CACjD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;KAClC,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAWD,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAyBtE"}

package/dist/shader-check.d.ts

@@ -0,0 +1,3 @@
+import type { CommandResult, ShaderCheckOptions } from './types.js';
+export declare function shaderCheckCommand(options?: ShaderCheckOptions): Promise<CommandResult<unknown>>;
+//# sourceMappingURL=shader-check.d.ts.map

package/dist/shader-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-check.d.ts","sourceRoot":"","sources":["../src/shader-check.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEpE,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CA2BjC"}

package/dist/skill-install.d.ts

@@ -0,0 +1,16 @@
+import type { SdkContext } from './sdk.js';
+import type { CommandResult, ProjectCommandOptions } from './types.js';
+export declare const PROJECT_SKILL_MOUNT_ROOTS: readonly string[];
+export interface SkillInstallReport {
+    readonly root: string;
+    readonly sourceRoot: string;
+    readonly manifest: string;
+    readonly skills: readonly string[];
+    readonly mountRoots: readonly string[];
+}
+export declare function copySdkSkills(sdk: SdkContext, projectRoot: string): Promise<void>;
+export declare function installProjectSkills(root: string, provenance?: Pick<SdkContext['manifest'], 'sdkVersion' | 'engineCommit'>): Promise<SkillInstallReport>;
+export declare function verifyProjectSkills(root: string): Promise<SkillInstallReport>;
+export declare function skillInstallCommand(options?: ProjectCommandOptions): Promise<CommandResult<SkillInstallReport>>;
+export declare function skillVerifyCommand(options?: ProjectCommandOptions): Promise<CommandResult<SkillInstallReport>>;
+//# sourceMappingURL=skill-install.d.ts.map

package/dist/skill-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-install.d.ts","sourceRoot":"","sources":["../src/skill-install.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEvE,eAAO,MAAM,yBAAyB,mBAOpC,CAAC;AAqBH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAkFD,wBAAsB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmCvF;AAmED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC,GACvE,OAAO,CAAC,kBAAkB,CAAC,CA0H7B;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuCnF;AAED,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAQ5C;AAED,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAQ5C"}

package/dist/software-capture.d.ts

@@ -0,0 +1,102 @@
+import { type Page } from 'playwright';
+import type { CommandResult, SoftwareCaptureOptions } from './types.js';
+export interface CapturePixelWitness {
+    readonly width: number;
+    readonly height: number;
+    readonly sampledPixels: number;
+    readonly lumaMin: number;
+    readonly lumaMax: number;
+    readonly lumaRange: number;
+    readonly varyingPixels: number;
+    readonly rendered: boolean;
+}
+export interface SoftwareCaptureRuntimeWitness {
+    readonly title: string;
+    readonly canvas: {
+        readonly width: number;
+        readonly height: number;
+    } | null;
+    readonly domUi: {
+        readonly rootChildren: number;
+        readonly openShadowRoots: number;
+        readonly textWitness: string;
+    };
+    readonly adapter: Readonly<Record<string, unknown>> | null;
+    readonly adapterError: string | null;
+    readonly engineFrameId: number | null;
+    readonly captureReady: string | null;
+    readonly userAgent: string;
+}
+export interface SoftwareCaptureRecord {
+    readonly index: number;
+    readonly checkpoint: string | null;
+    readonly ok: boolean;
+    readonly output: string;
+    readonly digest: string;
+    readonly pixels: CapturePixelWitness;
+    readonly runtime: SoftwareCaptureRuntimeWitness;
+}
+export interface SoftwareCaptureRunReport {
+    readonly schemaVersion: '2.0.0';
+    readonly runId: string;
+    readonly ok: boolean;
+    readonly mode: 'advanced-cpu-only-development';
+    readonly root: string;
+    readonly url: string;
+    readonly report: string;
+    readonly softwareRequested: true;
+    readonly deterministicRequested: boolean;
+    readonly viewport: {
+        readonly width: number;
+        readonly height: number;
+        readonly deviceScaleFactor: 1;
+        readonly colorProfile: 'srgb';
+        readonly colorScheme: 'light';
+        readonly locale: 'en-US';
+        readonly timezone: 'UTC';
+    };
+    readonly browser: {
+        readonly version: string;
+        readonly executable: string;
+    };
+    readonly display: string | null;
+    readonly lavapipeIcd: string | null;
+    readonly captures: readonly SoftwareCaptureRecord[];
+    readonly consoleErrors: readonly string[];
+    readonly pageErrors: readonly string[];
+    readonly closedAt?: string;
+    readonly boundary: string;
+}
+export interface SoftwareBrowserOpenOptions {
+    readonly software: true;
+    readonly browser?: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly port?: number;
+    readonly requireUi?: boolean;
+    readonly deterministic?: boolean;
+    readonly outputDir?: string;
+    readonly report?: string;
+    readonly runId?: string;
+}
+export interface SoftwareCaptureCheckpointOptions {
+    readonly output?: string;
+    readonly waitMs?: number;
+    readonly requireUi?: boolean;
+}
+export interface SoftwareBrowserSession {
+    readonly page: Page;
+    readonly url: string;
+    readonly reportPath: string;
+    capture(checkpoint?: string, options?: SoftwareCaptureCheckpointOptions): Promise<SoftwareCaptureRecord>;
+    report(): SoftwareCaptureRunReport;
+    close(): Promise<void>;
+}
+export interface SoftwareBrowser {
+    open(options: SoftwareBrowserOpenOptions): Promise<SoftwareBrowserSession>;
+    close(): Promise<void>;
+}
+export declare function summarizeCapturePixels(rgba: Uint8Array, width: number, height: number): CapturePixelWitness;
+export declare function createSoftwareBrowser(root: string): SoftwareBrowser;
+export declare function softwareCaptureCommand(options: SoftwareCaptureOptions): Promise<CommandResult<unknown>>;
+//# sourceMappingURL=software-capture.d.ts.map

package/dist/software-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"software-capture.d.ts","sourceRoot":"","sources":["../src/software-capture.ts"],"names":[],"mappings":"AAOA,OAAO,EAA0B,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAI/D,OAAO,KAAK,EAAgB,aAAa,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAOtF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5E,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC;CACjD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,IAAI,CAAC;IACjC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;QAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CACL,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAClC,MAAM,IAAI,wBAAwB,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAyJD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,mBAAmB,CAkCrB;AAqWD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAanE;AAaD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CA4BjC"}

package/dist/tools/__tests__/browser-host-port.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-host-port.test.d.ts.map

package/dist/tools/__tests__/browser-host-port.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-host-port.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/browser-host-port.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/carrier-faults.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=carrier-faults.integration.test.d.ts.map

package/dist/tools/__tests__/carrier-faults.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carrier-faults.integration.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/carrier-faults.integration.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/carrier-provider.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=carrier-provider.integration.test.d.ts.map

package/dist/tools/__tests__/carrier-provider.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carrier-provider.integration.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/carrier-provider.integration.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/commands.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=commands.test.d.ts.map

package/dist/tools/__tests__/commands.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/commands.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/coverage-gaps.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=coverage-gaps.test.d.ts.map

package/dist/tools/__tests__/coverage-gaps.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-gaps.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/coverage-gaps.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/domain-catalog.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=domain-catalog.test.d.ts.map

package/dist/tools/__tests__/domain-catalog.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-catalog.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/domain-catalog.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/preview-owner-gate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=preview-owner-gate.test.d.ts.map

package/dist/tools/__tests__/preview-owner-gate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-owner-gate.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/preview-owner-gate.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/preview-publication.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=preview-publication.test.d.ts.map

package/dist/tools/__tests__/preview-publication.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-publication.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/preview-publication.test.ts"],"names":[],"mappings":""}

package/dist/tools/__tests__/realm-dispatch.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=realm-dispatch.integration.test.d.ts.map

package/dist/tools/__tests__/realm-dispatch.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realm-dispatch.integration.test.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/realm-dispatch.integration.test.ts"],"names":[],"mappings":""}

package/dist/tools/benchmark/__tests__/admission-fixtures.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=admission-fixtures.test.d.ts.map

package/dist/tools/benchmark/__tests__/admission-fixtures.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission-fixtures.test.d.ts","sourceRoot":"","sources":["../../../../src/tools/benchmark/__tests__/admission-fixtures.test.ts"],"names":[],"mappings":""}

package/dist/tools/benchmark/__tests__/benchmark-vocabulary-owner.test-d.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=benchmark-vocabulary-owner.test-d.d.ts.map

package/dist/tools/benchmark/__tests__/benchmark-vocabulary-owner.test-d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark-vocabulary-owner.test-d.d.ts","sourceRoot":"","sources":["../../../../src/tools/benchmark/__tests__/benchmark-vocabulary-owner.test-d.ts"],"names":[],"mappings":""}

package/dist/tools/benchmark/harness.d.ts

@@ -0,0 +1,17 @@
+import { type AdmissionThresholds, type BenchmarkAdmissionReport, type BenchmarkRecipe, type BenchmarkSample } from './report.js';
+export interface BenchmarkMeasurement {
+    readonly durationMs: number;
+    readonly peakRssBytes: number;
+    readonly exclusivePhasesMs?: Readonly<Record<string, number>>;
+    readonly rhiDebugOverheadMs?: number;
+    readonly carrierRendezvousMs?: number;
+    readonly cleanupPassed: boolean;
+    readonly evictionPassed: boolean;
+}
+export interface BenchmarkHarnessOptions {
+    readonly recipe: BenchmarkRecipe;
+    readonly measure: (mode: BenchmarkSample['mode'], phase: BenchmarkSample['phase'], index: number) => Promise<BenchmarkMeasurement> | BenchmarkMeasurement;
+    readonly thresholds?: AdmissionThresholds;
+}
+export declare function runBenchmarkAdmission(options: BenchmarkHarnessOptions): Promise<BenchmarkAdmissionReport>;
+//# sourceMappingURL=harness.d.ts.map

package/dist/tools/benchmark/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../../src/tools/benchmark/harness.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,eAAe,EAErB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,CAChB,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAC7B,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CAyBnC"}

package/dist/tools/benchmark/index.d.ts

@@ -0,0 +1,4 @@
+export { type BenchmarkHarnessOptions, type BenchmarkMeasurement, runBenchmarkAdmission, } from './harness.js';
+export { type AdmissionThresholds, type BenchmarkAdmissionReport, type BenchmarkModeReport, type BenchmarkRecipe, type BenchmarkSample, createAdmissionReport, DEFAULT_ADMISSION_THRESHOLDS, summarizeBenchmarkSamples, } from './report.js';
+export { calculateSampleStatistics, type SampleStatistics } from './statistics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/benchmark/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/benchmark/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,yBAAyB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tools/benchmark/report.d.ts

@@ -0,0 +1,54 @@
+import { type SampleStatistics } from './statistics.js';
+export interface BenchmarkRecipe {
+    readonly snapshotDigest: string;
+    readonly backend: string;
+    readonly viewport: readonly [number, number];
+    readonly inputDigest: string;
+    readonly frameCount: number;
+    readonly rhiDebug: boolean;
+    readonly profiler: boolean;
+    readonly carrierRendezvous: boolean;
+    readonly digest: string;
+}
+export interface BenchmarkSample {
+    readonly mode: 'private' | 'service';
+    readonly phase: 'cold' | 'warm';
+    readonly durationMs: number;
+    readonly peakRssBytes: number;
+    readonly exclusivePhasesMs: Readonly<Record<string, number>>;
+    readonly rhiDebugOverheadMs: number;
+    readonly carrierRendezvousMs: number;
+    readonly cleanupPassed: boolean;
+    readonly evictionPassed: boolean;
+    readonly recipeDigest: string;
+}
+export interface BenchmarkModeReport {
+    readonly samples: number;
+    readonly durationMs: SampleStatistics;
+    readonly peakRssBytes: SampleStatistics;
+    readonly cleanupPassed: boolean;
+    readonly evictionPassed: boolean;
+    readonly exclusivePhasesMs: Readonly<Record<string, SampleStatistics>>;
+}
+export interface AdmissionThresholds {
+    readonly sampleCountPerPhase: number;
+    readonly medianImprovement: number;
+    readonly p95Improvement: number;
+    readonly maxRegression: number;
+    readonly peakRssMultiplier: number;
+}
+export declare const DEFAULT_ADMISSION_THRESHOLDS: AdmissionThresholds;
+export interface BenchmarkAdmissionReport {
+    readonly schema: 'forgeax.tool-service-admission.v1';
+    readonly recipe: BenchmarkRecipe;
+    readonly thresholds: AdmissionThresholds;
+    readonly order: readonly BenchmarkSample['mode'][];
+    readonly private: BenchmarkModeReport;
+    readonly service: BenchmarkModeReport;
+    readonly valid: boolean;
+    readonly admitted: boolean;
+    readonly reasons: readonly string[];
+}
+export declare function summarizeBenchmarkSamples(samples: readonly BenchmarkSample[]): BenchmarkModeReport;
+export declare function createAdmissionReport(recipe: BenchmarkRecipe, samples: readonly BenchmarkSample[], thresholds?: AdmissionThresholds): BenchmarkAdmissionReport;
+//# sourceMappingURL=report.d.ts.map

package/dist/tools/benchmark/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/tools/benchmark/report.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,eAAO,MAAM,4BAA4B,EAAE,mBAM1C,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,mCAAmC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,mBAAmB,CA8BrB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,UAAU,GAAE,mBAAkD,GAC7D,wBAAwB,CAsD1B"}

package/dist/tools/benchmark/statistics.d.ts

@@ -0,0 +1,8 @@
+export interface SampleStatistics {
+    readonly count: number;
+    readonly median: number;
+    readonly p95: number;
+    readonly max: number;
+}
+export declare function calculateSampleStatistics(samples: readonly number[]): SampleStatistics;
+//# sourceMappingURL=statistics.d.ts.map

package/dist/tools/benchmark/statistics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statistics.d.ts","sourceRoot":"","sources":["../../../src/tools/benchmark/statistics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,CAStF"}

package/dist/tools/bootstrap.d.ts

@@ -0,0 +1,49 @@
+import type { Context } from '@forgeax/engine-plugin';
+import { type CatalogLoaderBootstrapValue, type GamePluginEntry, type PluginCatalog, type PluginRealm, projectPluginEntries } from '@forgeax/engine-plugin/loader';
+import { type RealmCapabilityMatrix } from '@forgeax/engine-tool-runtime';
+import { type ProjectBootstrapPlan } from '../host/project-bootstrap.js';
+import { type ResourceBootstrapPlan } from '../host/resource-bootstrap.js';
+import type { ProjectFacts } from '../types.js';
+export interface PreviewBootstrapRoots {
+    readonly project: ProjectBootstrapPlan;
+    readonly resource: (guid: string) => ResourceBootstrapPlan;
+}
+/** Derives both physical roots without sharing project gameplay closure. */
+export declare function createPreviewBootstrapRoots(facts: ProjectFacts): PreviewBootstrapRoots;
+export interface RealmBootstrapInput {
+    readonly realm: PluginRealm;
+    readonly catalog: PluginCatalog;
+    readonly catalogDigest: string;
+    readonly supportedRealms: readonly PluginRealm[];
+    readonly entries: readonly GamePluginEntry[];
+    readonly payload?: unknown;
+    readonly lifecycle?: RealmLifecycleAdapter;
+}
+export interface RealmLifecycleHandle {
+    readonly stop: () => Promise<void>;
+}
+export interface RealmLifecycleAdapter {
+    readonly start: (input: {
+        readonly realm: PluginRealm;
+        readonly entries: readonly ReturnType<typeof projectPluginEntries>[number][];
+        readonly catalog: PluginCatalog;
+        readonly catalogDigest: string;
+    }) => Promise<RealmLifecycleHandle>;
+}
+export type RealmBootstrapResult = {
+    readonly ok: true;
+    readonly value: {
+        readonly realm: PluginRealm;
+        readonly catalogDigest: string;
+        readonly entries: readonly ReturnType<typeof projectPluginEntries>[number][];
+        readonly loader?: CatalogLoaderBootstrapValue;
+        readonly lifecycle?: RealmLifecycleHandle;
+    };
+} | {
+    readonly ok: false;
+    readonly error: unknown;
+};
+/** Bootstrap one declared realm from the same static Catalog and clone-safe input. */
+export declare function bootstrapRealm(ctx: Context | undefined, input: RealmBootstrapInput): Promise<RealmBootstrapResult>;
+export declare function assertRealmCapability(matrix: RealmCapabilityMatrix, realm: PluginRealm): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/tools/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/tools/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,qBAAqB,CAAC;CAC5D;AAED,4EAA4E;AAC5E,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,YAAY,GAAG,qBAAqB,CAKtF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,SAAS,WAAW,EAAE,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE;QACtB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;QAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7E,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;QAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;KAChC,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACrC;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;QAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,2BAA2B,CAAC;QAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;KAC3C,CAAC;CACH,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpD,sFAAsF;AACtF,wBAAsB,cAAc,CAClC,GAAG,EAAE,OAAO,GAAG,SAAS,EACxB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAwD/B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAK7F"}

package/dist/tools/browser-host.d.ts

@@ -0,0 +1,27 @@
+import type { ToolPreviewRecipe, ToolPreviewResourceRequest } from '@forgeax/engine-app';
+import { type ResourcePreviewReport } from '@forgeax/engine-preview';
+import { type SnapshotRef, type ToolDomainFailure } from '@forgeax/engine-tool-runtime';
+import type { BootstrapRoot } from '../host/base-host.js';
+import type { PreviewHostResult } from './preview-host.js';
+export type BrowserHostResult = {
+    readonly ok: true;
+    readonly value: PreviewHostResult;
+} | {
+    readonly ok: false;
+    readonly error: ToolDomainFailure;
+};
+export interface ResourcePreviewReportInput {
+    readonly snapshot: SnapshotRef;
+    readonly subject: ResourcePreviewReport['subject'];
+    readonly presentation: ResourcePreviewReport['presentation'];
+    readonly oracle: ResourcePreviewReport['oracle'];
+}
+export interface BrowserHostOptions {
+    readonly publish?: boolean;
+}
+/** @internal Vite treats port 0 as its default 5173, not as an OS-assigned port. */
+export declare function allocateLoopbackPort(): Promise<number>;
+export declare function publishPreviewArtifacts(projectRoot: string, runId: string, result: PreviewHostResult, reportInput?: ResourcePreviewReportInput): Promise<PreviewHostResult>;
+export declare function runBrowserPreviewHost(projectRoot: string, recipe: ToolPreviewRecipe, snapshot: SnapshotRef, runId: string, signal: AbortSignal, bootstrapRoot?: BootstrapRoot, resource?: ToolPreviewResourceRequest, options?: BrowserHostOptions): Promise<BrowserHostResult>;
+export declare function runBrowserResourcePreviewHost(projectRoot: string, recipe: ToolPreviewRecipe, snapshot: SnapshotRef, runId: string, signal: AbortSignal, resource: ToolPreviewResourceRequest, options?: BrowserHostOptions): Promise<BrowserHostResult>;
+//# sourceMappingURL=browser-host.d.ts.map

package/dist/tools/browser-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-host.d.ts","sourceRoot":"","sources":["../../src/tools/browser-host.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,iBAAiB,EACjB,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA+B,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAClG,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAEvB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC;AA4B9D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,oFAAoF;AACpF,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CA0B5D;AAoBD,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,iBAAiB,EACzB,WAAW,CAAC,EAAE,0BAA0B,GACvC,OAAO,CAAC,iBAAiB,CAAC,CAmJ5B;AAsBD,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,EACnB,aAAa,GAAE,aAAmC,EAClD,QAAQ,CAAC,EAAE,0BAA0B,EACrC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAkR5B;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,0BAA0B,EACpC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAW5B"}

package/dist/tools/cache.d.ts

@@ -0,0 +1,14 @@
+import type { JsonValue } from '@forgeax/engine-tool-runtime';
+export interface ServiceCacheEntry {
+    readonly artifactDigest: string;
+    readonly value?: JsonValue;
+}
+export interface ServiceCache {
+    readonly get: (key: string) => ServiceCacheEntry | undefined;
+    readonly set: (key: string, entry: ServiceCacheEntry) => void;
+    readonly evict: (key: string) => boolean;
+    readonly clear: () => void;
+    readonly size: () => number;
+}
+export declare function createServiceCache(): ServiceCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/tools/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/tools/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CASjD"}

package/dist/tools/capability.d.ts

@@ -0,0 +1,2 @@
+export { createServiceCapability, type ServiceAdmissionExpectation, type ServiceAdmissionRef, type ServiceCapability, } from '@forgeax/engine-tool-runtime';
+//# sourceMappingURL=capability.d.ts.map

package/dist/tools/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/tools/capability.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,8BAA8B,CAAC"}

package/dist/tools/carrier-provider.d.ts

@@ -0,0 +1,31 @@
+import type { CarrierLeaseRequest, CarrierOffer, CarrierResult, CarrierState, CarrierStateMachine, ToolTerminal } from '@forgeax/engine-tool-runtime';
+export interface CarrierProvider {
+    readonly offer: CarrierOffer;
+    readonly accept: (request: CarrierLeaseRequest) => CarrierResult<{
+        readonly leaseId: string;
+    }>;
+    readonly started: (leaseId: string) => CarrierResult<CarrierState>;
+    readonly exit: (leaseId: string) => CarrierResult<CarrierState>;
+}
+export interface CarrierProviderServiceOptions {
+    readonly machine: CarrierStateMachine;
+    readonly descriptorDigest: string;
+    readonly recipeDigest: string;
+    readonly execute: (request: CarrierExecutionRequest) => Promise<ToolTerminal<unknown>> | ToolTerminal<unknown>;
+    readonly host?: '127.0.0.1' | 'localhost';
+}
+/** Local structural view keeps DevKit source-compatible with an unbuilt runtime dist. */
+export interface CarrierExecutionRequest {
+    readonly leaseId: string;
+    readonly descriptorDigest: string;
+    readonly recipeDigest: string;
+    readonly args: unknown;
+}
+export interface CarrierProviderService {
+    readonly endpoint: string;
+    readonly offer: CarrierOffer;
+    readonly close: () => Promise<void>;
+}
+export declare function createCarrierProviderService(options: CarrierProviderServiceOptions): Promise<CarrierProviderService>;
+export declare function createCarrierProvider(machine: CarrierStateMachine): CarrierProvider;
+//# sourceMappingURL=carrier-provider.d.ts.map

package/dist/tools/carrier-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carrier-provider.d.ts","sourceRoot":"","sources":["../../src/tools/carrier-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACb,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,aAAa,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/F,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAC,YAAY,CAAC,CAAC;IACnE,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAC,YAAY,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAChB,OAAO,EAAE,uBAAuB,KAC7B,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;CAC3C;AAED,yFAAyF;AACzF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AA8BD,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,sBAAsB,CAAC,CAwJjC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,GAAG,eAAe,CAWnF"}