@forgeax/engine-devkit 0.1.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/tools/commands.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAqB1E,wBAAsB,WAAW,CAAC,IAAI,SAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAGvF;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CA0BjC;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAsCjC;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAuCjC"}

package/dist/tools/contributions.d.ts

@@ -0,0 +1,6 @@
+import { type ToolContribution } from '@forgeax/engine-tool-runtime';
+import type { BuildOptions, PluginInstallOptions } from '../types.js';
+export declare function createBuildContribution(projectRoot?: string): ToolContribution<BuildOptions, unknown>;
+export declare function createAuthorContribution(projectRoot?: string): ToolContribution<PluginInstallOptions, unknown>;
+export declare function createDefaultContributions(projectRoot?: string): readonly (ToolContribution<BuildOptions, unknown> | ToolContribution<PluginInstallOptions, unknown> | ToolContribution<unknown, unknown>)[];
+//# sourceMappingURL=contributions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contributions.d.ts","sourceRoot":"","sources":["../../src/tools/contributions.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAgBtE,wBAAgB,uBAAuB,CACrC,WAAW,SAAgB,GAC1B,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAWzC;AAED,wBAAgB,wBAAwB,CACtC,WAAW,SAAgB,GAC1B,gBAAgB,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAWjD;AAED,wBAAgB,0BAA0B,CACxC,WAAW,SAAgB,GAC1B,SAAS,CACR,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,GACvC,gBAAgB,CAAC,oBAAoB,EAAE,OAAO,CAAC,GAC/C,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CACrC,EAAE,CAMF"}

package/dist/tools/library.d.ts

@@ -0,0 +1,3 @@
+import { type ToolContribution, type ToolRunOptions, type ToolTerminal } from '@forgeax/engine-tool-runtime';
+export declare function runLibraryTool<TArgs, TResult>(contribution: ToolContribution<TArgs, TResult>, args: TArgs, options?: ToolRunOptions): Promise<ToolTerminal<TResult>>;
+//# sourceMappingURL=library.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/tools/library.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,8BAA8B,CAAC;AAEtC,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAC3C,YAAY,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,EAC9C,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAEhC"}

package/dist/tools/migration.d.ts

@@ -0,0 +1,36 @@
+import type { MigrationCapabilityProbe, MigrationOperation } from '@forgeax/engine-tool-runtime';
+import { type ArtifactRef, capabilityUnavailableError, type ServiceCapability, type ToolRealm } from '@forgeax/engine-tool-runtime';
+export { createCapabilityToken, createMigrationRecipe, type MigrationCapabilityProbe, type MigrationOperation, type MigrationRecipe, probeMigrationTarget, } from '@forgeax/engine-tool-runtime';
+export type MigrationPath = 'private' | 'service';
+export interface MigrationTarget extends MigrationCapabilityProbe {
+}
+export interface MigrationRosterEntry {
+    readonly operation: MigrationOperation;
+    readonly owner: string;
+    readonly realm: ToolRealm;
+    readonly artifacts: readonly MigrationEvidence[];
+    readonly benefit: string;
+    readonly fallback: 'private';
+}
+export interface MigrationEvidence {
+    readonly owner: string;
+    readonly source: 'M3';
+    readonly ref: ArtifactRef;
+}
+export interface MigrationResolution {
+    readonly path: MigrationPath;
+    readonly operation: MigrationOperation;
+    readonly owner: string;
+    readonly artifacts: readonly MigrationEvidence[];
+    readonly service: ServiceCapability;
+}
+export type MigrationResolutionResult = {
+    readonly ok: true;
+    readonly value: MigrationResolution;
+} | {
+    readonly ok: false;
+    readonly error: ReturnType<typeof capabilityUnavailableError>;
+};
+export declare function createMigrationRoster(): readonly MigrationRosterEntry[];
+export declare function resolveMigration(entries: readonly MigrationRosterEntry[], operation: MigrationOperation, target: MigrationTarget): MigrationResolutionResult;
+//# sourceMappingURL=migration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/tools/migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACjG,OAAO,EACL,KAAK,WAAW,EAChB,0BAA0B,EAE1B,KAAK,iBAAiB,EAEtB,KAAK,SAAS,EACf,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;AAElD,MAAM,WAAW,eAAgB,SAAQ,wBAAwB;CAAG;AAEpE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAA;CAAE,CAAC;AAwF1F,wBAAgB,qBAAqB,IAAI,SAAS,oBAAoB,EAAE,CAKvE;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,oBAAoB,EAAE,EACxC,SAAS,EAAE,kBAAkB,EAC7B,MAAM,EAAE,eAAe,GACtB,yBAAyB,CAqC3B"}

