@hypersoniclabs/helix-cli 0.1.7 → 0.1.23

package/dist/continuum/characterMigrationGenerator.js

@@ -0,0 +1,242 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CHARACTER_BASE_ITEM_IDS = void 0;
+exports.generateCharacterContinuumMigration = generateCharacterContinuumMigration;
+exports.registerCharacterContinuumMigrationGeneratorCommand = registerCharacterContinuumMigrationGeneratorCommand;
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const helix_manifest_1 = require("@hypersoniclabs/helix-manifest");
+const config_1 = require("../config");
+const cli_1 = require("./cli");
+const identity_1 = require("./identity");
+exports.DEFAULT_CHARACTER_BASE_ITEM_IDS = [
+    'b45e4a1e-0000-4000-8000-000000000001',
+    'bcafa7e1-9487-422d-8c08-e152b81f1f45',
+];
+const IDENTITY_NAMESPACE = 'helix.creator.character-continuum-migration/1';
+const MAX_MIGRATION_ITEMS = 100;
+const REQUEST_CONCURRENCY = 8;
+function migrationUuid(key) {
+    return (0, identity_1.deterministicContinuumUuid)(`${IDENTITY_NAMESPACE}\0${key}`);
+}
+function jsonFileBytes(value) {
+    return Buffer.concat([Buffer.from((0, helix_manifest_1.canonicalJsonBytes)(value)), Buffer.from('\n')]);
+}
+function slug(value) {
+    return value.toLowerCase().normalize('NFKD').replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '').slice(0, 48) || 'character-item';
+}
+async function boundedMap(values, mapper) {
+    const results = new Array(values.length);
+    let cursor = 0;
+    await Promise.all(Array.from({ length: Math.min(REQUEST_CONCURRENCY, values.length) }, async () => {
+        while (cursor < values.length) {
+            const index = cursor;
+            cursor += 1;
+            results[index] = await mapper(values[index]);
+        }
+    }));
+    return results;
+}
+async function getJson(fetcher, apiBaseUrl, path) {
+    const response = await fetcher(`${apiBaseUrl}${path}`);
+    if (!response.ok)
+        throw new Error(`GET ${path} failed with HTTP ${response.status}`);
+    const body = await response.json();
+    return body && typeof body === 'object' && 'item' in body && body.item !== undefined
+        ? body.item
+        : body;
+}
+async function downloadForPublication(fetcher, url) {
+    const response = await fetcher(url);
+    if (!response.ok)
+        throw new Error(`GET ${url} failed with HTTP ${response.status}`);
+    if (!response.body)
+        throw new Error(`GET ${url} returned no response body`);
+    const hash = (0, node_crypto_1.createHash)('sha256');
+    const inlineChunks = [];
+    let byteLength = 0;
+    let retainInline = true;
+    for await (const chunk of response.body) {
+        const bytes = Buffer.from(chunk);
+        byteLength += bytes.byteLength;
+        hash.update(bytes);
+        if (retainInline && byteLength <= cli_1.MAX_INLINE_OBJECT_BYTES) {
+            inlineChunks.push(bytes);
+        }
+        else if (retainInline) {
+            retainInline = false;
+            inlineChunks.length = 0;
+        }
+    }
+    if (byteLength === 0)
+        throw new Error(`GET ${url} returned an empty asset`);
+    return {
+        digest: hash.digest('hex'),
+        byteLength,
+        ...(retainInline ? { inlineBytes: Buffer.concat(inlineChunks, byteLength) } : {}),
+    };
+}
+function assertBoundedIds(ids, label) {
+    const unique = [...new Set(ids)];
+    if (unique.length > MAX_MIGRATION_ITEMS) {
+        throw new TypeError(`${label} exceeds the ${MAX_MIGRATION_ITEMS}-item migration batch limit`);
+    }
+    unique.forEach((id) => (0, identity_1.assertContinuumUuid)(id, label));
+    return unique;
+}
+async function inventory(options) {
+    const explicitIds = assertBoundedIds(options.itemIds ?? [], 'Universal Item id');
+    if (explicitIds.length) {
+        return boundedMap(explicitIds, (id) => getJson(options.fetch, options.apiBaseUrl, `/api/v1/universal-items/${id}`));
+    }
+    const baseIds = assertBoundedIds(options.baseItemIds?.length ? options.baseItemIds : [...exports.DEFAULT_CHARACTER_BASE_ITEM_IDS], 'base Universal Item id');
+    const compatibleResponses = await boundedMap(baseIds, (baseId) => getJson(options.fetch, options.apiBaseUrl, `/api/v1/universal-items/${baseId}/add-ons?limit=${MAX_MIGRATION_ITEMS}`));
+    const ids = new Set(baseIds);
+    compatibleResponses.forEach((compatible, index) => {
+        if (!Array.isArray(compatible.items))
+            throw new Error(`${baseIds[index]} compatible add-ons response is not an array`);
+        if (Number.isInteger(compatible.total) && compatible.total > compatible.items.length) {
+            throw new Error(`${baseIds[index]} returned ${compatible.items.length} of ${compatible.total} compatible add-ons; generate explicit --item-id descriptors instead of silently truncating`);
+        }
+        compatible.items.forEach((item) => ids.add(item.id));
+    });
+    const discoveredIds = assertBoundedIds([...ids], 'discovered Universal Item id');
+    return boundedMap(discoveredIds, (id) => getJson(options.fetch, options.apiBaseUrl, `/api/v1/universal-items/${id}`));
+}
+function listing(itemId, surface, item, packageId) {
+    return {
+        listing: {
+            schema: 'helix.continuum.listing/1',
+            id: migrationUuid(`listing:${itemId}:${surface}`),
+            surface,
+            target: surface === 'vault'
+                ? { type: 'package', packageId }
+                : { type: 'universal-item', universalItemId: itemId },
+            visibility: 'public',
+            title: item.title,
+            tags: ['character', item.kind === 'avatar' ? 'base' : 'add-on'],
+        },
+    };
+}
+async function descriptor(item, outputDirectory, fetcher) {
+    if (item.kind !== 'avatar' && item.kind !== 'add_on') {
+        throw new Error(`${item.id} ${item.title} is ${item.kind}, not a character base or add-on`);
+    }
+    if (item.kind === 'add_on' && item.hostKind !== 'character') {
+        throw new Error(`${item.id} ${item.title} is an add-on for ${item.hostKind ?? 'an unknown host'}, not a character`);
+    }
+    if (item.status !== 'published') {
+        throw new Error(`${item.id} ${item.title} must be published before generating public Continuum adoption`);
+    }
+    const web = item.assets?.find((asset) => asset.rendition === 'web' && asset.status === 'ready' && asset.mimeType === 'model/gltf-binary');
+    if (!web?.cdnUrl)
+        throw new Error(`${item.id} ${item.title} has no ready web GLB`);
+    const downloaded = await downloadForPublication(fetcher, web.cdnUrl);
+    const filename = (0, node_path_1.basename)(new URL(web.cdnUrl).pathname);
+    const glbReference = {
+        cid: `cid:sha256:${downloaded.digest}`,
+        bytes: downloaded.byteLength,
+        mediaType: 'model/gltf-binary',
+        role: item.kind === 'avatar' ? 'character-rendition' : 'web-rendition',
+    };
+    const packageId = migrationUuid(`package:${item.id}`);
+    const isBase = item.kind === 'avatar';
+    const objects = [];
+    let root = glbReference;
+    if (!isBase) {
+        const definitionBytes = jsonFileBytes({
+            schema: 'helix.continuum.character-addon/1',
+            itemId: item.id,
+            title: item.title,
+            hostKind: item.hostKind,
+            ...(item.fits?.slotType ? { slotType: item.fits.slotType } : {}),
+            fits: item.fits ?? {},
+            ops: item.ops ?? item.properties?.ops ?? [],
+            rendition: glbReference,
+        });
+        root = {
+            cid: `cid:sha256:${(0, node_crypto_1.createHash)('sha256').update(definitionBytes).digest('hex')}`,
+            bytes: definitionBytes.byteLength,
+            mediaType: 'application/vnd.helix.character-addon+json;version=1',
+            role: 'addon-definition',
+        };
+        objects.push({ reference: root, source: { kind: 'file', path: 'addon-definition.json', audience: 'public' } });
+        await (0, promises_1.writeFile)((0, node_path_1.join)(outputDirectory, item.id, 'addon-definition.json'), definitionBytes);
+    }
+    objects.push({
+        reference: glbReference,
+        source: downloaded.inlineBytes
+            ? { kind: 'file', path: filename, audience: 'public' }
+            : { kind: 'universal-item-adoption', assetId: web.id, contentSha256: downloaded.digest, audience: 'public' },
+    });
+    if (downloaded.inlineBytes)
+        await (0, promises_1.writeFile)((0, node_path_1.join)(outputDirectory, item.id, filename), downloaded.inlineBytes);
+    const requires = isBase ? [] : [item.fits?.requires?.skeleton ?? 'helix-humanoid@1'];
+    const provides = isBase
+        ? ['helix-humanoid@1', 'character.base@1']
+        : ['character-addon@1', ...(item.fits?.slotType ? [item.fits.slotType] : [])];
+    return {
+        projectId: `legacy-character-item:${item.id}`,
+        package: { schema: 'helix.continuum.package/1', id: packageId, type: isBase ? 'character' : 'addon', name: item.title },
+        packagePublication: { slug: `${slug(item.title)}-${item.id.slice(0, 8)}`, visibility: 'public' },
+        packageVersion: {
+            schema: 'helix.continuum.package-version/1',
+            package: { id: packageId, type: isBase ? 'character' : 'addon' },
+            version: '1.0.0', root, dependencies: [],
+            variants: [{ id: 'web', runtimeProfileId: 'web-balanced', object: glbReference }],
+            compatibility: { contract: isBase ? 'helix.character/1' : 'helix.addon/1', requires, provides },
+            provenance: { kind: 'imported', source: 'legacy-universal-item', sourceId: item.id },
+            expectedClosure: {
+                objectCount: objects.length,
+                totalBytes: objects.reduce((sum, object) => sum + object.reference.bytes, 0),
+            },
+        },
+        objects,
+        universalItemPin: { itemId: item.id, promoteToPublished: true },
+        listings: [listing(item.id, 'vault', item, packageId), listing(item.id, 'marketplace', item, packageId)],
+    };
+}
+async function generateCharacterContinuumMigration(options) {
+    const outputDirectory = (0, node_path_1.resolve)(options.outputDirectory);
+    const apiBaseUrl = (options.apiBaseUrl ?? config_1.DEFAULT_API_URL).replace(/\/+$/, '');
+    const fetcher = options.fetch ?? fetch;
+    await (0, promises_1.mkdir)(outputDirectory, { recursive: true });
+    const items = await inventory({ apiBaseUrl, fetch: fetcher, itemIds: options.itemIds, baseItemIds: options.baseItemIds });
+    const summary = [];
+    for (const item of items.sort((a, b) => a.id.localeCompare(b.id))) {
+        await (0, promises_1.mkdir)((0, node_path_1.join)(outputDirectory, item.id), { recursive: true });
+        const publication = await descriptor(item, outputDirectory, fetcher);
+        await (0, promises_1.writeFile)((0, node_path_1.join)(outputDirectory, item.id, 'publish.json'), Buffer.from(`${JSON.stringify(publication, null, 2)}\n`));
+        summary.push({
+            itemId: item.id,
+            title: item.title,
+            kind: item.kind,
+            packageId: publication.package.id,
+            listingIds: publication.listings.map((entry) => entry.listing.id),
+            descriptor: `${item.id}/publish.json`,
+        });
+    }
+    await (0, promises_1.writeFile)((0, node_path_1.join)(outputDirectory, 'inventory.json'), Buffer.from(`${JSON.stringify({ count: summary.length, items: summary }, null, 2)}\n`));
+    return { status: 'ready', count: summary.length, outputDirectory, itemIds: summary.map((item) => item.itemId) };
+}
+function collect(value, previous) {
+    return [...previous, value];
+}
+function registerCharacterContinuumMigrationGeneratorCommand(continuum) {
+    continuum
+        .command('prepare-legacy-character-packages')
+        .description('Generate deterministic Continuum character/add-on migration descriptors without publishing')
+        .requiredOption('--output <directory>', 'descriptor and small-object output directory')
+        .option('--item-id <uuid>', 'generate exactly this Universal Item (repeatable)', collect, [])
+        .option('--base-item-id <uuid>', 'discover this base and its compatible add-ons (repeatable)', collect, [])
+        .action(async (options) => {
+        const receipt = await generateCharacterContinuumMigration({
+            outputDirectory: options.output,
+            itemIds: options.itemId,
+            baseItemIds: options.baseItemId,
+        });
+        console.log(JSON.stringify(receipt, null, 2));
+    });
+}
+//# sourceMappingURL=characterMigrationGenerator.js.map

