@hypersoniclabs/helix-cli 0.1.24 → 0.1.25-helix3.460

package/dist/index.js

@@ -1145,6 +1145,67 @@ vehicleCommand
         process.exitCode = 2;
     }
 });
+vehicleCommand
+    .command('pull')
+    .description('Rebuild a publishable COPY of a live vehicle: read the Item\'s sealed Vehicle Package Version and write '
+    + 'vehicle-package.json (the exact sealed root), audio/<file> for every sound it pins, model.glb plus model-<renditionId>.glb for '
+    + 'every served mesh rendition, a publish.json carrying the Item fields (the legacy "general" rating is written as "everyone"; a '
+    + 'rating that is not one of everyone|teen|mature|adult needs --content-rating) and a pull.json recording where each byte came from. '
+    + 'Nothing is uploaded and no ledger is written, so the copy mints a NEW Item instead of resuming against the live one: '
+    + 'pull into a new directory, then `helix vehicle publish <dir>`. Exit 0 = pulled, 1 = nothing written, 2 = could not run')
+    .argument('<item-id>', 'the published vehicle Item to copy')
+    .argument('<dir>', 'a NEW directory to write the copy into (must not exist, or be empty)')
+    .option('--package-version <semver>', 'pull this Version instead of the Item\'s current pin (a car\'s history is copyable too)')
+    .option('--content-rating <rating>', 'the rating to write for the COPY: everyone, teen, mature or adult (default: the Item\'s own, mapped)')
+    .option('--json', 'print the machine-readable result')
+    .action(async (itemId, dir, opts) => {
+    try {
+        const pull = await Promise.resolve().then(() => __importStar(require('./vehicle/pull')));
+        const { getItem, fetchPublicObject, isRecord } = await Promise.resolve().then(() => __importStar(require('./vehicle/platform')));
+        const creds = requireAuth();
+        const api = lib_1.HelixApi.forCredentials(creds);
+        const apiUrl = creds.apiUrl.replace(/\/$/, '');
+        const shaOf = (value) => /^[0-9a-f]{64}$/i.test(value) ? value.toLowerCase() : (/^cid:sha256:([0-9a-f]{64})$/i.exec(value)?.[1] ?? null);
+        const result = await pull.pullVehicle({
+            itemId, dir, packageVersion: opts.packageVersion, contentRating: opts.contentRating,
+            onProgress: (m) => { if (!opts.json)
+                console.log(`· ${m}`); },
+        }, {
+            readItem: (id) => getItem(api, id),
+            readVersion: async (packageId, version) => {
+                const tail = `packages/${packageId}/versions/${encodeURIComponent(version)}`;
+                const unwrap = (body) => {
+                    const record = isRecord(body) ? body : {};
+                    const manifest = isRecord(record.manifest) ? record.manifest : record;
+                    return { ...(typeof record.manifestCid === 'string' ? { manifestCid: record.manifestCid } : {}), manifest };
+                };
+                try {
+                    return unwrap(await api.request('GET', `/api/v1/continuum/public/${tail}`));
+                }
+                catch (error) {
+                    // The public route serves a PUBLIC Package only; the authenticated one covers the creator's own and an admin.
+                    try {
+                        return unwrap(await api.request('GET', `/api/v1/continuum/${tail}`));
+                    }
+                    catch {
+                        throw error;
+                    }
+                }
+            },
+            readObject: async (cidOrSha) => {
+                const sha = shaOf(cidOrSha);
+                if (!sha)
+                    throw new Error(`not a Continuum object reference: ${cidOrSha}`);
+                return fetchPublicObject(apiUrl, sha);
+            },
+        });
+        printVehicleJsonOr(opts.json, result, () => console.log(pull.formatVehiclePull(result)));
+    }
+    catch (error) {
+        process.stderr.write(`${error instanceof lib_1.ApiError ? error.render() : `✖ ${error instanceof Error ? error.message : String(error)}`}\n`);
+        process.exitCode = 1;
+    }
+});
 vehicleAddOnCommand
     .command('publish')
     .description('Publish a vehicle add-on directory: the full `vehicle addon check` (drive effect measured), upload the model, seal a public addon '
@@ -3669,7 +3730,7 @@ assets
 });
 const assetsStart = assets
     .command('start')