package/dist/tools/native-preview.d.ts

@@ -0,0 +1,4 @@
+import { type ToolContribution, type ToolRunOptions, type ToolTerminal } from '@forgeax/engine-tool-runtime';
+export declare function isNativePreviewTool(id: string): boolean;
+export declare function runNativePreviewTool(contribution: ToolContribution<unknown, unknown>, args: unknown, options: ToolRunOptions, projectRoot: string): Promise<ToolTerminal<unknown>>;
+//# sourceMappingURL=native-preview.d.ts.map

package/dist/tools/native-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-preview.d.ts","sourceRoot":"","sources":["../../src/tools/native-preview.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,8BAA8B,CAAC;AAoBtC,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAChD,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAiMhC"}

package/dist/tools/offline-analysis.d.ts

@@ -0,0 +1,22 @@
+import { type PreviewArtifactManifest, type PreviewArtifactRole } from '@forgeax/engine-preview';
+import { type ToolArtifactManifest, type ToolDomainFailure, type ToolEvidenceKind } from '@forgeax/engine-tool-runtime';
+export interface OfflineAnalysisRequest {
+    readonly manifest: PreviewArtifactManifest | ToolArtifactManifest;
+    readonly required?: readonly (PreviewArtifactRole | ToolEvidenceKind)[];
+}
+export interface OfflineAnalysisResult {
+    readonly runId: string;
+    readonly captureId: string;
+    readonly artifacts: readonly {
+        readonly kind: string;
+        readonly digest: string;
+    }[];
+}
+export declare function analyzePreviewArtifacts(request: OfflineAnalysisRequest): {
+    readonly ok: true;
+    readonly value: OfflineAnalysisResult;
+} | {
+    readonly ok: false;
+    readonly error: ToolDomainFailure;
+};
+//# sourceMappingURL=offline-analysis.d.ts.map

package/dist/tools/offline-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-analysis.d.ts","sourceRoot":"","sources":["../../src/tools/offline-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EAEzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAEtB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,GAAG,oBAAoB,CAAC;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,EAAE,CAAC;CACzE;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnF;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,sBAAsB,GAE7B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAoC5D"}

package/dist/tools/preview-catalog.d.ts

@@ -0,0 +1,8 @@
+import type { PluginCatalog, ToolPlugin } from '@forgeax/engine-plugin';
+import { type NativePreviewHost } from '@forgeax/engine-preview';
+import type { ToolDescriptor } from '@forgeax/engine-tool-runtime';
+export declare const nativePreviewPlugins: readonly [readonly ["@forgeax/engine-preview/material", ToolPlugin], readonly ["@forgeax/engine-preview/mesh", ToolPlugin], readonly ["@forgeax/engine-preview/vfx", ToolPlugin], readonly ["@forgeax/engine-preview/texture", ToolPlugin]];
+export declare const nativePreviewTools: import("@forgeax/engine-tool-runtime").ToolContribution<unknown, unknown>[];
+export declare const nativePreviewDescriptors: readonly ToolDescriptor[];
+export declare function createNativePreviewCatalog(host: NativePreviewHost, selectedName?: string): PluginCatalog;
+//# sourceMappingURL=preview-catalog.d.ts.map

package/dist/tools/preview-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-catalog.d.ts","sourceRoot":"","sources":["../../src/tools/preview-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAKlF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,eAAO,MAAM,oBAAoB,6OAKvB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6EAA6D,CAAC;AAC7F,eAAO,MAAM,wBAAwB,EAAE,SAAS,cAAc,EAE7D,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,iBAAiB,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,aAAa,CAcf"}

package/dist/tools/preview-contributions.d.ts