package/dist/continuum/characterMigrationGenerator.js.map

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

package/dist/continuum/cli.d.ts

@@ -0,0 +1,69 @@
+import type { ContinuumObjectReference } from '@hypersoniclabs/helix-manifest';
+import type { ScenePackageCompilationInput } from '../sceneElements/continuum';
+import type { SourceSceneMap } from '../sceneImport/semantic';
+import type { ScratchSceneDescription } from './authoring';
+import type { ContinuumObjectPublication, ContinuumPublicationIntent } from './types';
+type FileObjectSource = {
+    kind: 'file';
+    path: string;
+    audience?: 'private' | 'public';
+};
+type CliObject = {
+    reference: ContinuumObjectReference;
+    source: FileObjectSource | Exclude<ContinuumObjectPublication['source'], {
+        kind: 'inline';
+    }>;
+};
+export type ContinuumPackagePublicationFile = Omit<ContinuumPublicationIntent, 'sourceDigest' | 'objects'> & {
+    sourceDigest?: string;
+    objects: CliObject[];
+    sourceDirectory?: {
+        path: string;
+        audience?: 'private' | 'public';
+    };
+};
+export type ContinuumWorldPublicationFile<T> = {
+    projectId: string;
+    sourceDigest?: string;
+    source: T;
+    compilation: Omit<ScenePackageCompilationInput, 'document'>;
+    packagePublication?: ContinuumPublicationIntent['packagePublication'];
+    defaultRuntimeProfileId: string;
+    objects?: CliObject[];
+    listings: ContinuumPublicationIntent['listings'];
+};
+export declare const MAX_INLINE_OBJECT_BYTES: number;
+export declare function readContinuumPublicationFile<T>(path: string): Promise<{
+    input: T;
+    sourceDigest: string;
+    objectPublications: ContinuumObjectPublication[];
+}>;
+export declare function readSafeRegularFile(path: string, maxBytes: number, label: string): Promise<{
+    path: string;
+    bytes: Uint8Array;
+}>;
+export declare function readSafeConfinedFile(baseDirectory: string, requestedPath: string, maxBytes: number, label: string): Promise<{
+    path: string;
+    bytes: Uint8Array;
+}>;
+export type SourceWorldPublicationFile = ContinuumWorldPublicationFile<SourceSceneMap>;
+export type ScratchWorldPublicationFile = ContinuumWorldPublicationFile<ScratchSceneDescription>;
+/**
+ * Proves, from the backend's own published contract, that a Package Version can be
+ * sealed immutably without becoming current and activated separately afterwards.
+ *
+ * This is deliberately not a hardcoded claim. Staging is the difference between
+ * publishing bytes and switching every world over to them, so the CLI reads the live
+ * OpenAPI document and confirms the seal request really accepts `activate` and the
+ * activate route really exists. A backend that predates staged versions fails the check
+ * instead of silently activating a release that was never verified.
+ */
+export type ContinuumStagedPackageVersionSupport = {
+    contract: 'helix.continuum.staged-package-version/1';
+    sealedNonCurrentStaging: boolean;
+    explicitVersionActivation: boolean;
+    /** The backend serves the admin Package publication routes (`publish-package --as-admin`). */
+    adminPackagePublication?: true;
+};
+export declare function continuumStagedPackageVersionSupport(apiOrigin: string, fetchImpl?: typeof fetch): Promise<ContinuumStagedPackageVersionSupport>;
+export {};

