@forgeax/engine-devkit 0.1.2

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,CA8EjC"}

package/dist/sdk.d.ts

@@ -0,0 +1,69 @@
+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;
+    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":"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"}

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/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/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,CAuBnC"}

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":"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"}

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,CAmR5B;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"}

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

@@ -0,0 +1,16 @@
+import { type CarrierOffer, type CarrierStateMachine } from '@forgeax/engine-tool-runtime';
+export { type CarrierProvider, createCarrierProvider } from './carrier-provider.js';
+export interface CarrierRendezvousOptions {
+    readonly presentation: 'hidden' | 'visible';
+    readonly projectId: string;
+    readonly consumerId: string;
+    readonly now: number;
+    readonly endpoint?: string;
+    readonly ttlMs?: number;
+}
+export interface CarrierRendezvous extends CarrierStateMachine {
+    readonly lookup: () => CarrierOffer | undefined;
+    readonly lookupCount: number;
+}
+export declare function createCarrierRendezvous(options: CarrierRendezvousOptions): CarrierRendezvous;
+//# sourceMappingURL=carrier-rendezvous.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"carrier-rendezvous.d.ts","sourceRoot":"","sources":["../../src/tools/carrier-rendezvous.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAEzB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,KAAK,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,YAAY,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAqB5F"}

package/dist/tools/catalog.d.ts

@@ -0,0 +1,66 @@
+import { type ToolContribution, type ToolDescriptor, type ToolRunOptions, type ToolTerminal } from '@forgeax/engine-tool-runtime';
+import type { BuildOptions, PluginInstallOptions } from '../types.js';
+import type { OfflineAnalysisRequest, OfflineAnalysisResult } from './offline-analysis.js';
+import type { PreviewHostRequest, PreviewHostResult } from './preview-host.js';
+export interface ToolCatalogAuthority {
+    readonly authorityDigest?: string;
+    readonly root?: string;
+    readonly read?: () => Promise<ToolCatalogAuthoritySnapshot>;
+    readonly projectionPath?: string;
+}
+export interface ToolCatalogAuthoritySnapshot {
+    readonly authorityDigest: string;
+    readonly descriptors: readonly ToolDescriptor[];
+}
+export interface ToolCatalogEntry {
+    readonly id: string;
+    readonly title: string;
+    readonly summary: string;
+    readonly realm: ToolDescriptor['realm'];
+    readonly evidence: ToolDescriptor['evidence'];
+    readonly argsSchema?: string;
+    readonly resultSchema?: string;
+}
+export interface ToolCatalog {
+    readonly schemaVersion: '1.0.0';
+    readonly authorityDigest: string;
+    readonly digest: string;
+    readonly entries: readonly ToolCatalogEntry[];
+}
+export type ToolCatalogLoadResult = {
+    readonly ok: true;
+    readonly value: ToolCatalog;
+} | {
+    readonly ok: false;
+    readonly error: {
+        readonly code: 'tool-catalog-authority-unreadable' | 'tool-catalog-projection-invalid';
+        readonly expected: string;
+        readonly hint: string;
+        readonly detail: Readonly<Record<string, string>>;
+    };
+};
+export declare const projectBuildDescriptor: ToolDescriptor<BuildOptions, unknown>;
+export declare const authorPluginInstallDescriptor: ToolDescriptor<PluginInstallOptions, unknown>;
+export declare const previewRunDescriptor: ToolDescriptor<PreviewHostRequest, PreviewHostResult>;
+export declare const previewOfflineAnalysisDescriptor: ToolDescriptor<OfflineAnalysisRequest, OfflineAnalysisResult>;
+export declare const defaultToolDescriptors: readonly ToolDescriptor[];
+export interface ToolRealmOwner {
+    readonly realm: ToolDescriptor['realm'];
+    readonly contributions: readonly ToolContribution[];
+}
+export interface ToolRealmDispatch {
+    readonly list: () => readonly ToolDescriptor[];
+    readonly describe: (id: string) => ToolDescriptor | undefined;
+    readonly run: <TResult = unknown>(id: string, args: unknown, options?: ToolRunOptions) => Promise<ToolTerminal<TResult>>;
+}
+/** Dispatches a descriptor to the one physical owner for its declared realm. */
+export declare function createRealmDispatch(contributions: readonly ToolContribution[], owners: readonly ToolRealmOwner[]): ToolRealmDispatch;
+export declare function createProjectToolCatalogAuthority(rootInput: string, descriptors?: readonly ToolDescriptor[]): ToolCatalogAuthority;
+export declare function loadToolCatalog(authority: ToolCatalogAuthority, descriptors?: readonly ToolDescriptor[]): Promise<ToolCatalogLoadResult>;
+export declare function materializeToolCatalog<TArgs, TResult>(contributions: readonly ToolContribution<TArgs, TResult>[], authority: ToolCatalogAuthority): ToolCatalog;
+export declare function materializeToolCatalog(contributions: readonly unknown[], authority: ToolCatalogAuthority): ToolCatalog;
+export declare function materializeToolDescriptorCatalog(descriptors: readonly ToolDescriptor[], authority: ToolCatalogAuthority): ToolCatalog;
+export declare function rebuildToolCatalog<TArgs, TResult>(contributions: readonly ToolContribution<TArgs, TResult>[], current: ToolCatalog | undefined, authority: ToolCatalogAuthority): ToolCatalog;
+export declare function listTools(catalog: ToolCatalog): readonly ToolCatalogEntry[];
+export declare function describeTool(catalog: ToolCatalog, id: string): ToolCatalogEntry | undefined;
+//# sourceMappingURL=catalog.d.ts.map

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

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