@@ -0,0 +1,12 @@
+import { type ToolContribution } from '@forgeax/engine-tool-runtime';
+import { type OfflineAnalysisRequest, type OfflineAnalysisResult } from './offline-analysis.js';
+import type { PreviewHostRequest, PreviewHostResult } from './preview-host.js';
+export declare function createPreviewContribution(): ToolContribution<PreviewHostRequest, PreviewHostResult>;
+export declare function createOfflineAnalysisContribution(): ToolContribution<OfflineAnalysisRequest, OfflineAnalysisResult>;
+export declare function createPreviewContributions(): readonly ToolContribution<unknown, unknown>[];
+/**
+ * The discoverable preview surface is domain-specific. The generic recipe
+ * contribution remains available only as an explicit migration error.
+ */
+export declare function createDomainPreviewContributions(): readonly ToolContribution<unknown, unknown>[];
+//# sourceMappingURL=preview-contributions.d.ts.map

package/dist/tools/preview-contributions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-contributions.d.ts","sourceRoot":"","sources":["../../src/tools/preview-contributions.ts"],"names":[],"mappings":"AAMA,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEjF,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG/E,wBAAgB,yBAAyB,IAAI,gBAAgB,CAC3D,kBAAkB,EAClB,iBAAiB,CAClB,CAKA;AAED,wBAAgB,iCAAiC,IAAI,gBAAgB,CACnE,sBAAsB,EACtB,qBAAqB,CACtB,CAOA;AAED,wBAAgB,0BAA0B,IAAI,SAAS,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAK1F;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,IAAI,SAAS,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAOhG"}

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