package/dist/continuum/cli.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_INLINE_OBJECT_BYTES = void 0;
+exports.readContinuumPublicationFile = readContinuumPublicationFile;
+exports.readSafeRegularFile = readSafeRegularFile;
+exports.readSafeConfinedFile = readSafeConfinedFile;
+exports.continuumStagedPackageVersionSupport = continuumStagedPackageVersionSupport;
+const node_crypto_1 = require("node:crypto");
+const node_buffer_1 = require("node:buffer");
+const node_path_1 = require("node:path");
+const promises_1 = require("node:fs/promises");
+const sourceBundle_1 = require("./sourceBundle");
+const objectUpload_1 = require("./objectUpload");
+const MAX_DESCRIPTOR_BYTES = 16 * 1024 * 1024;
+exports.MAX_INLINE_OBJECT_BYTES = 1024 * 1024;
+async function readContinuumPublicationFile(path) {
+    const absolute = (0, node_path_1.resolve)(path);
+    const descriptor = await readSafeRegularFile(absolute, MAX_DESCRIPTOR_BYTES, 'publication descriptor');
+    const descriptorPath = descriptor.path;
+    const bytes = descriptor.bytes;
+    const input = JSON.parse(node_buffer_1.Buffer.from(bytes).toString('utf8'));
+    let sourceDigest = (input.sourceDigest ?? (0, node_crypto_1.createHash)('sha256').update(bytes).digest('hex')).toLowerCase();
+    const objectPublications = [];
+    const descriptorDirectory = await (0, promises_1.realpath)((0, node_path_1.dirname)(descriptorPath));
+    for (const object of input.objects ?? []) {
+        if (object.source.kind === 'file') {
+            if (!object.source.path || object.source.path.includes('\0'))
+                throw new TypeError('file object source path must be a non-empty path');
+            // A file object rides the same lane as any local bytes: `putObject` inlines up to 1 MiB and stages the rest.
+            const source = await readSafeConfinedFile(descriptorDirectory, object.source.path, objectUpload_1.CONTINUUM_OBJECT_UPLOAD_MAX_BYTES, `file object source ${object.source.path}`);
+            objectPublications.push({
+                reference: object.reference,
+                source: { kind: 'inline', bytes: source.bytes, filename: (0, node_path_1.basename)(source.path), audience: object.source.audience },
+            });
+        }
+        else {
+            objectPublications.push({ reference: object.reference, source: object.source });
+        }
+    }
+    if (input.sourceDirectory !== undefined) {
+        if (!input.sourceDirectory || typeof input.sourceDirectory.path !== 'string' || !input.sourceDirectory.path || input.sourceDirectory.path.includes('\0')) {
+            throw new TypeError('sourceDirectory.path must be a non-empty descriptor-relative directory');
+        }
+        if (!input.packageVersion)
+            throw new TypeError('sourceDirectory requires packageVersion');
+        const sourcePath = (0, node_path_1.resolve)(descriptorDirectory, input.sourceDirectory.path);
+        const sourceMetadata = await (0, promises_1.lstat)(sourcePath);
+        if (sourceMetadata.isSymbolicLink() || !sourceMetadata.isDirectory())
+            throw new TypeError('sourceDirectory must be a real directory');
+        const sourceRealPath = await (0, promises_1.realpath)(sourcePath);
+        const confinement = (0, node_path_1.relative)(descriptorDirectory, sourceRealPath);
+        if (confinement === '..' || confinement.startsWith(`..${node_path_1.sep}`) || (0, node_path_1.isAbsolute)(confinement)) {
+            throw new TypeError('sourceDirectory escapes the descriptor directory');
+        }
+        const built = await (0, sourceBundle_1.buildContinuumSourceBundle)(sourceRealPath);
+        const previous = input.packageVersion.source;
+        input.packageVersion.source = built.reference;
+        input.packageVersion.expectedClosure = {
+            objectCount: input.packageVersion.expectedClosure.objectCount + (previous ? 0 : 1),
+            totalBytes: input.packageVersion.expectedClosure.totalBytes - (previous?.bytes ?? 0) + built.reference.bytes,
+        };
+        objectPublications.push({
+            reference: built.reference,
+            source: {
+                kind: 'inline',
+                bytes: built.bytes,
+                filename: 'continuum-source-bundle.json',
+                audience: input.sourceDirectory.audience ?? 'private',
+            },
+        });
+        sourceDigest = (0, node_crypto_1.createHash)('sha256').update(bytes).update('\0').update(built.bytes).digest('hex');
+    }
+    return { input, sourceDigest, objectPublications };
+}
+async function readSafeRegularFile(path, maxBytes, label) {
+    const resolved = await regularRealPath(path, maxBytes, label);
+    return { path: resolved, bytes: await (0, promises_1.readFile)(resolved) };
+}
+async function readSafeConfinedFile(baseDirectory, requestedPath, maxBytes, label) {
+    const base = await (0, promises_1.realpath)(baseDirectory);
+    const source = await readSafeRegularFile((0, node_path_1.resolve)(base, requestedPath), maxBytes, label);
+    const confinement = (0, node_path_1.relative)(base, source.path);
+    if (confinement === '..' || confinement.startsWith(`..${node_path_1.sep}`) || (0, node_path_1.isAbsolute)(confinement)) {
+        throw new TypeError(`${label} escapes the descriptor directory`);
+    }
+    return source;
+}
+async function regularRealPath(path, maxBytes, label) {
+    const linkMetadata = await (0, promises_1.lstat)(path);
+    if (linkMetadata.isSymbolicLink())
+        throw new TypeError(`${label} must not be a symbolic link`);
+    const resolved = await (0, promises_1.realpath)(path);
+    const metadata = await (0, promises_1.stat)(resolved);
+    if (!metadata.isFile())
+        throw new TypeError(`${label} must be a regular file`);
+    if (metadata.size > maxBytes)
+        throw new TypeError(`${label} exceeds the ${maxBytes}-byte read limit`);
+    return resolved;
+}
+const SEAL_ROUTE = /\/api\/v1\/continuum\/packages\/\{[^}]+\}\/versions\/\{[^}]+\}\/seal$/;
+const ACTIVATE_ROUTE = /\/api\/v1\/continuum\/packages\/\{[^}]+\}\/versions\/\{[^}]+\}\/activate$/;
+async function continuumStagedPackageVersionSupport(apiOrigin, fetchImpl = fetch) {
+    // Production disables /openapi.json, so a backend that states its capabilities is asked first.
+    const stated = await fetchImpl(new URL('/api/v1/continuum/publication-capabilities', apiOrigin).href, {
+        headers: { accept: 'application/json' },
+    });
+    if (stated.ok) {
+        const body = await stated.json();
+        if (body.contract !== 'helix.continuum.staged-package-version/1'
+            || body.sealedNonCurrentStaging !== true || body.explicitVersionActivation !== true) {
+            throw new Error('Continuum backend cannot seal a non-current Package Version and activate it separately; refusing to report staging support');
+        }
+        return {
+            contract: 'helix.continuum.staged-package-version/1',
+            sealedNonCurrentStaging: true,
+            explicitVersionActivation: true,
+            ...(body.adminPackagePublication === true ? { adminPackagePublication: true } : {}),
+        };
+    }
+    const documentUrl = new URL('/openapi.json', apiOrigin);
+    const response = await fetchImpl(documentUrl.href, { headers: { accept: 'application/json' } });
+    if (!response.ok) {
+        throw new Error(`Continuum backend did not publish an OpenAPI contract (HTTP ${response.status})`);
+    }
+    const document = await response.json();
+    const paths = Object.keys(document.paths ?? {});
+    const sealPath = paths.find((path) => SEAL_ROUTE.test(path));
+    const explicitVersionActivation = paths.some((path) => ACTIVATE_ROUTE.test(path));
+    let sealedNonCurrentStaging = false;
+    if (sealPath) {
+        const reference = document.paths?.[sealPath]?.post?.requestBody?.content?.['application/json']?.schema?.$ref;
+        const schemaName = reference?.split('/').pop();
+        const properties = schemaName ? document.components?.schemas?.[schemaName]?.properties : undefined;
+        sealedNonCurrentStaging = Boolean(properties && 'activate' in properties);
+    }
+    if (!sealedNonCurrentStaging || !explicitVersionActivation) {
+        throw new Error('Continuum backend cannot seal a non-current Package Version and activate it separately; refusing to report staging support');
+    }
+    return {
+        contract: 'helix.continuum.staged-package-version/1',
+        sealedNonCurrentStaging,
+        explicitVersionActivation,
+    };
+}
+//# sourceMappingURL=cli.js.map

