@assethub/cli 0.1.27 → 0.1.29

package/README.md

@@ -276,6 +276,78 @@ or an `imageUrl` to import), `config`, and optional `maxCostCredits`.
 An uncertain Trigger acknowledgement remains recoverable as `needs_review` with
 pending history; retrying the same operation never silently launches another run.
 
+### One-shot: image to finished asset
+
+`production run --image <file|asset-id>` is the fastest path from a single image to
+a finished, composed asset. It is a thin wrapper around `production automation`
+(split, mesh generation per part, and — by default — server-side compose, all in
+one call) plus waiting, cost estimation and downloads. It never re-runs the manual
+split/mesh/compose sequence itself.
+
+```sh
+# Estimate cost first; nothing is submitted, nothing is billed.
+assethub production run --image ./character.png --estimate
+
+# Run it, wait for every part and the compose stage, download the result.
+assethub production run --image ./character.png --wait --download --out-dir ./out/asset
+
+# An existing asset id works the same way as a local file.
+assethub production run --image "$IMAGE_ASSET_ID" --canvas "$CANVAS_ID" --wait
+```
+
+`--image` auto-detects its argument: an existing local path is uploaded like
+`--file`; anything else is treated like `--source-id`. Do not combine `--image`
+with `--file`/`--source-id`/other source flags — it already resolves one.
+
+`--compose` controls the compose stage:
+
+- Omitted: automation's own server-side default applies, untouched.
+- `--compose none`: disables automation's compose stage (`config.autoCompose:
+  false`); the run stops once every part's mesh is generated.
+- `--compose v6`: requests an explicit Composer V6 pass via
+  top-level `partComposerAgentVersion: "part_composer_v6_auto_assemble"`
+  (`config.autoCompose` is left at its default of `true`). A server that has shipped this (assethub-web PR
+  #8179) does the V6 compose itself, in the same automation call, pairing
+  each part's mesh with its source image automatically. Against an older,
+  currently-deployed server (detected by the automation response lacking
+  `estimatedCostBreakdown`), the CLI instead reads the batch's own
+  `mesh.generate` executions itself, pairs each produced mesh with the part
+  image it was generated from, and runs an explicit `composer run` — same
+  end result, either way you never pair mesh and image assets by hand.
+
+`--mesh-model <id>` and `--max-parts <n>` (default 24, matching the server's
+own conservative constant for this math) only affect `--estimate`'s math (mesh
+unit cost x an assumed worst-case part count — the CLI cannot know the real
+part count before splitting runs); they do not cap or select anything on the
+real run. `--max-cost <credits>` refuses to run at all, before anything is
+submitted, once the best-effort estimate exceeds it, and is also sent to the
+server as `maxCostCredits` on the real run as a backstop. `--estimate`'s numbers
+come only from side-effect-free catalog reads (mesh model credit cost, compose
+quotes) shaped like the server's own `split`/`meshGeneration`/`compose`
+breakdown; part-extraction/split has no dry-run price today, so that line is
+reported as unknown rather than guessed. On a real (non-`--estimate`) run
+against a server that has shipped #8179, the printed output additionally
+includes the server's own `estimatedTotalCredits`/`estimatedCostBreakdown`
+in place of the CLI's own preflight guess.
+
+This depends on assethub-web PR #8179 for the `partComposerAgentVersion` field
+and the richer cost breakdown; it is not merged/deployed as of this writing.
+The CLI degrades gracefully against the currently-deployed API (see above).
+
+`runs get <run-id> --summary` prints a handful of plain-text lines (status, stage,
+credits, output asset, error) instead of the full JSON execution. `runs wait
+<run-id>` is `runs watch` under a name that matches a long-running wait; both
+accept `--interval-ms`/`--timeout-ms` and retry rate limits the same way every
+other poll loop in the CLI does.
+
+The one-shot command's stdout is always a single JSON object (`batchId`,
+`estimate`, `batchStatus`, `compose`, `execution`, and `downloads` when
+requested) — the same convention every other command in this CLI already
+follows. `--json` is accepted for compatibility with that convention but has
+no effect, since there is no alternate plain-text mode to opt out of (`runs
+get --summary` is the one deliberate exception, and it is opt-in by its own
+flag).
+
 `evaluate list` discovers server evaluators. Server evaluation dispatch is currently
 unavailable. Graph exports are bounded to 100 runs/evaluations and 1,000 nodes;
 truncated exports require `--allow-truncated`. Other commands, including production run/intervene, rig and retopology,

package/dist/index.d.ts

@@ -22,7 +22,7 @@ type CommandContext = {
      */
     args: 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 init [--agent claude-code|codex|cursor...] [--project] [--dry-run] [--base-url <url>] [--workspace <id>] [--profile <name>]\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 [--query <text>] [--limit <1-100>] [--cursor <cursor>]\n  assethub workspace 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 nodes --canvas <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 api search [query]\n  assethub api describe \"<METHOD /path>\"\n  assethub api call \"<METHOD /path>\" [--path-json <json|@file>] [--query-json <json|@file>] [--input-json <json|@file|@->] [--operation-id <uuid>]\n  assethub skills list [--cursor <cursor>]\n  assethub skills get <skill-id> [--revision <n>]\n  assethub skills learn --input-json <json|@file|@-> --operation-id <uuid>\n  assethub skills update <skill-id> --input-json <json|@file|@->\n  assethub skills controls <skill-id> --revision <n> --grant-revision <n> --mode automatic|manual|off [--share]\n  assethub skills prepare --input-json <json|@file|@->\n  assethub skills proposal <proposal-id>\n  assethub skills accept <proposal-id> --input-json <json|@file|@->\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|codex] [--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-image-asset-id>] [--part <mesh-asset-id>[:<part-image-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 composer run --node <shape:id> --canvas <id> [--model <id>] [--mode quick|quality] [--operation-id <uuid>] [--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 generate --node <shape:id> --canvas <id> [--model-id <id>] [--params-json <json|@file>] [--operation-id <uuid>] [--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>] [--skill-mode auto|manual|off] [--skill-id <id>...] [--context <canvas-id> --context-version <n>] [--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>] [--skill-mode auto|manual|off] [--skill-id <id>...] [--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  --workspace <id>      Select workspace scope for this command without changing saved selection.\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 init --dry-run\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 init [--agent claude-code|codex|cursor...] [--project] [--dry-run] [--base-url <url>] [--workspace <id>] [--profile <name>]\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 [--query <text>] [--limit <1-100>] [--cursor <cursor>]\n  assethub workspace 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 nodes --canvas <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 api search [query]\n  assethub api describe \"<METHOD /path>\"\n  assethub api call \"<METHOD /path>\" [--path-json <json|@file>] [--query-json <json|@file>] [--input-json <json|@file|@->] [--operation-id <uuid>]\n  assethub skills list [--cursor <cursor>]\n  assethub skills get <skill-id> [--revision <n>]\n  assethub skills learn --input-json <json|@file|@-> --operation-id <uuid>\n  assethub skills update <skill-id> --input-json <json|@file|@->\n  assethub skills controls <skill-id> --revision <n> --grant-revision <n> --mode automatic|manual|off [--share]\n  assethub skills prepare --input-json <json|@file|@->\n  assethub skills proposal <proposal-id>\n  assethub skills accept <proposal-id> --input-json <json|@file|@->\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|codex] [--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-image-asset-id>] [--part <mesh-asset-id>[:<part-image-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 composer run --node <shape:id> --canvas <id> [--model <id>] [--mode quick|quality] [--operation-id <uuid>] [--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|wait <run-id> [--interval-ms <ms>] [--timeout-ms <n>] [--summary]\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 generate --node <shape:id> --canvas <id> [--model-id <id>] [--params-json <json|@file>] [--operation-id <uuid>] [--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>] [--skill-mode auto|manual|off] [--skill-id <id>...] [--context <canvas-id> --context-version <n>] [--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 run --image <file|asset-id> [--canvas <id>] [--part-extractor <name>] [--compose v6|none] [--mesh-model <id>] [--max-parts <n>] [--max-cost <credits>] [--estimate] [--wait] [--download --out-dir <dir>] [--json]\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>] [--skill-mode auto|manual|off] [--skill-id <id>...] [--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  --workspace <id>      Select workspace scope for this command without changing saved selection.\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 init --dry-run\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 run --image ./character.png --estimate\n  assethub production run --image ./character.png --compose v6 --max-cost 500 --wait --download --out-dir ./out/asset\n  assethub production watch ord_x\n  assethub runs get run_x --summary\n  assethub runs wait run_x --timeout-ms 3600000\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 commandSkills: (subcommand: string | undefined, positionals: string[], ctx: CommandContext) => Promise<void>;
 /**
  * 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":";AA6BA,OAAO,EAQL,KAAK,wBAAwB,EAO7B,KAAK,YAAY,EAEjB,KAAK,UAAU,EAef,oBAAoB,EACrB,MAAM,sBAAsB,CAAA;AAc7B,OAAO,EAAC,kBAAkB,EAAc,MAAM,gCAAgC,CAAA;AAI9E,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAA;AAuBxD,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,UAAU,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;CACnC,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;IAC/C,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,EAAE,YAAY,CAAA;IAClB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,EAAE,CAAA;CACf,CAAA;AA4ID,eAAO,MAAM,KAAK,28cA+IjB,CAAA;AA2gDD,eAAO,MAAM,aAAa,GACxB,YAAY,MAAM,GAAG,SAAS,EAC9B,aAAa,MAAM,EAAE,EACrB,KAAK,cAAc,KAClB,OAAO,CAAC,IAAI,CA6Hd,CAAA;AA61CD;;;;;;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;AA+tCD,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":";AA6BA,OAAO,EAQL,KAAK,wBAAwB,EAO7B,KAAK,YAAY,EAEjB,KAAK,UAAU,EAkBf,oBAAoB,EACrB,MAAM,sBAAsB,CAAA;AAc7B,OAAO,EAAC,kBAAkB,EAAc,MAAM,gCAAgC,CAAA;AAqB9E,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAA;AAuBxD,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,UAAU,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;CACnC,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;IAC/C,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,EAAE,YAAY,CAAA;IAClB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,EAAE,CAAA;CACf,CAAA;AA4ID,eAAO,MAAM,KAAK,s+dAoJjB,CAAA;AA2gDD,eAAO,MAAM,aAAa,GACxB,YAAY,MAAM,GAAG,SAAS,EAC9B,aAAa,MAAM,EAAE,EACrB,KAAK,cAAc,KAClB,OAAO,CAAC,IAAI,CA6Hd,CAAA;AA61CD;;;;;;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;AA07CD,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

@@ -22,6 +22,8 @@ import { activeExecution, childOperationId, CliExecutionError, executeRecorded,
 import { buildRunUploadPlan, formatBytes } from './runsUpload/buildRunUpload.js';
 import { readGraphFolder } from './runsUpload/graphFolder.js';
 import { uploadRun } from './runsUpload/uploadRun.js';
+import { existsSync } from 'node:fs';
+import { DEFAULT_MAX_PARTS, PART_COMPOSER_V6_AGENT_VERSION, buildAutomationConfig, buildComposerPartsFromMeshExecutions, detectOneShotImageInput, estimateOneShotCost, exceedsMaxCost, formatExecutionSummaryLines, parseComposeFlag, pollAutomationBatch, readServerCostBreakdown, resolveFullBodyImageAssetId, serverSupportsV6Compose, withErrorHint, } from './productionOneShot.js';
 const defaultBaseUrl = 'https://app.assethub.io';
 // Mirrors PUBLIC_IMAGE_GENERATE_DEFAULT_MODEL_ID in apps/frontend
 // (src/feature/imageGen/util/publicImageGenDefaultModel.ts). This package does
@@ -185,7 +187,7 @@ Usage:
   assethub canvas list [--cursor <cursor>] [--limit <n>]
   assethub canvas get|use|open [<id>]
   assethub runs list [--canvas <id>] [--cursor <cursor>] [--limit <n>]
-  assethub runs get|watch <run-id> [--timeout-ms <n>]
+  assethub runs get|watch|wait <run-id> [--interval-ms <ms>] [--timeout-ms <n>] [--summary]
   assethub runs resume <operation-id> [--wait]
   assethub graph list [--cursor <cursor>] [--limit <n>]
   assethub graph show|export [--canvas <id> | --graph <id>] [--source generated|upload] [--artifact <node-id>] [--out <path>] [--allow-truncated]
@@ -216,6 +218,7 @@ Usage:
   assethub production status <order-id> [--wait] [--download --out-dir <dir>]
   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>]
   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>]
+  assethub production run --image <file|asset-id> [--canvas <id>] [--part-extractor <name>] [--compose v6|none] [--mesh-model <id>] [--max-parts <n>] [--max-cost <credits>] [--estimate] [--wait] [--download --out-dir <dir>] [--json]
   assethub production watch <order-id> [--interval-ms <ms>] [--timeout-ms <ms>] [--download --out-dir <dir>]
   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>]
   assethub production interventions <order-id>
@@ -252,7 +255,11 @@ Examples:
   assethub animate retarget --resource-id rig_x --animation preset:idle --wait
   assethub production analyze --file ./input.png --part-extractor "V1.5" --wait
   assethub production run --order-id ord_x --mission-id ms_x --run-mode full_auto --max-cost-credits 200 --wait
+  assethub production run --image ./character.png --estimate
+  assethub production run --image ./character.png --compose v6 --max-cost 500 --wait --download --out-dir ./out/asset
   assethub production watch ord_x
+  assethub runs get run_x --summary
+  assethub runs wait run_x --timeout-ms 3600000
   assethub production intervene ord_x --exclude 7 --rename 3="left wing" --idempotency-key review-2026-07-29
   assethub production interventions ord_x
   assethub runs upload ./out/pluffy-run-2026-07-30 --dry-run
@@ -3110,6 +3117,156 @@ const productionSession = (ctx, operation, canvasId = selectedCanvasId(ctx.flags
     canvasId,
     operation,
 });
+/**
+ * `production run --image <file|assetId>`: the one-shot "image -> finished
+ * asset" command. A thin wrapper around `production automation` (which
+ * already does split -> mesh x N -> compose server-side) plus waiting,
+ * cost estimation and downloads — it never re-implements the manual
+ * split/mesh/compose dance. See productionOneShot.ts for the pure,
+ * independently-tested pieces (image-flag resolution, cost estimate math,
+ * batch-status polling, the V6 compose fallback's mesh<->image pairing, and
+ * error hints); this function only wires them to the client and to flags.
+ */
+const commandProductionRunOneShot = async (ctx) => {
+    if (sourceInputCount(ctx.flags) > 0) {
+        throw new Error('--image already resolves a source; do not combine it with --file/--source-id/--source-url/other source flags.');
+    }
+    const imageValue = requireFlag(ctx.flags, 'image');
+    const detected = detectOneShotImageInput(imageValue, existsSync);
+    const sourceFlags = {
+        ...ctx.flags,
+        ...(detected.kind === 'file'
+            ? { file: detected.path }
+            : { 'source-id': detected.resourceId }),
+    };
+    const compose = parseComposeFlag(getFlag(ctx.flags, 'compose'));
+    const meshModelId = getFlag(ctx.flags, 'mesh-model') ?? defaultMeshModelId;
+    const maxParts = getFlag(ctx.flags, 'max-parts') == null
+        ? DEFAULT_MAX_PARTS
+        : parsePositiveIntegerFlag(ctx.flags, 'max-parts', 1);
+    const maxCostCredits = getFlag(ctx.flags, 'max-cost') == null
+        ? undefined
+        : parsePositiveIntegerFlag(ctx.flags, 'max-cost', 1);
+    const agentVersion = resolvePartExtractorForAnalyze(ctx.flags);
+    // Every number below comes from a side-effect-free GET; nothing here
+    // starts real (billable) work, so this runs whether or not --estimate was
+    // passed and gates --max-cost before the real automation call below.
+    const [models, composerCapabilities] = await Promise.all([
+        ctx.client.v2.listModels({ domain: 'meshGen' }),
+        ctx.client.v2.getMeshComposers(),
+    ]);
+    const meshModel = models.find(model => model.id === meshModelId);
+    const composeCredits = compose === 'v6'
+        ? (composerCapabilities.quotes?.find(quote => quote.agentVersion === 'v6')
+            ?.credits ?? null)
+        : undefined;
+    const estimate = estimateOneShotCost({
+        meshModel,
+        maxParts,
+        composeRequested: compose === 'v6',
+        composeCredits,
+    });
+    if (exceedsMaxCost(estimate.totalCredits, maxCostCredits)) {
+        throw new Error(`Estimated cost ${estimate.totalCredits} credits exceeds --max-cost ${maxCostCredits}; refusing to run before spending anything. ${estimate.notes.join(' ')}`);
+    }
+    if (hasFlag(ctx.flags, 'estimate')) {
+        print({ estimate });
+        return;
+    }
+    const session = await productionSession(ctx, 'production.automation');
+    const source = await recordedSource(ctx, await requireSource({
+        flags: sourceFlags,
+        client: ctx.client,
+        fileMediaType: 'image',
+        preferUploadId: true,
+    }));
+    const analyzeImage = productionAnalyzeSourceFromSource(source);
+    const config = buildAutomationConfig(compose);
+    const body = {
+        images: [analyzeImage],
+        agentVersion,
+        ...(config ? { config } : {}),
+        ...(compose === 'v6' ? { partComposerAgentVersion: PART_COMPOSER_V6_AGENT_VERSION } : {}),
+        ...(maxCostCredits != null ? { maxCostCredits } : {}),
+    };
+    const queued = (await executeRecorded(session, 'production.automation', body, executionOptions(ctx.flags)));
+    stderr.write(`[run] batch=${queued.batchId}\n`);
+    // `estimatedCostBreakdown`'s presence on the automation response itself
+    // (assethub-web #8179) is the proof that this server understood
+    // `partComposerAgentVersion` and already ran Composer V6 server-side, in
+    // the same call — no client-side fallback compose is needed. Its absence
+    // means an older, currently-deployed server silently ignored that field,
+    // so the CLI still has to pair parts and run compose itself below.
+    const serverHandledV6Compose = compose === 'v6' &&
+        serverSupportsV6Compose(queued);
+    const needsFallbackCompose = compose === 'v6' && !serverHandledV6Compose;
+    let batchStatus;
+    if (hasFlag(ctx.flags, 'wait') || needsFallbackCompose) {
+        batchStatus = await pollAutomationBatch({
+            getStatus: () => ctx.client.v1.getProductionAutomationStatus(queued.batchId),
+            sleep: ms => delay(ms),
+            intervalMs: parsePositiveIntegerFlag(ctx.flags, 'interval-ms', 5000),
+            timeoutMs: parsePositiveIntegerFlag(ctx.flags, 'timeout-ms', 1800000),
+            onProgress: lines => lines.forEach(line => stderr.write(`${line}\n`)),
+        });
+    }
+    let composeExecution;
+    if (needsFallbackCompose) {
+        const order = queued.images[0];
+        if (!order)
+            throw new Error('Automation did not return an order for the requested image.');
+        if (batchStatus?.images.find(image => image.orderId === order.orderId)
+            ?.status === 'failed')
+            throw new Error(`Automation failed for order ${order.orderId}; there is nothing to compose.`);
+        const runs = await ctx.client.v2.listCanvasRuns(session.canvas.id, { limit: 200 });
+        const parts = buildComposerPartsFromMeshExecutions(runs.items, order.orderId);
+        const fullBodyImageAssetId = resolveFullBodyImageAssetId(runs.items, order.orderId) ??
+            (detected.kind === 'resourceId' ? detected.resourceId : undefined);
+        if (parts.length === 0 || fullBodyImageAssetId == null) {
+            throw withErrorHint(new Error('Could not find mesh part outputs (and the source image they were generated from) to compose for this order.'));
+        }
+        try {
+            const composeQueued = await executeRecorded(session, 'mesh.compose', {
+                parts,
+                fullBodyImageAssetId,
+                agentVersion: 'v6',
+            }, executionOptions(ctx.flags));
+            composeExecution = composeQueued.execution;
+        }
+        catch (error) {
+            throw error instanceof Error ? withErrorHint(error) : error;
+        }
+    }
+    // The automation receipt (`queued.execution`) is only the split stage's own
+    // execution row; the real completion signal for the whole order (mesh gen
+    // across every part, plus compose when the server ran it) is the batch
+    // status polled above. Once that says the order is done, re-fetch the
+    // execution so `--download`/the printed summary reflect the final state
+    // rather than the split-stage snapshot from right after submission.
+    const finalExecution = composeExecution ??
+        (batchStatus != null
+            ? await ctx.client.v2.getRun(queued.execution.runId)
+            : queued.execution);
+    // Prefer the server's own reported cost (#8179) over our preflight
+    // best-effort `estimate` once we actually have it; absent on a server
+    // that has not deployed #8179 yet, in which case only `estimate` (used
+    // for the --max-cost gate above) is available.
+    const serverCost = readServerCostBreakdown(queued);
+    // The machine-readable summary this prints is always JSON, matching every
+    // other command in this CLI; --json is accepted (it is a no-op) rather than
+    // rejected, since there is no plain-text mode here to opt out of.
+    print(await withOptionalDownloads(ctx.flags, sanitizeProductionOutput({
+        batchId: queued.batchId,
+        estimatedCostCredits: queued.estimatedCostCredits,
+        ...(serverCost ?? {}),
+        images: queued.images,
+        estimate,
+        batchStatus,
+        compose: composeExecution,
+        execution: finalExecution,
+    })));
+    process.exitCode = executionExitCode(finalExecution);
+};
 const commandProduction = async (subcommand, positionals, ctx) => {
     if (subcommand === 'agents') {
         print(sanitizeProductionOutput(await ctx.client.v1.getProductionAgents()));
@@ -3216,6 +3373,14 @@ const commandProduction = async (subcommand, positionals, ctx) => {
         return;
     }
     if (subcommand === 'run') {
+        // `production run --image <file|assetId>` is a different command in
+        // everything but name: the one-shot image -> finished-asset flow, not
+        // confirmed-task mission execution. Intercept before `--order-id` is
+        // required so the mission flow below is completely untouched when
+        // --image is absent.
+        if (getFlag(ctx.flags, 'image') != null) {
+            return commandProductionRunOneShot(ctx);
+        }
         const orderId = requireFlag(ctx.flags, 'order-id');
         const missionId = requireFlag(ctx.flags, 'mission-id');
         const runMode = parseRunModeFlag(ctx.flags);
@@ -3910,12 +4075,21 @@ const commandRuns = async (subcommand, positionals, ctx) => {
         print(await ctx.client.v2.listCanvasRuns(canvas.id, pageOptions(ctx.flags)));
         return;
     }
-    if (subcommand === 'get' || subcommand === 'watch') {
+    if (subcommand === 'get' || subcommand === 'watch' || subcommand === 'wait') {
         const id = requirePositional(positionals, 2, 'run-id');
+        // `wait` is `watch` under a name that matches how long-running waits are
+        // asked for elsewhere in the CLI; both poll the same way (429s are
+        // retried inside the client's own request layer, same as every other
+        // poll loop in this file) and accept the same --interval-ms/--timeout-ms.
         const execution = subcommand === 'get'
             ? await ctx.client.v2.getRun(id)
             : await waitForExecution(ctx.client, id, watchOptions(ctx.flags));
-        print({ execution });
+        if (subcommand === 'get' && hasFlag(ctx.flags, 'summary')) {
+            stdout.write(`${formatExecutionSummaryLines(execution).join('\n')}\n`);
+        }
+        else {
+            print({ execution });
+        }
         process.exitCode = executionExitCode(execution);
         return;
     }

package/dist/productionOneShot.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Pure, independently-testable pieces of `production run --image ...`
+ * (the image -> finished-asset one-shot command). Kept separate from
+ * index.ts so the tricky bits — cost estimation, batch-status polling, the
+ * V6 compose fallback's mesh<->image pairing, and error hints — can be unit
+ * tested without spinning up an HTTP server or spawning the built CLI.
+ *
+ * This module intentionally does not import from `./index.js`: the CLI
+ * command wiring (in index.ts) calls these functions and supplies whatever
+ * they need (flags already parsed, client calls already made) rather than
+ * this module reaching back into index.ts's private helpers, which would
+ * create a circular import between the two files.
+ */
+import type { CanvasExecution, MeshComposerPart, ModelSummary, ProductionAutomationBatchStatusResult, ProductionOrderStatus } from '@assethub/api-client';
+export type OneShotImageInput = {
+    kind: 'file';
+    path: string;
+} | {
+    kind: 'resourceId';
+    resourceId: string;
+};
+/**
+ * `--image <file|assetId>` auto-detection: an existing local path is treated
+ * as `--file`; anything else (an asset/resource id) is treated as
+ * `--source-id`. `exists` is injectable so this stays a pure function in
+ * tests instead of touching the real filesystem.
+ */
+export declare const detectOneShotImageInput: (value: string, exists: (path: string) => boolean) => OneShotImageInput;
+export type ComposeMode = 'v6' | 'none';
+/** Parses `--compose`. Absent stays absent (server default applies untouched). */
+export declare const parseComposeFlag: (value: string | undefined) => ComposeMode | undefined;
+/**
+ * The confirmed field name (assethub-web PR #8179, `web-cli-ux`) for
+ * requesting an explicit Composer V6 pass from `production automation`
+ * itself. Not `composeModel` — that was this module's pre-#8179 best guess.
+ */
+export declare const PART_COMPOSER_V6_AGENT_VERSION = "part_composer_v6_auto_assemble";
+/**
+ * Builds the `config` object for the `production automation` request.
+ *
+ * - `--compose` omitted: returns `undefined` so the request carries no
+ *   `config.autoCompose` at all, leaving the server default in effect.
+ * - `--compose none`: disables automation's own compose stage entirely.
+ * - `--compose v6`: leaves config unset. The version is a top-level automation
+ *   request field, added by the caller; `autoCompose` defaults to `true`.
+ */
+export declare const buildAutomationConfig: (compose: ComposeMode | undefined) => Record<string, unknown> | undefined;
+/**
+ * `estimatedCostBreakdown` (added by #8179) only appears on a server new
+ * enough to also honor `partComposerAgentVersion` — its presence in the
+ * automation response is the signal that the server already did the V6
+ * compose server-side in that same call, so no client-side fallback compose
+ * is needed. Its absence means an older, currently-deployed server: it
+ * silently ignored `partComposerAgentVersion` and ran its own default
+ * compose (if any), so the caller must still run the explicit fallback.
+ */
+export declare const serverSupportsV6Compose: (automationResult: Record<string, unknown>) => boolean;
+export declare const DEFAULT_MAX_PARTS = 24;
+export type CostLineItem = {
+    total: number | null;
+    note?: string;
+};
+export type OneShotCostBreakdown = {
+    split: CostLineItem & {
+        perImage: number | null;
+    };
+    meshGeneration: CostLineItem & {
+        perPart: number | null;
+        maxParts: number;
+    };
+    compose: CostLineItem & {
+        perLane: number | null;
+        lanesPerImage: number;
+    };
+};
+export type OneShotCostEstimate = {
+    breakdown: OneShotCostBreakdown;
+    totalCredits: number;
+    notes: string[];
+};
+/**
+ * Best-effort cost breakdown for `--estimate`, shaped like the server's own
+ * `estimatedCostBreakdown` (#8179: `split`/`meshGeneration`/`compose`, each
+ * with a per-unit price and a total). Nothing here calls `production
+ * automation`/`analyze` (that would start real, billable work); every
+ * number comes from a side-effect-free GET (`models` catalog, `mesh/compose`
+ * capabilities). Today's API has no dry-run cost for part extraction/split,
+ * so that line is reported as unknown rather than guessed. `maxParts`
+ * mirrors the server's own conservative constant for this math (24, per
+ * #8179) rather than a locally invented cap; `--max-parts` overrides it.
+ */
+export declare const estimateOneShotCost: (options: {
+    meshModel: ModelSummary | undefined;
+    maxParts: number;
+    composeRequested: boolean;
+    composeCredits: number | null | undefined;
+}) => OneShotCostEstimate;
+/**
+ * Reads the server's own `estimatedTotalCredits`/`estimatedCostBreakdown`
+ * off a real (non-estimate) automation response, when present (#8179).
+ * These fields are not yet in `ProductionAutomationResult`'s shipped type,
+ * so this reads them optionally/untyped rather than guessing a schema;
+ * absent on a server that has not deployed #8179 yet.
+ */
+export declare const readServerCostBreakdown: (automationResult: Record<string, unknown>) => {
+    estimatedTotalCredits: number;
+    estimatedCostBreakdown: unknown;
+} | undefined;
+/** Whether the estimated (or actual, server-reported) total would exceed `--max-cost`. */
+export declare const exceedsMaxCost: (totalCredits: number, maxCostCredits: number | undefined) => boolean;
+/**
+ * Human stage label for one image's `ProductionOrderStatus`. The API has no
+ * distinct "compose" status, so `ready`/`in_progress` are both reported as
+ * `mesh` (parts are being generated or are ready to be); there is no way to
+ * tell "meshing" apart from "composing" from this field alone.
+ */
+export declare const stageLabelForOrderStatus: (status: ProductionOrderStatus) => string;
+/**
+ * One line per per-image stage transition, plus a batch-level completion
+ * line when the completed/failed counts change. "mesh k/N" here means
+ * images processed out of the batch, not parts within one image — the batch
+ * status endpoint does not expose per-part progress.
+ */
+export declare const batchProgressLines: (previous: ProductionAutomationBatchStatusResult | undefined, next: ProductionAutomationBatchStatusResult) => string[];
+/**
+ * Polls `getStatus` (expected to be `client.v1.getProductionAutomationStatus`,
+ * which already retries 429s in its own request layer) until every image in
+ * the batch reaches a terminal outcome, printing one line per stage
+ * transition via `onProgress`. Mirrors the deadline/backoff shape of
+ * `pollProductionStatus`/`watchProductionRun` in index.ts.
+ */
+export declare const pollAutomationBatch: (options: {
+    getStatus: () => Promise<ProductionAutomationBatchStatusResult>;
+    sleep: (ms: number) => Promise<void>;
+    intervalMs: number;
+    timeoutMs: number;
+    onProgress?: (lines: string[]) => void;
+}) => Promise<ProductionAutomationBatchStatusResult>;
+/**
+ * The V6 compose fallback's mesh<->image pairing. Reads the automation
+ * batch's own `mesh.generate` executions (fetched via `listCanvasRuns` and
+ * filtered to the target order) for each part's produced mesh asset
+ * (`execution.outputs`, `mediaType === 'mesh'`) and the part image it was
+ * generated from (`execution.inputAssets`, `mediaType === 'image'`) — the
+ * same `{assetId, partImageAssetId}` shape `composer run --part
+ * <mesh>:<image>` accepts, so no manual pairing is needed.
+ */
+export declare const buildComposerPartsFromMeshExecutions: (executions: CanvasExecution[], orderId: string) => MeshComposerPart[];
+/**
+ * The V6 compose fallback's `fullBodyImageAssetId`. Automation's own result
+ * does not return a durable asset id for the original image (only
+ * `orderId`/`projectId`/`url`/`runId`), so this reads it back off the part
+ * images' own `sourceAssetId` (each part image's own upstream source is the
+ * original full-body photo it was cropped from) — the same field
+ * `composerInputFromRun`'s mesh.generate part-field allowlist tracks.
+ */
+export declare const resolveFullBodyImageAssetId: (executions: CanvasExecution[], orderId: string) => string | undefined;
+export type KnownErrorLike = {
+    status?: number;
+    code?: string;
+    message: string;
+    details?: {
+        meshAssetId?: string;
+        assetId?: string;
+        actualType?: string;
+        expectedType?: string;
+    };
+};
+/**
+ * Actionable next steps appended to (never replacing) a known
+ * `AssetHubApiError`'s own message. Matches on `error.code`/`error.details`
+ * first — `PART_IMAGE_REQUIRED` and `ASSET_WRONG_MEDIA_TYPE` are confirmed
+ * `/mesh/compose` error codes (assethub-web PR #8179) with a structured
+ * `details` payload. Falls back to matching on message content for a server
+ * that has not shipped those codes yet (e.g. today's deployed API, where
+ * the same failures still surface as a plain `404 ASSET_NOT_FOUND` or a
+ * generic validation message — "Asset not found" is quoted directly from
+ * the originally reported failure). `ASSET_NOT_FOUND` itself (asset does
+ * not exist / isn't yours) is left alone; it is not one of these cases.
+ */
+export declare const errorHintFor: (error: KnownErrorLike) => string | undefined;
+/** Appends an error hint to `error.message` in place, if one applies. */
+export declare const withErrorHint: <T extends Error & {
+    message: string;
+}>(error: T) => T;
+/** Condensed, human-readable lines for `runs get --summary`. */
+export declare const formatExecutionSummaryLines: (execution: CanvasExecution) => string[];
+//# sourceMappingURL=productionOneShot.d.ts.map

package/dist/productionOneShot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"productionOneShot.d.ts","sourceRoot":"","sources":["../src/productionOneShot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,qCAAqC,EACrC,qBAAqB,EACtB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,iBAAiB,GACzB;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,GAC5B;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAC,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,MAAM,EACb,QAAQ,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,KAChC,iBACoF,CAAA;AAEvF,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,CAAA;AAEvC,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,WAAW,GAAG,SAI1E,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,mCAAmC,CAAA;AAE9E;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,WAAW,GAAG,SAAS,KAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAE5B,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,GAClC,kBAAkB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACxC,OAA0D,CAAA;AAE7D,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,MAAM,MAAM,YAAY,GAAG;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,CAAA;AAEhE,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,YAAY,GAAG;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,CAAA;IAC/C,cAAc,EAAE,YAAY,GAAG;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAAA;IACzE,OAAO,EAAE,YAAY,GAAG;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAC,CAAA;CACxE,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,oBAAoB,CAAA;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAAI,SAAS;IAC3C,SAAS,EAAE,YAAY,GAAG,SAAS,CAAA;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,OAAO,CAAA;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAC1C,KAAG,mBAmDH,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,kBAAkB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACxC;IAAC,qBAAqB,EAAE,MAAM,CAAC;IAAC,sBAAsB,EAAE,OAAO,CAAA;CAAC,GAAG,SAKrE,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,cAAc,GACzB,cAAc,MAAM,EACpB,gBAAgB,MAAM,GAAG,SAAS,KACjC,OAAkE,CAAA;AAErE;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,qBAAqB,KAAG,MAgBxE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,qCAAqC,GAAG,SAAS,EAC3D,MAAM,qCAAqC,KAC1C,MAAM,EAuBR,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAU,SAAS;IACjD,SAAS,EAAE,MAAM,OAAO,CAAC,qCAAqC,CAAC,CAAA;IAC/D,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAA;CACvC,KAAG,OAAO,CAAC,qCAAqC,CAkBhD,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oCAAoC,GAC/C,YAAY,eAAe,EAAE,EAC7B,SAAS,MAAM,KACd,gBAAgB,EAclB,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,GACtC,YAAY,eAAe,EAAE,EAC7B,SAAS,MAAM,KACd,MAAM,GAAG,SAQX,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,CAAA;CACF,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,cAAc,KAAG,MAAM,GAAG,SA0B7D,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,KAAK,GAAG;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,EAAE,OAAO,CAAC,KAAG,CAI7E,CAAA;AAED,gEAAgE;AAChE,eAAO,MAAM,2BAA2B,GAAI,WAAW,eAAe,KAAG,MAAM,EAe9E,CAAA"}

package/dist/productionOneShot.js

@@ -0,0 +1,296 @@
+/**
+ * `--image <file|assetId>` auto-detection: an existing local path is treated
+ * as `--file`; anything else (an asset/resource id) is treated as
+ * `--source-id`. `exists` is injectable so this stays a pure function in
+ * tests instead of touching the real filesystem.
+ */
+export const detectOneShotImageInput = (value, exists) => exists(value) ? { kind: 'file', path: value } : { kind: 'resourceId', resourceId: value };
+/** Parses `--compose`. Absent stays absent (server default applies untouched). */
+export const parseComposeFlag = (value) => {
+    if (value == null)
+        return undefined;
+    if (value === 'v6' || value === 'none')
+        return value;
+    throw new Error('--compose must be "v6" or "none"');
+};
+/**
+ * The confirmed field name (assethub-web PR #8179, `web-cli-ux`) for
+ * requesting an explicit Composer V6 pass from `production automation`
+ * itself. Not `composeModel` — that was this module's pre-#8179 best guess.
+ */
+export const PART_COMPOSER_V6_AGENT_VERSION = 'part_composer_v6_auto_assemble';
+/**
+ * Builds the `config` object for the `production automation` request.
+ *
+ * - `--compose` omitted: returns `undefined` so the request carries no
+ *   `config.autoCompose` at all, leaving the server default in effect.
+ * - `--compose none`: disables automation's own compose stage entirely.
+ * - `--compose v6`: leaves config unset. The version is a top-level automation
+ *   request field, added by the caller; `autoCompose` defaults to `true`.
+ */
+export const buildAutomationConfig = (compose) => {
+    return compose === 'none' ? { autoCompose: false } : undefined;
+};
+/**
+ * `estimatedCostBreakdown` (added by #8179) only appears on a server new
+ * enough to also honor `partComposerAgentVersion` — its presence in the
+ * automation response is the signal that the server already did the V6
+ * compose server-side in that same call, so no client-side fallback compose
+ * is needed. Its absence means an older, currently-deployed server: it
+ * silently ignored `partComposerAgentVersion` and ran its own default
+ * compose (if any), so the caller must still run the explicit fallback.
+ */
+export const serverSupportsV6Compose = (automationResult) => automationResult.estimatedCostBreakdown != null;
+export const DEFAULT_MAX_PARTS = 24;
+/**
+ * Best-effort cost breakdown for `--estimate`, shaped like the server's own
+ * `estimatedCostBreakdown` (#8179: `split`/`meshGeneration`/`compose`, each
+ * with a per-unit price and a total). Nothing here calls `production
+ * automation`/`analyze` (that would start real, billable work); every
+ * number comes from a side-effect-free GET (`models` catalog, `mesh/compose`
+ * capabilities). Today's API has no dry-run cost for part extraction/split,
+ * so that line is reported as unknown rather than guessed. `maxParts`
+ * mirrors the server's own conservative constant for this math (24, per
+ * #8179) rather than a locally invented cap; `--max-parts` overrides it.
+ */
+export const estimateOneShotCost = (options) => {
+    const notes = [];
+    const split = {
+        perImage: null,
+        total: null,
+        note: 'part extraction/split cost has no dry-run price source today; the actual cost is reported after the run (see `production status` or `runs get --summary`)',
+    };
+    notes.push(split.note);
+    const perPart = options.meshModel?.creditCost ?? options.meshModel?.defaultCreditCost ?? null;
+    const meshTotal = perPart == null ? null : perPart * options.maxParts;
+    const meshGeneration = {
+        perPart,
+        maxParts: options.maxParts,
+        total: meshTotal,
+        ...(perPart == null
+            ? {
+                note: options.meshModel
+                    ? `mesh generation cost not included: no credit price found for model "${options.meshModel.id}"`
+                    : 'mesh generation cost not included: mesh model was not found in the catalog',
+            }
+            : {
+                note: `assumes up to ${options.maxParts} parts at ${perPart} credits each; the CLI has no way to know the actual part count before splitting runs`,
+            }),
+    };
+    notes.push(meshGeneration.note);
+    const lanesPerImage = 1;
+    const compose = options.composeRequested
+        ? options.composeCredits == null
+            ? {
+                perLane: null,
+                lanesPerImage,
+                total: null,
+                note: 'compose cost not included: no quote found for the requested compose model',
+            }
+            : { perLane: options.composeCredits, lanesPerImage, total: options.composeCredits * lanesPerImage }
+        : {
+            perLane: null,
+            lanesPerImage,
+            total: 0,
+            note: 'compose disabled by --compose none',
+        };
+    if (compose.note)
+        notes.push(compose.note);
+    const totalCredits = (meshGeneration.total ?? 0) + (compose.total ?? 0);
+    return { breakdown: { split, meshGeneration, compose }, totalCredits, notes };
+};
+/**
+ * Reads the server's own `estimatedTotalCredits`/`estimatedCostBreakdown`
+ * off a real (non-estimate) automation response, when present (#8179).
+ * These fields are not yet in `ProductionAutomationResult`'s shipped type,
+ * so this reads them optionally/untyped rather than guessing a schema;
+ * absent on a server that has not deployed #8179 yet.
+ */
+export const readServerCostBreakdown = (automationResult) => {
+    const total = automationResult.estimatedTotalCredits;
+    const breakdown = automationResult.estimatedCostBreakdown;
+    if (typeof total !== 'number' || breakdown == null)
+        return undefined;
+    return { estimatedTotalCredits: total, estimatedCostBreakdown: breakdown };
+};
+/** Whether the estimated (or actual, server-reported) total would exceed `--max-cost`. */
+export const exceedsMaxCost = (totalCredits, maxCostCredits) => maxCostCredits != null && totalCredits > maxCostCredits;
+/**
+ * Human stage label for one image's `ProductionOrderStatus`. The API has no
+ * distinct "compose" status, so `ready`/`in_progress` are both reported as
+ * `mesh` (parts are being generated or are ready to be); there is no way to
+ * tell "meshing" apart from "composing" from this field alone.
+ */
+export const stageLabelForOrderStatus = (status) => {
+    switch (status) {
+        case 'draft':
+            return 'queued';
+        case 'analyzing':
+            return 'split';
+        case 'ready':
+        case 'in_progress':
+            return 'mesh';
+        case 'completed':
+            return 'done';
+        case 'failed':
+            return 'failed';
+        default:
+            return status;
+    }
+};
+/**
+ * One line per per-image stage transition, plus a batch-level completion
+ * line when the completed/failed counts change. "mesh k/N" here means
+ * images processed out of the batch, not parts within one image — the batch
+ * status endpoint does not expose per-part progress.
+ */
+export const batchProgressLines = (previous, next) => {
+    const lines = [];
+    const previousStatusByOrder = new Map((previous?.images ?? []).map(image => [image.orderId, image.status]));
+    for (const image of next.images) {
+        const before = previousStatusByOrder.get(image.orderId);
+        if (before !== image.status) {
+            lines.push(`[batch] order=${image.orderId} stage=${stageLabelForOrderStatus(image.status)} (${image.status})`);
+        }
+    }
+    const previousSummary = previous?.summary;
+    const done = next.summary.completed + next.summary.failed;
+    if (previousSummary == null ||
+        previousSummary.completed !== next.summary.completed ||
+        previousSummary.failed !== next.summary.failed) {
+        lines.push(`[batch] mesh ${done}/${next.summary.total} done`);
+    }
+    return lines;
+};
+/**
+ * Polls `getStatus` (expected to be `client.v1.getProductionAutomationStatus`,
+ * which already retries 429s in its own request layer) until every image in
+ * the batch reaches a terminal outcome, printing one line per stage
+ * transition via `onProgress`. Mirrors the deadline/backoff shape of
+ * `pollProductionStatus`/`watchProductionRun` in index.ts.
+ */
+export const pollAutomationBatch = async (options) => {
+    const deadline = Date.now() + options.timeoutMs;
+    let previous;
+    for (;;) {
+        const status = await options.getStatus();
+        const lines = batchProgressLines(previous, status);
+        if (lines.length && options.onProgress)
+            options.onProgress(lines);
+        previous = status;
+        if (status.summary.completed + status.summary.failed >= status.summary.total) {
+            return status;
+        }
+        if (Date.now() >= deadline) {
+            throw new Error(`production run --wait timed out after ${options.timeoutMs}ms for batch=${status.batchId}`);
+        }
+        await options.sleep(Math.min(options.intervalMs, Math.max(0, deadline - Date.now())));
+    }
+};
+/**
+ * The V6 compose fallback's mesh<->image pairing. Reads the automation
+ * batch's own `mesh.generate` executions (fetched via `listCanvasRuns` and
+ * filtered to the target order) for each part's produced mesh asset
+ * (`execution.outputs`, `mediaType === 'mesh'`) and the part image it was
+ * generated from (`execution.inputAssets`, `mediaType === 'image'`) — the
+ * same `{assetId, partImageAssetId}` shape `composer run --part
+ * <mesh>:<image>` accepts, so no manual pairing is needed.
+ */
+export const buildComposerPartsFromMeshExecutions = (executions, orderId) => {
+    const parts = [];
+    for (const execution of executions) {
+        if (execution.operation !== 'mesh.generate')
+            continue;
+        if (!execution.orderIds.includes(orderId))
+            continue;
+        const meshOutput = execution.outputs.find(output => output.mediaType === 'mesh');
+        if (!meshOutput)
+            continue;
+        const partImage = execution.inputAssets?.find(asset => asset.mediaType === 'image');
+        parts.push({
+            assetId: meshOutput.assetId,
+            ...(partImage ? { partImageAssetId: partImage.assetId } : {}),
+        });
+    }
+    return parts;
+};
+/**
+ * The V6 compose fallback's `fullBodyImageAssetId`. Automation's own result
+ * does not return a durable asset id for the original image (only
+ * `orderId`/`projectId`/`url`/`runId`), so this reads it back off the part
+ * images' own `sourceAssetId` (each part image's own upstream source is the
+ * original full-body photo it was cropped from) — the same field
+ * `composerInputFromRun`'s mesh.generate part-field allowlist tracks.
+ */
+export const resolveFullBodyImageAssetId = (executions, orderId) => {
+    for (const execution of executions) {
+        if (execution.operation !== 'mesh.generate')
+            continue;
+        if (!execution.orderIds.includes(orderId))
+            continue;
+        const partImage = execution.inputAssets?.find(asset => asset.mediaType === 'image');
+        if (partImage?.sourceAssetId)
+            return partImage.sourceAssetId;
+    }
+    return undefined;
+};
+/**
+ * Actionable next steps appended to (never replacing) a known
+ * `AssetHubApiError`'s own message. Matches on `error.code`/`error.details`
+ * first — `PART_IMAGE_REQUIRED` and `ASSET_WRONG_MEDIA_TYPE` are confirmed
+ * `/mesh/compose` error codes (assethub-web PR #8179) with a structured
+ * `details` payload. Falls back to matching on message content for a server
+ * that has not shipped those codes yet (e.g. today's deployed API, where
+ * the same failures still surface as a plain `404 ASSET_NOT_FOUND` or a
+ * generic validation message — "Asset not found" is quoted directly from
+ * the originally reported failure). `ASSET_NOT_FOUND` itself (asset does
+ * not exist / isn't yours) is left alone; it is not one of these cases.
+ */
+export const errorHintFor = (error) => {
+    if (error.code === 'PART_IMAGE_REQUIRED') {
+        const meshAssetId = error.details?.meshAssetId ?? '<mesh-asset-id>';
+        return `pass --part ${meshAssetId}:<part-image-asset-id>, or regenerate with mesh generate --derived-from-run <split-run-id>`;
+    }
+    if (error.code === 'ASSET_WRONG_MEDIA_TYPE') {
+        const { assetId, actualType, expectedType } = error.details ?? {};
+        if (expectedType === 'mesh' && actualType === 'image') {
+            return `asset ${assetId ?? '<asset-id>'} is an image; run mesh generate (or production run --image) first`;
+        }
+        return `asset ${assetId ?? '<asset-id>'} has the wrong type: expected ${expectedType ?? 'unknown'}, got ${actualType ?? 'unknown'}`;
+    }
+    const message = error.message.toLowerCase();
+    if (message.includes('asset not found') || message.includes('not found')) {
+        return 'compose expects a mesh part asset id, not an image asset — run `mesh generate` (or `production run --image <file|assetId>`) first, then compose the resulting mesh asset ids';
+    }
+    if (message.includes('part image') ||
+        message.includes('partimageassetid') ||
+        message.includes('full body image') ||
+        message.includes('fullbodyimageassetid')) {
+        return "pass `--part <mesh-asset-id>:<part-image-asset-id>` on `composer run`/`composer refine` to attach each part's source image (or use `production run --image ... --compose v6`, which pairs them automatically)";
+    }
+    return undefined;
+};
+/** Appends an error hint to `error.message` in place, if one applies. */
+export const withErrorHint = (error) => {
+    const hint = errorHintFor(error);
+    if (hint)
+        error.message = `${error.message} (${hint})`;
+    return error;
+};
+/** Condensed, human-readable lines for `runs get --summary`. */
+export const formatExecutionSummaryLines = (execution) => {
+    const lines = [
+        `runId: ${execution.runId}`,
+        `operation: ${execution.operation}`,
+        `status: ${execution.status}`,
+        `canvas: ${execution.canvas.id}`,
+    ];
+    if (execution.orderIds.length)
+        lines.push(`orders: ${execution.orderIds.join(', ')}`);
+    lines.push(`credits: reserved=${execution.usage.reservedCredits ?? '-'} charged=${execution.usage.chargedCredits ?? '-'}`);
+    const output = execution.outputs[0];
+    lines.push(`output: ${output ? output.assetId : '-'}`);
+    if (execution.error)
+        lines.push(`error: ${execution.error.code}: ${execution.error.message}`);
+    return lines;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assethub/cli",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "Command line interface for AssetHub.",
   "type": "module",
   "bin": {

package/skills/assethub/SKILL.md

@@ -72,6 +72,26 @@ assethub api call "POST /mesh/compose" --input-json @request.json --operation-id
 - `--operation-id <uuid>` makes a paid request idempotent. Reuse the **same** ID with the **same** input to retry; a new candidate needs a new ID.
 - Generation returns `execution` with the canvas URL, run and job IDs, and the output asset IDs. Chain those IDs into the next step with `--source-id`.
 
+### Fast path: image to a finished, composed asset
+
+Turning one image into a finished 3D asset does **not** need manual `parts split`
+→ `mesh generate` (once per part) → `composer run`. Use the one-shot command instead:
+
+```bash
+assethub production run --image ./character.png --estimate
+assethub production run --image ./character.png --wait --download --out-dir ./out/asset
+```
+
+`--image` accepts a local file path or an existing asset id — it auto-detects
+which. This wraps `production automation` (split, mesh generation per part, and
+compose all happen server-side) plus waiting and downloads; it never leaves you
+to pair mesh outputs with their source part images by hand. `--compose v6`
+requests a Composer V6 pass explicitly (still pairs parts and images
+automatically); `--compose none` stops after mesh generation. `--max-cost
+<credits>` refuses to run at all once the estimate exceeds it. `runs get <run-id>
+--summary` is the readable alternative to the full JSON dump for checking on a
+long run.
+
 ### 5. Wait or recover — never resubmit blindly
 
 ```bash