@@ -0,0 +1,85 @@
+import { type ToolPreviewRecipeOptions, type ToolPreviewRunResult, type ToolPreviewTrace } from '@forgeax/engine-app';
+import type { CarrierLeaseRequest, CarrierOffer, CarrierResult, CarrierState, ToolDomainFailure, ToolExecutionContext } from '@forgeax/engine-tool-runtime';
+export interface PreviewHostRequest {
+    readonly recipe: ToolPreviewRecipeOptions;
+    readonly projectRoot?: string;
+    readonly carrier?: PreviewCarrierRoute;
+}
+export interface PreviewHostMechanisms {
+    readonly runId: string;
+    readonly projectRoot: string;
+    readonly backend: 'webgpu';
+    readonly signal: AbortSignal;
+}
+export interface PreviewHostSession {
+    readonly withSession: <T>(execute: (mechanisms: PreviewHostMechanisms) => Promise<T>) => Promise<T>;
+}
+/**
+ * Creates the physical host lease. Domain identity stays in the executor;
+ * this seam carries only browser, backend, and lexical run ownership.
+ */
+export declare function createPreviewHostSession(input: {
+    readonly runId: string;
+    readonly projectRoot: string;
+    readonly signal: AbortSignal;
+}): PreviewHostSession;
+export interface PreviewCarrierRoute {
+    readonly lookup: () => CarrierOffer | undefined;
+    readonly lease: (request: CarrierLeaseRequest) => CarrierResult<{
+        readonly leaseId: string;
+    }>;
+    readonly started: (leaseId: string) => CarrierResult<CarrierState>;
+    readonly execute: (leaseId: string, request: Omit<PreviewHostRequest, 'carrier'>, context: Pick<ToolExecutionContext, 'runId' | 'signal'>) => Promise<PreviewRouteResult<PreviewHostResult>>;
+    readonly exit: (leaseId: string) => CarrierResult<CarrierState>;
+    readonly now?: () => number;
+}
+export interface PreviewHostResult {
+    readonly actualCarrier: 'headless-private' | 'headed-private' | 'visible-consumer';
+    readonly trace: ToolPreviewTrace;
+    readonly captureId: string;
+    readonly drawCalls: number;
+    readonly committedDrawIndex: number;
+    readonly nonBlackPixels: number;
+    readonly actionTrace: ToolPreviewRunResult['actionTrace'];
+    readonly tape: ToolPreviewRunResult['tape'];
+    readonly profile: ToolPreviewRunResult['profile'];
+    readonly capturePng: ToolPreviewRunResult['capturePng'];
+    readonly png: ToolPreviewRunResult['png'];
+    readonly manifest: ToolPreviewRunResult['manifest'];
+    readonly artifacts: ToolPreviewRunResult['artifacts'];
+    readonly operationTiming: ToolPreviewRunResult['operationTiming'];
+    readonly resource?: import('@forgeax/engine-app').ToolPreviewResourceFacts;
+}
+export type PreviewHostRunner = (request: PreviewHostRequest, context: ToolExecutionContext) => Promise<{
+    readonly ok: true;
+    readonly value: PreviewHostResult;
+} | {
+    readonly ok: false;
+    readonly error: ToolDomainFailure;
+}>;
+type PreviewRouteResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: ToolDomainFailure;
+};
+export interface CarrierCleanupTrace {
+    readonly actualCarrier: 'headless-private' | 'headed-private' | 'visible-consumer';
+    readonly backend: 'webgpu';
+    readonly cleanup: readonly ['gpu', 'canvas', 'page', 'carrier'];
+    readonly failure: {
+        readonly code: 'tool-preview-carrier-exit';
+        readonly detail: {
+            readonly carrier: CarrierCleanupTrace['actualCarrier'];
+        };
+    };
+}
+export declare function createCarrierCleanupTrace(input: {
+    readonly actualCarrier: CarrierCleanupTrace['actualCarrier'];
+    readonly backend: 'webgpu';
+}): CarrierCleanupTrace;
+export declare function runCarrierPreviewRoute<T>(presentation: ToolPreviewRecipeOptions['presentation'], carrier: PreviewCarrierRoute | undefined, executePrivate: () => Promise<PreviewRouteResult<T>>, executeConsumer?: (leaseId: string) => Promise<PreviewRouteResult<T>>): Promise<PreviewRouteResult<T>>;
+export declare const runPreviewHost: PreviewHostRunner;
+export {};
+//# sourceMappingURL=preview-host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview-host.d.ts","sourceRoot":"","sources":["../../src/tools/preview-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAGtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,EACtB,OAAO,EAAE,CAAC,UAAU,EAAE,qBAAqB,KAAK,OAAO,CAAC,CAAC,CAAC,KACvD,OAAO,CAAC,CAAC,CAAC,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B,GAAG,kBAAkB,CAiBrB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,YAAY,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,aAAa,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAC,YAAY,CAAC,CAAC;IACnE,QAAQ,CAAC,OAAO,EAAE,CAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,EAC5C,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,QAAQ,CAAC,KACpD,OAAO,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAC,YAAY,CAAC,CAAC;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;IACnF,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAC1D,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACxD,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACtD,QAAQ,CAAC,eAAe,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,qBAAqB,EAAE,wBAAwB,CAAC;CAC5E;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CACR;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,CAC5D,CAAC;AAEF,KAAK,kBAAkB,CAAC,CAAC,IACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;IACnF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAChE,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;QAC3C,QAAQ,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAA;SAAE,CAAC;KAC7E,CAAC;CACH;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;CAC5B,GAAG,mBAAmB,CAUtB;AAWD,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,YAAY,EAAE,wBAAwB,CAAC,cAAc,CAAC,EACtD,OAAO,EAAE,mBAAmB,GAAG,SAAS,EACxC,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EACpD,eAAe,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAkB,GACpF,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAsBhC;AAED,eAAO,MAAM,cAAc,EAAE,iBAkF5B,CAAC"}

package/dist/tools/preview-migration.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDomainFailure, type ToolTerminal } from '@forgeax/engine-tool-runtime';
+export declare const retiredPreviewOperationFailure: ToolDomainFailure;
+export declare function retiredPreviewTool(): ToolTerminal<never>;
+//# sourceMappingURL=preview-migration.d.ts.map

package/dist/tools/preview-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-migration.d.ts","sourceRoot":"","sources":["../../src/tools/preview-migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,8BAA8B,CAAC;AAEtC,eAAO,MAAM,8BAA8B,EAAE,iBAQ5C,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,YAAY,CAAC,KAAK,CAAC,CAWxD"}

package/dist/tools/private-executor.d.ts

