@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/bridge/detect.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isBridgeDirectoryExcluded = isBridgeDirectoryExcluded;
+exports.detectBridgeSource = detectBridgeSource;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const glb_1 = require("./glb");
+const hash_1 = require("./hash");
+const types_1 = require("./types");
+const DIRECTORY_EXCLUDES = new Set(['.git', 'node_modules', 'Intermediate', 'Saved', 'DerivedDataCache', 'Library', '.godot']);
+/** Shared by detection and immutable execution snapshots. */
+function isBridgeDirectoryExcluded(name) {
+    return DIRECTORY_EXCLUDES.has(name);
+}
+async function hashDirectoryFile(root, path, hash) {
+    const info = (0, node_fs_1.statSync)(path);
+    const name = (0, node_path_1.relative)(root, path).replaceAll('\\', '/');
+    hash.update(`F\0${name}\0${info.size}\0`);
+    await new Promise((resolvePromise, rejectPromise) => {
+        const stream = (0, node_fs_1.createReadStream)(path);
+        stream.on('data', (chunk) => hash.update(chunk));
+        stream.on('error', rejectPromise);
+        stream.on('end', resolvePromise);
+    });
+    return info.size;
+}
+async function hashDirectoryTree(root, current, hash, counter) {
+    let sizeBytes = 0;
+    for (const entry of (0, node_fs_1.readdirSync)(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+        const path = (0, node_path_1.join)(current, entry.name);
+        if (entry.isSymbolicLink())
+            throw new Error(`Bridge directory sources may not contain symlinks: ${path}`);
+        if (entry.isDirectory()) {
+            if (!isBridgeDirectoryExcluded(entry.name)) {
+                counter.directories += 1;
+                hash.update(`D\0${(0, node_path_1.relative)(root, path).replaceAll('\\', '/')}\0`);
+                sizeBytes += await hashDirectoryTree(root, path, hash, counter);
+            }
+        }
+        else if (entry.isFile()) {
+            counter.files += 1;
+            sizeBytes += await hashDirectoryFile(root, path, hash);
+        }
+    }
+    return sizeBytes;
+}
+async function hashDirectory(root) {
+    const hash = (0, node_crypto_1.createHash)('sha256');
+    const counter = { files: 0, directories: 0 };
+    const sizeBytes = await hashDirectoryTree(root, root, hash, counter);
+    return {
+        sha256: hash.digest('hex'),
+        sizeBytes,
+        fileCount: counter.files,
+        directoryCount: counter.directories,
+    };
+}
+function directoryKind(path) {
+    const names = (0, node_fs_1.readdirSync)(path, { withFileTypes: true }).map((entry) => entry.name);
+    const uproject = names.find((name) => name.toLowerCase().endsWith('.uproject'));
+    if (uproject)
+        return { kind: 'unreal.project', evidence: [`found ${uproject}`] };
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(path, 'ProjectSettings', 'ProjectVersion.txt')) && (0, node_fs_1.existsSync)((0, node_path_1.join)(path, 'Assets'))) {
+        return { kind: 'unity.project', evidence: ['found Assets/ and ProjectSettings/ProjectVersion.txt'] };
+    }
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(path, 'project.godot')))
+        return { kind: 'godot.project', evidence: ['found project.godot'] };
+    return { kind: 'directory.unknown', evidence: ['no supported engine project marker found'] };
+}
+function fileKind(path) {
+    switch ((0, node_path_1.extname)(path).toLowerCase()) {
+        case '.glb': return 'format.glb';
+        case '.gltf': return 'format.gltf';
+        case '.fbx': return 'format.fbx';
+        case '.obj': return 'format.obj';
+        case '.usd':
+        case '.usda':
+        case '.usdc': return 'format.usd';
+        case '.usdz': return 'format.usdz';
+        case '.vrm': return 'format.vrm';
+        case '.png':
+        case '.jpg':
+        case '.jpeg':
+        case '.webp':
+        case '.tga':
+        case '.dds':
+        case '.ktx':
+        case '.ktx2': return 'format.image';
+        case '.wav':
+        case '.ogg':
+        case '.mp3':
+        case '.flac':
+        case '.m4a': return 'format.audio';
+        default: return 'file.unknown';
+    }
+}
+function suggestedType(kind, inspection) {
+    if (kind === 'metahuman.face' || kind === 'format.vrm' || (inspection?.skinCount ?? 0) > 0)
+        return 'character';
+    if (kind.endsWith('.project') || kind === 'format.obj')
+        return 'scene';
+    if ((inspection?.animationCount ?? 0) > 0 && (inspection?.meshCount ?? 0) === 0)
+        return 'animation';
+    return 'asset';
+}
+async function detectBridgeSource(source) {
+    const path = (0, node_path_1.resolve)(source);
+    if (!(0, node_fs_1.existsSync)(path))
+        throw new Error(`Bridge source does not exist: ${path}`);
+    const info = (0, node_fs_1.statSync)(path);
+    if (!info.isFile() && !info.isDirectory())
+        throw new Error(`Bridge source must be a regular file or directory: ${path}`);
+    if (info.isDirectory()) {
+        const detected = directoryKind(path);
+        const fingerprint = await hashDirectory(path);
+        return {
+            schemaVersion: types_1.BRIDGE_DETECTION_SCHEMA,
+            source: path,
+            sourceKind: detected.kind,
+            suggestedType: suggestedType(detected.kind),
+            confidence: detected.kind === 'directory.unknown' ? 0.2 : 1,
+            evidence: detected.evidence,
+            ...fingerprint,
+        };
+    }
+    let kind = fileKind(path);
+    const evidence = [`extension ${(0, node_path_1.extname)(path).toLowerCase() || '(none)'}`];
+    let inspection;
+    if (kind === 'format.glb' || kind === 'format.vrm') {
+        const gltf = (0, glb_1.readGlbJson)(path, info.size);
+        inspection = (0, glb_1.inspectGlbJson)(gltf);
+        evidence.push(`${inspection.meshCount} mesh(es), ${inspection.skinCount} skin(s), ${inspection.animationCount} animation(s)`);
+        const names = [...inspection.nodeNames, ...inspection.meshNames];
+        if (names.some((name) => /FaceMesh/i.test(name)) &&
+            !names.some((name) => /BodyMesh/i.test(name)) &&
+            inspection.materialNames.some((name) => /MI_Eye[LR]_Baked/i.test(name))) {
+            kind = 'metahuman.face';
+            evidence.push('MetaHuman FaceMesh and baked eye materials');
+        }
+    }
+    return {
+        schemaVersion: types_1.BRIDGE_DETECTION_SCHEMA,
+        source: path,
+        sourceKind: kind,
+        suggestedType: suggestedType(kind, inspection),
+        confidence: kind === 'file.unknown' ? 0.1 : kind === 'format.fbx' ? 0.8 : 1,
+        evidence: [`${(0, node_path_1.basename)(path)}: ${evidence.join('; ')}`],
+        sha256: await (0, hash_1.sha256File)(path),
+        sizeBytes: info.size,
+        ...(inspection ? { inspection } : {}),
+    };
+}
+//# sourceMappingURL=detect.js.map

