@assethub/cli 0.1.22 → 0.1.24

package/README.md

@@ -2,6 +2,31 @@
 
 Command line interface for AssetHub.
 
+## API discovery and Workspace Skills
+
+Use `api search [query]` to discover the authenticated server catalog and
+`api describe "METHOD /path"` to inspect an exact request contract. `api call`
+accepts `--path-json`, `--query-json`, and `--input-json` (inline JSON or `@file`).
+Mutations require an explicit stable `--operation-id <uuid>`. Preserve that UUID
+and exact inputs; inspect any returned run ID before retrying uncertain work.
+The server's workspace, gate, billing, and terminal-result rules still apply.
+
+`skills list|get|learn|update|controls|prepare|proposal|accept` uses the existing
+Workspace Skills API. Read `--help` for required revisions and JSON inputs.
+For V3.7 Artist Skills or V3.7.1 Building Modules, `production analyze` and new
+`parts split` analyses accept
+`--skill-mode auto|manual|off` and up to three distinct `--skill-id <id>` values.
+Manual selection requires IDs; off rejects them. The server resolves authorized
+published skill revisions and keeps Internal gates and actor checks in force.
+Existing `parts split --order-id` operations reject skill flags; use
+`runs resume` to recover the saved operation with its original selection.
+
+For complete-object graph models, add `--context <canvas-id> --context-version <n>`
+to `production analyze` to apply that exact saved Must/Avoid guidance. Both flags
+are required together; `--context` also selects the execution canvas and must
+match `--canvas` when supplied. Stale revisions and unsupported engines fail
+before generation. Guidance does not expand the model's supported part boundaries.
+
 ## Personal API keys
 
 Log in once with a personal key, then select its workspace:

package/dist/index.d.ts

@@ -1,8 +1,29 @@
 #!/usr/bin/env node
-import { type AnimationRetargetRequest, type Intervention, type RigRequest } from '@assethub/api-client';
+import { type AnimationRetargetRequest, type Intervention, type RigRequest, createAssetHubClient } 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 [--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 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 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>] [--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  --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 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";
+type ResolvedAuth = {
+    apiKey: string;
+    authentication?: 'personal';
+    workspaceId?: string;
+    baseUrl: string;
+    profile: string;
+    source: 'flag' | 'env' | 'profile';
+};
+type CommandContext = {
+    client: ReturnType<typeof createAssetHubClient>;
+    flags: Flags;
+    auth: ResolvedAuth;
+    /**
+     * The raw argument slice, kept alongside the parsed flags because `Flags` is
+     * keyed by flag name and so cannot say which of two different flags came
+     * first. `production intervene` needs that order: an intervention batch's seq
+     * order in the log is the operator's own order of decisions.
+     */
+    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 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 <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 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 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 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":";AA4BA,OAAO,EAIL,KAAK,wBAAwB,EAO7B,KAAK,YAAY,EAEjB,KAAK,UAAU,EAgBhB,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;AA2JxD,eAAO,MAAM,KAAK,s3aAkIjB,CAAA;AA4sFD;;;;;;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;AAgsCD,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":";AA4BA,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;AA4HD,eAAO,MAAM,KAAK,wvcA6IjB,CAAA;AAi/CD,eAAO,MAAM,aAAa,GACxB,YAAY,MAAM,GAAG,SAAS,EAC9B,aAAa,MAAM,EAAE,EACrB,KAAK,cAAc,KAClB,OAAO,CAAC,IAAI,CA6Hd,CAAA;AA41CD;;;;;;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"}

package/dist/index.js

@@ -15,7 +15,7 @@ import { basename, dirname, extname, join, resolve } from 'node:path';
 import { argv, env, exit, stdin, stderr, stdout } from 'node:process';
 import { fileURLToPath } from 'node:url';
 import { promisify } from 'node:util';
-import { AssetHubApiError, WorkspaceClientError, createWorkspaceClient, createAssetHubClient, } from '@assethub/api-client';
+import { AssetHubApiError, callApiOperation, describeApiOperation, discoverApiOperations, searchApiOperations, WorkspaceClientError, createWorkspaceClient, createAssetHubClient, } from '@assethub/api-client';
 import { resolveCanvasSelection, saveCanvasSelection } from './canvas.js';
 import { activeExecution, childOperationId, CliExecutionError, executeRecorded, hasRecordedOperation, openExecutionSession, resumeRecorded, waitForExecution, } from './execution.js';
 import { buildRunUploadPlan, formatBytes } from './runsUpload/buildRunUpload.js';
@@ -36,6 +36,8 @@ const artifactGraphPartExtractorApiValues = new Set([
     'ah_agent_graph_v3_6_4',
     'ah_agent_graph_v3_6_5',
     'ah_agent_graph_pluffy_v3_1',
+    'ah_agent_graph_v3_7',
+    'ah_agent_graph_v3_7_1',
 ]);
 const partExtractorOptions = [
     {
@@ -78,6 +80,16 @@ const partExtractorOptions = [
         apiValue: 'ah_agent_graph_pluffy_v3_1',
         aliases: ['pluffy', 'pluffy v3.1', 'pluffy 3.1'],
     },
+    {
+        publicName: 'V3.7 Artist Skills',
+        apiValue: 'ah_agent_graph_v3_7',
+        aliases: ['v3.7', '3.7'],
+    },
+    {
+        publicName: 'V3.7.1 Building Modules',
+        apiValue: 'ah_agent_graph_v3_7_1',
+        aliases: ['v3.7.1', '3.7.1'],
+    },
 ];
 const partExtractorPublicNames = partExtractorOptions
     .map(option => option.publicName)
@@ -135,9 +147,20 @@ Usage:
   assethub files upload <file> --media-type image|mesh
   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>]
   assethub capabilities
+  assethub api search [query]
+  assethub api describe "<METHOD /path>"
+  assethub api call "<METHOD /path>" [--path-json <json|@file>] [--query-json <json|@file>] [--input-json <json|@file|@->] [--operation-id <uuid>]
+  assethub skills list [--cursor <cursor>]
+  assethub skills get <skill-id> [--revision <n>]
+  assethub skills learn --input-json <json|@file|@-> --operation-id <uuid>
+  assethub skills update <skill-id> --input-json <json|@file|@->
+  assethub skills controls <skill-id> --revision <n> --grant-revision <n> --mode automatic|manual|off [--share]
+  assethub skills prepare --input-json <json|@file|@->
+  assethub skills proposal <proposal-id>
+  assethub skills accept <proposal-id> --input-json <json|@file|@->
   assethub composer models
   assethub composer refine --list-modes
-  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>]
+  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>]
   assethub composer refine --input-json <json|@file> [--canvas <id>] [--operation-id <uuid>] [--wait] [--download --out-dir <dir>]
   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]
   assethub composer run --input-json <json|@file> [--canvas <id>] [--operation-id <uuid>] [--wait] [--download --out-dir <dir>]