@@ -0,0 +1,3 @@
+import type { ToolContribution, ToolRunOptions, ToolRuntime, ToolTerminal } from '@forgeax/engine-tool-runtime';
+export declare function runPrivateTool<TArgs, TResult>(runtime: ToolRuntime, contribution: ToolContribution<TArgs, TResult>, args: TArgs, options?: ToolRunOptions): Promise<ToolTerminal<TResult>>;
+//# sourceMappingURL=private-executor.d.ts.map

package/dist/tools/private-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-executor.d.ts","sourceRoot":"","sources":["../../src/tools/private-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,YAAY,EACb,MAAM,8BAA8B,CAAC;AAEtC,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAC3C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,EAC9C,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAEhC"}

package/dist/tools/project-tools.d.ts

@@ -0,0 +1,23 @@
+import { type ToolPlugin } from '@forgeax/engine-plugin';
+import { type PluginRealm } from '@forgeax/engine-plugin/loader';
+import { type GameProjectPluginEntry } from '@forgeax/engine-project';
+import type { ToolContribution, ToolRunOptions, ToolTerminal } from '@forgeax/engine-tool-runtime';
+export interface ProjectToolBinding {
+    readonly contribution: ToolContribution<unknown, unknown>;
+    readonly entry: GameProjectPluginEntry;
+    readonly moduleName: string;
+    readonly realm: PluginRealm;
+    readonly toolPlugin?: ToolPlugin;
+    readonly loadToolPlugin: () => Promise<ToolPlugin>;
+}
+export interface ProjectToolModuleLoader {
+    readonly load: (name: string) => Promise<unknown>;
+    readonly close: () => Promise<void>;
+}
+export interface ProjectToolDiscoveryOptions {
+    readonly moduleLoader?: ProjectToolModuleLoader;
+    readonly loadModules?: boolean;
+}
+export declare function discoverProjectTools(rootInput: string, options?: ProjectToolDiscoveryOptions): Promise<readonly ProjectToolBinding[]>;
+export declare function runProjectTool(binding: ProjectToolBinding, args: unknown, options: ToolRunOptions): Promise<ToolTerminal<unknown>>;
+//# sourceMappingURL=project-tools.d.ts.map

package/dist/tools/project-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-tools.d.ts","sourceRoot":"","sources":["../../src/tools/project-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAIL,KAAK,WAAW,EAEjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,KAAK,sBAAsB,EAAqB,MAAM,yBAAyB,CAAC;AACzF,OAAO,KAAK,EACV,gBAAgB,EAEhB,cAAc,EACd,YAAY,EACb,MAAM,8BAA8B,CAAC;AAGtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAwHD,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAyDxC;AAgBD,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAqChC"}

package/dist/tools/realms.d.ts

@@ -0,0 +1,22 @@
+import type { ToolRealm } from '@forgeax/engine-tool-runtime';
+import { createRealmCapabilityMatrix as createRuntimeRealmCapabilityMatrix, type RealmCapability, type RealmCapabilityInput, type RealmCapabilityMatrix } from '@forgeax/engine-tool-runtime';
+export type { RealmCapability, RealmCapabilityInput, RealmCapabilityMatrix };
+export { createRuntimeRealmCapabilityMatrix as createRealmCapabilityMatrix };
+export declare function resolveRealmCapability(matrix: RealmCapabilityMatrix, realm: ToolRealm): RealmCapability;
+declare const RESOURCE_KINDS: readonly ["process", "port", "page", "canvas", "fiber"];
+export type ResourceKind = (typeof RESOURCE_KINDS)[number];
+export interface ResourceProbe {
+    readonly observe: (kind: ResourceKind, id: string) => void;
+    readonly release: (kind: ResourceKind, id: string) => void;
+    readonly owner: (id: string) => ResourceOwner;
+    readonly snapshot: () => Readonly<Record<ResourceKind, readonly string[]>>;
+}
+export interface ResourceOwner {
+    readonly id: string;
+    readonly observe: (kind: ResourceKind, resourceId: string) => void;
+    readonly release: (kind: ResourceKind, resourceId: string) => void;
+    readonly stop: () => void;
+}
+export declare function createResourceProbe(): ResourceProbe;
+export { createResourceBootstrapPlan, createResourceBootstrapTrace, type ResourceBootstrapPlan, type ResourceBootstrapTrace, type ResourceBootstrapTraceInput, } from '../host/resource-bootstrap.js';
+//# sourceMappingURL=realms.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"realms.d.ts","sourceRoot":"","sources":["../../src/tools/realms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EACL,2BAA2B,IAAI,kCAAkC,EACjE,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,CAAC;AAC7E,OAAO,EAAE,kCAAkC,IAAI,2BAA2B,EAAE,CAAC;AAE7E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,SAAS,GACf,eAAe,CAEjB;AAED,QAAA,MAAM,cAAc,yDAA0D,CAAC;AAC/E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,aAAa,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAgDnD;AAED,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,GACjC,MAAM,+BAA+B,CAAC"}

