@assethub/cli 0.1.16 → 0.1.18

package/README.md

@@ -141,7 +141,7 @@ Existing parts commands use the same canvas and durable operation storage:
 assethub parts split --source-id "$IMAGE_ASSET_ID" --canvas "$CANVAS_ID" --part-extractor V1.5 --wait
 # Select only the parts to execute; --all-ready selects all ready tasks.
 assethub parts split --source-id "$IMAGE_ASSET_ID" --canvas "$CANVAS_ID" --part-extractor V1.5 --all-ready --wait
-# Internal V3.6.1 and V3.6.3 run the complete graph split through one analyze receipt.
+# Internal V3.6.1, V3.6.3 and V3.6.4 run the complete graph split through one analyze receipt.
 assethub production agents
 assethub parts split --source-id "$IMAGE_ASSET_ID" --canvas "$CANVAS_ID" --part-extractor V3.6.1 --all-ready --wait
 assethub production automation --canvas "$CANVAS_ID" --input-json @batch.json --wait
@@ -150,7 +150,8 @@ assethub production automation --canvas "$CANVAS_ID" --input-json @batch.json --
 `parts split` keeps separate analysis and selected-part execution phases. Each phase
 has its own saved operation ID, with the execution linked to the analysis run.
 For Internal `V3.6.1` (`V3.6.1 Primary Images First`) and `V3.6.3`
-(`V3.6.3 Fast Analysis`, CLI 0.1.16+), analysis runs the complete
+(`V3.6.3 Fast Analysis`, CLI 0.1.16+), and `V3.6.4`
+(`V3.6.4 Fast Analysis`, CLI 0.1.17+), analysis runs the complete
 Artifact Graph split. `--all-ready` waits for that one receipt and does not start a
 second production execution. Resume an interrupted graph split with
 `runs resume <operation-id>`; `--task-id`, `--mission-id`,
@@ -421,7 +422,8 @@ Image generation uses the `v2` endpoint with mandatory canvas history.
 
 Part extraction uses the same names shown in the AssetHub product: `V1.5`,
 `V2.0 alpha`, `V2.1 alpha`, and the Internal-only aliases `V3.6.1`
-(`V3.6.1 Primary Images First`) and `V3.6.3` (`V3.6.3 Fast Analysis`).
+(`V3.6.1 Primary Images First`), `V3.6.3` (`V3.6.3 Fast Analysis`),
+and `V3.6.4` (`V3.6.4 Fast Analysis`).
 Run `production agents` to check availability and `supportedOnGraphEndpoint`
 before selecting a graph version. These aliases do not change the default.
 Retired names are no longer accepted by the CLI.
@@ -540,3 +542,30 @@ variables to your MCP client and reconnect. This server uses
 `https://app.assethub.io/api/workspaces/mcp` and exposes `workspace_list`,
 `workspace_members_list`, `workspace_member_invite`, `workspace_member_set_role`,
 and `workspace_member_remove`. Keep the existing API-key MCP server for generation.
+
+## Download a canvas handoff
+
+```sh
+assethub canvas download --canvas 42 --out-dir ./client-handoff
+assethub canvas download --canvas 42 --mesh mesh_123 --out-dir ./mesh-handoff
+```
+
+This staged feature uses the selected workspace API key. A canvas invitation does
+not grant API-key or workspace access. Use an empty output directory. The bundle
+contains image files, final mesh files, `manifest.json`, `index.html`, and
+`history.md`. Open `index.html` locally to review images and recorded steps.
+
+The export follows the actual recorded mesh inputs and image-edit ancestors,
+including intermediate assets removed from the canvas. Current canvas connections
+are not generation evidence. UI `mesh_generation` / `projected_image_gen`, API
+execution receipts, and associated Production / Artifact Graph records are read
+without dispatching new work. Prompts and models appear when recorded. Missing
+or ambiguous history is reported explicitly; this is the available recorded
+history, not a reconstruction of unrecorded editing gestures.
+
+Downloads stream to temporary files and are renamed only after completion. The
+manifest records local paths, byte counts and SHA-256 hashes; signed URL tokens
+and API credentials are not saved. Download failures retain the successful files
+and manifest and exit 1. Truncated exports exit 3. Individual files are limited to
+1 GiB, and bounded server traversal reports any omitted history. History warnings
+can remain even when all available files download successfully.

package/dist/canvasDownload.d.ts

@@ -0,0 +1,28 @@
+import type { CanvasExport } from '@assethub/api-client';
+/** Signed file URLs are used without API credentials and never written into the bundle. */
+export declare const downloadCanvas: (input: {
+    client: {
+        v2: {
+            exportCanvas: (id: number, options?: {
+                mesh?: string;
+            }) => Promise<CanvasExport>;
+        };
+    };
+    canvasId: number;
+    mesh?: string;
+    outDir: string;
+    progress?: (message: string) => void;
+}) => Promise<{
+    outDir: string;
+    manifestPath: string;
+    htmlPath: string;
+    historyPath: string;
+    downloaded: number;
+    failed: number;
+    steps: number;
+    warnings: string[];
+    missingEvidence: string[];
+    truncated: boolean;
+    exitCode: number;
+}>;
+//# sourceMappingURL=canvasDownload.d.ts.map

package/dist/canvasDownload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasDownload.d.ts","sourceRoot":"","sources":["../src/canvasDownload.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,YAAY,EAAoB,MAAM,sBAAsB,CAAA;AAmBzE,2FAA2F;AAC3F,eAAO,MAAM,cAAc,GAAU,OAAO;IAC1C,MAAM,EAAE;QACN,EAAE,EAAE;YACF,YAAY,EAAE,CACZ,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;aAAC,KACtB,OAAO,CAAC,YAAY,CAAC,CAAA;SAC3B,CAAA;KACF,CAAA;IACD,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACrC;;;;;;;;;;;;EA8LA,CAAA"}

package/dist/canvasDownload.js

