tripo-cli 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.8.1
+
+- Add `tripo models`: lists the model ids each capability accepts (3D generation, text-to-image, image-to-image, texture, rig, segment, decimate) with defaults and CLI aliases. It reads the local whitelist, makes no API call and is excluded from analytics like `docs`/`config`. `--json` prints one JSON line.
+
 ## 0.8.0
 
 - Preflight every deterministic `make` chain request before uploads or generation. Normal runs and dry runs use the same validation; direct `executeMake` validates before balance/generation calls. Runtime source-dependent checks remain in place.

package/README.md

@@ -36,6 +36,7 @@ Works with both Tripo regions from the same install — international (`openapi.
 | `tripo redo [task]` | re-run with a fresh seed |
 | `tripo login / logout / whoami / use` | device flow: browser approves, key arrives automatically (paste fallback); stored 0600 in `~/.tripo/config.json`; `use` switches accounts |
 | `tripo topup / balance / usage` | open the billing page + detect the credits arriving; check spend |
+| `tripo models` | list the model ids each capability accepts, with defaults and aliases (local whitelist, no API call) |
 | `tripo generate <endpoint>` | deterministic access to all 8 generation endpoints |
 | `tripo model / anim / mesh <step>` | texture, convert, import, rig-check, rig, retarget, segment, complete, decimate, uv, smartsegment |
 | `tripo task get/list/watch` | query tasks and wait for them (progress on stderr) |

package/dist/commands/completion.js

@@ -2,7 +2,7 @@
 import { UsageError } from '../core/errors.js';
 import { isMeshEditEnabled } from '../knowledge/chains.js';
 const COMMANDS = [
-    'login', 'logout', 'whoami', 'use', 'balance', 'usage', 'topup',
+    'login', 'logout', 'whoami', 'use', 'balance', 'usage', 'models', 'topup',
     'make', 'view', 'redo', 'ai',
     'generate', 'model', 'anim', 'mesh', 'task', 'files', 'batch', 'history',
     'config', 'doctor', 'update', 'docs', 'completion', 'mcp',

package/dist/commands/models.js

@@ -0,0 +1,47 @@
+/** `tripo models` — list the model ids each capability accepts (local whitelist, no API call). */
+import { emitResult } from '../core/output.js';
+import { CAPABILITY_DEFAULTS, DECIMATE_MODELS, IMAGE_TO_IMAGE_MODELS, LEGACY_3D_MODELS, MODEL_ALIASES, MODEL_P1, MODEL_P2, MODEL_V31, RIG_MODEL_ALIASES, RIG_MODEL_V1, RIG_MODEL_V25, RIG_MODEL_V30, SEGMENT_MODELS, TEXTURE_MODELS, TEXT_TO_IMAGE_MODELS, } from '../knowledge/models.js';
+/** Wire ids with the CLI aliases that normalize to each of them. */
+function withAliases(ids, aliases) {
+    return ids.map((id) => {
+        const names = Object.keys(aliases).filter((alias) => aliases[alias] === id && alias !== id);
+        return names.length ? { id, aliases: names } : { id };
+    });
+}
+function plain(ids) {
+    return ids.map((id) => ({ id }));
+}
+export function listModels() {
+    return [
+        {
+            capability: '3d-generation (text/image/multiview-to-model)',
+            default: MODEL_V31,
+            models: withAliases([MODEL_V31, MODEL_P2, MODEL_P1, ...LEGACY_3D_MODELS], MODEL_ALIASES),
+        },
+        { capability: 'text-to-image', default: CAPABILITY_DEFAULTS.textToImage, models: plain(TEXT_TO_IMAGE_MODELS) },
+        { capability: 'image-to-image', default: CAPABILITY_DEFAULTS.imageToImage, models: plain(IMAGE_TO_IMAGE_MODELS) },
+        { capability: 'texture (model texture)', default: CAPABILITY_DEFAULTS.texture, models: plain(TEXTURE_MODELS) },
+        {
+            capability: 'rig (anim rig)',
+            default: CAPABILITY_DEFAULTS.rig,
+            models: withAliases([RIG_MODEL_V1, RIG_MODEL_V25, RIG_MODEL_V30], RIG_MODEL_ALIASES),
+        },
+        { capability: 'segment (mesh segment)', default: CAPABILITY_DEFAULTS.segment, models: plain(SEGMENT_MODELS) },
+        { capability: 'decimate (mesh decimate)', default: 'v2.0', models: plain(DECIMATE_MODELS) },
+    ];
+}
+export function registerModelsCommand(program) {
+    program
+        .command('models')
+        .description('list the model ids each capability accepts (local whitelist, no API call)')
+        .action(() => {
+        const data = listModels();
+        const human = data
+            .map((c) => [
+            `${c.capability}  (default: ${c.default})`,
+            ...c.models.map((m) => `  ${m.id}${m.aliases ? `  (aliases: ${m.aliases.join(', ')})` : ''}`),
+        ].join('\n'))
+            .join('\n\n');
+        emitResult(data, human);
+    });
+}

package/dist/program.js

@@ -13,6 +13,7 @@ import { registerGenerateCommands } from './commands/generate.js';
 import { registerHomeAction } from './commands/home.js';
 import { registerMakeCommand } from './commands/make.js';
 import { registerMcpCommand } from './commands/mcp.js';
+import { registerModelsCommand } from './commands/models.js';
 import { registerProcessCommands } from './commands/process-groups.js';
 import { registerTaskCommands } from './commands/task.js';
 import { registerTopupCommand } from './commands/topup.js';
@@ -52,7 +53,7 @@ export function buildProgram() {
         const path = [];
         for (let command = actionCommand; command && command !== program; command = command.parent)
             path.unshift(command.name());
-        const excluded = ['mcp', 'docs', 'completion', 'config', 'update', 'use', 'logout', 'home'];
+        const excluded = ['mcp', 'docs', 'completion', 'config', 'update', 'use', 'logout', 'home', 'models'];
         if (actionCommand.name() !== 'mcp')
             beginOperation(path.join(':'), path.length === 0 || excluded.includes(path[0]) || actionCommand.opts().dryRun === true, undefined, actionCommand.opts().region === 'cn' || actionCommand.opts().region === 'ov' ? actionCommand.opts().region : undefined);
         // Startup version hint (cached, non-blocking). `update` reports on its
@@ -67,6 +68,7 @@ export function buildProgram() {
     registerAuthCommands(program);
     registerTopupCommand(program);
     registerAccountCommands(program);
+    registerModelsCommand(program);
     registerGenerateCommands(program);
     registerProcessCommands(program);
     registerTaskCommands(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tripo-cli",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Tripo 3D intelligent CLI — turn a prompt or an image into engine-ready 3D assets from your terminal (Tripo V3 API)",
   "keywords": [
     "tripo",

package/skill/SKILL.md

@@ -5,7 +5,7 @@ description: Generate and process 3D models with the Tripo API through the tripo
 
 # Tripo CLI Skill
 
-**Bundled with tripo-cli 0.8.0.**
+**Bundled with tripo-cli 0.8.1.**
 
 - Display aliases `H3.1`, `H3.0`, `H2.5`, `P1.0`, `P2.0` (case-insensitive) normalize before validation; unknown 3D/image model IDs fail locally.
 - `make` validates deterministic later steps before uploading or generating.
@@ -113,6 +113,7 @@ If an upstream command fails or prints no task, the downstream submits nothing a
 | --- | --- |
 | `tripo task get/watch <id> --download` | inspect / block on / download an existing task |
 | `tripo balance` / `tripo usage` | credits: `{"balance","frozen"}` / recent spend |
+| `tripo models` | accepted model ids per capability, defaults and aliases (local, no API call) |
 | `tripo redo [@last]` | same request, new seed |
 | `tripo view [@last]` | (humans) open a local 3D preview; agents read `preview.png` instead |
 | `tripo files upload <path>` | get a `file_token` |