-    .description('Start one generation job without waiting; prop/character use Dreamer, other supported kinds use the shared asset pipeline. For audio, --mode selects sound_effect (default), music, or text_to_speech.')
+    .description('Start one generation job without waiting; prop/character use the Asset Generation job lane, other supported kinds use the standalone lane. For audio, --mode selects sound_effect (default), music, or text_to_speech.')
     .argument('<kind>', 'prop, character, image, material, audio, gaussian_splat, or animation (explicit unavailable stub)')
     // Optional at the parser level ON PURPOSE: text_to_speech takes its content from --text, and a
     // commander-level "missing required argument 'prompt'" would be actively misleading there.
@@ -3678,8 +3739,8 @@ const assetsStart = assets
     .option('--title <title>', 'asset title')
     .option('--additional-prompt <text>', 'additional generation guidance')
     .option('--target-polycount <n>', 'prop/character triangle target')
-    .option('--project-id <id>', 'Dreamer project id')
-    .option('--session-id <id>', 'Dreamer session id')
+    .option('--project-id <id>', 'Dreamer project id (set only when Dreamer, the website agent, started the call)')
+    .option('--session-id <id>', 'Dreamer session id (set only when Dreamer, the website agent, started the call)')
     .option('--loop', 'audio: request loopable output')
     .option('--duration-seconds <n>', 'audio duration')
     .option('--resolution <n>', 'material resolution: 1024 or 2048', '1024')
@@ -3887,7 +3948,7 @@ assets
     // does not continue anything. The job parks at `preview_ready` and waits for an explicit
     // `helix assets resume`, which nothing said, so a finished character sat there indefinitely.
     .description('Approve a job waiting at an approval gate. The concept gate continues on its own; the preview gate then waits for `helix assets resume`')