@@ -0,0 +1,184 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { createWriteStream } from 'node:fs';
+import { mkdir, readdir, rename, unlink, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { Readable, Transform } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+const html = (value) => value.replace(/[&<>"']/g, character => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[character]);
+const markdown = (value) => value.replace(/[\\`*_{}\[\]()#+.!|<>-]/g, '\\$&').replace(/\r?\n/g, ' ');
+/** Signed file URLs are used without API credentials and never written into the bundle. */
+export const downloadCanvas = async (input) => {
+    const outDir = resolve(input.outDir);
+    await mkdir(outDir, { recursive: true, mode: 0o700 });
+    if ((await readdir(outDir)).length)
+        throw new Error('Canvas download requires an empty output directory');
+    const exported = await input.client.v2.exportCanvas(input.canvasId, {
+        mesh: input.mesh,
+    });
+    if (exported.schemaVersion !== 'assethub.canvas-export.v1' ||
+        exported.canvas.id !== input.canvasId)
+        throw new Error('Invalid canvas export response');
+    await mkdir(join(outDir, 'files'), { mode: 0o700 });
+    const files = [];
+    for (const [index, asset] of exported.assets.entries()) {
+        const { url, ...safeAsset } = asset;
+        const file = { ...safeAsset };
+        files.push(file);
+        input.progress?.(`Downloading ${index + 1}/${exported.assets.length}`);
+        const temporary = join(outDir, 'files', `.${randomUUID()}.tmp`);
+        try {
+            if (!url)
+                throw new Error('No downloadable file URL is available');
+            const parsed = new URL(url);
+            if (!['http:', 'https:'].includes(parsed.protocol) ||
+                parsed.username ||
+                parsed.password)
+                throw new Error('Invalid download URL');
+            const response = await fetch(url, {
+                signal: AbortSignal.timeout(120_000),
+                redirect: 'error',
+            });
+            if (!response.ok)
+                throw new Error(`HTTP ${response.status}`);
+            if (!response.body)
+                throw new Error('Empty file response');
+            const contentType = response.headers
+                .get('content-type')
+                ?.split(';')[0]
+                ?.trim();
+            const imageTypes = {
+                'image/png': 'png',
+                'image/jpeg': 'jpg',
+                'image/webp': 'webp',
+                'image/gif': 'gif',
+                'image/avif': 'avif',
+            };
+            let extension;
+            if (asset.mediaType === 'image') {
+                const ext = contentType && imageTypes[contentType];
+                if (!ext)
+                    throw new Error('Expected a raster image file');
+                extension = ext;
+            }
+            else {
+                if (contentType === 'text/html' || contentType === 'image/svg+xml')
+                    throw new Error('Expected a mesh file');
+                extension = ['glb', 'gltf', 'fbx', 'obj', 'stl', 'ply', 'zip'].includes(asset.format ?? '')
+                    ? asset.format
+                    : 'glb';
+            }
+            const stem = asset.name
+                .replace(/[^a-zA-Z0-9_-]+/g, '-')
+                .replace(/^-+|-+$/g, '')
+                .slice(0, 50) || asset.mediaType;
+            const name = `${String(index + 1).padStart(3, '0')}-${stem}-${createHash('sha256').update(asset.id).digest('hex').slice(0, 10)}.${extension}`;
+            const hash = createHash('sha256');
+            let bytes = 0;
+            const meter = new Transform({
+                transform(chunk, _encoding, callback) {
+                    bytes += chunk.length;
+                    if (bytes > 1024 * 1024 * 1024)
+                        return callback(new Error('File exceeds 1 GiB'));
+                    hash.update(chunk);
+                    callback(null, chunk);
+                },
+            });
+            await pipeline(Readable.fromWeb(response.body), meter, createWriteStream(temporary, { flags: 'wx', mode: 0o600 }));
+            if (bytes === 0)
+                throw new Error('Empty file response');
+            await rename(temporary, join(outDir, 'files', name));
+            Object.assign(file, {
+                path: `files/${name}`,
+                bytes,
+                sha256: hash.digest('hex'),
+            });
+        }
+        catch (error) {
+            // Network errors may contain signed URLs. Only our bounded known messages
+            // are retained, never provider error bodies or raw fetch exceptions.
+            const message = error instanceof Error ? error.message : '';
+            file.error =
+                /^(HTTP \d{3}|No downloadable file URL is available|Invalid download URL|Empty file response|Expected a raster image file|Expected a mesh file|File exceeds 1 GiB)$/.test(message)
+                    ? message
+                    : 'File download failed';
+        }
+        finally {
+            await unlink(temporary).catch(error => {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            });
+        }
+    }
+    const byId = new Map(files.map(file => [file.id, file]));
+    const showAsset = (id) => {
+        const file = byId.get(id);
+        return file?.path
+            ? `<a href="${html(file.path)}">${html(file.name)}</a>`
+            : html(file?.name ?? id);
+    };
+    const warnings = [
+        ...exported.warnings,
+        ...(exported.truncated
+            ? ['The export was truncated; some assets or history are missing.']
+            : []),
+    ];
+    const manifest = { ...exported, assets: files, warnings };
+    const sections = exported.steps
+        .map(step => `<section><h2>${html(step.operation)}</h2><p>${html([step.createdAt, step.model, step.source].filter(Boolean).join(' · '))}</p>${step.prompt ? `<pre>${html(step.prompt)}</pre>` : ''}<p>Inputs: ${step.inputs.map(ref => `${showAsset(ref.id)} (${html(ref.role)}; ${html(ref.evidence)})`).join(', ') || 'No recorded inputs'}</p><p>Outputs: ${step.outputs.map(showAsset).join(', ') || 'History step'}</p>${step.warnings.map(warning => `<p>${html(warning)}</p>`).join('')}</section>`)
+        .join('');
+    const document = `<!doctype html><html lang="en"><meta charset="utf-8"><meta name="viewport" content="width=device-width"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src 'self'; style-src 'unsafe-inline'; base-uri 'none'; form-action 'none'"><title>${html(exported.canvas.name)}</title><style>body{font:16px system-ui;max-width:1000px;margin:32px auto;padding:0 20px;color:#202126}a{color:#2455ac}pre{white-space:pre-wrap;overflow-wrap:anywhere}section{border-top:1px solid #ccc;padding:16px 0}.images{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:20px}img{width:100%;height:220px;object-fit:contain}figure{margin:0}figcaption{overflow-wrap:anywhere}</style><h1>${html(exported.canvas.name)}</h1><p>Canvas ${exported.canvas.id}. Actual generation inputs and available recorded history. Canvas connections are not evidence of generation inputs.</p>${warnings.map(warning => `<p>${html(warning)}</p>`).join('')}<h2>Files</h2><div class="images">${files.map(file => `<figure>${file.mediaType === 'image' && file.path ? `<img loading="lazy" src="${html(file.path)}" alt="${html(file.name)}">` : ''}<figcaption>${showAsset(file.id)} · ${html(file.role)}${file.error ? ` · ${html(file.error)}` : ''}</figcaption></figure>`).join('')}</div><h2>History</h2>${sections}</html>`;
+    const mdAsset = (id) => {
+        const file = byId.get(id);
+        return file?.path
+            ? `[${markdown(file.name)}](${file.path})`
+            : markdown(file?.name ?? id);
+    };
+    const history = [
+        `# ${markdown(exported.canvas.name)}`,
+        '',
+        `Canvas ${exported.canvas.id}. Actual generation inputs and available history; canvas connections are not generation evidence.`,
+        '',
+        ...warnings.map(warning => `- ${markdown(warning)}`),
+        '',
+        '## Files',
+        '',
+        ...files.map(file => `- ${mdAsset(file.id)} (${file.role})${file.error ? `: ${markdown(file.error)}` : ''}`),
+        '',
+        ...exported.steps.flatMap(step => [
+            `## ${markdown(step.operation)}`,
+            '',
+            markdown([step.createdAt, step.model, step.source].filter(Boolean).join(' · ')),
+            '',
+            ...(step.prompt ? [`Prompt: ${markdown(step.prompt)}`, ''] : []),
+            `Inputs: ${step.inputs.map(ref => `${mdAsset(ref.id)} (${markdown(ref.role)}; ${markdown(ref.evidence)})`).join(', ') || 'No recorded inputs'}`,
+            '',
+            `Outputs: ${step.outputs.map(mdAsset).join(', ') || 'History step'}`,
+            '',
+            ...step.warnings.map(warning => `- ${markdown(warning)}`),
+            '',
+        ]),
+    ].join('\n');
+    await writeFile(join(outDir, 'manifest.json'), JSON.stringify(manifest, null, 2) + '\n', { mode: 0o600, flag: 'wx' });
+    await writeFile(join(outDir, 'index.html'), document, {
+        mode: 0o600,
+        flag: 'wx',
+    });
+    await writeFile(join(outDir, 'history.md'), history, {
+        mode: 0o600,
+        flag: 'wx',
+    });
+    const failed = files.filter(file => file.error).length;
+    return {
+        outDir,
+        manifestPath: join(outDir, 'manifest.json'),
+        htmlPath: join(outDir, 'index.html'),
+        historyPath: join(outDir, 'history.md'),
+        downloaded: files.length - failed,
+        failed,
+        steps: exported.steps.length,
+        warnings,
+        missingEvidence: exported.steps.flatMap(step => step.warnings),
+        truncated: exported.truncated,
+        exitCode: failed ? 1 : exported.truncated ? 3 : 0,
+    };
+};

package/dist/index.d.ts

@@ -2,7 +2,7 @@
 import { type AnimationRetargetRequest, type Intervention, type RigRequest } from '@assethub/api-client';
 import { buildRunUploadPlan } from './runsUpload/buildRunUpload.js';
 type Flags = Record<string, string | boolean | string[]>;
-export declare const usage = "AssetHub CLI\n\nCLI and MCP are available to all AssetHub users. Workspace permissions and feature availability apply.\n\nUsage:\n  assethub --version\n  assethub doctor [--mcp] [--profile <name>] [--timeout-ms <n>]\n  assethub mcp tools [tool-name] [--account] [--profile <name>] [--timeout-ms <n>]\n  assethub mcp config --client cursor|codex [--account] [--base-url <url>]\n  assethub auth login --api-key <key> [--base-url <url>] [--profile <name>]\n  assethub auth login --api-key-stdin [--base-url <url>] [--profile <name>]\n  assethub auth login --access-token-stdin [--base-url <url>] [--profile <name>]\n  assethub auth status [--profile <name>]\n  assethub auth logout [--profile <name>]\n  assethub workspace list|get\n  assethub workspace create --name <name> [--operation-id <uuid>]\n  assethub workspace use <workspace-id>\n  assethub workspace members [--workspace <id>]\n  assethub workspace invite --email <email> [--role user|admin] [--resend] [--workspace <id>]\n  assethub workspace set-role <user-id> --role user|admin [--workspace <id>]\n  assethub workspace remove-member <user-id> [--workspace <id>]\n  assethub workspace prepare|sync|analyze|verify --internal --manifest <json> --state <json>\n  assethub workspace self-check --internal\n  assethub workspace context put --internal --org <uuid> --actor <uuid> --canvas <id> --file <json> [--if-version <n>] [--order <uuid>]\n  assethub workspace context get --internal --org <uuid> --actor <uuid> --canvas <id> [--out <json>] [--order <uuid>]\n  assethub project ingest <source-dir> --out-dir <directory> [--exclude-dir <relative-path>...]\n  assethub language text|vision --input-json @<json> --operation-id <uuid> [--out <json>]\n  assethub canvas import --canvas <id> --file <image> [--name <name>]\n  assethub canvas context get --canvas <id> [--out <json>]\n  assethub canvas context put --canvas <id> --file <json> [--if-version <n>]\n  assethub canvas layout --canvas <id> --input-json @<json>\n  assethub canvas compare --canvas <id> --source-id <asset-id> --asset-id <asset-id> --out <html>\n  assethub moodboard create --input-json @<json> [--operation-id <uuid>]\n  assethub moodboard list|get|update|archive [<board-id>] [--input-json @<json>]\n  assethub moodboard analyze <board-id> [--revision <uuid>] [--wait]\n  assethub image generate --canvas <id> --context <id> [--context-version <n>] [--context-source <key>] [--moodboard-revision <uuid>] --prompt <text> --wait\n  assethub models list [--domain <domain>] [--ids-only] [--limit <n>]\n  assethub models get <model-id>\n  assethub files import <url> --media-type image|mesh\n  assethub files upload <file> --media-type image|mesh\n  assethub source create (--file <path> | --source-url <url> | --source-id <id> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri> | --clipboard) --media-type image|mesh [--file-name <name>] [--content-type <type>]\n  assethub capabilities\n  assethub composer models\n  assethub composer refine --list-modes\n  assethub composer refine --from-run <run-id> --instruction <text> [--mode standard|thorough|placement|workshop|blender] [--max-rounds <n>] [--transforms-json <json|@file>] [--wait] [--download --out-dir <dir>]\n  assethub composer refine --input-json <json|@file> [--canvas <id>] [--operation-id <uuid>] [--wait] [--download --out-dir <dir>]\n  assethub composer run --part <mesh-asset-id> [--part <mesh-asset-id>...] --reference <image-asset-id> [--model <id>] [--mode quick|quality] [--transforms-json <json|@file>] [--canvas <id>] [--wait]\n  assethub composer run --input-json <json|@file> [--canvas <id>] [--operation-id <uuid>] [--wait] [--download --out-dir <dir>]\n  assethub composer run --from-run <run-id> [--transforms-json <json|@file>] [--mode quick|quality] [--wait]\n  assethub canvas create [--name <name>] [--operation-id <uuid>]\n  assethub canvas list [--cursor <cursor>] [--limit <n>]\n  assethub canvas get|use|open [<id>]\n  assethub runs list [--canvas <id>] [--cursor <cursor>] [--limit <n>]\n  assethub runs get|watch <run-id> [--timeout-ms <n>]\n  assethub runs resume <operation-id> [--wait]\n  assethub graph list [--cursor <cursor>] [--limit <n>]\n  assethub graph show|export [--canvas <id> | --graph <id>] [--source generated|upload] [--artifact <node-id>] [--out <path>] [--allow-truncated]\n  assethub graph lineage --artifact <node-id> [--canvas <id> | --graph <id>] [--source generated|upload] [--direction ancestors|descendants|both] [--depth <n>] [--out <path>]\n  assethub evaluate list\n  assethub evaluations submit --artifact <asset-id> --report <json|file|@file|@-> [--agent <name>] [--canvas <id>] [--reference <asset-id>...] [--run <run-id>] [--operation-id <uuid>] [--require-pass]\n  assethub evaluations list [--canvas <id>] [--artifact <asset-id>]\n  assethub evaluations get <evaluation-id>\n  assethub image generate --input-json <json|@file|@-> [--canvas <id>] [--operation-id <uuid>] [--agent <name>] [--derived-from-run <run-id>] [--from-node <graphId/nodeId> --graph-revision <rev>] [--wait]\n  assethub mesh generate --input-json <json|@file|@-> [--canvas <id>] [--operation-id <uuid>] [--agent <name>] [--derived-from-run <run-id>] [--from-node <graphId/nodeId> --graph-revision <rev>] [--wait]\n  assethub mesh list [--query <text>] [--cursor <cursor>] [--limit <n>]\n  assethub mesh get <mesh-asset-id>\n  assethub mesh download <mesh-asset-id> --out-dir <directory>\n  assethub image generate --prompt <text> [--file <path> | --source-url <url> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri> | --clipboard] [--file-name <name>] [--content-type <type>] [--model-id <id>] [--batch-size <n>] [--wait] [--download --out-dir <dir>] [--canvas <id>] [--operation-id <uuid>] [--api-version v2]\n  assethub image generate --prompt <text> --source-resource-id <id> --api-version v2 [--model-id <id>] [--batch-size <n>] [--wait]\n  assethub mesh generate (--file <path> | --source-url <url> | --source-resource-id <id> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri>) [--file-name <name>] [--content-type <type>] [--model-id <id>] [--name <name>] [--wait] [--download --out-dir <dir>]\n  assethub mesh retopo (--source-resource-id <id> | --source-url <url> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri>) --model-id <id> [--file-name <name>] [--content-type <type>] [--wait] [--download --out-dir <dir>]\n  assethub rig check (--file <path> | --source-url <url> | --source-resource-id <id> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri>) [--name <name>] [--wait] [--download --out-dir <dir>]\n  assethub rig create (--file <path> | --source-url <url> | --source-resource-id <id> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri>) [--model v1.0-20240301|v2.5-20260210] [--rig-type biped|quadruped|hexapod|octopod|avian|serpentine|aquatic] [--spec tripo|mixamo] [--out-format glb|fbx] [--name <name>] [--wait] [--download --out-dir <dir>]\n  assethub animate presets [--model v1.0-20240301|v2.5-20260210] [--rig-type <type>]\n  assethub animate retarget --resource-id <id> --animation <preset-id> [--animation <preset-id>... up to 5 total] [--out-format glb|fbx] [--bake-animation true|false] [--export-with-geometry true|false] [--animate-in-place true|false] [--name <name>] [--wait] [--download --out-dir <dir>]\n  assethub jobs get <job-id> [--download --out-dir <dir>]\n  assethub jobs watch <job-id> [--interval-ms <ms>] [--timeout-ms <ms>] [--download --out-dir <dir>]\n  assethub production analyze (--file <path> | --source-url <url> | --source-id <id> | --image-url <url> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri> | --clipboard) [--file-name <name>] [--content-type <type>] [--part-extractor <name>] [--name <name>] [--wait] [--download --out-dir <dir>]\n  assethub production agents\n  assethub production automation --input-json <json|@file|@-> [--canvas <id>] [--operation-id <uuid>] [--wait]\n  assethub production status <order-id> [--wait] [--download --out-dir <dir>]\n  assethub production execute --order-id <id> --mission-id <id> --task-id <id> [--task-id <id>...] [--part-extractor <name>] [--part-extraction-mode fast|high_quality] [--wait] [--download --out-dir <dir>]\n  assethub production run --order-id <id> --mission-id <id> [--run-mode full_auto|approval] [--task-id <id>...] [--part-extractor <name>] [--part-extraction-mode fast|high_quality] [--allowed-model-id <id>...] [--max-iterations <n>] [--max-cost-credits <n>] [--wait] [--download --out-dir <dir>]\n  assethub production watch <order-id> [--interval-ms <ms>] [--timeout-ms <ms>] [--download --out-dir <dir>]\n  assethub production intervene <order-id> (--exclude <target-id> | --include <target-id> | --add-part <name> | --rename <target-id>=<name> | --reject <target-id>[=<reason>] | --regenerate <target-id>=<mode> | --set-param <key>=<value> | --ops-json <json|@file|@->)... [--idempotency-key <key>]\n  assethub production interventions <order-id>\n  assethub runs upload <path> [--graph-id <id>] [--stream-id <id>] [--rev <n>] [--description <text>] [--tag <tag>...] [--skip-register] [--dry-run]\n  assethub parts split (--file <path> | --source-url <url> | --source-id <id> | --image-url <url> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri> | --clipboard | --order-id <id>) [--file-name <name>] [--content-type <type>] [--part-extractor <name>] [--wait] [--task-id <id>...] [--mission-id <id>] [--all-ready] [--download --out-dir <dir>]\n  assethub parts compare (--file <path> | --source-url <url> | --source-id <id> | --image-url <url> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri> | --clipboard) [--file-name <name>] [--content-type <type>] [--preprocess-prompt <text>] [--preprocess-model-id <id>] [--fail-on-preprocess-error] [--part-extractor <name>] [--wait] [--task-id <id>...] [--mission-id <id>] [--all-ready] [--download --out-dir <dir>]\n  assethub autopilot [<image>] --demo [--yolo] [--json] [--max-regen <n>] [--stall-rounds <n>] [--tie-epsilon <x>] [--multiview 2-view|4-view|6-view] [--ab-mode serial|cross] [--credit-budget <n>]\n\nGlobal options:\n  --api-key <key>       Overrides saved auth and ASSETHUB_API_KEY.\n  --base-url <url>      Override the selected API origin. Default: https://app.assethub.io.\n  --profile <name>      Select this saved profile ahead of environment credentials and origin.\n  --config <path>       Auth config path. Defaults to ~/.assethub/config.json.\n  --version             Show installed package version.\n  --help                Show help.\n\nExamples:\n  ASSETHUB_API_KEY=ah_live_xxx assethub models list\n  assethub auth login --api-key-stdin\n  assethub models list --ids-only\n  assethub files upload ./input.png --media-type image\n  assethub source create --file ./input.png --media-type image\n  pbpaste | assethub source create --stdin-data-uri --media-type image\n  assethub source create --clipboard --media-type image --file-name clipboard.png\n  printf '{\"image_url\":{\"url\":\"data:image/png;base64,...\"}}' | assethub parts split --stdin-json --part-extractor \"V1.5\" --wait\n  base64 -i ./input.png | assethub parts split --stdin-base64 --file-name input.png --content-type image/png --part-extractor \"V1.5\" --wait\n  cat ./input.png | assethub parts split --stdin --file-name input.png --part-extractor \"V1.5\" --wait\n  assethub image generate --prompt \"stylized prop concept\" --wait\n  assethub mesh generate --file ./input.png --wait\n  assethub animate presets --rig-type biped\n  assethub rig create --source-resource-id mesh_x --rig-type biped --wait\n  assethub animate retarget --resource-id rig_x --animation preset:idle --wait\n  assethub production analyze --file ./input.png --part-extractor \"V1.5\" --wait\n  assethub production run --order-id ord_x --mission-id ms_x --run-mode full_auto --max-cost-credits 200 --wait\n  assethub production watch ord_x\n  assethub production intervene ord_x --exclude 7 --rename 3=\"left wing\" --idempotency-key review-2026-07-29\n  assethub production interventions ord_x\n  assethub runs upload ./out/pluffy-run-2026-07-30 --dry-run\n  assethub runs upload ./out/pluffy-run-2026-07-30 --tag pluffy --description \"V3 humanoid, 18 parts\"\n  assethub parts split --file ./input.png --part-extractor \"V1.5\" --wait --all-ready\n  assethub parts compare --file ./input.png --preprocess-prompt \"clean white background, centered product photo\" --part-extractor \"V1.5\" --wait --all-ready\n";
+export declare const usage = "AssetHub CLI\n\nCLI and MCP are available to all AssetHub users. Workspace permissions and feature availability apply.\n\nUsage:\n  assethub --version\n  assethub doctor [--mcp] [--profile <name>] [--timeout-ms <n>]\n  assethub mcp tools [tool-name] [--account] [--profile <name>] [--timeout-ms <n>]\n  assethub mcp config --client cursor|codex [--account] [--base-url <url>]\n  assethub auth login --api-key <key> [--base-url <url>] [--profile <name>]\n  assethub auth login --api-key-stdin [--base-url <url>] [--profile <name>]\n  assethub auth login --access-token-stdin [--base-url <url>] [--profile <name>]\n  assethub auth status [--profile <name>]\n  assethub auth logout [--profile <name>]\n  assethub workspace list|get\n  assethub workspace create --name <name> [--operation-id <uuid>]\n  assethub workspace use <workspace-id>\n  assethub workspace members [--workspace <id>]\n  assethub workspace invite --email <email> [--role user|admin] [--resend] [--workspace <id>]\n  assethub workspace set-role <user-id> --role user|admin [--workspace <id>]\n  assethub workspace remove-member <user-id> [--workspace <id>]\n  assethub workspace prepare|sync|analyze|verify --internal --manifest <json> --state <json>\n  assethub workspace self-check --internal\n  assethub workspace context put --internal --org <uuid> --actor <uuid> --canvas <id> --file <json> [--if-version <n>] [--order <uuid>]\n  assethub workspace context get --internal --org <uuid> --actor <uuid> --canvas <id> [--out <json>] [--order <uuid>]\n  assethub project ingest <source-dir> --out-dir <directory> [--exclude-dir <relative-path>...]\n  assethub language text|vision --input-json @<json> --operation-id <uuid> [--out <json>]\n  assethub canvas download --canvas <id> --out-dir <directory> [--mesh <mesh_asset_id>]\n  assethub canvas import --canvas <id> --file <image> [--name <name>]\n  assethub canvas context get --canvas <id> [--out <json>]\n  assethub canvas context put --canvas <id> --file <json> [--if-version <n>]\n  assethub canvas layout --canvas <id> --input-json @<json>\n  assethub canvas compare --canvas <id> --source-id <asset-id> --asset-id <asset-id> --out <html>\n  assethub moodboard create --input-json @<json> [--operation-id <uuid>]\n  assethub moodboard list|get|update|archive [<board-id>] [--input-json @<json>]\n  assethub moodboard analyze <board-id> [--revision <uuid>] [--wait]\n  assethub image generate --canvas <id> --context <id> [--context-version <n>] [--context-source <key>] [--moodboard-revision <uuid>] --prompt <text> --wait\n  assethub models list [--domain <domain>] [--ids-only] [--limit <n>]\n  assethub models get <model-id>\n  assethub files import <url> --media-type image|mesh\n  assethub files upload <file> --media-type image|mesh\n  assethub source create (--file <path> | --source-url <url> | --source-id <id> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri> | --clipboard) --media-type image|mesh [--file-name <name>] [--content-type <type>]\n  assethub capabilities\n  assethub composer models\n  assethub composer refine --list-modes\n  assethub composer refine --from-run <run-id> --instruction <text> [--mode standard|thorough|placement|workshop|blender] [--max-rounds <n>] [--transforms-json <json|@file>] [--wait] [--download --out-dir <dir>]\n  assethub composer refine --input-json <json|@file> [--canvas <id>] [--operation-id <uuid>] [--wait] [--download --out-dir <dir>]\n  assethub composer run --part <mesh-asset-id> [--part <mesh-asset-id>...] --reference <image-asset-id> [--model <id>] [--mode quick|quality] [--transforms-json <json|@file>] [--canvas <id>] [--wait]\n  assethub composer run --input-json <json|@file> [--canvas <id>] [--operation-id <uuid>] [--wait] [--download --out-dir <dir>]\n  assethub composer run --from-run <run-id> [--transforms-json <json|@file>] [--mode quick|quality] [--wait]\n  assethub canvas create [--name <name>] [--operation-id <uuid>]\n  assethub canvas list [--cursor <cursor>] [--limit <n>]\n  assethub canvas get|use|open [<id>]\n  assethub runs list [--canvas <id>] [--cursor <cursor>] [--limit <n>]\n  assethub runs get|watch <run-id> [--timeout-ms <n>]\n  assethub runs resume <operation-id> [--wait]\n  assethub graph list [--cursor <cursor>] [--limit <n>]\n  assethub graph show|export [--canvas <id> | --graph <id>] [--source generated|upload] [--artifact <node-id>] [--out <path>] [--allow-truncated]\n  assethub graph lineage --artifact <node-id> [--canvas <id> | --graph <id>] [--source generated|upload] [--direction ancestors|descendants|both] [--depth <n>] [--out <path>]\n  assethub evaluate list\n  assethub evaluations submit --artifact <asset-id> --report <json|file|@file|@-> [--agent <name>] [--canvas <id>] [--reference <asset-id>...] [--run <run-id>] [--operation-id <uuid>] [--require-pass]\n  assethub evaluations list [--canvas <id>] [--artifact <asset-id>]\n  assethub evaluations get <evaluation-id>\n  assethub image generate --input-json <json|@file|@-> [--canvas <id>] [--operation-id <uuid>] [--agent <name>] [--derived-from-run <run-id>] [--from-node <graphId/nodeId> --graph-revision <rev>] [--wait]\n  assethub mesh generate --input-json <json|@file|@-> [--canvas <id>] [--operation-id <uuid>] [--agent <name>] [--derived-from-run <run-id>] [--from-node <graphId/nodeId> --graph-revision <rev>] [--wait]\n  assethub mesh list [--query <text>] [--cursor <cursor>] [--limit <n>]\n  assethub mesh get <mesh-asset-id>\n  assethub mesh download <mesh-asset-id> --out-dir <directory>\n  assethub image generate --prompt <text> [--file <path> | --source-url <url> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri> | --clipboard] [--file-name <name>] [--content-type <type>] [--model-id <id>] [--batch-size <n>] [--wait] [--download --out-dir <dir>] [--canvas <id>] [--operation-id <uuid>] [--api-version v2]\n  assethub image generate --prompt <text> --source-resource-id <id> --api-version v2 [--model-id <id>] [--batch-size <n>] [--wait]\n  assethub mesh generate (--file <path> | --source-url <url> | --source-resource-id <id> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri>) [--file-name <name>] [--content-type <type>] [--model-id <id>] [--name <name>] [--wait] [--download --out-dir <dir>]\n  assethub mesh retopo (--source-resource-id <id> | --source-url <url> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri>) --model-id <id> [--file-name <name>] [--content-type <type>] [--wait] [--download --out-dir <dir>]\n  assethub rig check (--file <path> | --source-url <url> | --source-resource-id <id> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri>) [--name <name>] [--wait] [--download --out-dir <dir>]\n  assethub rig create (--file <path> | --source-url <url> | --source-resource-id <id> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri>) [--model v1.0-20240301|v2.5-20260210] [--rig-type biped|quadruped|hexapod|octopod|avian|serpentine|aquatic] [--spec tripo|mixamo] [--out-format glb|fbx] [--name <name>] [--wait] [--download --out-dir <dir>]\n  assethub animate presets [--model v1.0-20240301|v2.5-20260210] [--rig-type <type>]\n  assethub animate retarget --resource-id <id> --animation <preset-id> [--animation <preset-id>... up to 5 total] [--out-format glb|fbx] [--bake-animation true|false] [--export-with-geometry true|false] [--animate-in-place true|false] [--name <name>] [--wait] [--download --out-dir <dir>]\n  assethub jobs get <job-id> [--download --out-dir <dir>]\n  assethub jobs watch <job-id> [--interval-ms <ms>] [--timeout-ms <ms>] [--download --out-dir <dir>]\n  assethub production analyze (--file <path> | --source-url <url> | --source-id <id> | --image-url <url> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri> | --clipboard) [--file-name <name>] [--content-type <type>] [--part-extractor <name>] [--name <name>] [--wait] [--download --out-dir <dir>]\n  assethub production agents\n  assethub production automation --input-json <json|@file|@-> [--canvas <id>] [--operation-id <uuid>] [--wait]\n  assethub production status <order-id> [--wait] [--download --out-dir <dir>]\n  assethub production execute --order-id <id> --mission-id <id> --task-id <id> [--task-id <id>...] [--part-extractor <name>] [--part-extraction-mode fast|high_quality] [--wait] [--download --out-dir <dir>]\n  assethub production run --order-id <id> --mission-id <id> [--run-mode full_auto|approval] [--task-id <id>...] [--part-extractor <name>] [--part-extraction-mode fast|high_quality] [--allowed-model-id <id>...] [--max-iterations <n>] [--max-cost-credits <n>] [--wait] [--download --out-dir <dir>]\n  assethub production watch <order-id> [--interval-ms <ms>] [--timeout-ms <ms>] [--download --out-dir <dir>]\n  assethub production intervene <order-id> (--exclude <target-id> | --include <target-id> | --add-part <name> | --rename <target-id>=<name> | --reject <target-id>[=<reason>] | --regenerate <target-id>=<mode> | --set-param <key>=<value> | --ops-json <json|@file|@->)... [--idempotency-key <key>]\n  assethub production interventions <order-id>\n  assethub runs upload <path> [--graph-id <id>] [--stream-id <id>] [--rev <n>] [--description <text>] [--tag <tag>...] [--skip-register] [--dry-run]\n  assethub parts split (--file <path> | --source-url <url> | --source-id <id> | --image-url <url> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri> | --clipboard | --order-id <id>) [--file-name <name>] [--content-type <type>] [--part-extractor <name>] [--wait] [--task-id <id>...] [--mission-id <id>] [--all-ready] [--download --out-dir <dir>]\n  assethub parts compare (--file <path> | --source-url <url> | --source-id <id> | --image-url <url> | --file-ref-json <json> | --stdin | --stdin-base64 | --stdin-data-uri | --stdin-json | --source-json <json|@file|@-> | --data-uri <uri> | --clipboard) [--file-name <name>] [--content-type <type>] [--preprocess-prompt <text>] [--preprocess-model-id <id>] [--fail-on-preprocess-error] [--part-extractor <name>] [--wait] [--task-id <id>...] [--mission-id <id>] [--all-ready] [--download --out-dir <dir>]\n  assethub autopilot [<image>] --demo [--yolo] [--json] [--max-regen <n>] [--stall-rounds <n>] [--tie-epsilon <x>] [--multiview 2-view|4-view|6-view] [--ab-mode serial|cross] [--credit-budget <n>]\n\nGlobal options:\n  --api-key <key>       Overrides saved auth and ASSETHUB_API_KEY.\n  --base-url <url>      Override the selected API origin. Default: https://app.assethub.io.\n  --profile <name>      Select this saved profile ahead of environment credentials and origin.\n  --config <path>       Auth config path. Defaults to ~/.assethub/config.json.\n  --version             Show installed package version.\n  --help                Show help.\n\nExamples:\n  ASSETHUB_API_KEY=ah_live_xxx assethub models list\n  assethub auth login --api-key-stdin\n  assethub models list --ids-only\n  assethub files upload ./input.png --media-type image\n  assethub source create --file ./input.png --media-type image\n  pbpaste | assethub source create --stdin-data-uri --media-type image\n  assethub source create --clipboard --media-type image --file-name clipboard.png\n  printf '{\"image_url\":{\"url\":\"data:image/png;base64,...\"}}' | assethub parts split --stdin-json --part-extractor \"V1.5\" --wait\n  base64 -i ./input.png | assethub parts split --stdin-base64 --file-name input.png --content-type image/png --part-extractor \"V1.5\" --wait\n  cat ./input.png | assethub parts split --stdin --file-name input.png --part-extractor \"V1.5\" --wait\n  assethub image generate --prompt \"stylized prop concept\" --wait\n  assethub mesh generate --file ./input.png --wait\n  assethub animate presets --rig-type biped\n  assethub rig create --source-resource-id mesh_x --rig-type biped --wait\n  assethub animate retarget --resource-id rig_x --animation preset:idle --wait\n  assethub production analyze --file ./input.png --part-extractor \"V1.5\" --wait\n  assethub production run --order-id ord_x --mission-id ms_x --run-mode full_auto --max-cost-credits 200 --wait\n  assethub production watch ord_x\n  assethub production intervene ord_x --exclude 7 --rename 3=\"left wing\" --idempotency-key review-2026-07-29\n  assethub production interventions ord_x\n  assethub runs upload ./out/pluffy-run-2026-07-30 --dry-run\n  assethub runs upload ./out/pluffy-run-2026-07-30 --tag pluffy --description \"V3 humanoid, 18 parts\"\n  assethub parts split --file ./input.png --part-extractor \"V1.5\" --wait --all-ready\n  assethub parts compare --file ./input.png --preprocess-prompt \"clean white background, centered product photo\" --part-extractor \"V1.5\" --wait --all-ready\n";
 /**
  * The `animate retarget` request, built from flags alone.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAsBA,OAAO,EAIL,KAAK,wBAAwB,EAO7B,KAAK,YAAY,EAEjB,KAAK,UAAU,EAgBhB,MAAM,sBAAsB,CAAA;AAa7B,OAAO,EAAC,kBAAkB,EAAc,MAAM,gCAAgC,CAAA;AAI9E,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAA;AAoIxD,eAAO,MAAM,KAAK,4zZA4HjB,CAAA;AAq1ED;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GACxC,OAAO,KAAK,KACX,wBA0BF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,KAAK,KACX,IAAI,CAAC,UAAU,EAAE,QAAQ,CAM1B,CAAA;AA6fF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,SAAS,MAAM,EAAE,KACtB,YAAY,EAuGd,CAAA;AAmqCD,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,OAAO,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,MAAM,GAAG,SAAS,EAC9B,aAAa,MAAM,EAAE,EACrB,OAAO,KAAK,KACX,cAoBF,CAAA;AAED,KAAK,iBAAiB,GAAG,IAAI,CAC3B,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,EAC5C,SAAS,GACT,UAAU,GACV,KAAK,GACL,WAAW,GACX,QAAQ,GACR,OAAO,GACP,OAAO,GACP,UAAU,CACb,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,EACjB,MAAM,iBAAiB;;;;;;;;;;;;;;CAUvB,CAAA;AAEF,eAAO,MAAM,sBAAsB,GACjC,SAAS,UAAU,CAAC,OAAO,iBAAiB,CAAC,EAC7C,MAAM,iBAAiB,EACvB,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;CAYf,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAuBA,OAAO,EAIL,KAAK,wBAAwB,EAO7B,KAAK,YAAY,EAEjB,KAAK,UAAU,EAgBhB,MAAM,sBAAsB,CAAA;AAa7B,OAAO,EAAC,kBAAkB,EAAc,MAAM,gCAAgC,CAAA;AAI9E,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAA;AA4IxD,eAAO,MAAM,KAAK,q5ZA6HjB,CAAA;AAq1ED;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,GACxC,OAAO,KAAK,KACX,wBA0BF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,KAAK,KACX,IAAI,CAAC,UAAU,EAAE,QAAQ,CAM1B,CAAA;AA6fF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,SAAS,MAAM,EAAE,KACtB,YAAY,EAuGd,CAAA;AAyrCD,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,OAAO,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,MAAM,GAAG,SAAS,EAC9B,aAAa,MAAM,EAAE,EACrB,OAAO,KAAK,KACX,cAoBF,CAAA;AAED,KAAK,iBAAiB,GAAG,IAAI,CAC3B,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,EAC5C,SAAS,GACT,UAAU,GACV,KAAK,GACL,WAAW,GACX,QAAQ,GACR,OAAO,GACP,OAAO,GACP,UAAU,CACb,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,EACjB,MAAM,iBAAiB;;;;;;;;;;;;;;CAUvB,CAAA;AAEF,eAAO,MAAM,sBAAsB,GACjC,SAAS,UAAU,CAAC,OAAO,iBAAiB,CAAC,EAC7C,MAAM,iBAAiB,EACvB,SAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;CAYf,CAAA"}

package/dist/index.js

@@ -2,6 +2,7 @@
 import { setTimeout as delay } from 'node:timers/promises';
 import { cliVersion, diagnose, mcpConfig } from './setup.js';
 import { ingestProjectSources } from './projectSources.js';
+import { downloadCanvas } from './canvasDownload.js';
 import { writeCanvasComparison } from './canvasComparison.js';
 import { importCanvasAssetWithState } from './canvasAssetImport.js';
 import { execFile, spawn } from 'node:child_process';
@@ -28,7 +29,11 @@ const defaultImageModelId = 'imageGen.nanoBanana2.openrouter';
 const defaultMeshModelId = 'meshGen.hunyuan31';
 const defaultProfileName = 'default';
 const defaultPartExtractorName = 'V1.5';
-const isArtifactGraphPartExtractor = (value) => value === 'ah_agent_graph_v3_6_1' || value === 'ah_agent_graph_v3_6_3';
+const artifactGraphPartExtractorApiValues = new Set([
+    'ah_agent_graph_v3_6_1',
+    'ah_agent_graph_v3_6_3',
+    'ah_agent_graph_v3_6_4',
+]);
 const partExtractorOptions = [
     {
         publicName: 'V1.5',
@@ -51,9 +56,14 @@ const partExtractorOptions = [
         aliases: ['v3.6.1', '3.6.1', 'v3.6.1 primary images first'],
     },
     {
-        publicName: 'V3.6.3',
+        publicName: 'V3.6.3 Fast Analysis',
         apiValue: 'ah_agent_graph_v3_6_3',
-        aliases: ['v3.6.3', '3.6.3', 'v3.6.3 fast analysis'],
+        aliases: ['v3.6.3', '3.6.3'],
+    },
+    {
+        publicName: 'V3.6.4 Fast Analysis',
+        apiValue: 'ah_agent_graph_v3_6_4',
+        aliases: ['v3.6.4', '3.6.4'],
     },
 ];
 const partExtractorPublicNames = partExtractorOptions
@@ -94,6 +104,7 @@ Usage:
   assethub workspace context get --internal --org <uuid> --actor <uuid> --canvas <id> [--out <json>] [--order <uuid>]
   assethub project ingest <source-dir> --out-dir <directory> [--exclude-dir <relative-path>...]
   assethub language text|vision --input-json @<json> --operation-id <uuid> [--out <json>]
+  assethub canvas download --canvas <id> --out-dir <directory> [--mesh <mesh_asset_id>]
   assethub canvas import --canvas <id> --file <image> [--name <name>]
   assethub canvas context get --canvas <id> [--out <json>]
   assethub canvas context put --canvas <id> --file <json> [--if-version <n>]
@@ -2751,7 +2762,7 @@ const isArtifactGraphPartSplit = (value, execution) => (value != null &&
     typeof value === 'object' &&
     'engine' in value &&
     value.engine === 'artifact-graph') ||
-    isArtifactGraphPartExtractor(execution.resolvedInput?.agentVersion);
+    artifactGraphPartExtractorApiValues.has(String(execution.resolvedInput?.agentVersion));
 const commandParts = async (subcommand, ctx) => {
     const runPartSplit = async (source, operationId = getFlag(ctx.flags, 'operation-id') ?? randomUUID()) => {
         let orderId = source == null ? getFlag(ctx.flags, 'order-id') : undefined;
@@ -2762,14 +2773,15 @@ const commandParts = async (subcommand, ctx) => {
         const requestedAgentVersion = orderId == null || partExtractorFlag != null
             ? resolvePartExtractorApiValue(partExtractorFlag ?? defaultPartExtractorName)
             : undefined;
-        if (isArtifactGraphPartExtractor(requestedAgentVersion)) {
-            const name = partExtractorPublicNameByApiValue.get(requestedAgentVersion);
+        if (requestedAgentVersion != null &&
+            artifactGraphPartExtractorApiValues.has(requestedAgentVersion)) {
+            const publicName = publicPartExtractorName(requestedAgentVersion);
             for (const flag of ['task-id', 'mission-id', 'part-extraction-mode']) {
                 if (hasFlag(ctx.flags, flag))
-                    throw new Error(`--${flag} is not supported with ${name}`);
+                    throw new Error(`--${flag} is not supported with ${publicName}`);
             }
             if (orderId != null)
-                throw new Error(`--order-id is not supported with ${name}; use runs resume <operation-id> to resume a graph split`);
+                throw new Error(`--order-id is not supported with ${publicName}; use runs resume <operation-id> to resume a graph split`);
         }
         const session = await productionSession(ctx, orderId == null ? 'production.analyze' : 'production.execute');
         let execution;
@@ -3013,6 +3025,23 @@ const canvasForRead = (ctx) => openExecutionSession({
     create: false,
 });
 const commandCanvas = async (subcommand, positionals, ctx) => {
+    if (subcommand === 'download') {
+        const outDir = requireFlag(ctx.flags, 'out-dir');
+        const { canvas } = await canvasForRead(ctx);
+        const mesh = getFlag(ctx.flags, 'mesh');
+        if (mesh && !/^mesh_[1-9]\d*$/.test(mesh))
+            throw new Error('--mesh must be a mesh_<id> asset ID');
+        const result = await downloadCanvas({
+            client: ctx.client,
+            canvasId: canvas.id,
+            mesh,
+            outDir,
+            progress: message => process.stderr.write(`${message}\n`),
+        });
+        print(result);
+        process.exitCode = result.exitCode;
+        return;
+    }
     if (subcommand === 'context' ||
         subcommand === 'import' ||
         subcommand === 'compare' ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assethub/cli",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Command line interface for AssetHub.",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@assethub/api-client": "^0.1.8",
+    "@assethub/api-client": "^0.1.9",
     "@modelcontextprotocol/sdk": "^1.30.0"
   },
   "repository": {