@metamesh/cli 0.0.0-stage → 0.13.0

package/dist/authoring/run.js

@@ -0,0 +1,304 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { builtinModules } from "node:module";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { build, transform } from "esbuild";
+import { defaultModelingLimits } from "@metamesh/modeling/engine";
+import { sha256, writeAtomicJson } from "./artifacts.js";
+import { checkAuthoringSource } from "./check.js";
+import { discoverAuthoringEnvironment, projectPackageDirectory } from "./environment.js";
+import { AuthoringError, authoringFailure } from "./errors.js";
+const builtin = new Set([...builtinModules, ...builtinModules.map((name) => `node:${name}`)]);
+async function terminateExecution(child) {
+    child.stdout?.destroy();
+    child.stderr?.destroy();
+    if (process.platform !== "win32") {
+        try {
+            if (child.pid !== undefined)
+                process.kill(-child.pid, "SIGKILL");
+        }
+        catch {
+            child.kill("SIGKILL");
+        }
+        return;
+    }
+    if (child.pid === undefined)
+        return;
+    await new Promise((done) => {
+        const killer = spawn("taskkill", ["/PID", String(child.pid), "/T", "/F"], {
+            stdio: "ignore",
+            windowsHide: true,
+        });
+        const fallback = setTimeout(() => {
+            child.kill("SIGKILL");
+            killer.kill();
+            done();
+        }, 1000);
+        const finish = () => {
+            clearTimeout(fallback);
+            child.kill("SIGKILL");
+            done();
+        };
+        killer.once("error", finish);
+        killer.once("close", finish);
+    });
+}
+async function bundleEntry(entry, project, outfile, kind, tsconfig) {
+    const imports = {};
+    const sourceHashes = new Map();
+    const capture = {
+        name: "preserve-installed-package-identities",
+        setup(builder) {
+            builder.onResolve({ filter: /^[^./\\]|^@/ }, async (args) => {
+                if (args.pluginData === "resolved" || isAbsolute(args.path) || builtin.has(args.path))
+                    return undefined;
+                const resolved = await builder.resolve(args.path, {
+                    resolveDir: args.resolveDir || project,
+                    kind: args.kind,
+                    pluginData: "resolved",
+                });
+                if (resolved.errors.length > 0)
+                    return { errors: resolved.errors };
+                if (projectPackageDirectory(args.resolveDir || project, args.path) === undefined)
+                    return { path: resolved.path };
+                imports[args.path] = resolved.path;
+                return {
+                    path: args.kind === "require-call" ? resolved.path : pathToFileURL(resolved.path).href,
+                    external: true,
+                };
+            });
+            builder.onLoad({ filter: /\.(?:[cm]?[jt]sx?|json)$/ }, async (args) => {
+                const contents = await readFile(args.path, "utf8");
+                sourceHashes.set(resolve(args.path), sha256(contents));
+                const extension = args.path.split(".").at(-1);
+                const loader = extension === "tsx" || extension === "jsx" || extension === "json"
+                    ? extension
+                    : extension.endsWith("ts")
+                        ? "ts"
+                        : "js";
+                if (!contents.includes("import.meta") || loader === "json")
+                    return { contents, loader, resolveDir: dirname(args.path) };
+                const transformed = await transform(contents, {
+                    loader,
+                    sourcefile: args.path,
+                    sourcemap: "inline",
+                    sourcesContent: true,
+                    target: "node24",
+                    format: "esm",
+                    define: {
+                        "import.meta.url": JSON.stringify(pathToFileURL(args.path).href),
+                        "import.meta.dirname": JSON.stringify(dirname(args.path)),
+                        "import.meta.filename": JSON.stringify(args.path),
+                    },
+                });
+                return { contents: transformed.code, loader: "js", resolveDir: dirname(args.path) };
+            });
+        },
+    };
+    const result = await build({
+        entryPoints: [entry],
+        outfile,
+        absWorkingDir: project,
+        bundle: true,
+        platform: "node",
+        format: "esm",
+        target: "node24",
+        sourcemap: "linked",
+        metafile: true,
+        logLevel: "silent",
+        plugins: [capture],
+        ...(tsconfig === undefined ? {} : { tsconfig }),
+    });
+    // Ask the same import-condition resolver for host entry points, independent of author imports.
+    await build({
+        stdin: {
+            contents: [
+                "@metamesh/modeling/engine",
+                "@metamesh/generator-sdk",
+                "@metamesh/generator-sdk/parameters",
+                "@metamesh/generator-sdk/packages",
+            ]
+                .filter((name) => name === "@metamesh/modeling/engine" || kind === "generator")
+                .map((name) => `import ${JSON.stringify(name)};`)
+                .join("\n"),
+            resolveDir: project,
+        },
+        absWorkingDir: project,
+        bundle: true,
+        platform: "node",
+        format: "esm",
+        write: false,
+        logLevel: "silent",
+        plugins: [capture],
+    });
+    const inputs = Object.keys(result.metafile.inputs).sort();
+    const hashes = inputs.map((input) => {
+        const file = resolve(project, input);
+        const fingerprint = sourceHashes.get(file);
+        if (fingerprint === undefined)
+            throw new AuthoringError("bundle", "UNTRACKED_SOURCE", `Cannot fingerprint bundled source ${input}.`, 1);
+        return `${relative(project, file).replaceAll("\\", "/")}:${fingerprint}`;
+    });
+    return { fingerprint: sha256(hashes.join("\n")), imports };
+}
+async function executeChild(request, runtimeDirectory, timeoutMs, onLog) {
+    const requestFile = join(runtimeDirectory, "request.json");
+    const resultFile = join(runtimeDirectory, "result.json");
+    await writeFile(requestFile, JSON.stringify(request));
+    const child = spawn(process.execPath, [
+        "--enable-source-maps",
+        fileURLToPath(new URL("./worker.js", import.meta.url)),
+        requestFile,
+        resultFile,
+    ], {
+        cwd: dirname(request.modulePath),
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+        detached: process.platform !== "win32",
+    });
+    let logBytes = 0;
+    const append = (chunk) => {
+        const available = Math.max(0, 64 * 1024 - logBytes);
+        if (available > 0)
+            onLog?.(chunk.subarray(0, available).toString("utf8"));
+        if (logBytes < 64 * 1024 && logBytes + chunk.length > 64 * 1024)
+            onLog?.("\n[MetaMesh author logs truncated at 64 KiB]\n");
+        logBytes += chunk.length;
+    };
+    child.stdout.on("data", append);
+    child.stderr.on("data", append);
+    let timedOut = false;
+    let terminated;
+    const timer = setTimeout(() => {
+        timedOut = true;
+        terminated = terminateExecution(child);
+    }, timeoutMs);
+    try {
+        const code = await new Promise((done, reject) => {
+            child.once("error", reject);
+            child.once("close", done);
+        });
+        if (timedOut) {
+            await terminated;
+            return {
+                success: false,
+                phase: "execute",
+                exitCode: 1,
+                diagnostics: [
+                    {
+                        code: "EXECUTION_TIMEOUT",
+                        severity: "error",
+                        message: `Generation exceeded its ${timeoutMs} ms deadline and was terminated.`,
+                    },
+                ],
+            };
+        }
+        if (code !== 0)
+            throw new AuthoringError("execute", "WORKER_FAILED", `Generation process exited with ${code ?? "a signal"}.`);
+        return JSON.parse(await readFile(resultFile, "utf8"));
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function runAuthoringSource(options) {
+    let directory;
+    let runtimeDirectory;
+    try {
+        const project = resolve(options.project ?? process.cwd());
+        const timeoutMs = options.timeoutMs ?? 30000;
+        if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 3600000)
+            throw new AuthoringError("invocation", "INVALID_TIMEOUT", "Timeout must be an integer from 1 to 3600000 milliseconds.");
+        const limits = { ...defaultModelingLimits, ...options.limits };
+        for (const [key, value] of Object.entries(limits))
+            if (!Object.hasOwn(defaultModelingLimits, key) ||
+                !Number.isSafeInteger(value) ||
+                value < (key === "maxCircularSegments" ? 3 : 1) ||
+                value > defaultModelingLimits[key])
+                throw new AuthoringError("invocation", "INVALID_LIMIT", `Resource limit ${key} must be a positive integer no greater than the engine default.`);
+        const runId = randomUUID();
+        directory = join(resolve(project, options.output ?? ".metamesh/runs"), runId);
+        await mkdir(directory, { recursive: true });
+        const checked = await checkAuthoringSource(options);
+        if (!checked.success) {
+            const failure = { ...checked, runDirectory: directory };
+            await writeAtomicJson(join(directory, "failure.json"), failure);
+            return failure;
+        }
+        const environment = await discoverAuthoringEnvironment(project);
+        runtimeDirectory = join(directory, ".runtime");
+        await mkdir(runtimeDirectory);
+        const modulePath = join(runtimeDirectory, "model.mjs");
+        let bundled;
+        try {
+            bundled = await bundleEntry(checked.entry, project, modulePath, options.kind, checked.tsconfig);
+        }
+        catch (error) {
+            throw new AuthoringError("bundle", "BUNDLE_FAILED", error instanceof Error ? error.message : String(error), 1);
+        }
+        const enginePath = bundled.imports["@metamesh/modeling/engine"];
+        if (enginePath === undefined)
+            throw new AuthoringError("environment", "ENGINE_NOT_INSTALLED", "Cannot resolve installed Modeling engine.");
+        const request = {
+            modulePath,
+            directory,
+            kind: options.kind,
+            params: options.params ?? {},
+            export3mf: options.export3mf ?? false,
+            enginePath,
+            ...(options.fontFixtures === undefined
+                ? {}
+                : { fontFixtures: resolve(project, options.fontFixtures) }),
+            ...(bundled.imports["@metamesh/generator-sdk"] === undefined
+                ? {}
+                : { sdkPath: bundled.imports["@metamesh/generator-sdk"] }),
+            ...(bundled.imports["@metamesh/generator-sdk/parameters"] === undefined
+                ? {}
+                : { parametersPath: bundled.imports["@metamesh/generator-sdk/parameters"] }),
+            ...(bundled.imports["@metamesh/generator-sdk/packages"] === undefined
+                ? {}
+                : { packagesPath: bundled.imports["@metamesh/generator-sdk/packages"] }),
+            metadata: {
+                formatVersion: 1,
+                status: "complete",
+                runId,
+                createdAt: new Date().toISOString(),
+                kind: options.kind,
+                source: {
+                    entry: relative(project, checked.entry).replaceAll("\\", "/"),
+                    fingerprint: bundled.fingerprint,
+                },
+                packages: Object.fromEntries(environment.packages.map(({ name, version }) => [name, version])),
+                policy: { timeoutMs, limits },
+            },
+        };
+        const result = await executeChild(request, runtimeDirectory, timeoutMs, options.onLog);
+        if (!result.success) {
+            await rm(join(directory, "manifest.json"), { force: true });
+            const failure = { ...result, runDirectory: directory };
+            await writeAtomicJson(join(directory, "failure.json"), failure);
+            return failure;
+        }
+        return result;
+    }
+    catch (error) {
+        const failure = {
+            ...authoringFailure(error),
+            ...(directory === undefined ? {} : { runDirectory: directory }),
+        };
+        if (directory !== undefined) {
+            await rm(join(directory, "manifest.json"), { force: true }).catch(() => undefined);
+            await writeAtomicJson(join(directory, "failure.json"), failure).catch(() => undefined);
+        }
+        return failure;
+    }
+    finally {
+        if (runtimeDirectory !== undefined &&
+            directory !== undefined &&
+            dirname(resolve(runtimeDirectory)) === resolve(directory))
+            await rm(runtimeDirectory, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/authoring/run.js.map

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

package/dist/authoring/types.d.ts

@@ -0,0 +1,138 @@
+import type { Bounds3, FinalizedModel, GenerationDiagnostic, ModelingLimits, Vector3 } from "@metamesh/modeling";
+import type { ModelDependencies, SnapshotPart } from "@metamesh/modeling/engine";
+export declare const AUTHORING_PROTOCOL_VERSION = 1;
+export type AuthoringKind = "model" | "generator";
+export type AuthoringPhase = "invocation" | "environment" | "check" | "parameters" | "assets" | "bundle" | "execute" | "artifact" | "render";
+export interface AuthoringDiagnostic {
+    readonly code: string;
+    readonly message: string;
+    readonly severity: "error" | "warning";
+    readonly file?: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly parameterId?: string;
+    readonly path?: readonly (number | string)[];
+    readonly context?: Readonly<Record<string, unknown>>;
+}
+export interface AuthoringFailure {
+    readonly success: false;
+    readonly phase: AuthoringPhase;
+    readonly exitCode: 1 | 2;
+    readonly diagnostics: readonly AuthoringDiagnostic[];
+    readonly runDirectory?: string;
+}
+export interface DocumentationEntry {
+    readonly id: string;
+    readonly title: string;
+    readonly summary: string;
+    readonly path: string;
+    readonly importPath: string;
+    readonly availability: string;
+    readonly canonical: string;
+    readonly keywords: readonly string[];
+}
+export interface DocumentationManifest {
+    readonly formatVersion: 1;
+    readonly packageName: string;
+    readonly packageVersion: string;
+    readonly documents: readonly DocumentationEntry[];
+}
+export interface InstalledAuthoringPackage {
+    readonly name: string;
+    readonly version: string;
+    readonly manifestPath: string;
+    readonly documentCount: number;
+}
+export interface AuthoringEnvironment {
+    readonly authoringProtocolVersion: typeof AUTHORING_PROTOCOL_VERSION;
+    readonly project: string;
+    readonly packages: readonly InstalledAuthoringPackage[];
+    readonly capabilities: readonly string[];
+}
+export interface CheckOptions {
+    readonly entry: string;
+    readonly kind: AuthoringKind;
+    readonly project?: string;
+    readonly tsconfig?: string;
+}
+export interface CheckSuccess {
+    readonly success: true;
+    readonly entry: string;
+    readonly kind: AuthoringKind;
+    readonly tsconfig?: string;
+    readonly diagnostics: readonly AuthoringDiagnostic[];
+}
+export interface RunOptions extends CheckOptions {
+    readonly params?: Readonly<Record<string, unknown>>;
+    readonly fontFixtures?: string;
+    readonly output?: string;
+    readonly timeoutMs?: number;
+    readonly limits?: Partial<ModelingLimits>;
+    readonly export3mf?: boolean;
+    readonly onLog?: (text: string) => void;
+}
+export interface CapturedBuffer {
+    readonly path: string;
+    readonly bytes: number;
+    readonly sha256: string;
+}
+export interface CapturedResource {
+    readonly id: string;
+    readonly positions: CapturedBuffer;
+    readonly indices: CapturedBuffer;
+    readonly measurements: SnapshotPart["measurements"];
+}
+export interface CapturedPart {
+    readonly id: string;
+    readonly resourceId: string;
+    readonly position: Vector3;
+    readonly rotation: Vector3;
+    readonly color?: string;
+    readonly measurements: SnapshotPart["measurements"];
+}
+export interface CapturedRunManifest {
+    readonly formatVersion: 1;
+    readonly status: "complete";
+    readonly runId: string;
+    readonly createdAt: string;
+    readonly kind: AuthoringKind;
+    readonly source: {
+        readonly entry: string;
+        readonly fingerprint: string;
+    };
+    readonly packages: Readonly<Record<string, string>>;
+    readonly parameters: Readonly<Record<string, unknown>>;
+    /** Effective Generator font selections, or declared and byte-verified standalone fixture revisions. */
+    readonly assets: readonly {
+        readonly faceId: string;
+        readonly revision: string;
+        readonly weight: number;
+    }[];
+    readonly policy: {
+        readonly timeoutMs: number;
+        readonly limits: ModelingLimits;
+    };
+    readonly diagnostics: readonly GenerationDiagnostic[];
+    readonly bounds: Bounds3;
+    readonly stats: FinalizedModel["stats"];
+    readonly dependencies: ModelDependencies;
+    readonly resources: readonly CapturedResource[];
+    readonly parts: readonly CapturedPart[];
+    readonly export3mf?: CapturedBuffer;
+}
+export interface CapturedGeometry {
+    readonly id: string;
+    readonly positions: Float32Array;
+    readonly indices: Uint32Array;
+}
+export interface CapturedRun {
+    readonly directory: string;
+    readonly manifest: CapturedRunManifest;
+    readonly resources: readonly CapturedGeometry[];
+}
+export interface RunSuccess {
+    readonly success: true;
+    readonly runDirectory: string;
+    readonly manifest: CapturedRunManifest;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/authoring/types.d.ts.map

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

package/dist/authoring/types.js

@@ -0,0 +1,2 @@
+export const AUTHORING_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/authoring/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/authoring/types.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC"}

package/dist/authoring/worker.d.ts

@@ -0,0 +1,15 @@
+import type { CapturedRunManifest } from "./types.js";
+export interface WorkerRequest {
+    readonly modulePath: string;
+    readonly directory: string;
+    readonly kind: "model" | "generator";
+    readonly params: Readonly<Record<string, unknown>>;
+    readonly fontFixtures?: string;
+    readonly export3mf: boolean;
+    readonly metadata: Omit<CapturedRunManifest, "resources" | "parts" | "bounds" | "stats" | "diagnostics" | "dependencies" | "export3mf" | "assets" | "parameters">;
+    readonly enginePath: string;
+    readonly sdkPath?: string;
+    readonly parametersPath?: string;
+    readonly packagesPath?: string;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/authoring/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/authoring/worker.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAGV,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CACrB,mBAAmB,EACjB,WAAW,GACX,OAAO,GACP,QAAQ,GACR,OAAO,GACP,aAAa,GACb,cAAc,GACd,WAAW,GACX,QAAQ,GACR,YAAY,CACf,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/dist/authoring/worker.js

@@ -0,0 +1,163 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { pathToFileURL } from "node:url";
+import { captureSnapshot } from "./artifacts.js";
+import { AuthoringError, authoringFailure, isRecord } from "./errors.js";
+function program(value) {
+    return isRecord(value) && value.kind === "metamesh-model" && typeof value.generate === "function";
+}
+async function execute(request) {
+    let snapshot;
+    let dispose;
+    let phase = "execute";
+    try {
+        const entry = await import(pathToFileURL(request.modulePath).href);
+        if (!isRecord(entry))
+            throw new AuthoringError("execute", "INVALID_ENTRY", "Author entry is not a module.", 1);
+        let model;
+        let definition;
+        let parameters = request.params;
+        if (request.kind === "generator") {
+            phase = "parameters";
+            if (request.packagesPath === undefined || request.parametersPath === undefined)
+                throw new AuthoringError("environment", "SDK_NOT_INSTALLED", "Generator execution requires the installed SDK.");
+            const packages = (await import(pathToFileURL(request.packagesPath).href));
+            const params = (await import(pathToFileURL(request.parametersPath).href));
+            definition = packages.parseGeneratorDefinition(entry.definition);
+            const parsed = params
+                .createParamCodec(definition)
+                .safeParse({ ...params.getDefaultParameters(definition), ...request.params });
+            if (!parsed.success)
+                return {
+                    success: false,
+                    phase: "parameters",
+                    exitCode: 1,
+                    diagnostics: parsed.issues.map((issue) => ({ ...issue, severity: "error" })),
+                };
+            parameters = parsed.data;
+            const runtime = entry.default;
+            if (!isRecord(runtime) ||
+                runtime.formatVersion !== packages.GENERATOR_PACKAGE_FORMAT_VERSION ||
+                runtime.generatorId !== definition.id ||
+                runtime.version !== definition.version ||
+                !program(runtime.generate))
+                throw new AuthoringError("execute", "INVALID_GENERATOR_MODULE", "Default export must be the Generator module envelope matching definition.", 1);
+            model = runtime.generate;
+        }
+        else {
+            if (!program(entry.default))
+                throw new AuthoringError("execute", "INVALID_MODEL_PROGRAM", "Default export must be an ordinary ModelProgram.", 1);
+            model = entry.default;
+        }
+        phase = "assets";
+        const loaded = request.fontFixtures === undefined
+            ? undefined
+            : await (await import("@metamesh/testkit/font-fixtures")).loadFontFixtures(request.fontFixtures);
+        let services;
+        if (definition !== undefined) {
+            if (loaded !== undefined)
+                services = await loaded.prepareServices(definition, parameters);
+            else if (definition.parameters.some(({ type }) => type === "font"))
+                throw new AuthoringError("assets", "FONT_FIXTURES_REQUIRED", "Generator Font parameters require --font-fixtures <local-descriptors.json>.", 1);
+            else {
+                if (request.sdkPath === undefined)
+                    throw new AuthoringError("environment", "SDK_NOT_INSTALLED", "Generator execution requires the installed SDK.");
+                services = (await import(pathToFileURL(request.sdkPath).href))
+                    .UNPREPARED_GENERATOR_SERVICES;
+            }
+        }
+        phase = "execute";
+        const { createModelEngine } = (await import(pathToFileURL(request.enginePath).href));
+        const engine = await createModelEngine();
+        const session = services === undefined
+            ? engine.createSession(model, {
+                limits: request.metadata.policy.limits,
+            })
+            : engine.createSession(model, {
+                services,
+                limits: request.metadata.policy.limits,
+            });
+        dispose = () => session.dispose();
+        snapshot = session.run(parameters);
+        const exported = request.export3mf ? await engine.export3mf(snapshot.parts) : undefined;
+        phase = "artifact";
+        const selectedAssets = definition === undefined
+            ? (loaded?.selections ?? [])
+            : definition.parameters
+                .filter(({ type }) => type === "font")
+                .map(({ id }) => parameters[id])
+                .filter((value) => isRecord(value) &&
+                typeof value.faceId === "string" &&
+                typeof value.revision === "string" &&
+                typeof value.weight === "number");
+        const manifest = await captureSnapshot(request.directory, snapshot, { ...request.metadata, assets: selectedAssets, parameters }, exported);
+        return { success: true, runDirectory: request.directory, manifest };
+    }
+    catch (error) {
+        if (error instanceof AuthoringError)
+            return authoringFailure(error);
+        if (isRecord(error) || error instanceof Error) {
+            const shaped = error;
+            if (Array.isArray(shaped.issues))
+                return {
+                    success: false,
+                    phase,
+                    exitCode: 1,
+                    diagnostics: shaped.issues.map((issue) => ({
+                        ...issue,
+                        code: issue.code ?? "INVALID_DEFINITION",
+                        severity: "error",
+                    })),
+                };
+            if (Array.isArray(shaped.diagnostics))
+                return {
+                    success: false,
+                    phase,
+                    exitCode: 1,
+                    diagnostics: shaped.diagnostics.map((issue) => ({
+                        ...issue,
+                        code: issue.code ?? "GENERATION_ASSERTION",
+                    })),
+                };
+            if (typeof shaped.code === "string" && isRecord(shaped.context))
+                return {
+                    success: false,
+                    phase,
+                    exitCode: 1,
+                    diagnostics: [
+                        {
+                            code: shaped.code,
+                            severity: "error",
+                            message: error instanceof Error ? error.message : "Geometry failure",
+                            context: shaped.context,
+                        },
+                    ],
+                };
+        }
+        return {
+            success: false,
+            phase,
+            exitCode: phase === "artifact" ? 2 : 1,
+            diagnostics: [
+                {
+                    code: phase === "assets" ? "ASSET_PREPARATION_FAILED" : "EXECUTION_FAILED",
+                    severity: "error",
+                    message: error instanceof Error ? error.message : String(error),
+                    ...(error instanceof Error && error.stack !== undefined
+                        ? { context: { stack: error.stack } }
+                        : {}),
+                },
+            ],
+        };
+    }
+    finally {
+        snapshot?.dispose();
+        dispose?.();
+    }
+}
+const requestFile = process.argv[2];
+const resultFile = process.argv[3];
+if (requestFile !== undefined && resultFile !== undefined) {
+    const result = await execute(JSON.parse(await readFile(requestFile, "utf8")));
+    await writeFile(resultFile, JSON.stringify(result));
+}
+//# sourceMappingURL=worker.js.map