package/dist/tools/run-command.d.ts

@@ -0,0 +1,17 @@
+import type { OperationCommandOptions } from '../types.js';
+export declare function runOperationCommand(options: OperationCommandOptions): Promise<{
+    readonly outcome: "failed";
+    readonly failure: import("@forgeax/engine-tool-runtime").ToolRuntimeError;
+    readonly snapshotAfter?: import("@forgeax/engine-tool-runtime").SnapshotRef;
+    readonly artifacts: readonly import("@forgeax/engine-tool-runtime").ArtifactRef[];
+    readonly cleanup?: import("@forgeax/engine-tool-runtime").ToolCleanupReport;
+    readonly timing?: import("@forgeax/engine-tool-runtime").ToolTiming;
+} | {
+    readonly outcome: "succeeded";
+    readonly result: unknown;
+    readonly snapshotAfter?: import("@forgeax/engine-tool-runtime").SnapshotRef;
+    readonly artifacts: readonly import("@forgeax/engine-tool-runtime").ArtifactRef[];
+    readonly cleanup?: import("@forgeax/engine-tool-runtime").ToolCleanupReport;
+    readonly timing?: import("@forgeax/engine-tool-runtime").ToolTiming;
+}>;
+//# sourceMappingURL=run-command.d.ts.map

package/dist/tools/run-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../src/tools/run-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAI3D,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,uBAAuB;;;;;;;;;;;;;;GAKzE"}

package/dist/tools/runtime.d.ts

@@ -0,0 +1,5 @@
+import { type ToolContribution, type ToolRuntime } from '@forgeax/engine-tool-runtime';
+export declare function createDevkitToolRuntime<TArgs, TResult>(contributions: readonly ToolContribution<TArgs, TResult>[]): ToolRuntime;
+export declare function createDevkitToolRuntime(contributions: readonly unknown[]): ToolRuntime;
+export declare function createPreviewToolRuntime(): ToolRuntime;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/tools/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAGtC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EACpD,aAAa,EAAE,SAAS,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,GACzD,WAAW,CAAC;AACf,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,SAAS,OAAO,EAAE,GAAG,WAAW,CAAC;AAKxF,wBAAgB,wBAAwB,IAAI,WAAW,CAEtD"}

package/dist/tools/service-transport.d.ts

@@ -0,0 +1,17 @@
+import { type AuthenticatedLoopbackTransport, type ServiceWireHandler } from '@forgeax/engine-tool-runtime';
+export type { AuthenticatedLoopbackTransport, AuthenticatedLoopbackTransportOptions, ServiceWireHandler, ServiceWireRequest, } from '@forgeax/engine-tool-runtime';
+export { createAuthenticatedLoopbackTransport } from '@forgeax/engine-tool-runtime';
+export interface AuthenticatedLoopbackServiceOptions {
+    readonly bearerToken: string;
+    readonly handler: ServiceWireHandler;
+    readonly host?: '127.0.0.1' | 'localhost';
+    readonly expectedDescriptorDigest?: string;
+    readonly expectedRecipeDigest?: string;
+}
+export interface AuthenticatedLoopbackService {
+    readonly endpoint: string;
+    readonly transport: AuthenticatedLoopbackTransport;
+    readonly close: () => Promise<void>;
+}
+export declare function createAuthenticatedLoopbackService(options: AuthenticatedLoopbackServiceOptions): Promise<AuthenticatedLoopbackService>;
+//# sourceMappingURL=service-transport.d.ts.map