package/dist/tools/cli-adapter.d.ts

@@ -0,0 +1,5 @@
+import { type ToolRuntime, type ToolTerminal } from '@forgeax/engine-tool-runtime';
+export declare function decorateResourcePreviewTerminal<TResult>(terminal: ToolTerminal<TResult>): ToolTerminal<TResult>;
+export declare function runNamedTool(runtime: ToolRuntime, id: string, args: unknown): Promise<ToolTerminal<unknown>>;
+export declare function runGenericTool(runtime: ToolRuntime, id: string, encodedArgs: string): Promise<ToolTerminal<unknown>>;
+//# sourceMappingURL=cli-adapter.d.ts.map

package/dist/tools/cli-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-adapter.d.ts","sourceRoot":"","sources":["../../src/tools/cli-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,8BAA8B,CAAC;AAEtC,wBAAgB,+BAA+B,CAAC,OAAO,EACrD,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,GAC9B,YAAY,CAAC,OAAO,CAAC,CAkBvB;AAUD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAIhC;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAiBhC"}

package/dist/tools/client.d.ts

@@ -0,0 +1,18 @@
+import { type ToolContribution, type ToolRunOptions, type ToolTerminal } from '@forgeax/engine-tool-runtime';
+import { type ToolCatalogEntry, type ToolRealmOwner } from './catalog.js';
+import type { ProjectToolBinding, ProjectToolDiscoveryOptions } from './project-tools.js';
+export interface ToolClientOptions extends ProjectToolDiscoveryOptions {
+    readonly projectRoot: string;
+    /** Optional physical realm owners used by a host/carrier integration. */
+    readonly realmOwners?: readonly ToolRealmOwner[];
+    /** Injectable builtins for physical host tests and alternate Engine adapters. */
+    readonly baseContributions?: readonly ToolContribution[];
+    readonly projectDiscovery?: (projectRoot: string) => Promise<readonly ProjectToolBinding[]>;
+}
+export interface ToolClient {
+    readonly list: () => readonly ToolCatalogEntry[];
+    readonly describe: (id: string) => ToolCatalogEntry | undefined;
+    readonly run: <TResult = unknown>(id: string, args: unknown, options?: ToolRunOptions) => Promise<ToolTerminal<TResult>>;
+}
+export declare function createToolClient(options: ToolClientOptions): Promise<ToolClient>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/tools/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAE1F,MAAM,WAAW,iBAAkB,SAAQ,2BAA2B;IACpE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACjD,iFAAiF;IACjF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;CAC7F;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,gBAAgB,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,GAAG,OAAO,EAC9B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;CACrC;AAeD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmDtF"}

package/dist/tools/commands.d.ts

@@ -0,0 +1,6 @@
+import type { CommandResult, OperationCommandOptions } from '../types.js';
+export declare function listCommand(root?: string): Promise<CommandResult<unknown>>;
+export declare function describeCommand(options: OperationCommandOptions): Promise<CommandResult<unknown>>;
+export declare function runCommand(options: OperationCommandOptions): Promise<CommandResult<unknown>>;
+export declare function execCommand(options: OperationCommandOptions): Promise<CommandResult<unknown>>;
+//# sourceMappingURL=commands.d.ts.map