package/dist/bridge/detect.js.map

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

package/dist/bridge/execute.d.ts

@@ -0,0 +1,3 @@
+import { type BridgeImportOptions, type BridgeImportResult } from './types';
+export { BRIDGE_MAX_FBX_RAW_TEXTURE_BYTES, discoverGltfDependencies, readBridgeSiblingTextures, } from './internal/snapshots';
+export declare function importWithBridge(source: string, options?: BridgeImportOptions): Promise<BridgeImportResult>;

package/dist/bridge/execute.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readBridgeSiblingTextures = exports.discoverGltfDependencies = exports.BRIDGE_MAX_FBX_RAW_TEXTURE_BYTES = void 0;
+exports.importWithBridge = importWithBridge;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const artifacts_1 = require("./internal/artifacts");
+const builtInExecution_1 = require("./internal/builtInExecution");
+const externalExecution_1 = require("./internal/externalExecution");
+const outputReservation_1 = require("./internal/outputReservation");
+const snapshots_1 = require("./internal/snapshots");
+const plugins_1 = require("./plugins");
+const resolution_1 = require("./resolution");
+const types_1 = require("./types");
+// These helpers were part of the first public Bridge surface. Keep deliberate
+// re-exports while their implementation remains internal to source bundling.
+var snapshots_2 = require("./internal/snapshots");
+Object.defineProperty(exports, "BRIDGE_MAX_FBX_RAW_TEXTURE_BYTES", { enumerable: true, get: function () { return snapshots_2.BRIDGE_MAX_FBX_RAW_TEXTURE_BYTES; } });
+Object.defineProperty(exports, "discoverGltfDependencies", { enumerable: true, get: function () { return snapshots_2.discoverGltfDependencies; } });
+Object.defineProperty(exports, "readBridgeSiblingTextures", { enumerable: true, get: function () { return snapshots_2.readBridgeSiblingTextures; } });
+async function executeCapability(plan, step, outputDir, options, plugins, input, sourcePath, namedInputs) {
+    if (input && input.kind !== step.accepts) {
+        throw new Error(`Bridge step ${step.index} expected '${step.accepts}' but received '${input.kind}'.`);
+    }
+    if (!input && step.index > 1) {
+        throw new Error(`Bridge step ${step.index} has no '${step.accepts}' artifact from the preceding step.`);
+    }
+    const plugin = (0, externalExecution_1.resolvePlannedPlugin)(step, plugins);
+    if ((0, builtInExecution_1.isBuiltInCapability)(step.capability)) {
+        return (0, builtInExecution_1.executeBuiltInCapability)(plan, step, outputDir, options, plugin, input, sourcePath);
+    }
+    const capability = plugin.manifest.capabilities.find((entry) => entry.id === step.capability);
+    if (!capability?.command || !plugin.root)
+        throw new Error(`Capability '${step.capability}' has no executable handler.`);
+    return (0, externalExecution_1.executeExternalCapability)(plugin, step, plan, outputDir, options, input, sourcePath, namedInputs);
+}
+async function importWithBridge(source, options = {}) {
+    const plugins = (0, plugins_1.loadBridgePlugins)(options.pluginDirs);
+    const plan = await (0, resolution_1.resolveBridgePlan)(source, options, plugins);
+    const hasExternalCommand = plan.steps.some((step) => {
+        const plugin = (0, externalExecution_1.resolvePlannedPlugin)(step, plugins);
+        return Boolean(plugin.root && plugin.manifest.capabilities.find((entry) => entry.id === step.capability)?.command);
+    });
+    if (!options.dryRun && hasExternalCommand && options.expectedPlanKey === undefined) {
+        throw new Error(`Bridge external execution requires the reviewed plan key ${plan.deterministicKey}. ` +
+            `CLI: pass --expect-plan-key ${plan.deterministicKey}. ` +
+            `MCP/API: set expectedPlanKey to '${plan.deterministicKey}'.`);
+    }
+    if (options.expectedPlanKey !== undefined && options.expectedPlanKey !== plan.deterministicKey) {
+        throw new Error(`Bridge plan key mismatch: expected ${options.expectedPlanKey}, resolved ${plan.deterministicKey}. ` +
+            'Review the new plan before granting execution permissions.');
+    }
+    if (options.dryRun)
+        return { plan, outputs: [], provenancePath: null };
+    if (plan.blockers.length > 0)
+        throw new Error(`Bridge plan is blocked:\n- ${plan.blockers.join('\n- ')}`);
+    const availableInputs = new Set((0, snapshots_1.requestedAuxiliaryInputPaths)(plan, options).map((entry) => entry.name));
+    for (const input of plan.requiredInputs) {
+        if (availableInputs.has(input))
+            continue;
+        if (input === 'headTexture')
+            throw new Error('Bridge plan requires --head-texture or --input headTexture=<path>.');
+        if (input === 'eyeTexture')
+            throw new Error('Bridge plan requires --eye-texture or --input eyeTexture=<path>.');
+        if (input === 'palette')
+            throw new Error('Bridge plan requires --input palette=<palette.json>.');
+        throw new Error(`Bridge plan requires named input '${input}'; pass --input ${input}=<path>.`);
+    }
+    const outputDir = (0, node_path_1.resolve)(options.output ?? (0, node_path_1.join)(process.cwd(), 'bridge-out'));
+    const outputParent = (0, node_path_1.dirname)(outputDir);
+    await (0, promises_1.mkdir)(outputParent, { recursive: true });
+    if ((0, node_fs_1.existsSync)(outputDir))
+        throw new Error(`Bridge output path already exists: ${outputDir}`);
+    const reservationPath = (0, node_path_1.join)(outputParent, `.${(0, node_path_1.basename)(outputDir)}.bridge-reservation`);
+    const transactionDir = (0, node_path_1.join)(outputParent, `.${(0, node_path_1.basename)(outputDir)}.bridge-stage-${(0, node_crypto_1.randomUUID)()}`);
+    const reservationRecord = {
+        schemaVersion: 'helix.bridge-reservation/1',
+        reservationId: (0, node_crypto_1.randomUUID)(),
+        pid: process.pid,
+        hostname: (0, node_os_1.hostname)(),
+        startedAt: new Date().toISOString(),
+        outputDir,
+        transactionDir,
+    };
+    let reservation = null;
+    let removeSignalCleanup = () => undefined;
+    let published = false;
+    let outputs = [];
+    const keepStage = options.keepStage === true || process.env.HELIX_BRIDGE_KEEP_STAGE === '1';
+    try {
+        reservation = await (0, outputReservation_1.acquireOutputReservation)(reservationPath, reservationRecord);
+        removeSignalCleanup = (0, outputReservation_1.installSignalCleanup)(reservationRecord, reservationPath, reservation, (signal) => (0, externalExecution_1.terminateActiveExternalProcesses)(`Bridge import interrupted by ${signal}`));
+        await (0, promises_1.mkdir)(transactionDir);
+        if (keepStage)
+            options.onProgress?.(`debug: bridge stage will be kept at ${transactionDir} if this import fails`);
+        const packageDir = (0, node_path_1.join)(transactionDir, 'package');
+        const workingDir = (0, node_path_1.join)(transactionDir, 'work');
+        await (0, promises_1.mkdir)(packageDir, { recursive: true });
+        await (0, promises_1.mkdir)(workingDir, { recursive: true });
+        if ((0, node_fs_1.existsSync)(outputDir))
+            throw new Error(`Bridge output path already exists: ${outputDir}`);
+        const sourceIsDirectory = (0, node_fs_1.statSync)(plan.source.source).isDirectory();
+        const sourceSnapshot = sourceIsDirectory
+            ? await (0, snapshots_1.snapshotDirectorySource)(plan.source.source, plan.source, workingDir)
+            : await (0, snapshots_1.snapshotFileSource)(plan.source.source, plan.source, workingDir, plan.identity.sourceDependencies);
+        const auxiliary = await (0, snapshots_1.snapshotAuxiliaryInputs)(plan, options, workingDir);
+        const executionPlan = {
+            ...plan,
+            sourceSnapshot: sourceSnapshot.identity,
+        };
+        const executionPlugins = await (0, snapshots_1.snapshotExternalPlugins)(executionPlan, plugins, workingDir);
+        for (const step of executionPlan.steps) {
+            auxiliary.options.onProgress?.(`${step.index}/${executionPlan.steps.length} ${step.capability}`);
+            const stepOutputDir = step.index < executionPlan.steps.length
+                ? (0, node_path_1.join)(workingDir, `step-${step.index}`)
+                : packageDir;
+            await (0, promises_1.mkdir)(stepOutputDir, { recursive: true });
+            const matchingInputs = step.index === 1
+                ? []
+                : outputs.filter((artifact) => artifact.kind === step.accepts);
+            if (matchingInputs.length > 1) {
+                throw new Error(`Bridge step ${step.index} cannot choose one scalar input from ${matchingInputs.length} ` +
+                    `'${step.accepts}' artifacts produced by the preceding step. Split the batch or use a batch-aware capability.`);
+            }
+            const input = matchingInputs[0] ?? null;
+            const stepOutputs = await executeCapability(executionPlan, step, stepOutputDir, auxiliary.options, executionPlugins, input, sourceSnapshot.path, auxiliary.requestInputs);
+            if (!stepOutputs.some((artifact) => artifact.kind === step.produces)) {
+                throw new Error(`Bridge step ${step.index} did not produce its planned '${step.produces}' artifact.`);
+            }
+            outputs = stepOutputs;
+        }
+        if (!outputs.some((artifact) => artifact.kind === executionPlan.goal)) {
+            throw new Error(`Bridge pipeline completed without its planned goal '${executionPlan.goal}'.`);
+        }
+        const usedPluginIds = [...new Set(executionPlan.steps.map((step) => step.plugin))];
+        const serializedOutputs = outputs.map((artifact) => (0, artifacts_1.serializedArtifact)(packageDir, artifact));
+        const provenance = {
+            schemaVersion: types_1.BRIDGE_PROVENANCE_SCHEMA,
+            deterministicKey: executionPlan.deterministicKey,
+            source: {
+                path: (0, node_path_1.basename)(executionPlan.source.source),
+                kind: executionPlan.source.sourceKind,
+                sha256: executionPlan.source.sha256,
+                sizeBytes: executionPlan.source.sizeBytes,
+                ...(executionPlan.source.fileCount === undefined ? {} : { fileCount: executionPlan.source.fileCount }),
+                ...(executionPlan.source.directoryCount === undefined
+                    ? {}
+                    : { directoryCount: executionPlan.source.directoryCount }),
+            },
+            plugins: usedPluginIds.map((id) => {
+                const plugin = executionPlugins.find((entry) => entry.manifest.id === id);
+                return { id, version: plugin.manifest.version, digest: plugin.contentDigest };
+            }),
+            capabilities: executionPlan.steps.map((step) => step.capability),
+            target: executionPlan.target,
+            settings: {
+                contentType: executionPlan.contentType,
+                inputs: auxiliary.inputs,
+                tools: Object.fromEntries(Object.entries(executionPlan.identity.tools).map(([requirement, tool]) => [
+                    requirement,
+                    {
+                        environmentVariable: tool.environmentVariable,
+                        file: (0, node_path_1.basename)(tool.executable),
+                        sha256: tool.sha256,
+                        sizeBytes: tool.sizeBytes,
+                    },
+                ])),
+                sourceBundle: {
+                    snapshot: sourceSnapshot.identity,
+                    dependencies: sourceSnapshot.dependencies,
+                },
+            },
+            outputs: serializedOutputs,
+            createdAt: new Date().toISOString(),
+        };
+        const stagedProvenancePath = (0, node_path_1.join)(packageDir, 'bridge-provenance.json');
+        (0, node_fs_1.writeFileSync)(stagedProvenancePath, `${JSON.stringify(provenance, null, 2)}\n`);
+        const finalOutputs = outputs.map((artifact) => ({
+            ...artifact,
+            path: (0, node_path_1.join)(outputDir, (0, artifacts_1.containedRelativePath)(packageDir, artifact.path)),
+        }));
+        await (0, promises_1.rm)(workingDir, { recursive: true, force: true });
+        await (0, promises_1.rename)(packageDir, outputDir);
+        await (0, promises_1.rm)(transactionDir, { recursive: true, force: true }).catch(() => undefined);
+        published = true;
+        return { plan: executionPlan, outputs: finalOutputs, provenancePath: (0, node_path_1.join)(outputDir, 'bridge-provenance.json') };
+    }
+    finally {
+        removeSignalCleanup();
+        if (!published) {
+            if (keepStage) {
+                options.onProgress?.(`debug: bridge stage kept for inspection: ${transactionDir}`);
+            }
+            else {
+                await (0, promises_1.rm)(transactionDir, { recursive: true, force: true });
+            }
+        }
+        if (reservation)
+            await reservation.close().catch(() => undefined);
+        await (0, outputReservation_1.removeOwnedReservation)(reservationPath, reservationRecord.reservationId);
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/bridge/execute.js.map

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

package/dist/bridge/glb.d.ts

@@ -0,0 +1,60 @@
+import type { BridgeGlbInspection } from './types';
+export interface BridgeGltfJson {
+    asset?: {
+        version?: string;
+    };
+    scenes?: Array<{
+        name?: string;
+        nodes?: number[];
+    }>;
+    nodes?: Array<{
+        name?: string;
+        mesh?: number;
+        skin?: number;
+        children?: number[];
+    }>;
+    meshes?: Array<{
+        name?: string;
+        primitives?: Array<{
+            attributes?: Record<string, number>;
+            indices?: number;
+            material?: number;
+        }>;
+    }>;
+    skins?: Array<{
+        name?: string;
+        joints?: number[];
+    }>;
+    accessors?: Array<{
+        count?: number;
+    }>;
+    animations?: Array<{
+        name?: string;
+    }>;
+    materials?: Array<{
+        name?: string;
+        pbrMetallicRoughness?: {
+            baseColorTexture?: {
+                index?: number;
+            };
+            metallicRoughnessTexture?: {
+                index?: number;
+            };
+            baseColorFactor?: number[];
+        };
+        normalTexture?: {
+            index?: number;
+        };
+        occlusionTexture?: {
+            index?: number;
+        };
+        emissiveTexture?: {
+            index?: number;
+        };
+    }>;
+    textures?: unknown[];
+}
+export declare function parseGlbJson(bytes: Uint8Array): BridgeGltfJson;
+/** Read only the GLB header and JSON chunk. Binary payloads stay on disk. */
+export declare function readGlbJson(path: string, fileSize: number): BridgeGltfJson;
+export declare function inspectGlbJson(gltf: BridgeGltfJson): BridgeGlbInspection;

package/dist/bridge/glb.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseGlbJson = parseGlbJson;
+exports.readGlbJson = readGlbJson;
+exports.inspectGlbJson = inspectGlbJson;
+const node_fs_1 = require("node:fs");
+const GLB_MAGIC = 0x46546c67;
+const JSON_CHUNK = 0x4e4f534a;
+const MAX_INSPECTION_NAMES = 512;
+const MAX_INSPECTION_JSON_BYTES = 16 * 1024 * 1024;
+function jsonChunkLength(header, fileSize, maxJsonBytes = Number.MAX_SAFE_INTEGER) {
+    const buffer = Buffer.isBuffer(header) ? header : Buffer.from(header);
+    if (buffer.length < 20)
+        throw new Error('GLB is too short');
+    if (buffer.readUInt32LE(0) !== GLB_MAGIC)
+        throw new Error('file is not a GLB');
+    if (buffer.readUInt32LE(4) !== 2)
+        throw new Error('GLB version must be 2');
+    if (buffer.readUInt32LE(8) !== fileSize)
+        throw new Error('GLB length header does not match the file');
+    const jsonLength = buffer.readUInt32LE(12);
+    if (buffer.readUInt32LE(16) !== JSON_CHUNK || 20 + jsonLength > fileSize) {
+        throw new Error('GLB JSON chunk is invalid');
+    }
+    if (jsonLength > maxJsonBytes) {
+        throw new Error(`GLB JSON chunk exceeds the ${maxJsonBytes}-byte inspection limit`);
+    }
+    return jsonLength;
+}
+function parseJsonChunk(bytes) {
+    try {
+        return JSON.parse(Buffer.from(bytes).toString('utf8').trim());
+    }
+    catch (error) {
+        throw new Error(`GLB JSON cannot be parsed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function readExactly(descriptor, buffer, position) {
+    let offset = 0;
+    while (offset < buffer.length) {
+        const bytesRead = (0, node_fs_1.readSync)(descriptor, buffer, offset, buffer.length - offset, position + offset);
+        if (bytesRead === 0)
+            throw new Error('GLB is too short');
+        offset += bytesRead;
+    }
+}
+function parseGlbJson(bytes) {
+    const buffer = Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes);
+    const jsonLength = jsonChunkLength(buffer.subarray(0, 20), buffer.length);
+    return parseJsonChunk(buffer.subarray(20, 20 + jsonLength));
+}
+/** Read only the GLB header and JSON chunk. Binary payloads stay on disk. */
+function readGlbJson(path, fileSize) {
+    const descriptor = (0, node_fs_1.openSync)(path, 'r');
+    try {
+        const header = Buffer.allocUnsafe(20);
+        readExactly(descriptor, header, 0);
+        const jsonLength = jsonChunkLength(header, fileSize, MAX_INSPECTION_JSON_BYTES);
+        const json = Buffer.allocUnsafe(jsonLength);
+        readExactly(descriptor, json, 20);
+        return parseJsonChunk(json);
+    }
+    finally {
+        (0, node_fs_1.closeSync)(descriptor);
+    }
+}
+function inspectGlbJson(gltf) {
+    const names = (entries) => [
+        ...new Set((entries ?? []).map((entry) => entry.name).filter((entry) => typeof entry === 'string')),
+    ].slice(0, MAX_INSPECTION_NAMES);
+    return {
+        meshCount: gltf.meshes?.length ?? 0,
+        skinCount: gltf.skins?.length ?? 0,
+        animationCount: gltf.animations?.length ?? 0,
+        materialCount: gltf.materials?.length ?? 0,
+        nodeNames: names(gltf.nodes),
+        meshNames: names(gltf.meshes),
+        materialNames: names(gltf.materials),
+    };
+}
+//# sourceMappingURL=glb.js.map

package/dist/bridge/glb.js.map

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

package/dist/bridge/hash.d.ts

@@ -0,0 +1,6 @@
+export declare function sha256Bytes(bytes: Uint8Array): string;
+export declare function sha256File(path: string): Promise<string>;
+export declare function hashAndSizeFileSync(path: string): {
+    sha256: string;
+    sizeBytes: number;
+};

package/dist/bridge/hash.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sha256Bytes = sha256Bytes;
+exports.sha256File = sha256File;
+exports.hashAndSizeFileSync = hashAndSizeFileSync;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const HASH_BUFFER_BYTES = 1024 * 1024;
+function sha256Bytes(bytes) {
+    return (0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex');
+}
+function sha256File(path) {
+    return new Promise((resolve, reject) => {
+        const hash = (0, node_crypto_1.createHash)('sha256');
+        const stream = (0, node_fs_1.createReadStream)(path);
+        stream.on('error', reject);
+        stream.on('data', (chunk) => hash.update(chunk));
+        stream.on('end', () => resolve(hash.digest('hex')));
+    });
+}
+function hashAndSizeFileSync(path) {
+    const hash = (0, node_crypto_1.createHash)('sha256');
+    const buffer = Buffer.allocUnsafe(HASH_BUFFER_BYTES);
+    const descriptor = (0, node_fs_1.openSync)(path, 'r');
+    let sizeBytes = 0;
+    try {
+        for (;;) {
+            const bytesRead = (0, node_fs_1.readSync)(descriptor, buffer, 0, buffer.length, null);
+            if (bytesRead === 0)
+                break;
+            sizeBytes += bytesRead;
+            hash.update(buffer.subarray(0, bytesRead));
+        }
+    }
+    finally {
+        (0, node_fs_1.closeSync)(descriptor);
+    }
+    return { sha256: hash.digest('hex'), sizeBytes };
+}
+//# sourceMappingURL=hash.js.map

package/dist/bridge/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/bridge/hash.ts"],"names":[],"mappings":";;AAKA,kCAEC;AAED,gCAQC;AAED,kDAgBC;AAnCD,6CAAyC;AACzC,qCAA0E;AAE1E,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtC,SAAgB,WAAW,CAAC,KAAiB;IAC3C,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,IAAA,0BAAgB,EAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,mBAAmB,CAAC,IAAY;IAC9C,MAAM,IAAI,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,IAAA,kBAAQ,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,SAAS,GAAG,IAAA,kBAAQ,EAAC,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACvE,IAAI,SAAS,KAAK,CAAC;gBAAE,MAAM;YAC3B,SAAS,IAAI,SAAS,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAA,mBAAS,EAAC,UAAU,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;AACnD,CAAC"}

package/dist/bridge/index.d.ts

@@ -0,0 +1,11 @@
+export * from './types';
+export * from './validate';
+export * from './manifest';
+export * from './detect';
+export * from './planner';
+export * from './resolution';
+export * from './plugins';
+export * from './metahuman';
+export * from './characterAddon';
+export * from './execute';
+export * from './management';

package/dist/bridge/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./validate"), exports);
+__exportStar(require("./manifest"), exports);
+__exportStar(require("./detect"), exports);
+__exportStar(require("./planner"), exports);
+__exportStar(require("./resolution"), exports);
+__exportStar(require("./plugins"), exports);
+__exportStar(require("./metahuman"), exports);
+__exportStar(require("./characterAddon"), exports);
+__exportStar(require("./execute"), exports);
+__exportStar(require("./management"), exports);
+//# sourceMappingURL=index.js.map