package/dist/tools/service-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-transport.d.ts","sourceRoot":"","sources":["../../src/tools/service-transport.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,8BAA8B,EAEnC,KAAK,kBAAkB,EAGxB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,8BAA8B,EAC9B,qCAAqC,EACrC,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,oCAAoC,EAAE,MAAM,8BAA8B,CAAC;AAEpF,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IAC1C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,8BAA8B,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAyCD,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,mCAAmC,GAC3C,OAAO,CAAC,4BAA4B,CAAC,CAsEvC"}

package/dist/tools/service.d.ts

@@ -0,0 +1,22 @@
+import { type AuthenticatedLoopbackTransport, type ServiceAdmissionRef, type ServiceCapability, type ToolContribution, type ToolTerminal } from '@forgeax/engine-tool-runtime';
+export interface ServiceExecutorOptions<TArgs, TResult> {
+    readonly contribution: ToolContribution<TArgs, TResult>;
+    readonly privateExecutor: (args: TArgs) => Promise<ToolTerminal<TResult>>;
+    readonly transport: AuthenticatedLoopbackTransport;
+    readonly admission?: ServiceAdmissionRef;
+    readonly descriptorDigest: string;
+    readonly recipeDigest: string;
+    readonly workloadClass: string;
+    readonly codeDigest: string;
+    readonly browserVersion: string;
+    readonly bearerToken?: string;
+}
+export interface ServiceExecutor<TArgs, TResult> {
+    readonly capability: ServiceCapability;
+    readonly run: (args: TArgs, options?: {
+        readonly recipeDigest?: string;
+        readonly signal?: AbortSignal;
+    }) => Promise<ToolTerminal<TResult>>;
+}
+export declare function createServiceExecutor<TArgs, TResult>(options: ServiceExecutorOptions<TArgs, TResult>): ServiceExecutor<TArgs, TResult>;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/tools/service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,8BAA8B,EAMnC,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,sBAAsB,CAAC,KAAK,EAAE,OAAO;IACpD,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxD,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E,QAAQ,CAAC,SAAS,EAAE,8BAA8B,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe,CAAC,KAAK,EAAE,OAAO;IAC7C,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,CACZ,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KACxE,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;CACrC;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAClD,OAAO,EAAE,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,GAC9C,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CA+CjC"}

package/dist/types.d.ts