-    .argument('<job-id>', 'Dreamer job id')
+    .argument('<job-id>', 'Asset Generation job id')
     .requiredOption('--gate <gate>', 'concept or preview')
     .option('--json', 'emit only the job JSON on stdout')
     .action(async (jobId, opts) => {
@@ -3917,7 +3978,7 @@ assets
 assets
     .command('revise')
     .description('Revise a job waiting at an approval gate, with new guidance. CHARGES a fresh regeneration — this is a spend, not a free retry. The only advance path when the server rejected its own concept.')
-    .argument('<job-id>', 'Dreamer job id')
+    .argument('<job-id>', 'Asset Generation job id')
     .requiredOption('--gate <gate>', 'concept or preview')
     .option('--prompt <text>', 'what to change about the rejected output')
     .action(async (jobId, opts) => {
@@ -3937,7 +3998,7 @@ assets
 assets
     .command('retry')
     .description('Retry a FAILED job (no new guidance). Resumes from the stage that stopped — the mesh phase for a prop or character, the bundle/publish step for a material, image or texture')
-    .argument('<job-id>', 'Dreamer job id')
+    .argument('<job-id>', 'Asset Generation job id')
     .action(async (jobId) => {
     const creds = requireAuth();
     try {
@@ -3952,7 +4013,7 @@ assets
 assets
     .command('abandon')
     .description('Explain how a stranded job releases its held LIX (no platform verb does this on demand)')
-    .argument('[job-id]', 'Dreamer job id')
+    .argument('[job-id]', 'Asset Generation job id')
     .action(() => {
     // Calls NOTHING on purpose. POST /dreamer/jobs/:id/abandon was specified and built, then
     // withdrawn before deploying — releasing escrow is real money movement. Keeping a command that
@@ -3974,8 +4035,8 @@ assets
 assets
     .command('status')
     .description('Poll one generation job without starting or advancing a duplicate')
-    .argument('<job-id>', 'Dreamer job id')
-    .requiredOption('--pipeline <pipeline>', 'dreamer (prop/character) or asset')
+    .argument('<job-id>', 'Asset Generation job id')
+    .requiredOption('--pipeline <pipeline>', 'dreamer = prop/character job lane (legacy name), asset = standalone lane')
     .action(async (jobId, opts) => {
     if (!['dreamer', 'asset'].includes(opts.pipeline)) {
         fail('✖ --pipeline must be dreamer or asset');
@@ -4034,7 +4095,7 @@ assets
 });
 assets
     .command('generate')
-    .description('Generate and publish a new prop or character through Dreamer')
+    .description('Generate and publish a new prop or character with Asset Generation')
     .argument('<kind>', 'prop or character')
     .argument('<prompt>', 'asset prompt')
     .option('--title <title>', 'asset title')
@@ -4110,8 +4171,8 @@ assets
 });
 assets
     .command('resume')
-    .description('Resume and publish an existing Dreamer asset job')
-    .argument('<job-id>', 'Dreamer job id')
+    .description('Resume and publish an existing Asset Generation job')
+    .argument('<job-id>', 'Asset Generation job id')
     .option('--visibility <visibility>', 'public, unlisted, or private (default: the visibility the job was generated with, else public)')
     .option('--timeout <ms>', 'how long to wait for the job to finish before giving up (client-side only — the job keeps running; default 1200000ms/20min)')
     .option('--poll-interval <ms>', 'how often to poll job status while waiting (default 2000ms)')
@@ -4143,12 +4204,12 @@ assets
 });
 assets
     .command('generate-image')
-    .description('Generate a standalone image through Dreamer')
+    .description('Generate a standalone image with Asset Generation')
     .argument('<prompt>', 'image prompt')
     .option('--title <title>', 'asset title')
     .option('--additional-prompt <text>', 'additional generation guidance')
-    .option('--project-id <id>', 'Dreamer project id')
-    .option('--session-id <id>', 'Dreamer session id')
+    .option('--project-id <id>', 'Dreamer project id (set only when Dreamer, the website agent, started the call)')
+    .option('--session-id <id>', 'Dreamer session id (set only when Dreamer, the website agent, started the call)')
     .option('--visibility <public|private>', 'where the image lands in the Vault. Default: your account preference (public unless you opted out). ' +
     'Use `private` for the concept/reference sheet of a private avatar, so the sheet is not published.')
     .action(async (prompt, opts) => {
@@ -4180,8 +4241,8 @@ assets
     .argument('<prompt>', 'material prompt')
     .option('--title <title>', 'asset title')
     .option('--additional-prompt <text>', 'additional generation guidance')
-    .option('--project-id <id>', 'Dreamer project id')
-    .option('--session-id <id>', 'Dreamer session id')
+    .option('--project-id <id>', 'Dreamer project id (set only when Dreamer, the website agent, started the call)')
+    .option('--session-id <id>', 'Dreamer session id (set only when Dreamer, the website agent, started the call)')
     .option('--resolution <n>', 'map resolution: 1024 (web/mobile default) or 2048', '1024')
     .option('--repeat-per-meter <n>', 'physical texture scale expressed as tile repeats per metre')
     .action(async (prompt, opts) => {
@@ -4207,11 +4268,11 @@ assets
 });
 assets
     .command('generate-environment')
-    .description('Generate an experimental Gaussian-splat environment through Dreamer')
+    .description('Generate an experimental Gaussian-splat environment with Asset Generation')
     .argument('<prompt>', 'generation prompt')
     .option('--additional-prompt <text>', 'additional generation guidance')
-    .option('--project-id <id>', 'Dreamer project id')
-    .option('--session-id <id>', 'Dreamer session id')
+    .option('--project-id <id>', 'Dreamer project id (set only when Dreamer, the website agent, started the call)')
+    .option('--session-id <id>', 'Dreamer session id (set only when Dreamer, the website agent, started the call)')
     .option('--title <title>', 'asset title')
     .option('--splat-scope <scope>', 'object or environment', 'environment')
     .action(async (prompt, opts) => {