@@ -172,7 +195,7 @@ Usage:
   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>]
   assethub jobs get <job-id> [--download --out-dir <dir>]
   assethub jobs watch <job-id> [--interval-ms <ms>] [--timeout-ms <ms>] [--download --out-dir <dir>]
-  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>]
+  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>]
   assethub production agents
   assethub production automation --input-json <json|@file|@-> [--canvas <id>] [--operation-id <uuid>] [--wait]
   assethub production status <order-id> [--wait] [--download --out-dir <dir>]
@@ -182,7 +205,7 @@ Usage:
   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>
   assethub runs upload <path> [--graph-id <id>] [--stream-id <id>] [--rev <n>] [--description <text>] [--tag <tag>...] [--skip-register] [--dry-run]
-  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>]
+  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>]
   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>]
   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>]
 
@@ -313,6 +336,30 @@ const resolvePartExtractorApiValue = (value) => {
     return option.apiValue;
 };
 const resolvePartExtractorForAnalyze = (flags) => resolvePartExtractorApiValue(getPartExtractorFlag(flags) ?? defaultPartExtractorName);
+const resolveProductionSkillSelection = (flags, agentVersion) => {
+    const mode = getFlag(flags, 'skill-mode');
+    const skillIds = getFlagValues(flags, 'skill-id').map(value => assertFlagHasValue(value, '--skill-id <id>'));
+    if (mode == null) {
+        if (skillIds.length > 0)
+            throw new Error('--skill-id requires --skill-mode');
+        return undefined;
+    }
+    if (mode !== 'auto' && mode !== 'manual' && mode !== 'off')
+        throw new Error('--skill-mode must be "auto", "manual", or "off"');
+    if (!['ah_agent_graph_v3_7', 'ah_agent_graph_v3_7_1'].includes(agentVersion))
+        throw new Error('--skill-mode requires V3.7 Artist Skills or V3.7.1 Building Modules');
+    if (skillIds.length > 3)
+        throw new Error('--skill-id accepts at most 3 values');
+    if (new Set(skillIds).size !== skillIds.length)
+        throw new Error('--skill-id values must be unique');
+    if (skillIds.some(skillId => !/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/.test(skillId)))
+        throw new Error('--skill-id contains an invalid workspace skill ID');
+    if (mode === 'manual' && skillIds.length === 0)
+        throw new Error('--skill-mode manual requires at least one --skill-id');
+    if (mode === 'off' && skillIds.length > 0)
+        throw new Error('--skill-mode off does not accept --skill-id');
+    return { mode, skillIds };
+};
 const publicPartExtractorName = (value) => {
     if (value == null) {
         return null;
@@ -1275,6 +1322,112 @@ const commandSource = async (subcommand, ctx) => {
     }
     print({ source, fileRef: source.fileRef, mediaType });
 };
+const commandApi = async (subcommand, positionals, ctx) => {
+    if (!['search', 'describe', 'call'].includes(subcommand ?? ''))
+        throw new Error('Use api search|describe|call. Mutations require --operation-id.');
+    const discovery = await discoverApiOperations(ctx.client);
+    if (subcommand === 'search') {
+        print({
+            operations: searchApiOperations(discovery.catalog, positionals.slice(2).join(' ')),
+        });
+        return;
+    }
+    const operation = requirePositional(positionals, 2, 'operation');
+    if (subcommand === 'describe') {
+        const found = discovery.catalog.get(operation);
+        if (!found)
+            throw new Error('Unknown operation. Use api search first.');
+        print(describeApiOperation(found, discovery.specs[found.path.startsWith('/api/v1/') ? 'v1' : 'v2']));
+        return;
+    }
+    const pathJson = getFlag(ctx.flags, 'path-json');
+    const queryJson = getFlag(ctx.flags, 'query-json');
+    const bodyJson = getFlag(ctx.flags, 'input-json');
+    const operationId = getFlag(ctx.flags, 'operation-id');
+    activeExecution.operationId = operationId;
+    try {
+        print(await callApiOperation(ctx.client, discovery, {
+            operation,
+            operationId,
+            path: pathJson
+                ? (await readJsonArgument(pathJson, '--path-json'))
+                : undefined,
+            query: queryJson
+                ? (await readJsonArgument(queryJson, '--query-json'))
+                : undefined,
+            body: bodyJson
+                ? await readJsonArgument(bodyJson, '--input-json')
+                : undefined,
+        }));
+    }
+    catch (error) {
+        if (error instanceof AssetHubApiError && error.runId)
+            activeExecution.runId = error.runId;
+        throw error;
+    }
+};
+export const commandSkills = async (subcommand, positionals, ctx) => {
+    if (subcommand === 'list') {
+        print(await ctx.client.v2.listWorkspaceSkills({
+            cursor: getFlag(ctx.flags, 'cursor'),
+        }));
+        return;
+    }
+    if (subcommand === 'get') {
+        print(await ctx.client.v2.getWorkspaceSkill(requirePositional(positionals, 2, 'skill-id'), {
+            revision: hasFlag(ctx.flags, 'revision')
+                ? parsePositiveIntegerFlag(ctx.flags, 'revision', 1)
+                : undefined,
+        }));
+        return;
+    }
+    if (subcommand === 'controls') {
+        const mode = parseEnumFlag(ctx.flags, 'mode', [
+            'automatic',
+            'manual',
+            'off',
+        ]);
+        if (!mode)
+            throw new Error('Missing required flag: --mode');
+        requireFlag(ctx.flags, 'revision');
+        requireFlag(ctx.flags, 'grant-revision');
+        print(await ctx.client.v2.setWorkspaceSkillControls(requirePositional(positionals, 2, 'skill-id'), {
+            expectedRevision: parsePositiveIntegerFlag(ctx.flags, 'revision', 1),
+            expectedGrantRevision: parsePositiveIntegerFlag(ctx.flags, 'grant-revision', 1),
+            mode,
+            ...(hasFlag(ctx.flags, 'share') ? { share: true } : {}),
+        }));
+        return;
+    }
+    if (subcommand === 'proposal') {
+        print(await ctx.client.v2.getWorkspaceSkillProposal(requirePositional(positionals, 2, 'proposal-id')));
+        return;
+    }
+    if (['learn', 'prepare'].includes(subcommand ?? '')) {
+        const input = await readJsonArgument(requireFlag(ctx.flags, 'input-json'), '--input-json');
+        const operationId = subcommand === 'learn'
+            ? requireFlag(ctx.flags, 'operation-id')
+            : undefined;
+        if (operationId != null &&
+            !/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(operationId))
+            throw new Error('--operation-id must be a UUID; reuse the same ID and input after an uncertain response');
+        if (operationId != null)
+            activeExecution.operationId = operationId;
+        print(subcommand === 'learn'
+            ? await ctx.client.v2.learnWorkspaceSkill(input, { idempotencyKey: operationId })
+            : await ctx.client.v2.prepareWorkspaceSkillProposal(input));
+        return;
+    }
+    if (['update', 'accept'].includes(subcommand ?? '')) {
+        const id = requirePositional(positionals, 2, subcommand === 'update' ? 'skill-id' : 'proposal-id');
+        const input = await readJsonArgument(requireFlag(ctx.flags, 'input-json'), '--input-json');
+        print(subcommand === 'update'
+            ? await ctx.client.v2.updateWorkspaceSkill(id, input)
+            : await ctx.client.v2.acceptWorkspaceSkillProposal(id, input));
+        return;
+    }
+    throw new Error('Use skills list|get|learn|update|controls|prepare|proposal|accept');
+};
 const commandModels = async (subcommand, positionals, ctx) => {
     if (subcommand === 'list') {
         const domain = getFlag(ctx.flags, 'domain');
@@ -1966,6 +2119,7 @@ const meshRefinementModes = [
     'placement',
     'workshop',
     'blender',
+    'codex',
 ];
 const refinementTransforms = (value, flag) => {
     if (value == null || typeof value !== 'object' || Array.isArray(value))
@@ -1997,6 +2151,10 @@ const refinementModeInfo = (capabilities, mode) => {
         throw new Error(`Refinement mode ${mode} is unavailable${info.reason ? `: ${info.reason}` : ''}`);
     return info;
 };
+const refinementContinuationFields = [
+    'geometryBackend', 'referenceMode', 'calibration', 'referenceViews',
+    'geometrySources', 'reviewContext', 'background',
+];
 /** Reuse the frozen sources and latest editable scene, never replay server-only receipt fields. */
 const composerInputFromRun = (previous, operation) => {
     const source = previous.resolvedInput ?? previous.input ?? previous.requestedInput ?? {};
@@ -2012,7 +2170,14 @@ const composerInputFromRun = (previous, operation) => {
             'quickRunId',
             'quickScene',
         ]
-        : ['fullBodyImageAssetId', 'agentRuntime', 'mode', 'instruction', 'maxRounds'];
+        : [
+            'fullBodyImageAssetId',
+            'agentRuntime',
+            'mode',
+            'instruction',
+            'maxRounds',
+            ...refinementContinuationFields,
+        ];
     const input = Object.fromEntries(fields
         .filter(key => source[key] !== undefined)
         .map(key => [key, source[key]]));
@@ -2036,6 +2201,13 @@ const composerInputFromRun = (previous, operation) => {
     if (transforms != null)
         input.transforms = transforms;
     if (operation === 'mesh.refine') {
+        for (const key of ['calibration', 'referenceViews', 'geometrySources']) {
+            if (previous.refinement?.[key] != null)
+                input[key] = previous.refinement[key];
+        }
+        const reviewContext = previous.refinement?.report?.reviewContext;
+        if (reviewContext != null)
+            input.reviewContext = reviewContext;
         const referenceTransform = previous.composition?.referenceTransform ?? source.referenceTransform;
         if (referenceTransform != null)
             input.referenceTransform = referenceTransform;
@@ -2097,6 +2269,8 @@ const commandComposerRefine = async (ctx) => {
         capabilities.defaultMode;
     if (!meshRefinementModes.includes(mode))
         throw new Error(`--mode must be one of: ${meshRefinementModes.join(', ')}`);
+    if (mode !== 'codex' && (input.geometryBackend || input.referenceMode === 'all_angles' || input.background))
+        throw new Error('Saved Blender-backend, all-angle or background settings require codex mode; use --input-json with settings matching the new mode');
     const modeInfo = refinementModeInfo(capabilities, mode);
     const maxRoundsFlag = getFlag(ctx.flags, 'max-rounds');
     const inputMaxRounds = input.maxRounds;
@@ -2129,6 +2303,9 @@ const commandComposerRefine = async (ctx) => {
         operation: 'mesh.refine',
     });
     const body = {
+        ...Object.fromEntries(refinementContinuationFields
+            .filter(key => input[key] !== undefined)
+            .map(key => [key, input[key]])),
         parts: refinementParts,
         fullBodyImageAssetId: input.fullBodyImageAssetId,
         transforms,
@@ -2893,9 +3070,9 @@ const readOpsJsonFlag = async (flags) => {
     }
     return parsed;
 };
-const productionSession = (ctx, operation) => openExecutionSession({
+const productionSession = (ctx, operation, canvasId = selectedCanvasId(ctx.flags)) => openExecutionSession({
     ...stateOptions(ctx),
-    canvasId: selectedCanvasId(ctx.flags),
+    canvasId,
     operation,
 });
 const commandProduction = async (subcommand, positionals, ctx) => {
@@ -2904,11 +3081,28 @@ const commandProduction = async (subcommand, positionals, ctx) => {
         return;
     }
     if (subcommand === 'analyze') {
-        const session = await productionSession(ctx, 'production.analyze');
+        const agentVersion = resolvePartExtractorForAnalyze(ctx.flags);
+        const skillSelection = resolveProductionSkillSelection(ctx.flags, agentVersion);
+        const projectContext = hasFlag(ctx.flags, 'context') || hasFlag(ctx.flags, 'context-version')
+            ? {
+                canvasId: Number(requireFlag(ctx.flags, 'context')),
+                version: Number(requireFlag(ctx.flags, 'context-version')),
+            }
+            : undefined;
+        if (projectContext) {
+            if (Object.values(projectContext).some(value => !Number.isSafeInteger(value) || value <= 0))
+                throw new Error('--context and --context-version must be positive integers');
+            const canvasId = selectedCanvasId(ctx.flags);
+            if (canvasId != null && canvasId !== projectContext.canvasId)
+                throw new Error('--context must match --canvas');
+        }
+        const session = await productionSession(ctx, 'production.analyze', projectContext?.canvasId);
         const analyzed = await executeRecorded(session, 'production.analyze', {
             ...(await resolveProductionAnalyzeSource(ctx)),
-            agentVersion: resolvePartExtractorForAnalyze(ctx.flags),
+            agentVersion,
             name: getFlag(ctx.flags, 'name'),
+            ...(skillSelection == null ? {} : { skillSelection }),
+            ...(projectContext == null ? {} : { projectContext }),
         }, executionOptions(ctx.flags));
         await printRecorded(ctx, analyzed);
         return;
@@ -3091,11 +3285,16 @@ const commandParts = async (subcommand, ctx) => {
         let orderId = source == null ? getFlag(ctx.flags, 'order-id') : undefined;
         if (orderId != null) {
             orderId = assertFlagHasValue(orderId, '--order-id <id>');
+            if (hasFlag(ctx.flags, 'skill-mode') || hasFlag(ctx.flags, 'skill-id'))
+                throw new Error('--skill-mode and --skill-id cannot be changed with --order-id; use runs resume to preserve the saved selection');
         }
         const partExtractorFlag = getPartExtractorFlag(ctx.flags);
         const requestedAgentVersion = orderId == null || partExtractorFlag != null
             ? resolvePartExtractorApiValue(partExtractorFlag ?? defaultPartExtractorName)
             : undefined;
+        const skillSelection = requestedAgentVersion == null
+            ? undefined
+            : resolveProductionSkillSelection(ctx.flags, requestedAgentVersion);
         if (requestedAgentVersion != null &&
             artifactGraphPartExtractorApiValues.has(requestedAgentVersion)) {
             const publicName = publicPartExtractorName(requestedAgentVersion);
@@ -3115,6 +3314,7 @@ const commandParts = async (subcommand, ctx) => {
                 ...(source ?? (await resolveProductionAnalyzeSource(ctx))),
                 agentVersion: resolvePartExtractorForAnalyze(ctx.flags),
                 name: getFlag(ctx.flags, 'name'),
+                ...(skillSelection == null ? {} : { skillSelection }),
             }, { ...executionOptions(ctx.flags), operationId });
             analyzed = result;
             execution = result.execution;
@@ -3930,6 +4130,12 @@ const run = async () => {
     }
     const ctx = await createContext(parsed.flags, argv.slice(2));
     switch (command) {
+        case 'api':
+            await commandApi(subcommand, parsed.positionals, ctx);
+            return;
+        case 'skills':
+            await commandSkills(subcommand, parsed.positionals, ctx);
+            return;
         case 'composer':
             await commandComposer(subcommand, ctx);
             return;

package/package.json

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