@helix3/helix-cli 0.1.13-helix3.126 → 0.1.13-helix3.128

package/dist/index.js

@@ -1667,6 +1667,61 @@ function printMaterialHuman(material) {
         console.log(`  ${role}: ${url}`);
     }
 }
+// `helix assets publish <file>` — the verb that was missing.
+//
+// `POST /api/v1/vault/assets` has always accepted a plain file, but the only CLI
+// caller was `helix item-def publish`, which demands a weapon or emote
+// descriptor. So a finished .glb on disk could reach the Vault only by being
+// GENERATED through Dreamer or by being filed as a weapon it is not. This puts
+// the file in, and stops there: no descriptor, no product, no listing — those
+// stay separate decisions.
+assets
+    .command('publish')
+    .description('Publish a file you already have as a HELIX Vault asset')
+    .argument('<file>', 'the file to upload (.glb, .wav/.mp3/.ogg, .png/.jpg/.webp/.ktx2, .spz)')
+    .option('--kind <kind>', `Vault kind — inferred from the extension when omitted (${lib_1.VAULT_ASSET_KINDS.join(', ')})`)
+    .option('--title <text>', 'human title (default: the filename without its extension)')
+    .option('--description <text>', 'what this asset is')
+    .option('--tags <a,b>', 'comma-separated tags')
+    .option('--private', 'keep it out of Vault search — only you can reference it')
+    .option('--human', 'readable summary instead of JSON')
+    .action(async (file, opts) => {
+    const creds = requireAuth();
+    try {
+        const { publishVaultAsset } = await Promise.resolve().then(() => __importStar(require('./vaultPublish')));
+        const path = (0, node_path_1.resolve)(file);
+        if (!(0, node_fs_1.existsSync)(path))
+            fail(`✖ no such file: ${file}`);
+        const bytes = (0, node_fs_1.readFileSync)(path);
+        const result = await publishVaultAsset(lib_1.HelixApi.forCredentials(creds), {
+            bytes,
+            filename: (0, node_path_1.basename)(path),
+            ...(opts.kind !== undefined && { kind: opts.kind }),
+            ...(opts.title !== undefined && { title: opts.title }),
+            ...(opts.description !== undefined && { description: opts.description }),
+            ...(opts.tags !== undefined && { tags: opts.tags.split(',') }),
+            ...(opts.private === true && { visibility: 'private' }),
+        });
+        if (opts.human) {
+            console.log(`✔ ${result.assetId} v${result.artifact.version}`);
+            // A HELD publish gets no URL — the moderation gate is holding the
+            // bytes for a human, and saying so beats printing `null`.
+            if (result.visibility === 'held') {
+                console.log('  held for review — it serves once a human approves it');
+            }
+            else if (result.artifact.url) {
+                console.log(`  ${result.artifact.url}`);
+            }
+            console.log(`  reference it as: vault:${result.assetId}`);
+        }
+        else {
+            printJson(result);
+        }
+    }
+    catch (err) {
+        fail(`✖ ${err instanceof Error ? err.message : String(err)}`);
+    }
+});
 assets
     .command('materials')
     .description('Search the versioned HELIX material catalog')