@hypersoniclabs/helix-mcp 0.2.15 → 0.2.16-helix3.191

package/README.md

@@ -63,8 +63,8 @@ workflow), `read_doc({ name: "vehicles" })` the HELIX Vehicle Contract (the rule
 from-scratch builds; physics from real specs; audio; add-ons; publication; QA; a complete live
 reference package). New vehicle content follows the sealed Package workflow; the former vehicle
 Item-first MCP publisher routes are retired. `visual_qa_item` judges a candidate `packageVersion`. `item_thumbnail`
-re-renders (`action: "refresh"`, with `force` / `dryRun`) or replaces (`action: "set"`, `imagePath`) a
-published item's thumbnail in-process through the creator's own credentials.
+requests a server re-render of a published item's catalog thumbnail (with `force` / `dryRun`) and returns the
+preview URL. The catalog card is rendered by HELIX; creators cannot override it (add images to the item page instead).
 
 Avatar lifecycle: `get_started({ kind: "avatar" })` serves the `helix-avatars` skill. A generated avatar ("make me an
 avatar of this character, publish it privately") is ONE blocking call, `create_avatar`, which executes the bundled CLI:

package/dist/server.js

@@ -2474,33 +2474,38 @@ server.registerTool('delist_item', {
     label: 'Delist item',
     timeoutMs: 2 * VEHICLE_MIN,
 }));
+/** What creators are told whenever they try to override the catalog card. */
+const CATALOG_CARD_IS_PLATFORM_ONLY = 'Catalog thumbnails are rendered by HELIX; creators cannot override the catalog card. Add images to the item page instead.';
 server.registerTool('item_thumbnail', {
-    description: "Refresh or replace the thumbnail of an ALREADY-PUBLISHED item (avatar, wearable, add-on, vehicle, ...) you own — runs in-process, no CLI step. action=refresh re-renders the canonical thumbnail from the item's ACTIVE Package Version with the standard server renderer (use after a corrected Package Version, or when the thumbnail still shows an older mesh); pass dryRun first to see what would change without writing, and force to re-render when the server says it is already current. action=set uploads your own png/jpg/webp (imagePath) — moderated, and it is kept across version moves until a later refresh with force. To correct a Package-backed avatar mesh, seal a new Package Version and move the item onto it, then refresh here. A creator-owned item only (403 otherwise); an older backend answers 'does not support thumbnail refresh yet'. Not for worlds: use set_world_thumbnail.",
+    description: "Request a fresh server render of an ALREADY-PUBLISHED item's catalog thumbnail (avatar, wearable, add-on, vehicle, ...) you own, and get back the preview URL — runs in-process, no CLI step. The catalog card is rendered by HELIX with the standard renderer from the item's ACTIVE Package Version, with one fixed camera and lighting preset per item type; creators CANNOT upload or override it (action=set is gone and is refused). Use this after a corrected Package Version, or when the card still shows an older mesh; pass dryRun first to see what would change without writing, and force to re-render when the server says it is already current. To correct a Package-backed mesh, seal a new Package Version and move the item onto it, then request the render here. A creator-owned item only (403 otherwise); an older backend answers 'does not support thumbnail refresh yet'. Not for worlds: use set_world_thumbnail.",
     inputSchema: {
-        action: zod_1.z.enum(['refresh', 'set']).describe('refresh = server re-render from the active Package Version; set = upload your own image'),
+        action: zod_1.z
+            .enum(['refresh', 'set'])
+            .optional()
+            .describe('Default and only working action: refresh (server re-render). "set" is refused: creators cannot override the catalog card.'),
         itemId: zod_1.z.string().describe('Published universal item id (UUID) from the item detail page/API or an approved Creator publication receipt.'),
-        force: zod_1.z.boolean().optional().describe('refresh only: re-render even when the stored thumbnail is already current'),
-        dryRun: zod_1.z.boolean().optional().describe('refresh only: report what would change, write nothing'),
-        imagePath: zod_1.z.string().optional().describe('set only: absolute path to a png/jpg/jpeg/webp image (up to 10 MiB)'),
+        force: zod_1.z.boolean().optional().describe('Re-render even when the stored thumbnail is already current'),
+        dryRun: zod_1.z.boolean().optional().describe('Report what would change, write nothing'),
     },
-}, async ({ action, itemId, force, dryRun, imagePath }) => {
+}, async ({ action, itemId, force, dryRun }) => {
+    if (action === 'set')
+        return errText(`item_thumbnail action=set is not available. ${CATALOG_CARD_IS_PLATFORM_ONLY}`);
     const creds = (0, helix_cli_1.loadCredentials)();
     if (!creds)
         return errText('Not logged in. Ask the human to run: helix login');
-    if (action === 'set' && !imagePath)
-        return errText('item_thumbnail action=set needs imagePath (png/jpg/webp).');
-    if (action === 'set' && (force || dryRun))
-        return errText('force and dryRun apply to action=refresh only; set uploads exactly the image given.');
-    if (action === 'refresh' && imagePath)
-        return errText('imagePath applies to action=set only; refresh re-renders on the server.');
     try {
-        const result = action === 'set'
-            ? await (0, helix_cli_1.setItemThumbnail)(itemId, (0, node_path_1.resolve)(imagePath), creds)
-            : await (0, helix_cli_1.refreshItemThumbnail)(itemId, { force, dryRun }, creds);
-        return text([...(0, helix_cli_1.renderItemThumbnailResult)(result), '', JSON.stringify(result, null, 2)].join('\n'));
+        const result = await (0, helix_cli_1.refreshItemThumbnail)(itemId, { force, dryRun }, creds);
+        return text([
+            ...(0, helix_cli_1.renderItemThumbnailResult)(result),
+            '',
+            `Preview URL: ${result.thumbnailUrl ?? result.previousThumbnailUrl ?? '(none yet)'}`,
+            CATALOG_CARD_IS_PLATFORM_ONLY,
+            '',
+            JSON.stringify(result, null, 2),
+        ].join('\n'));
     }
     catch (err) {
-        return errText(`item_thumbnail ${action} failed: ${(0, helix_cli_1.describeThumbnailError)(err, itemId)}`);
+        return errText(`item_thumbnail refresh failed: ${(0, helix_cli_1.describeThumbnailError)(err, itemId)}`);
     }
 });
 const distributionLimit = zod_1.z