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

package/dist/bridge/internal/externalExecution.js

@@ -0,0 +1,261 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.windowsProcessTreeKillCommand = windowsProcessTreeKillCommand;
+exports.fingerprintRequiredExternalTools = fingerprintRequiredExternalTools;
+exports.terminateActiveExternalProcesses = terminateActiveExternalProcesses;
+exports.executeExternalCapability = executeExternalCapability;
+exports.resolvePlannedPlugin = resolvePlannedPlugin;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const hash_1 = require("../hash");
+const types_1 = require("../types");
+const artifacts_1 = require("./artifacts");
+const EXTERNAL_STDOUT_LIMIT = 16 * 1024 * 1024;
+const PROCESS_TREE_KILL_GRACE_MS = 5_000;
+const JAVASCRIPT_HANDLER_EXTENSIONS = new Set(['.js', '.cjs', '.mjs']);
+const EXTERNAL_TOOL_REQUIREMENTS = types_1.BRIDGE_EXTERNAL_TOOL_ENVIRONMENT;
+const activeExternalTerminations = new Set();
+function windowsProcessTreeKillCommand(pid) {
+    return { executable: 'taskkill.exe', args: ['/PID', String(pid), '/T', '/F'] };
+}
+function fingerprintTool(requirement, environmentVariable) {
+    const configured = process.env[environmentVariable];
+    if (!configured)
+        throw new Error(`${requirement} requires ${environmentVariable}.`);
+    const requested = (0, node_path_1.resolve)(configured);
+    const info = (0, node_fs_1.lstatSync)(requested);
+    if (info.isSymbolicLink() || !info.isFile()) {
+        throw new Error(`${environmentVariable} must identify a regular non-symlink file.`);
+    }
+    const executable = (0, node_fs_1.realpathSync)(requested);
+    return { environmentVariable, executable, ...(0, hash_1.hashAndSizeFileSync)(executable) };
+}
+function sameToolFingerprint(left, right) {
+    return left.environmentVariable === right.environmentVariable &&
+        left.executable === right.executable &&
+        left.sha256 === right.sha256 &&
+        left.sizeBytes === right.sizeBytes;
+}
+/** Fingerprint every host executable required by the resolved graph before review. */
+function fingerprintRequiredExternalTools(plan) {
+    const tools = {};
+    for (const requirement of [...new Set(plan.steps.flatMap((step) => step.requires))].sort()) {
+        const environmentVariable = EXTERNAL_TOOL_REQUIREMENTS[requirement];
+        if (environmentVariable && process.env[environmentVariable]) {
+            tools[requirement] = fingerprintTool(requirement, environmentVariable);
+        }
+    }
+    return tools;
+}
+function plannedToolEnvironment(step, plan) {
+    const environment = { PATH: process.env.PATH ?? '' };
+    for (const requirement of step.requires) {
+        const environmentVariable = EXTERNAL_TOOL_REQUIREMENTS[requirement];
+        if (!environmentVariable)
+            continue;
+        const expected = plan.identity.tools[requirement];
+        if (!expected)
+            throw new Error(`${requirement} has no executable identity in the reviewed Bridge plan.`);
+        let actual;
+        try {
+            actual = fingerprintTool(requirement, environmentVariable);
+        }
+        catch (error) {
+            throw new Error(`${requirement} required tool changed after plan resolution; review a new plan. ` +
+                `${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (!sameToolFingerprint(actual, expected)) {
+            throw new Error(`${requirement} required tool changed after plan resolution; review a new plan.`);
+        }
+        environment[environmentVariable] = expected.executable;
+    }
+    return environment;
+}
+function waitForClose(child, timeoutMs) {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return Promise.resolve();
+    return new Promise((resolvePromise) => {
+        const timeout = setTimeout(resolvePromise, timeoutMs);
+        child.once('close', () => {
+            clearTimeout(timeout);
+            resolvePromise();
+        });
+    });
+}
+/** Terminate a handler and all editor/worker descendants it launched. */
+async function terminateProcessTree(child) {
+    if (!child.pid || child.exitCode !== null || child.signalCode !== null)
+        return;
+    if (process.platform !== 'win32') {
+        try {
+            process.kill(-child.pid, 'SIGKILL');
+        }
+        catch {
+            child.kill('SIGKILL');
+        }
+        await waitForClose(child, PROCESS_TREE_KILL_GRACE_MS);
+        if (child.exitCode === null && child.signalCode === null)
+            child.kill('SIGKILL');
+        return;
+    }
+    await new Promise((resolvePromise) => {
+        const command = windowsProcessTreeKillCommand(child.pid);
+        const killer = (0, node_child_process_1.spawn)(command.executable, command.args, {
+            stdio: 'ignore',
+            windowsHide: true,
+            shell: false,
+        });
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            resolvePromise();
+        };
+        const timeout = setTimeout(() => {
+            killer.kill('SIGKILL');
+            finish();
+        }, PROCESS_TREE_KILL_GRACE_MS);
+        killer.once('error', finish);
+        killer.once('close', finish);
+    });
+    await waitForClose(child, PROCESS_TREE_KILL_GRACE_MS);
+    if (child.exitCode === null && child.signalCode === null)
+        child.kill('SIGKILL');
+}
+/** Used by Bridge signal cleanup to stop external work before deleting its transaction. */
+async function terminateActiveExternalProcesses(reason) {
+    await Promise.all([...activeExternalTerminations].map((terminate) => terminate(reason)));
+}
+async function executeExternalCapability(plugin, step, plan, outputDir, options, input, sourcePath, namedInputs) {
+    const capabilityId = step.capability;
+    if (!plugin.root)
+        throw new Error(`${capabilityId} has no external plugin root`);
+    const capability = plugin.manifest.capabilities.find((entry) => entry.id === capabilityId);
+    if (!capability?.command)
+        throw new Error(`${capabilityId} has no executable handler`);
+    const requested = [...new Set([
+            ...(capability.permissions ?? plugin.manifest.permissions),
+            ...types_1.BRIDGE_EXTERNAL_COMMAND_PERMISSIONS,
+        ])];
+    const approved = new Set(options.approvedPermissions ?? []);
+    const missing = requested.filter((permission) => !approved.has(permission));
+    if (missing.length > 0) {
+        throw new Error(`${plugin.manifest.id} requires explicit permission approval: ${missing.join(', ')}. ` +
+            `Re-run with ${missing.map((permission) => `--allow-permission ${permission}`).join(' ')}.`);
+    }
+    const root = (0, node_fs_1.realpathSync)(plugin.root);
+    const requestedExecutable = (0, node_path_1.join)(root, capability.command.executable);
+    const executableInfo = (0, node_fs_1.lstatSync)(requestedExecutable);
+    if (executableInfo.isSymbolicLink() || !executableInfo.isFile()) {
+        throw new Error(`${capabilityId} executable must be a regular non-symlink file`);
+    }
+    const executable = (0, node_fs_1.realpathSync)(requestedExecutable);
+    if (!(0, artifacts_1.pathInside)(root, executable))
+        throw new Error(`${capabilityId} executable escapes its plugin directory`);
+    const pluginRequest = {
+        schemaVersion: types_1.BRIDGE_PLUGIN_REQUEST_SCHEMA,
+        capability: capabilityId,
+        source: { ...plan.source, source: sourcePath },
+        input,
+        inputs: namedInputs,
+        outputDir,
+        target: plan.target,
+        deterministicKey: plan.deterministicKey,
+    };
+    const request = JSON.stringify(pluginRequest);
+    const toolEnvironment = plannedToolEnvironment(step, plan);
+    const response = await new Promise((resolvePromise, rejectPromise) => {
+        const ownsProcessGroup = process.platform !== 'win32';
+        const handlerArguments = capability.command.args ?? [];
+        const isJavaScriptHandler = JAVASCRIPT_HANDLER_EXTENSIONS.has((0, node_path_1.extname)(executable).toLowerCase());
+        const child = (0, node_child_process_1.spawn)(isJavaScriptHandler ? process.execPath : executable, isJavaScriptHandler ? [executable, ...handlerArguments] : handlerArguments, {
+            cwd: root,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            shell: false,
+            detached: ownsProcessGroup,
+            env: toolEnvironment,
+        });
+        const stdout = [];
+        const stderr = [];
+        let size = 0;
+        let forcedFailure = null;
+        let termination = null;
+        const terminate = async (reason) => {
+            forcedFailure ??= reason;
+            termination ??= terminateProcessTree(child);
+            await termination;
+            clearTimeout(timeout);
+            activeExternalTerminations.delete(terminate);
+            rejectPromise(new Error(forcedFailure));
+        };
+        activeExternalTerminations.add(terminate);
+        const timeout = setTimeout(() => { void terminate(`${capabilityId} timed out`); }, (capability.command.timeoutSeconds ?? 900) * 1000);
+        child.stdout.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > EXTERNAL_STDOUT_LIMIT)
+                void terminate(`${capabilityId} exceeded the ${EXTERNAL_STDOUT_LIMIT}-byte output limit`);
+            else
+                stdout.push(chunk);
+        });
+        child.stderr.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > EXTERNAL_STDOUT_LIMIT)
+                void terminate(`${capabilityId} exceeded the ${EXTERNAL_STDOUT_LIMIT}-byte output limit`);
+            else
+                stderr.push(chunk);
+        });
+        child.on('error', (error) => {
+            if (!forcedFailure)
+                forcedFailure = `${capabilityId} failed to start: ${error.message}`;
+        });
+        child.stdin.on('error', (error) => {
+            void terminate(`${capabilityId} failed while receiving its request: ${error.message}`);
+        });
+        child.on('close', (code) => {
+            clearTimeout(timeout);
+            activeExternalTerminations.delete(terminate);
+            if (forcedFailure)
+                rejectPromise(new Error(forcedFailure));
+            else if (code !== 0)
+                rejectPromise(new Error(`${capabilityId} exited ${code}: ${Buffer.concat(stderr).toString('utf8').slice(0, 4000)}`));
+            else
+                resolvePromise(Buffer.concat(stdout).toString('utf8'));
+        });
+        child.stdin.end(request);
+    });
+    const parsed = JSON.parse(response);
+    if (!Array.isArray(parsed.artifacts) || parsed.artifacts.length === 0)
+        throw new Error(`${capabilityId} returned no artifacts`);
+    return parsed.artifacts.map((artifact) => {
+        if (!artifact.kind || !artifact.path)
+            throw new Error(`${capabilityId} returned an invalid artifact`);
+        if (artifact.kind !== step.produces) {
+            throw new Error(`${capabilityId} returned artifact kind '${artifact.kind}' outside its planned edge (expected '${step.produces}')`);
+        }
+        if (artifact.metadata !== undefined && artifact.metadata !== null &&
+            (typeof artifact.metadata !== 'object' || Array.isArray(artifact.metadata))) {
+            throw new Error(`${capabilityId} returned invalid artifact metadata; expected an object, null, or no metadata`);
+        }
+        const path = (0, node_fs_1.realpathSync)((0, node_path_1.resolve)(outputDir, artifact.path));
+        if (!(0, artifacts_1.pathInside)((0, node_fs_1.realpathSync)(outputDir), path))
+            throw new Error(`${capabilityId} returned an artifact outside the output directory`);
+        return (0, artifacts_1.fileArtifact)(artifact.kind, path, artifact.metadata === null || artifact.metadata === undefined
+            ? undefined
+            : artifact.metadata);
+    });
+}
+function resolvePlannedPlugin(step, plugins) {
+    const plugin = plugins.find((entry) => entry.manifest.id === step.plugin &&
+        entry.manifest.version === step.pluginVersion &&
+        entry.contentDigest === step.pluginDigest &&
+        entry.manifest.capabilities.some((candidate) => candidate.id === step.capability));
+    if (!plugin) {
+        throw new Error(`Bridge planned plugin is unavailable or changed: ${step.plugin}@${step.pluginVersion} ` +
+            `(${step.pluginDigest}) for ${step.capability}`);
+    }
+    return plugin;
+}
+//# sourceMappingURL=externalExecution.js.map

package/dist/bridge/internal/externalExecution.js.map

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

package/dist/bridge/internal/outputReservation.d.ts

@@ -0,0 +1,13 @@
+import type { FileHandle } from 'node:fs/promises';
+export type BridgeReservation = {
+    schemaVersion: 'helix.bridge-reservation/1';
+    reservationId: string;
+    pid: number;
+    hostname: string;
+    startedAt: string;
+    outputDir: string;
+    transactionDir: string;
+};
+export declare function acquireOutputReservation(reservationPath: string, record: BridgeReservation): Promise<FileHandle>;
+export declare function removeOwnedReservation(reservationPath: string, reservationId: string): Promise<void>;
+export declare function installSignalCleanup(record: BridgeReservation, reservationPath: string, reservation: FileHandle, beforeCleanup?: (signal: NodeJS.Signals) => Promise<void> | void): () => void;

package/dist/bridge/internal/outputReservation.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.acquireOutputReservation = acquireOutputReservation;
+exports.removeOwnedReservation = removeOwnedReservation;
+exports.installSignalCleanup = installSignalCleanup;
+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("./artifacts");
+function parseReservation(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed.schemaVersion === 'helix.bridge-reservation/1' &&
+            typeof parsed.reservationId === 'string' &&
+            Number.isInteger(parsed.pid) && Number(parsed.pid) > 0 &&
+            typeof parsed.hostname === 'string' &&
+            typeof parsed.startedAt === 'string' &&
+            typeof parsed.outputDir === 'string' &&
+            typeof parsed.transactionDir === 'string'
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function processIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        const code = typeof error === 'object' && error !== null && 'code' in error ? error.code : null;
+        return code !== 'ESRCH';
+    }
+}
+function ownedTransactionPath(outputDir, transactionDir) {
+    const outputParent = (0, node_path_1.dirname)(outputDir);
+    const resolved = (0, node_path_1.resolve)(transactionDir);
+    return (0, artifacts_1.pathInside)(outputParent, resolved) &&
+        (0, node_path_1.basename)(resolved).startsWith(`.${(0, node_path_1.basename)(outputDir)}.bridge-stage-`);
+}
+async function recoverStaleLocalReservation(reservationPath, outputDir) {
+    let existing;
+    try {
+        existing = parseReservation(await (0, promises_1.readFile)(reservationPath, 'utf8'));
+    }
+    catch (error) {
+        const code = typeof error === 'object' && error !== null && 'code' in error ? error.code : null;
+        if (code === 'ENOENT')
+            return true;
+        throw error;
+    }
+    if (!existing || existing.hostname !== (0, node_os_1.hostname)() || processIsAlive(existing.pid) ||
+        (0, node_path_1.resolve)(existing.outputDir) !== outputDir || !ownedTransactionPath(outputDir, existing.transactionDir)) {
+        return false;
+    }
+    const retired = `${reservationPath}.stale-${existing.reservationId}-${(0, node_crypto_1.randomUUID)()}`;
+    try {
+        await (0, promises_1.rename)(reservationPath, retired);
+    }
+    catch (error) {
+        const code = typeof error === 'object' && error !== null && 'code' in error ? error.code : null;
+        if (code === 'ENOENT')
+            return true;
+        throw error;
+    }
+    const moved = parseReservation(await (0, promises_1.readFile)(retired, 'utf8'));
+    if (moved?.reservationId !== existing.reservationId) {
+        if (!(0, node_fs_1.existsSync)(reservationPath))
+            await (0, promises_1.rename)(retired, reservationPath).catch(() => undefined);
+        return false;
+    }
+    await (0, promises_1.rm)(existing.transactionDir, { recursive: true, force: true });
+    await (0, promises_1.rm)(retired, { force: true });
+    return true;
+}
+async function acquireOutputReservation(reservationPath, record) {
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        try {
+            const handle = await (0, promises_1.open)(reservationPath, 'wx');
+            try {
+                await handle.writeFile(`${JSON.stringify(record, null, 2)}\n`);
+                return handle;
+            }
+            catch (error) {
+                await handle.close().catch(() => undefined);
+                await (0, promises_1.rm)(reservationPath, { force: true });
+                throw error;
+            }
+        }
+        catch (error) {
+            const code = typeof error === 'object' && error !== null && 'code' in error ? error.code : null;
+            if (code !== 'EEXIST')
+                throw error;
+            if (attempt === 0 && await recoverStaleLocalReservation(reservationPath, record.outputDir))
+                continue;
+            throw new Error(`Another Bridge import reserved this output: ${record.outputDir}. ` +
+                `If it was interrupted, inspect ${reservationPath}; remove only that exact reservation and its recorded transaction ` +
+                `after confirming the recorded process is no longer running.`);
+        }
+    }
+    throw new Error(`Unable to reserve Bridge output: ${record.outputDir}`);
+}
+function reservationIsOwned(reservationPath, reservationId) {
+    try {
+        return parseReservation((0, node_fs_1.readFileSync)(reservationPath, 'utf8'))?.reservationId === reservationId;
+    }
+    catch {
+        return false;
+    }
+}
+async function removeOwnedReservation(reservationPath, reservationId) {
+    if (reservationIsOwned(reservationPath, reservationId))
+        await (0, promises_1.rm)(reservationPath, { force: true });
+}
+function installSignalCleanup(record, reservationPath, reservation, beforeCleanup = () => undefined) {
+    const handlers = new Map();
+    let handlingSignal = false;
+    for (const signal of ['SIGINT', 'SIGTERM']) {
+        const handler = () => {
+            if (handlingSignal)
+                return;
+            handlingSignal = true;
+            for (const [name, listener] of handlers)
+                process.off(name, listener);
+            void Promise.resolve(beforeCleanup(signal)).catch(() => undefined).then(() => {
+                try {
+                    (0, node_fs_1.closeSync)(reservation.fd);
+                }
+                catch { /* already closed */ }
+                if (reservationIsOwned(reservationPath, record.reservationId)) {
+                    if (ownedTransactionPath(record.outputDir, record.transactionDir)) {
+                        (0, node_fs_1.rmSync)(record.transactionDir, { recursive: true, force: true });
+                    }
+                    (0, node_fs_1.rmSync)(reservationPath, { force: true });
+                }
+                process.kill(process.pid, signal);
+            });
+        };
+        handlers.set(signal, handler);
+        process.once(signal, handler);
+    }
+    return () => {
+        for (const [signal, handler] of handlers)
+            process.off(signal, handler);
+    };
+}
+//# sourceMappingURL=outputReservation.js.map

package/dist/bridge/internal/outputReservation.js.map

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

package/dist/bridge/internal/snapshots.d.ts

@@ -0,0 +1,32 @@
+import { type LoadedBridgePlugin } from '../plugins';
+import type { BridgeInputFingerprint, BridgeImportOptions, BridgeNamedInput, BridgePlan, BridgePlanOptions, BridgeSourceSnapshotIdentity } from '../types';
+export declare const BRIDGE_MAX_FBX_RAW_TEXTURE_BYTES: number;
+export declare const defaultMetaHumanEyeTexture: () => string;
+export type FileSourceSnapshot = {
+    path: string;
+    dependencies: Record<string, BridgeInputFingerprint>;
+    identity: BridgeSourceSnapshotIdentity;
+};
+/** Returns external buffer/image files required to relocate a JSON glTF. */
+export declare function discoverGltfDependencies(path: string): string[];
+/** Reads FBX sibling textures with a fixed aggregate memory budget and bounded concurrency. */
+export declare function readBridgeSiblingTextures(sourceDir: string, names: readonly string[], maxAggregateBytes?: number): Promise<Map<string, Buffer>>;
+/** Fingerprint every safe file sidecar that participates in a source bundle. */
+export declare function fingerprintSourceDependencies(source: string, detection: BridgePlan['source']): Promise<Record<string, BridgeInputFingerprint>>;
+export declare function snapshotFileSource(source: string, detection: BridgePlan['source'], workDir: string, expectedDependencies: Record<string, BridgeInputFingerprint>): Promise<FileSourceSnapshot>;
+export declare function snapshotDirectorySource(source: string, detection: BridgePlan['source'], workDir: string): Promise<FileSourceSnapshot>;
+export declare function snapshotAuxiliaryInputs(plan: BridgePlan, options: BridgeImportOptions, workDir: string): Promise<{
+    options: BridgeImportOptions;
+    inputs: Record<string, BridgeInputFingerprint>;
+    requestInputs: Record<string, BridgeNamedInput>;
+}>;
+/** Fingerprint every effective auxiliary input without creating snapshots or output state. */
+export declare function fingerprintAuxiliaryInputs(plan: BridgePlan, options: BridgePlanOptions): Promise<Record<string, BridgeInputFingerprint>>;
+type RequestedAuxiliaryInput = {
+    name: string;
+    option?: 'headTexture' | 'eyeTexture' | 'canonical' | 'map';
+    path: string;
+};
+export declare function requestedAuxiliaryInputPaths(plan: BridgePlan, options: BridgePlanOptions): RequestedAuxiliaryInput[];
+export declare function snapshotExternalPlugins(plan: BridgePlan, plugins: LoadedBridgePlugin[], workDir: string): Promise<LoadedBridgePlugin[]>;
+export {};