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

package/dist/unreal/package.js

@@ -0,0 +1,273 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildUnrealPackageVersion = buildUnrealPackageVersion;
+exports.buildUnrealPublicationIntent = buildUnrealPublicationIntent;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const objectUpload_1 = require("../continuum/objectUpload");
+const release_1 = require("./release");
+/** The descriptor is a small JSON document; a damaged one must never be read whole. */
+const MAX_DESCRIPTOR_BYTES = 4 * 1024 * 1024;
+/**
+ * A cooked-role document lists file receipts, never file bytes, so a strict
+ * small upper bound is enough to read and validate it before any hash. This is
+ * what keeps the role JSON path from ever buffering a cooked UCAS.
+ */
+const MAX_ROLE_DOCUMENT_BYTES = 16 * 1024 * 1024;
+/**
+ * Read at most `maxBytes` from a file without ever allocating the whole file
+ * first. `stat` is only an early rejection; the read loop enforces the bound.
+ */
+async function readBoundedFile(path, maxBytes) {
+    const handle = await (0, promises_1.open)(path, 'r');
+    try {
+        const stats = await handle.stat();
+        if (stats.size > maxBytes) {
+            throw new Error(`File ${path} is ${stats.size} bytes, above the ${maxBytes}-byte JSON bound`);
+        }
+        const buffer = Buffer.allocUnsafe(stats.size);
+        let filled = 0;
+        while (filled < stats.size) {
+            const { bytesRead } = await handle.read(buffer, filled, stats.size - filled, filled);
+            if (bytesRead === 0)
+                break;
+            filled += bytesRead;
+        }
+        if (filled !== stats.size) {
+            throw new Error(`File ${path} changed while being read`);
+        }
+        return buffer;
+    }
+    finally {
+        await handle.close();
+    }
+}
+/**
+ * Resolve a role document path: the caller-supplied exact mapping wins, and the
+ * SDK's own output layout is the fallback so the builder can derive the closure
+ * without a second argument.
+ */
+function cookedRoleDocumentPath(options, role) {
+    const fromMap = options.objectPaths?.[role.manifest.cid];
+    if (fromMap)
+        return fromMap;
+    return (0, node_path_1.join)((0, node_path_1.resolve)(options.publishDir), 'continuum', 'roles', `${role.role}.json`);
+}
+/**
+ * Read a cooked-role document under a strict bound, prove its raw bytes hash to
+ * the pinned CID (not merely its parsed canonical form), and validate it against
+ * the real helix-manifest schema for this role.
+ */
+async function loadCookedRoleDocument(options, role) {
+    const path = cookedRoleDocumentPath(options, role);
+    const bytes = await readBoundedFile(path, MAX_ROLE_DOCUMENT_BYTES);
+    if (bytes.byteLength !== role.manifest.bytes) {
+        throw new Error(`Role document ${path} is ${bytes.byteLength} bytes but the descriptor pins ${role.manifest.bytes} for ${role.manifest.cid}`);
+    }
+    const actual = (0, helix_manifest_1.cidFromBytes)(bytes);
+    if (actual !== role.manifest.cid) {
+        throw new Error(`Role document ${path} hashes to ${actual} but the descriptor pins ${role.manifest.cid}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(bytes.toString('utf8'));
+    }
+    catch {
+        throw new Error(`Role document ${path} is not JSON for ${role.manifest.cid}`);
+    }
+    const result = (0, helix_manifest_1.validateUnrealCookedRoleManifest)(parsed, {
+        expectedRole: role.role,
+    });
+    if (!result.valid) {
+        throw new Error(`The cooked role document ${path} does not satisfy helix-manifest:\n  ${result.errors.join('\n  ')}`);
+    }
+    return { role, path, document: result.unrealCookedRole };
+}
+async function buildUnrealPackageVersion(options) {
+    const publishDir = (0, node_path_1.resolve)(options.publishDir);
+    const descriptorPath = (0, node_path_1.join)(publishDir, 'continuum', 'unreal-world.json');
+    let raw;
+    try {
+        raw = (await readBoundedFile(descriptorPath, MAX_DESCRIPTOR_BYTES)).toString('utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`No Continuum descriptor at ${descriptorPath}. Publish with an SDK that emits one ` +
+                '(helix-unreal-runtime #55).');
+        }
+        throw error;
+    }
+    let descriptor;
+    try {
+        descriptor = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`The Continuum descriptor at ${descriptorPath} is not JSON.`);
+    }
+    // Their validator decides whether the SDK produced a legal descriptor. A
+    // package version built on an illegal one would be refused later and further
+    // away, with the error naming the package rather than the World.
+    const validated = (0, helix_manifest_1.validateUnrealWorldDefinition)(descriptor);
+    if (!validated.valid) {
+        throw new Error(`The World descriptor does not satisfy helix-manifest:\n  ${validated.errors.join('\n  ')}`);
+    }
+    const unrealWorld = validated.unrealWorld;
+    // The root CID must BE the canonical descriptor CID -- helix-manifest tests
+    // that explicitly ("refuses a root CID that is not the canonical descriptor
+    // CID"). The bytes published inline are the canonical bytes that CID names,
+    // so a non-canonical on-disk descriptor cannot be staged under a CID its own
+    // bytes would not hash to.
+    const rootBytes = new Uint8Array((0, helix_manifest_1.canonicalJsonBytes)(unrealWorld));
+    const rootCid = (0, helix_manifest_1.canonicalJsonCid)(unrealWorld);
+    const variants = unrealWorld.roles.map((role) => ({
+        id: role.role === 'windows-client' ? 'win64-client' : 'linux-server',
+        runtimeProfileId: release_1.UNREAL_RUNTIME_PROFILE.id,
+        object: role.manifest,
+    }));
+    // The exact closure: the descriptor, one variant per cooked role, the role
+    // documents, any descriptor-declared cooked objects, and every cooked file the
+    // role documents index. Deduplicated by CID, so a file shared by two roles is
+    // one object. The backend's `collectManifestObjectReferences` sees only the
+    // descriptor + role documents, so the cooked files are what its sealed
+    // closure must also expand from the role documents; declaring the wrong count
+    // here is what the backend seal refuses.
+    const roleDocuments = await Promise.all(unrealWorld.roles.map((role) => loadCookedRoleDocument(options, role)));
+    const closure = new Map();
+    closure.set(rootCid, {
+        cid: rootCid,
+        bytes: rootBytes.byteLength,
+        mediaType: helix_manifest_1.CONTINUUM_UNREAL_WORLD_MEDIA_TYPE,
+        role: 'unreal-world',
+    });
+    for (const variant of variants)
+        closure.set(variant.object.cid, variant.object);
+    for (const role of unrealWorld.roles)
+        closure.set(role.manifest.cid, role.manifest);
+    for (const declared of unrealWorld.objects ?? [])
+        closure.set(declared.cid, declared);
+    for (const loaded of roleDocuments) {
+        for (const file of loaded.document.files) {
+            closure.set(file.object.cid, file.object);
+        }
+    }
+    const pkg = {
+        schema: helix_manifest_1.CONTINUUM_PACKAGE_SCHEMA,
+        id: options.packageId,
+        type: 'unreal-world',
+        name: options.name ?? unrealWorld.mountPoint.replace(/^\//, ''),
+    };
+    const packageVersion = {
+        schema: helix_manifest_1.CONTINUUM_PACKAGE_VERSION_SCHEMA,
+        package: { id: pkg.id, type: pkg.type },
+        version: options.version,
+        root: {
+            cid: rootCid,
+            bytes: rootBytes.byteLength,
+            mediaType: helix_manifest_1.CONTINUUM_UNREAL_WORLD_MEDIA_TYPE,
+            role: 'unreal-world',
+        },
+        dependencies: [],
+        variants,
+        compatibility: { contract: 'helix.continuum/1', requires: [], provides: [] },
+        // The World was authored in Unreal and cooked by the SDK; naming the source
+        // is what lets a later reader tell a cooked World from an imported one.
+        provenance: { kind: 'authored', source: 'helix-unreal-runtime' },
+        expectedClosure: {
+            objectCount: closure.size,
+            totalBytes: [...closure.values()].reduce((sum, reference) => sum + reference.bytes, 0),
+        },
+        unrealWorld,
+    };
+    const versionResult = (0, helix_manifest_1.validateContinuumPackageVersion)(packageVersion);
+    if (!versionResult.valid) {
+        throw new Error(`The Package Version does not satisfy helix-manifest:\n  ${versionResult.errors.join('\n  ')}`);
+    }
+    return {
+        package: pkg,
+        packageVersion: versionResult.manifest,
+        roleObjectIsUndefinedUpstream: false,
+    };
+}
+async function buildUnrealPublicationIntent(options) {
+    const built = await buildUnrealPackageVersion(options);
+    const unrealWorld = built.packageVersion.unrealWorld;
+    if (!unrealWorld) {
+        throw new Error('The Package Version carries no Unreal World definition');
+    }
+    const audience = options.visibility ?? 'private';
+    const pathFor = (reference) => {
+        const path = options.objectPaths[reference.cid];
+        if (!path) {
+            throw new Error(`No local file supplied for descriptor object ${reference.cid} (${reference.mediaType}); ` +
+                'the cooked role manifests and their per-file objects must be provided, not adopted');
+        }
+        return path;
+    };
+    /** Stream a cooked file and prove its exact size and SHA-256 with bounded memory. */
+    const verifyCookedFile = async (reference) => {
+        const path = pathFor(reference);
+        const { sha256, sizeBytes } = await (0, objectUpload_1.sha256File)(path);
+        if (sizeBytes !== reference.bytes) {
+            throw new Error(`File ${path} is ${sizeBytes} bytes but the descriptor pins ${reference.bytes} for ${reference.cid}`);
+        }
+        const actual = `cid:sha256:${sha256}`;
+        if (actual !== reference.cid) {
+            throw new Error(`File ${path} hashes to ${actual} but the descriptor pins ${reference.cid}`);
+        }
+        return path;
+    };
+    const objects = [
+        {
+            // The descriptor is small and its canonical bytes are exactly what the
+            // root CID names, so it goes inline. Its CID is the canonical CID of the
+            // document, which is what makes the package root verifiable.
+            reference: built.packageVersion.root,
+            source: {
+                kind: 'inline',
+                bytes: (0, helix_manifest_1.canonicalJsonBytes)(unrealWorld),
+                filename: 'unreal-world.json',
+                audience,
+            },
+        },
+    ];
+    const seen = new Set([built.packageVersion.root.cid]);
+    const pushObject = (object) => {
+        if (seen.has(object.reference.cid))
+            return;
+        seen.add(object.reference.cid);
+        objects.push(object);
+    };
+    for (const role of unrealWorld.roles) {
+        const loaded = await loadCookedRoleDocument(options, role);
+        const rolePath = pathFor(role.manifest);
+        pushObject({
+            reference: role.manifest,
+            source: {
+                kind: 'file',
+                path: rolePath,
+                filename: (0, node_path_1.basename)(rolePath),
+                audience,
+            },
+        });
+        for (const file of loaded.document.files) {
+            const path = await verifyCookedFile(file.object);
+            pushObject({
+                reference: file.object,
+                source: { kind: 'file', path, filename: (0, node_path_1.basename)(path), audience },
+            });
+        }
+    }
+    const intent = {
+        projectId: options.projectId,
+        sourceDigest: options.sourceDigest,
+        package: built.package,
+        packagePublication: { visibility: audience },
+        packageVersion: built.packageVersion,
+        objects,
+        listings: [],
+        ...(options.world ? { world: options.world } : {}),
+    };
+    return { intent, roleObjectIsUndefinedUpstream: built.roleObjectIsUndefinedUpstream };
+}
+//# sourceMappingURL=package.js.map

package/dist/unreal/package.js.map

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

package/dist/unreal/release.d.ts

@@ -0,0 +1,41 @@
+import { type RuntimeProfile, type WorldRelease } from '@hypersoniclabs/helix-manifest';
+import { AvatarMode } from './avatarMode';
+/**
+ * Builds the Continuum World Release document for a cooked Unreal World.
+ *
+ * NOTHING HERE IS DESIGNED. Every shape below is read from the contracts the
+ * web team already owns in helix-manifest, and the document is handed to their
+ * own `validateWorldRelease` before it is written — if this file disagrees with
+ * the contract, the command fails rather than emitting something plausible.
+ *
+ * The Unreal runtime profile in particular is not invented: helix-manifest
+ * defines it, comments it in runtime-profile.ts ("the Unreal runtime profile
+ * ('windows' / 'unreal-5.8') mounts cooked Unreal Worlds and never reads Scene
+ * documents") and exercises it in unreal-world.spec.ts. This ports that exact
+ * profile rather than choosing one.
+ */
+/** The profile helix-manifest defines for a cooked Unreal World. */
+export declare const UNREAL_RUNTIME_PROFILE: RuntimeProfile;
+export type UnrealReleaseOptions = {
+    /** A publish output directory: the one holding world-build-manifest.json. */
+    publishDir: string;
+    /** The Continuum package this World's descriptor was published as. */
+    packageId: string;
+    packageVersion: string;
+    /** Release identity. Both are UUIDs in the contract. */
+    releaseId: string;
+    worldId: string;
+    version: string;
+    outPath?: string;
+    maxPlayers?: number;
+    contentRating?: 'everyone' | 'teen' | 'mature';
+    /** Avatar appearance policy. Default: 'universal' (absent from the release). */
+    avatarMode?: AvatarMode;
+};
+export type UnrealReleaseResult = {
+    outPath: string;
+    release: WorldRelease;
+    /** Artifact CIDs the runtime must have before the World can open. */
+    readyCids: string[];
+};
+export declare function buildUnrealWorldRelease(options: UnrealReleaseOptions): Promise<UnrealReleaseResult>;

package/dist/unreal/release.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNREAL_RUNTIME_PROFILE = void 0;
+exports.buildUnrealWorldRelease = buildUnrealWorldRelease;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const avatarMode_1 = require("./avatarMode");
+/**
+ * Builds the Continuum World Release document for a cooked Unreal World.
+ *
+ * NOTHING HERE IS DESIGNED. Every shape below is read from the contracts the
+ * web team already owns in helix-manifest, and the document is handed to their
+ * own `validateWorldRelease` before it is written — if this file disagrees with
+ * the contract, the command fails rather than emitting something plausible.
+ *
+ * The Unreal runtime profile in particular is not invented: helix-manifest
+ * defines it, comments it in runtime-profile.ts ("the Unreal runtime profile
+ * ('windows' / 'unreal-5.8') mounts cooked Unreal Worlds and never reads Scene
+ * documents") and exercises it in unreal-world.spec.ts. This ports that exact
+ * profile rather than choosing one.
+ */
+/** The profile helix-manifest defines for a cooked Unreal World. */
+exports.UNREAL_RUNTIME_PROFILE = {
+    schema: helix_manifest_1.CONTINUUM_RUNTIME_PROFILE_SCHEMA,
+    id: 'unreal-5-8-win64',
+    platform: 'windows',
+    renderer: 'unreal-5.8',
+    quality: 'high',
+    // scene: 0 is the contract's way of saying this renderer consumes no Scene
+    // documents at all. A cooked World mounts its own content.
+    contracts: { continuum: 1, scene: 0 },
+    capabilities: ['unreal-world'],
+};
+function cidFromSha256(digest, where) {
+    if (!/^[a-f0-9]{64}$/.test(digest)) {
+        // Uppercase hex is the same content and a different CID string, which is
+        // the one failure a content-addressing scheme must never have.
+        throw new Error(`${where} is not a lowercase sha256: ${JSON.stringify(digest)}`);
+    }
+    return `cid:sha256:${digest}`;
+}
+async function buildUnrealWorldRelease(options) {
+    const publishDir = (0, node_path_1.resolve)(options.publishDir);
+    // The descriptor's CID is written by the publisher beside the descriptor
+    // itself (helix-unreal-runtime, HelixContinuumUnrealWorld::WriteDescriptor).
+    // Reading it rather than recomputing keeps one producer of that identity.
+    const descriptorCidPath = (0, node_path_1.join)(publishDir, 'continuum', 'unreal-world.cid');
+    let manifestCid;
+    try {
+        manifestCid = (await (0, promises_1.readFile)(descriptorCidPath, 'utf8')).trim();
+    }
+    catch {
+        throw new Error(`No Continuum descriptor at ${descriptorCidPath}. Publish with an SDK that emits one ` +
+            '(helix-unreal-runtime #55), and check the publish log for why it was skipped.');
+    }
+    const buildManifestPath = (0, node_path_1.join)(publishDir, 'world-build-manifest.json');
+    let build;
+    try {
+        build = JSON.parse(await (0, promises_1.readFile)(buildManifestPath, 'utf8'));
+    }
+    catch {
+        throw new Error(`No build manifest at ${buildManifestPath}.`);
+    }
+    // The ready set is what the runtime must hold before the World can open. For
+    // a cooked World that is its content artifacts, addressed by the digests the
+    // build manifest already verified.
+    const readyCids = (build.artifacts ?? [])
+        .filter((artifact) => typeof artifact.digest === 'string')
+        .map((artifact, index) => cidFromSha256(String(artifact.digest), `artifacts[${index}].digest`));
+    if (readyCids.length === 0) {
+        throw new Error('The build manifest declares no artifacts, so the World has nothing to mount.');
+    }
+    const packageReference = {
+        packageId: options.packageId,
+        version: options.packageVersion,
+        manifestCid: manifestCid,
+    };
+    const avatarMode = (0, avatarMode_1.parseAvatarMode)(options.avatarMode);
+    const readyCidsTyped = readyCids;
+    const release = {
+        schema: helix_manifest_1.CONTINUUM_WORLD_RELEASE_SCHEMA,
+        id: options.releaseId,
+        worldId: options.worldId,
+        version: options.version,
+        // rootScene is a Package Version reference and the contract does not
+        // require a scene-typed package -- an Unreal World's root IS its
+        // unreal-world package, which is why `scene: 0` above is coherent.
+        rootScene: packageReference,
+        gameplayPackages: [],
+        runtimeProfiles: [exports.UNREAL_RUNTIME_PROFILE],
+        readySets: [
+            {
+                schema: helix_manifest_1.CONTINUUM_READY_SET_SCHEMA,
+                id: 'unreal-world-content',
+                runtimeProfileId: exports.UNREAL_RUNTIME_PROFILE.id,
+                phase: 'beforeSpawn',
+                cids: readyCidsTyped,
+                // A World's own cooked content lives as long as the session that
+                // mounted it; it is not system content and not the player's.
+                retention: 'world-session',
+            },
+        ],
+        runtimePolicy: {
+            maxPlayers: options.maxPlayers ?? 1,
+            contentRating: options.contentRating ?? 'everyone',
+            requiredCapabilities: ['unreal-world'],
+            ...((0, avatarMode_1.shouldEmitAvatarMode)(avatarMode) ? { avatarMode } : {}),
+        },
+    };
+    // Their validator, not ours. Emitting a document this side believes in and
+    // the contract rejects is exactly the failure that costs a cook and an upload.
+    const validated = (0, helix_manifest_1.validateWorldRelease)(release);
+    if (!validated.valid) {
+        throw new Error(`The World Release does not satisfy helix-manifest:\n  ${validated.errors.join('\n  ')}`);
+    }
+    const outPath = (0, node_path_1.resolve)(options.outPath ?? (0, node_path_1.join)(publishDir, 'continuum', 'world-release.json'));
+    await (0, promises_1.mkdir)((0, node_path_1.dirname)(outPath), { recursive: true });
+    await (0, promises_1.writeFile)(outPath, `${JSON.stringify(validated.release, null, 2)}\n`, 'utf8');
+    return { outPath, release: validated.release, readyCids };
+}
+//# sourceMappingURL=release.js.map

package/dist/unreal/release.js.map

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

package/dist/unreal.d.ts

@@ -0,0 +1,30 @@
+import { type UnrealArtifactMode, type UnrealNetworkingMode } from './unrealManifest';
+export { initUnrealManifest, packageUnrealProject, readUnrealManifest, UNREAL_ARTIFACT_MODES, UNREAL_MANIFEST_FILENAME, UNREAL_NETWORKING_MODES, UNREAL_PACKAGE_INDEX_FILENAME, type UnrealArtifactMode, type UnrealNetworkingMode, type UnrealPackageIndex, type UnrealPackageResult, type UnrealProjectManifest, } from './unrealManifest';
+export { AvatarMode, parseAvatarMode, shouldEmitAvatarMode, } from './unreal/avatarMode';
+export declare const HELIX_UNREAL_ENGINE_VERSION: "5.8";
+export declare const HELIX_UNREAL_CONTRACT_VERSION: 21;
+export type UnrealValidationCheck = {
+    id: string;
+    status: 'pass' | 'fail';
+    message: string;
+    file?: string;
+};
+export type UnrealProjectValidationReport = {
+    schemaVersion: 1;
+    ok: boolean;
+    projectDir: string;
+    projectFile: string | null;
+    engineVersion: string | null;
+    contractVersion: number | null;
+    artifactMode: UnrealArtifactMode | null;
+    networking: UnrealNetworkingMode | null;
+    checks: UnrealValidationCheck[];
+    summary: {
+        passed: number;
+        failed: number;
+    };
+};
+export declare function validateUnrealProject(input?: string, options?: {
+    includeMcp?: boolean;
+}): UnrealProjectValidationReport;
+export declare function formatUnrealValidationReport(report: UnrealProjectValidationReport): string;