@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/unreal.js

@@ -0,0 +1,362 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELIX_UNREAL_CONTRACT_VERSION = exports.HELIX_UNREAL_ENGINE_VERSION = exports.shouldEmitAvatarMode = exports.parseAvatarMode = exports.UNREAL_PACKAGE_INDEX_FILENAME = exports.UNREAL_NETWORKING_MODES = exports.UNREAL_MANIFEST_FILENAME = exports.UNREAL_ARTIFACT_MODES = exports.readUnrealManifest = exports.packageUnrealProject = exports.initUnrealManifest = void 0;
+exports.validateUnrealProject = validateUnrealProject;
+exports.formatUnrealValidationReport = formatUnrealValidationReport;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const unrealManifest_1 = require("./unrealManifest");
+var unrealManifest_2 = require("./unrealManifest");
+Object.defineProperty(exports, "initUnrealManifest", { enumerable: true, get: function () { return unrealManifest_2.initUnrealManifest; } });
+Object.defineProperty(exports, "packageUnrealProject", { enumerable: true, get: function () { return unrealManifest_2.packageUnrealProject; } });
+Object.defineProperty(exports, "readUnrealManifest", { enumerable: true, get: function () { return unrealManifest_2.readUnrealManifest; } });
+Object.defineProperty(exports, "UNREAL_ARTIFACT_MODES", { enumerable: true, get: function () { return unrealManifest_2.UNREAL_ARTIFACT_MODES; } });
+Object.defineProperty(exports, "UNREAL_MANIFEST_FILENAME", { enumerable: true, get: function () { return unrealManifest_2.UNREAL_MANIFEST_FILENAME; } });
+Object.defineProperty(exports, "UNREAL_NETWORKING_MODES", { enumerable: true, get: function () { return unrealManifest_2.UNREAL_NETWORKING_MODES; } });
+Object.defineProperty(exports, "UNREAL_PACKAGE_INDEX_FILENAME", { enumerable: true, get: function () { return unrealManifest_2.UNREAL_PACKAGE_INDEX_FILENAME; } });
+var avatarMode_1 = require("./unreal/avatarMode");
+Object.defineProperty(exports, "parseAvatarMode", { enumerable: true, get: function () { return avatarMode_1.parseAvatarMode; } });
+Object.defineProperty(exports, "shouldEmitAvatarMode", { enumerable: true, get: function () { return avatarMode_1.shouldEmitAvatarMode; } });
+exports.HELIX_UNREAL_ENGINE_VERSION = '5.8';
+exports.HELIX_UNREAL_CONTRACT_VERSION = 21;
+const MCP_PLUGIN_NAMES = ['ModelContextProtocol', 'AllToolsets'];
+const MCP_CLIENT_CONFIG_PATHS = [
+    '.mcp.json',
+    '.cursor/mcp.json',
+    '.vscode/mcp.json',
+    '.gemini/settings.json',
+];
+const IGNORED_SCAN_DIRECTORIES = new Set([
+    '.git',
+    'Binaries',
+    'DerivedDataCache',
+    'Intermediate',
+    'Saved',
+    'node_modules',
+]);
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readJson(path) {
+    const value = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+    if (!isObject(value))
+        throw new Error('expected a JSON object');
+    return value;
+}
+function findProjectFile(input) {
+    const absolute = (0, node_path_1.resolve)(input);
+    if ((0, node_fs_1.existsSync)(absolute) && (0, node_fs_1.statSync)(absolute).isFile()) {
+        if ((0, node_path_1.extname)(absolute).toLowerCase() !== '.uproject') {
+            return {
+                projectDir: (0, node_path_1.dirname)(absolute),
+                projectFile: null,
+                error: `${absolute} is not a .uproject file`,
+            };
+        }
+        return { projectDir: (0, node_path_1.dirname)(absolute), projectFile: absolute };
+    }
+    if (!(0, node_fs_1.existsSync)(absolute) || !(0, node_fs_1.statSync)(absolute).isDirectory()) {
+        return {
+            projectDir: absolute,
+            projectFile: null,
+            error: `${absolute} is not a project directory`,
+        };
+    }
+    const descriptors = (0, node_fs_1.readdirSync)(absolute)
+        .filter((entry) => (0, node_path_1.extname)(entry).toLowerCase() === '.uproject')
+        .sort();
+    if (descriptors.length !== 1) {
+        const detail = descriptors.length === 0
+            ? 'no .uproject file found'
+            : `found ${descriptors.length} .uproject files (${descriptors.join(', ')})`;
+        return { projectDir: absolute, projectFile: null, error: detail };
+    }
+    return { projectDir: absolute, projectFile: (0, node_path_1.join)(absolute, descriptors[0]) };
+}
+function pluginByName(project, name) {
+    if (!Array.isArray(project.Plugins))
+        return null;
+    const match = project.Plugins.find((candidate) => isObject(candidate) && candidate.Name === name);
+    return isObject(match) ? match : null;
+}
+function isEditorOnlyPlugin(plugin) {
+    if (!plugin || plugin.Enabled !== true || !Array.isArray(plugin.TargetAllowList)) {
+        return false;
+    }
+    return (plugin.TargetAllowList.length === 1 &&
+        String(plugin.TargetAllowList[0]).toLowerCase() === 'editor');
+}
+function iniValue(text, expectedSection, expectedKey) {
+    let section = '';
+    let found = null;
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith(';') || line.startsWith('#'))
+            continue;
+        const sectionMatch = line.match(/^\[([^\]]+)]$/);
+        if (sectionMatch) {
+            section = sectionMatch[1].trim();
+            continue;
+        }
+        if (section.toLowerCase() !== expectedSection.toLowerCase())
+            continue;
+        const equals = line.indexOf('=');
+        if (equals < 0)
+            continue;
+        const key = line.slice(0, equals).trim().replace(/^[+-.]/, '');
+        if (key.toLowerCase() === expectedKey.toLowerCase()) {
+            found = line.slice(equals + 1).trim();
+        }
+    }
+    return found;
+}
+function isLoopbackHost(host) {
+    const normalized = host.trim().toLowerCase().replace(/^\[|]$/g, '');
+    return normalized === 'localhost' || normalized === '127.0.0.1' || normalized === '::1';
+}
+function isLoopbackHttpUrl(rawUrl) {
+    try {
+        const url = new URL(rawUrl);
+        return url.protocol === 'http:' && isLoopbackHost(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+function jsonMcpUrl(config) {
+    for (const containerName of ['mcpServers', 'servers']) {
+        const container = config[containerName];
+        if (!isObject(container))
+            continue;
+        const server = container['unreal-mcp'];
+        if (isObject(server) && typeof server.url === 'string')
+            return server.url;
+    }
+    return null;
+}
+function codexMcpUrl(text) {
+    let inUnrealSection = false;
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        const section = line.match(/^\[([^\]]+)]$/);
+        if (section) {
+            const normalized = section[1].replace(/["']/g, '').toLowerCase();
+            inUnrealSection =
+                normalized === 'mcp_servers.unreal-mcp' ||
+                    normalized === 'mcpservers.unreal-mcp';
+            continue;
+        }
+        if (!inUnrealSection)
+            continue;
+        const match = line.match(/^url\s*=\s*["']([^"']+)["']/i);
+        if (match)
+            return match[1];
+    }
+    return null;
+}
+function findMcpClientUrls(projectDir) {
+    const urls = [];
+    for (const relative of MCP_CLIENT_CONFIG_PATHS) {
+        const path = (0, node_path_1.join)(projectDir, relative);
+        if (!(0, node_fs_1.existsSync)(path))
+            continue;
+        const url = jsonMcpUrl(readJson(path));
+        if (url)
+            urls.push({ file: path, url });
+    }
+    const codexConfig = (0, node_path_1.join)(projectDir, '.codex', 'config.toml');
+    if ((0, node_fs_1.existsSync)(codexConfig)) {
+        const url = codexMcpUrl((0, node_fs_1.readFileSync)(codexConfig, 'utf8'));
+        if (url)
+            urls.push({ file: codexConfig, url });
+    }
+    return urls;
+}
+function walkTextFiles(root) {
+    if (!(0, node_fs_1.existsSync)(root))
+        return [];
+    const files = [];
+    const visit = (directory) => {
+        for (const entry of (0, node_fs_1.readdirSync)(directory, { withFileTypes: true })) {
+            if (entry.isDirectory()) {
+                if (!IGNORED_SCAN_DIRECTORIES.has(entry.name))
+                    visit((0, node_path_1.join)(directory, entry.name));
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            if (['.ini', '.cs', '.cpp', '.h', '.hpp'].includes((0, node_path_1.extname)(entry.name).toLowerCase())) {
+                files.push((0, node_path_1.join)(directory, entry.name));
+            }
+        }
+    };
+    visit(root);
+    return files;
+}
+function firstUnsafeBind(files) {
+    for (const file of files) {
+        const text = (0, node_fs_1.readFileSync)(file, 'utf8');
+        const match = text.match(/^\s*DefaultBindAddress\s*=\s*([^;#\r\n]+)/im);
+        if (match && !isLoopbackHost(match[1]))
+            return { file, value: match[1].trim() };
+    }
+    return null;
+}
+function firstPattern(files, pattern) {
+    return files.find((file) => pattern.test((0, node_fs_1.readFileSync)(file, 'utf8'))) ?? null;
+}
+function validateUnrealProject(input = '.', options = {}) {
+    const located = findProjectFile(input);
+    const checks = [];
+    const add = (id, ok, message, file) => checks.push({ id, status: ok ? 'pass' : 'fail', message, ...(file ? { file } : {}) });
+    add('project.descriptor', located.projectFile !== null, located.projectFile
+        ? `Found ${(0, node_path_1.basename)(located.projectFile)}`
+        : located.error ?? 'Could not resolve the Unreal project descriptor', located.projectFile ?? undefined);
+    let project = null;
+    if (located.projectFile) {
+        try {
+            project = readJson(located.projectFile);
+        }
+        catch (error) {
+            add('project.descriptor-json', false, `Invalid .uproject JSON: ${error instanceof Error ? error.message : String(error)}`, located.projectFile);
+        }
+    }
+    const engineVersion = project && typeof project.EngineAssociation === 'string'
+        ? project.EngineAssociation
+        : null;
+    add('unreal.engine-version', engineVersion === exports.HELIX_UNREAL_ENGINE_VERSION, engineVersion === exports.HELIX_UNREAL_ENGINE_VERSION
+        ? `Unreal Engine ${exports.HELIX_UNREAL_ENGINE_VERSION}`
+        : `Expected EngineAssociation ${exports.HELIX_UNREAL_ENGINE_VERSION}; found ${engineVersion ?? 'none'}`, located.projectFile ?? undefined);
+    const helixPlugin = project ? pluginByName(project, 'HelixSDK') : null;
+    add('helix.sdk-plugin', helixPlugin?.Enabled === true, helixPlugin?.Enabled === true
+        ? 'HelixSDK plugin is enabled for mandatory HelixPlatform identity/session integration'
+        : 'HelixSDK must be present and enabled for HelixPlatform identity/session integration', located.projectFile ?? undefined);
+    const manifestResult = (0, unrealManifest_1.readUnrealManifest)(located.projectDir);
+    const manifest = manifestResult.manifest;
+    add('unreal.manifest', manifest !== null, manifest
+        ? `Valid ${manifest.artifactMode} publish manifest (${manifest.slug}@${manifest.version})`
+        : manifestResult.errors.join('; '), manifestResult.path);
+    add('unreal.manifest-platform-sdk', manifest?.platformSdk.identity === true && manifest?.platformSdk.session === true, manifest?.platformSdk.identity === true && manifest?.platformSdk.session === true
+        ? 'Publish manifest requires HelixPlatform identity and session integration'
+        : 'Publish manifest must require platformSdk.identity=true and platformSdk.session=true', manifestResult.path);
+    const networkingValid = manifest !== null && (manifest.networking.mode !== 'helixnet' ||
+        manifest.networking.contractVersion === exports.HELIX_UNREAL_CONTRACT_VERSION);
+    add('unreal.manifest-networking', networkingValid, manifest
+        ? networkingValid
+            ? `Networking mode: ${manifest.networking.mode}${manifest.networking.mode === 'helixnet' ? ` (contract v${exports.HELIX_UNREAL_CONTRACT_VERSION})` : ' (HelixNet contract not required)'}`
+            : `HelixNet requires contract v${exports.HELIX_UNREAL_CONTRACT_VERSION}`
+        : 'Networking mode could not be validated', manifestResult.path);
+    const requiresHelixNetContract = manifest?.networking.mode === 'helixnet';
+    const contractFile = (0, node_path_1.join)(located.projectDir, 'Contracts', 'helix-sdk-contract.json');
+    let contractVersion = null;
+    let contractEngine = null;
+    try {
+        const contract = readJson(contractFile);
+        contractVersion = typeof contract.contractVersion === 'number'
+            ? contract.contractVersion
+            : null;
+        contractEngine = typeof contract.unrealEngine === 'string' ? contract.unrealEngine : null;
+    }
+    catch {
+        // The check below reports a missing or malformed marker without throwing.
+    }
+    const contractFileOk = !requiresHelixNetContract || (contractVersion === exports.HELIX_UNREAL_CONTRACT_VERSION &&
+        contractEngine === exports.HELIX_UNREAL_ENGINE_VERSION);
+    add('helix.contract-file', contractFileOk, contractFileOk
+        ? requiresHelixNetContract
+            ? `HelixNet contract marker is v${exports.HELIX_UNREAL_CONTRACT_VERSION} for Unreal ${exports.HELIX_UNREAL_ENGINE_VERSION}`
+            : `Networking mode ${manifest?.networking.mode ?? 'unknown'} does not require the HelixNet contract marker`
+        : `Expected Contracts/helix-sdk-contract.json with contractVersion ${exports.HELIX_UNREAL_CONTRACT_VERSION} and unrealEngine ${exports.HELIX_UNREAL_ENGINE_VERSION}`, contractFile);
+    const defaultGame = (0, node_path_1.join)(located.projectDir, 'Config', 'DefaultGame.ini');
+    const runtimeContract = (0, node_fs_1.existsSync)(defaultGame)
+        ? iniValue((0, node_fs_1.readFileSync)(defaultGame, 'utf8'), '/Script/HelixPlatform.HelixPlatformSettings', 'ContractVersion')
+        : null;
+    add('helix.runtime-contract-version', !requiresHelixNetContract || runtimeContract === String(exports.HELIX_UNREAL_CONTRACT_VERSION), !requiresHelixNetContract || runtimeContract === String(exports.HELIX_UNREAL_CONTRACT_VERSION)
+        ? requiresHelixNetContract
+            ? `HelixPlatform HelixNet settings use contract v${exports.HELIX_UNREAL_CONTRACT_VERSION}`
+            : `Networking mode ${manifest?.networking.mode ?? 'unknown'} does not require ContractVersion`
+        : `Expected [/Script/HelixPlatform.HelixPlatformSettings] ContractVersion=${exports.HELIX_UNREAL_CONTRACT_VERSION} in Config/DefaultGame.ini`, defaultGame);
+    if (options.includeMcp)
+        for (const name of MCP_PLUGIN_NAMES) {
+            const plugin = project ? pluginByName(project, name) : null;
+            add(`mcp.${name}.enabled`, plugin?.Enabled === true, plugin?.Enabled === true
+                ? `${name} plugin is enabled`
+                : `${name} must be present and enabled in the .uproject`, located.projectFile ?? undefined);
+            add(`mcp.${name}.editor-only`, isEditorOnlyPlugin(plugin), isEditorOnlyPlugin(plugin)
+                ? `${name} is restricted to TargetAllowList [Editor]`
+                : `${name} must use exactly TargetAllowList [\"Editor\"] so it cannot enter game/shipping targets`, located.projectFile ?? undefined);
+        }
+    const editorSettings = (0, node_path_1.join)(located.projectDir, 'Config', 'DefaultEditorPerProjectUserSettings.ini');
+    const autoStart = (0, node_fs_1.existsSync)(editorSettings)
+        ? iniValue((0, node_fs_1.readFileSync)(editorSettings, 'utf8'), '/Script/ModelContextProtocolEngine.ModelContextProtocolSettings', 'bAutoStartServer')
+        : null;
+    if (options.includeMcp)
+        add('mcp.editor-settings', autoStart?.toLowerCase() === 'false', autoStart?.toLowerCase() === 'false'
+            ? 'Unreal MCP auto-start is explicitly off in editor-only project settings'
+            : 'Set bAutoStartServer=False in Config/DefaultEditorPerProjectUserSettings.ini; start MCP explicitly from the editor', editorSettings);
+    let clientUrls = [];
+    let clientConfigError = null;
+    try {
+        clientUrls = findMcpClientUrls(located.projectDir);
+    }
+    catch (error) {
+        clientConfigError = error instanceof Error ? error.message : String(error);
+    }
+    if (options.includeMcp)
+        add('mcp.client-config', clientUrls.length > 0 && !clientConfigError, clientConfigError
+            ? `Could not read an Unreal MCP client config: ${clientConfigError}`
+            : clientUrls.length > 0
+                ? `Found ${clientUrls.length} Unreal MCP client configuration(s)`
+                : 'Generate an Unreal MCP client config from the editor (ModelContextProtocol.GenerateClientConfig Codex or All)');
+    const unsafeClient = clientUrls.find(({ url }) => !isLoopbackHttpUrl(url));
+    if (options.includeMcp)
+        add('mcp.client-loopback', clientUrls.length > 0 && !unsafeClient, unsafeClient
+            ? `Unreal MCP URL must stay on loopback; found ${unsafeClient.url}`
+            : clientUrls.length > 0
+                ? 'Every Unreal MCP client URL is loopback-only'
+                : 'No Unreal MCP client URL was available to verify', unsafeClient?.file);
+    const sourceFiles = walkTextFiles((0, node_path_1.join)(located.projectDir, 'Source'));
+    const configFiles = walkTextFiles((0, node_path_1.join)(located.projectDir, 'Config'));
+    const scannedFiles = [...sourceFiles, ...configFiles];
+    const unsafeBind = firstUnsafeBind(configFiles);
+    if (options.includeMcp)
+        add('mcp.server-loopback', unsafeBind === null, unsafeBind
+            ? `HTTP server DefaultBindAddress must be loopback; found ${unsafeBind.value}`
+            : 'No non-loopback HTTP server bind override found', unsafeBind?.file);
+    const shippingFlagFile = firstPattern(scannedFiles, /-ModelContextProtocolStartServer\b/);
+    if (options.includeMcp)
+        add('mcp.shipping-startup-flag', shippingFlagFile === null, shippingFlagFile
+            ? 'Remove -ModelContextProtocolStartServer from project source/config; MCP must be started only in the editor'
+            : 'No project-level MCP startup flag can leak into packaged builds', shippingFlagFile ?? undefined);
+    const runtimeStartupFile = firstPattern(sourceFiles, /(?:IModelContextProtocolModule[^\n;]*|ModelContextProtocol\.)StartServer\s*\(/);
+    if (options.includeMcp)
+        add('mcp.runtime-startup-code', runtimeStartupFile === null, runtimeStartupFile
+            ? 'Direct MCP server startup is forbidden in project runtime source; use the editor console command'
+            : 'No direct MCP server startup exists in project runtime source', runtimeStartupFile ?? undefined);
+    const passed = checks.filter((check) => check.status === 'pass').length;
+    const failed = checks.length - passed;
+    return {
+        schemaVersion: 1,
+        ok: failed === 0,
+        projectDir: located.projectDir,
+        projectFile: located.projectFile,
+        engineVersion,
+        contractVersion,
+        artifactMode: manifest?.artifactMode ?? null,
+        networking: manifest?.networking.mode ?? null,
+        checks,
+        summary: { passed, failed },
+    };
+}
+function formatUnrealValidationReport(report) {
+    const lines = [
+        `HELIX Unreal project: ${report.projectFile ?? report.projectDir}`,
+        ...report.checks.map((check) => `${check.status === 'pass' ? '✔' : '✖'} ${check.message}`),
+        '',
+        report.ok
+            ? `Ready: Unreal ${exports.HELIX_UNREAL_ENGINE_VERSION}, ${report.artifactMode ?? 'unknown artifact'}, ${report.networking ?? 'unknown networking'}, HelixPlatform identity/session.`
+            : `${report.summary.failed} validation problem(s).`,
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=unreal.js.map

package/dist/unreal.js.map

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

package/dist/unrealCandidate.d.ts

@@ -0,0 +1,213 @@
+export declare const CANDIDATE_MANIFEST_FILENAME = "world-build-manifest.json";
+export declare const CANDIDATE_RECEIPT_FILENAME = "world-build-manifest.sha256";
+export declare const CANDIDATE_COOK_PLAN_FILENAME = "cook-plan.json";
+export declare const CANDIDATE_SCOPE_REPORT_FILENAME = "cook-scope-report.json";
+export declare const CANDIDATE_MANIFEST_SCHEMA = "helix.world-build/v1";
+export declare const CANDIDATE_SDK_CONTRACT = "helix.unreal.sdk/v1";
+export declare const CANDIDATE_SCOPE_REPORT_SCHEMA = "helix.cook-scope-report/v1";
+/** The exact string the backend signs into every artifact PUT ticket. */
+export declare const PRIVATE_IMMUTABLE = "private, max-age=31536000, immutable";
+/** Cook-output role → backend Shared-Runtime artifact role. */
+export declare const CANDIDATE_ROLE_TO_BACKEND: {
+    readonly clientContent: "windows_client_content";
+    readonly serverContent: "linux_server_content";
+    readonly clientLua: "lua_client";
+    readonly sharedLua: "lua_shared";
+    readonly serverLua: "lua_server";
+    readonly clientWebUI: "webui";
+    readonly sharedWebUI: "webui";
+};
+/** Cook-output role → the path prefix its files take inside the Build. */
+export declare const CANDIDATE_ROLE_PATH_PREFIX: {
+    readonly clientContent: "client";
+    readonly serverContent: "server";
+    readonly clientLua: "lua/client";
+    readonly sharedLua: "lua/shared";
+    readonly serverLua: "lua/server";
+    readonly clientWebUI: "webui/client";
+    readonly sharedWebUI: "webui/shared";
+};
+/** Cook-output role → the build target it must declare. */
+export declare const CANDIDATE_ROLE_TARGET: {
+    readonly clientContent: "windowsClient";
+    readonly serverContent: "linuxServer";
+    readonly clientLua: "windowsClient";
+    readonly sharedLua: "portable";
+    readonly serverLua: "linuxServer";
+    readonly clientWebUI: "windowsClient";
+    readonly sharedWebUI: "portable";
+};
+/** Unreal hosting profile → the backend's network mode. */
+export declare const HOST_PROFILE_TO_NETWORK_MODE: {
+    readonly offline: "single_player";
+    readonly listen: "listen";
+    readonly managedOnDemand: "managed";
+    readonly managedPersistent: "managed";
+};
+export type CandidateRole = keyof typeof CANDIDATE_ROLE_TO_BACKEND;
+export type BackendArtifactRole = (typeof CANDIDATE_ROLE_TO_BACKEND)[CandidateRole];
+export type SharedRuntimeNetworkMode = (typeof HOST_PROFILE_TO_NETWORK_MODE)[keyof typeof HOST_PROFILE_TO_NETWORK_MODE];
+export declare const MAX_ARTIFACTS = 96;
+export declare const MAX_ARTIFACT_BYTES: number;
+export declare const MAX_TOTAL_BYTES: number;
+export type CandidateFileReceipt = {
+    path: string;
+    sha256: string;
+    sizeBytes: number;
+    mediaType: string;
+};
+export type CandidateArtifactGroup = {
+    role: CandidateRole;
+    target: string;
+    mountPoint: string;
+    digest: string;
+    sizeBytes: number;
+    files: CandidateFileReceipt[];
+};
+export type CandidateManifest = {
+    schemaVersion: string;
+    runtime: {
+        unrealEngineVersion: string;
+        helixRuntimeVersion: string;
+        helixSdkVersion: string;
+        helixSdkContract: string;
+    };
+    entry: {
+        map: string;
+        gameMode?: string;
+    };
+    profiles: {
+        host: string;
+        network?: string;
+        authority?: string;
+    };
+    capabilities: {
+        required: string[];
+        optional: string[];
+    };
+    provenance: {
+        cookPlanSha256: string;
+    };
+    artifacts: CandidateArtifactGroup[];
+};
+/**
+ * The cook's own account of what it actually pulled in.
+ *
+ * `-CookDir` SEEDS the cook; it does not BOUND the reference walk, so a `/Game`
+ * asset hard-referenced from a map inside the cook root is cooked into the DLC.
+ * The commandlet fails closed on a dirty report, but this is the check that
+ * matters most: it sits at the boundary where bytes actually leave the machine.
+ */
+export type CookScopeReport = {
+    schemaVersion: string;
+    clean: boolean;
+    totalPackages: number;
+    declaredRoots: string[];
+    cookedPackages: string[];
+    outOfScopePackages: string[];
+};
+export type VerifiedCandidate = {
+    directory: string;
+    manifest: CandidateManifest;
+    /** sha256 of world-build-manifest.json, as recorded in its .sha256 receipt. */
+    manifestSha256: string;
+    cookPlan: {
+        digest: string;
+        packages: string[];
+    };
+    cookScope: CookScopeReport;
+    roles: CandidateRole[];
+    totalBytes: number;
+};
+/** A single artifact intent plus the local file that must be PUT for it. */
+export type PlannedUpload = {
+    role: BackendArtifactRole;
+    path: string;
+    sizeBytes: number;
+    sha256: string;
+    mediaType: string;
+    mountPath: string;
+    /** Candidate-relative source, e.g. `artifacts/clientContent/Content/Paks/x.utoc`. */
+    source: string;
+};
+export type SharedRuntimeCreateRequest = {
+    idempotencyKey: string;
+    manifest: {
+        version: 1;
+        runtimeAdapter: 'unreal';
+        networkMode: SharedRuntimeNetworkMode;
+        runtime: {
+            engineVersion: string;
+            runtimeVersion: string;
+            sdkVersion: string;
+        };
+        activities: Array<{
+            id: string;
+            map: string;
+            gameMode?: string;
+            maxPlayers: number;
+        }>;
+        capabilities: string[];
+        artifacts: Array<Omit<PlannedUpload, 'source'>>;
+    };
+};
+export type SharedRuntimePublishPlan = {
+    worldId: string;
+    candidateManifestSha256: string;
+    networkMode: SharedRuntimeNetworkMode;
+    create: SharedRuntimeCreateRequest;
+    uploads: PlannedUpload[];
+    totalBytes: number;
+};
+/**
+ * Every candidate/plan rejection. A distinct class so the command layer can
+ * print the creator-facing list without swallowing genuine bugs, and so a
+ * caller can tell "your build is not publishable" from "the network failed".
+ */
+export declare class UnrealCandidateError extends Error {
+    readonly problems: string[];
+    constructor(message: string, problems?: string[]);
+    render(): string;
+}
+export declare function sha256File(path: string): Promise<string>;
+/**
+ * The cook's own per-group digest: a receipt over every file's path, digest,
+ * size, and media type. Recomputing it is what makes a hand-edited manifest —
+ * one whose files were swapped after the cook signed off — fail closed.
+ */
+export declare function candidateArtifactDigest(files: CandidateFileReceipt[]): string;
+/**
+ * Fail-closed audit of the cook scope report.
+ *
+ * The report is a CLAIM, exactly like the manifest, so the out-of-scope set is
+ * RECOMPUTED from `cookedPackages` against `declaredRoots` and the two must
+ * agree. A report that disagrees with itself is refused rather than believed —
+ * otherwise a build could declare `clean: true` beside offenders it also lists.
+ *
+ * Every uncertain state refuses. An absent report is "cannot tell", and
+ * cannot-tell must not publish: treating absent as clean is precisely the
+ * silent-no-op failure this gate exists to stop.
+ */
+export declare function auditCookScope(report: CookScopeReport, problems: string[]): void;
+export declare function verifyUnrealCandidate(input: string, options?: {
+    engineVersion?: string;
+}): Promise<VerifiedCandidate>;
+export type PlanOptions = {
+    worldId: string;
+    idempotencyKey: string;
+    activityId?: string;
+    maxPlayers: number;
+};
+/**
+ * Turns a verified candidate into the exact backend create request plus the
+ * upload list. Every bound the backend enforces is re-checked here so a build
+ * that cannot possibly be accepted is refused before the first byte moves.
+ */
+export declare function planSharedRuntimePublish(candidate: VerifiedCandidate, options: PlanOptions): SharedRuntimePublishPlan;
+/**
+ * The default idempotency key. Derived from the candidate's own manifest
+ * digest, so re-running a publish after a network failure REPLAYS the same
+ * Build instead of minting a second one, while a genuinely re-cooked world
+ * (different bytes → different digest) gets its own.
+ */
+export declare function defaultIdempotencyKey(candidate: VerifiedCandidate): string;