@@ -0,0 +1,84 @@
+import type { GameProjectPluginEntry } from '@forgeax/engine-project';
+export type ForgeaXCommand = 'new' | 'init' | 'doctor' | 'test' | 'dev' | 'build' | 'package' | 'serve' | 'preview' | 'plugin.install' | 'plugin.uninstall' | 'skill.install' | 'skill.verify' | 'sdk.install' | 'asset.add' | 'asset.verify' | 'asset.inspect' | 'asset.list' | 'shader.check' | 'list' | 'describe' | 'run' | 'exec';
+export interface CommandError {
+    readonly code: string;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: Readonly<Record<string, unknown>>;
+}
+export type CommandResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: CommandError;
+};
+export interface CommandEnvelope<T = unknown> {
+    readonly schemaVersion: '1.0.0';
+    readonly command: ForgeaXCommand;
+    readonly ok: boolean;
+    readonly value?: T;
+    readonly error?: CommandError;
+}
+export interface ProjectFacts {
+    readonly root: string;
+    readonly id: string;
+    readonly name: string;
+    readonly entry: string;
+    readonly bootstrapEntry?: string;
+    readonly plugins: readonly GameProjectPluginEntry[];
+    readonly physics?: '2d' | '3d';
+    readonly defaultScene?: string;
+    readonly assetRoots: readonly string[];
+    readonly assetImporters?: readonly string[];
+    readonly assetPublicDir?: string;
+    readonly packageJson: Readonly<Record<string, unknown>>;
+}
+export interface ProjectCommandOptions {
+    readonly root?: string;
+    readonly json?: boolean;
+}
+export interface InitOptions extends ProjectCommandOptions {
+    readonly dryRun?: boolean;
+    readonly install?: boolean;
+}
+export interface NewOptions extends ProjectCommandOptions {
+    readonly dryRun?: boolean;
+    readonly template?: string;
+}
+export interface BuildOptions extends ProjectCommandOptions {
+    readonly base?: string;
+    readonly outDir?: string;
+}
+export interface PackageOptions extends ProjectCommandOptions {
+    readonly output?: string;
+}
+export interface AssetAddOptions extends ProjectCommandOptions {
+    readonly path: string;
+    readonly dryRun?: boolean;
+}
+export interface AssetInspectOptions extends ProjectCommandOptions {
+    readonly subject: string;
+}
+export interface ShaderCheckOptions extends ProjectCommandOptions {
+    readonly path?: string;
+}
+export interface OperationCommandOptions extends ProjectCommandOptions {
+    readonly id?: string;
+    readonly args?: string;
+    readonly input?: string;
+    readonly program?: string;
+}
+export interface PluginInstallOptions extends ProjectCommandOptions {
+    readonly id: string;
+    readonly module: string;
+    readonly realm?: 'host' | 'engine' | 'build';
+    readonly dependency?: string;
+    readonly dryRun?: boolean;
+}
+export interface PluginUninstallOptions extends ProjectCommandOptions {
+    readonly id: string;
+    readonly dependency?: string;
+    readonly dryRun?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@forgeax/engine-devkit",
+  "version": "0.1.2",
+  "private": false,
+  "type": "module",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "description": "ForgeaX external game project CLI and build orchestration.",
+  "bin": {
+    "forgeax": "./dist/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./cli": "./dist/cli.mjs",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@forgeax/engine-animation": "0.1.2",
+    "@forgeax/engine-app": "0.1.2",
+    "@forgeax/engine-assets-runtime": "0.1.2",
+    "@forgeax/engine-audio": "0.1.2",
+    "@forgeax/engine-audio-webaudio": "0.1.2",
+    "@forgeax/engine-fbx": "0.1.2",
+    "@forgeax/engine-font": "0.1.2",
+    "@forgeax/engine-geometry": "0.1.2",
+    "@forgeax/engine-gltf": "0.1.2",
+    "@forgeax/engine-image": "0.1.2",
+    "@forgeax/engine-input": "0.1.2",
+    "@forgeax/engine-pack": "0.1.2",
+    "@forgeax/engine-physics": "0.1.2",
+    "@forgeax/engine-plugin": "0.1.2",
+    "@forgeax/engine-preview": "0.1.2",
+    "@forgeax/engine-project": "0.1.2",
+    "@forgeax/engine-render": "0.1.2",
+    "@forgeax/engine-render-graph": "0.1.2",
+    "@forgeax/engine-rhi-debug": "0.1.2",
+    "@forgeax/engine-runtime": "0.1.2",
+    "@forgeax/engine-scene": "0.1.2",
+    "@forgeax/engine-shader-compiler": "0.1.2",
+    "@forgeax/engine-skinning": "0.1.2",
+    "@forgeax/engine-tool-runtime": "0.1.2",
+    "@forgeax/engine-types": "0.1.2",
+    "@forgeax/engine-vfx-compiler": "0.1.2",
+    "@forgeax/engine-vite-plugin-pack": "0.1.2",
+    "@forgeax/engine-vite-plugin-shader": "0.1.2",
+    "jiti": "1.21.7",
+    "playwright": "1.60.0",
+    "vite": "8.0.10",
+    "vitest": "4.1.5"
+  },
+  "devDependencies": {
+    "@forgeax/engine-rhi-null": "0.1.2",
+    "@types/node": "^20.14.0"
+  },
+  "forgeax": {
+    "metrics": {
+      "bundle-size": {
+        "enabled": true,
+        "path": "dist/cli.mjs",
+        "compression": "gzip"
+      },
+      "fps": {
+        "enabled": false,
+        "reason": "Node-only build orchestration; runtime FPS belongs to consumer games"
+      },
+      "bench": {
+        "enabled": false,
+        "reason": "CLI latency is not a runtime hot path"
+      },
+      "gate": {
+        "enabled": true,
+        "command": "pnpm test",
+        "cwd": "packages/devkit"
+      },
+      "spike-report": {
+        "enabled": false,
+        "reason": "production DevKit package"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  }
+}