package/dist/continuum/cli.js.map

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

package/dist/continuum/cliAuthority.d.ts

@@ -0,0 +1,17 @@
+type ListingCarrier = {
+    listings: Array<{
+        listing: {
+            id: string;
+            visibility: string;
+        };
+    }>;
+};
+/**
+ * Process-local capability used only by the executable entrypoint. It is not
+ * exported from the Creator library, serializable into a descriptor, or
+ * available to the MCP adapter.
+ */
+export declare function confirmPublicListingsForCli<T extends ListingCarrier>(input: T, confirmed: boolean): T;
+export declare function cliConfirmedPublicListing(input: object, listingId: string): boolean;
+export declare function transferCliPublicListingConfirmation(source: object, target: ListingCarrier): void;
+export {};

package/dist/continuum/cliAuthority.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmPublicListingsForCli = confirmPublicListingsForCli;
+exports.cliConfirmedPublicListing = cliConfirmedPublicListing;
+exports.transferCliPublicListingConfirmation = transferCliPublicListingConfirmation;
+const cliPublicListingConfirmations = new WeakMap();
+/**
+ * Process-local capability used only by the executable entrypoint. It is not
+ * exported from the Creator library, serializable into a descriptor, or
+ * available to the MCP adapter.
+ */
+function confirmPublicListingsForCli(input, confirmed) {
+    if (confirmed) {
+        cliPublicListingConfirmations.set(input, new Set(input.listings
+            .filter((entry) => entry.listing.visibility === 'public')
+            .map((entry) => entry.listing.id)));
+    }
+    return input;
+}
+function cliConfirmedPublicListing(input, listingId) {
+    return cliPublicListingConfirmations.get(input)?.has(listingId) === true;
+}
+function transferCliPublicListingConfirmation(source, target) {
+    const confirmed = cliPublicListingConfirmations.get(source);
+    if (confirmed)
+        cliPublicListingConfirmations.set(target, confirmed);
+}
+//# sourceMappingURL=cliAuthority.js.map

package/dist/continuum/cliAuthority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliAuthority.js","sourceRoot":"","sources":["../../src/continuum/cliAuthority.ts"],"names":[],"mappings":";;AASA,kEAOC;AAED,8DAEC;AAED,oFAGC;AAvBD,MAAM,6BAA6B,GAAG,IAAI,OAAO,EAA+B,CAAC;AAEjF;;;;GAIG;AACH,SAAgB,2BAA2B,CAA2B,KAAQ,EAAE,SAAkB;IAChG,IAAI,SAAS,EAAE,CAAC;QACd,6BAA6B,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ;aAC5D,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC;aACxD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,yBAAyB,CAAC,KAAa,EAAE,SAAiB;IACxE,OAAO,6BAA6B,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAC3E,CAAC;AAED,SAAgB,oCAAoC,CAAC,MAAc,EAAE,MAAsB;IACzF,MAAM,SAAS,GAAG,6BAA6B,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5D,IAAI,SAAS;QAAE,6BAA6B,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACtE,CAAC"}

package/dist/continuum/client.d.ts

@@ -0,0 +1,103 @@
+import type { ContinuumPackage, ContinuumPackageVersion, ContinuumPackageVersionReference, Listing, WorldRelease } from '@hypersoniclabs/helix-manifest';
+import { HelixApi } from '../api';
+import type { ContinuumLease, ContinuumObjectRecord, ContinuumPublicationApi } from './types';
+import type { ContinuumPackageInspection } from './pull';
+/** Thin transport only. Creator policy and compilation stay out of the backend client. */
+export declare class HelixContinuumApi implements ContinuumPublicationApi {
+    protected readonly api: HelixApi;
+    constructor(api: HelixApi);
+    putObject(input: {
+        bytes: Uint8Array;
+        filename: string;
+        mediaType: string;
+        audience?: 'private' | 'public';
+    }): Promise<ContinuumObjectRecord>;
+    /**
+     * Publish a cooked file from disk without ever holding the whole file.
+     *
+     * Small objects keep the generic 32 MiB lane; only a reviewed Unreal object
+     * above that cap takes the dedicated resumable large lane. The file is
+     * stream-hashed once and each part is read on demand.
+     */
+    putObjectFromFile(input: {
+        path: string;
+        filename: string;
+        mediaType: string;
+        audience?: 'private' | 'public';
+    }): Promise<ContinuumObjectRecord>;
+    adoptUniversalItemObject(assetId: string, contentSha256: string, audience?: 'private' | 'public'): Promise<ContinuumObjectRecord>;
+    adoptVaultObject(versionId: string, audience?: 'private' | 'public'): Promise<ContinuumObjectRecord>;
+    adoptInstantWorldObject(buildId: string, contentSha256: string): Promise<ContinuumObjectRecord>;
+    createPackage(pkg: ContinuumPackage, settings?: {
+        slug?: string;
+        visibility?: 'private' | 'public';
+    }): Promise<unknown>;
+    createPackageVersion(packageId: string, version: ContinuumPackageVersion): Promise<unknown>;
+    inspectPackageVersion(packageId: string, version: string): Promise<ContinuumPackageInspection>;
+    readPackageObject(packageId: string, version: string, manifestCid: string, cid: string): Promise<{
+        bytes: Uint8Array;
+        mediaType: string;
+    }>;
+    acquirePackageVersionLease(packageId: string, version: string, input: {
+        leaseOwner: string;
+        ttlSeconds: number;
+        operationId: string;
+        expectedFencingToken?: string;
+    }): Promise<ContinuumLease>;
+    sealPackageVersion(packageId: string, version: string, input: {
+        leaseOwner: string;
+        fencingToken: string;
+        activate?: boolean;
+    }): Promise<unknown>;
+    pinVaultAssetVersionPackage(vaultAssetVersionId: string, packagePin: ContinuumPackageVersionReference): Promise<unknown>;
+    pinUniversalItemPackage(itemId: string, input: {
+        packagePin: ContinuumPackageVersionReference;
+        promoteToPublished?: true;
+    }): Promise<unknown>;
+    /** Admin-only migration for legacy Items that cannot be pinned by their current owner. */
+    pinLegacyUniversalItemPackageAsAdmin(itemId: string, input: {
+        packagePin: ContinuumPackageVersionReference;
+        promoteToPublished?: true;
+    }): Promise<unknown>;
+    createListing(listing: Listing): Promise<unknown>;
+    publishWorldRelease(worldId: string, input: {
+        release: WorldRelease;
+        defaultRuntimeProfileId: string;
+    }): Promise<unknown>;
+}
+/**
+ * Explicitly scoped transport for the one-time migration of legacy Universal
+ * Items whose current creator differs from the authenticated Continuum admin.
+ * Every other publication operation is identical to the normal creator path.
+ */
+export declare class HelixLegacyAdminContinuumApi extends HelixContinuumApi {
+    pinUniversalItemPackage(itemId: string, input: {
+        packagePin: ContinuumPackageVersionReference;
+        promoteToPublished?: true;
+    }): Promise<unknown>;
+    createListing(listing: Listing): Promise<unknown>;
+}
+/**
+ * Publishes into an EXISTING Package another account owns (platform material corrections such as the HELIX
+ * Palette) through the backend's admin Package routes. Ownership never changes; objects upload as the admin.
+ */
+export declare class HelixPackageAdminContinuumApi extends HelixContinuumApi {
+    createPackage(pkg: ContinuumPackage, settings?: {
+        slug?: string;
+        visibility?: 'private' | 'public';
+    }): Promise<unknown>;
+    createPackageVersion(packageId: string, version: ContinuumPackageVersion): Promise<unknown>;
+    inspectPackageVersion(packageId: string, version: string): Promise<ContinuumPackageInspection>;
+    acquirePackageVersionLease(packageId: string, version: string, input: {
+        leaseOwner: string;
+        ttlSeconds: number;
+        operationId: string;
+        expectedFencingToken?: string;
+    }): Promise<ContinuumLease>;
+    sealPackageVersion(packageId: string, version: string, input: {
+        leaseOwner: string;
+        fencingToken: string;
+        activate?: boolean;
+    }): Promise<unknown>;
+    createListing(): Promise<unknown>;
+}