@melius-ai/cli 0.7.0 → 0.8.0

package/README.md

@@ -269,6 +269,8 @@ Requires the Pro or Enterprise plan.
 
 Scope to a **folder** with `--folder-id` (from `mel asset folders`): with a query it filters within that folder and its subfolders; **omit the query** to bring in the _whole_ folder (every asset in it). `mel asset folders` returns each folder's root-relative `path` (e.g. `Brand / Logos`) to disambiguate same-named folders.
 
+Filter by **tag** with `--tags <names>` (comma-separated, case-insensitive): assets carrying **all** the named tags (AND). Combine with a query, or use `--tags` alone (or with `--folder-id`) to bring in every asset carrying them. An unknown tag name matches nothing.
+
 `mel asset place` creates a file node per asset (writes to CRDT, no re-upload) and returns `{ placed: [{ assetId, nodeId, mediaType }] }`. Wire the returned `nodeId`s into generations with `mel edge create`. This is the correct way to reuse an existing library asset — do **not** re-upload it.
 
 ```bash
@@ -280,6 +282,10 @@ mel asset place <canvasId> <assetId1> <assetId2>
 mel asset folders                                   # → [{ id, name, path, fileCount }]
 mel asset search --folder-id <folderId>             # every asset in the folder
 mel asset search "shark" --folder-id <folderId>     # or filter within it
+
+# Filter by tag (AND across tags)
+mel asset search "logo" --tags brand                # tagged 'brand'
+mel asset search --tags brand,hero                  # every asset with BOTH tags
 ```
 
 ### Shell completion

package/dist/bin/mel.js

@@ -7,7 +7,7 @@ import {
   printUpgradeNoticeIfNeeded,
   withDefaultHelp,
   writeError
-} from "../chunk-5QT6WMID.js";
+} from "../chunk-3PBGQVUH.js";
 
 // bin/mel.ts
 var program = createProgram();

package/dist/{chunk-5QT6WMID.js → chunk-3PBGQVUH.js}

@@ -7911,6 +7911,24 @@ var FileTypeSchema = external_exports.enum([
   "pdf",
   "text"
 ]);
+var AssetShareModeSchema = external_exports.enum(["team", "anyone"]);
+var TAG_COLOR_PALETTE = [
+  "hsl(189deg, 72%, 46%)",
+  "hsl(280deg, 60%, 50%)",
+  "hsl(24deg, 76%, 46%)",
+  "hsl(142deg, 58%, 40%)",
+  "hsl(330deg, 64%, 46%)",
+  "hsl(45deg, 68%, 42%)",
+  "hsl(210deg, 66%, 44%)",
+  "hsl(168deg, 55%, 38%)"
+];
+var TagColorSchema = external_exports.enum(TAG_COLOR_PALETTE);
+var MAX_ASSET_TAG_NAME_LENGTH = 100;
+var FileTagSchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  name: external_exports.string(),
+  color: external_exports.string()
+});
 var FileCanvasBacklinkSchema = external_exports.object({
   canvasId: external_exports.string().uuid(),
   projectId: external_exports.string().uuid(),
@@ -7939,6 +7957,9 @@ var FileCardSchema = external_exports.object({
    * The "Open canvas" CTA opens the first directly, or — when there is more
    * than one — prompts the user to pick which to open. */
   canvases: external_exports.array(FileCanvasBacklinkSchema),
+  // The tags assigned to this file (unordered). Always present — empty when
+  // untagged — so the grid can render chips without a per-card fetch.
+  tags: external_exports.array(FileTagSchema),
   // The canvas node whose currently-active version produced this generated
   // asset. The Files grid shows only active-version outputs, so each
   // generated card maps to exactly one such node; this lets the viewer load
@@ -8049,6 +8070,13 @@ var ListFilesQuerySchema = external_exports.object({
   createdByUserId: external_exports.string().uuid().optional(),
   sort: FileSortSchema.default("created_desc"),
   folderId: external_exports.union([external_exports.string().uuid(), external_exports.literal("root")]).optional(),
+  // Filter to files carrying ALL of these tag ids (AND — narrows the set).
+  // Comma-separated in the query string (e.g. `?tagIds=<id1>,<id2>`) because
+  // this GET has no array-query support; absent means no tag filter. Each id
+  // is validated as a uuid after splitting.
+  tagIds: external_exports.string().optional().transform(
+    (value) => value ? value.split(",").map((id) => id.trim()).filter(Boolean) : void 0
+  ).pipe(external_exports.array(external_exports.string().uuid()).optional()),
   // The "Hidden" view: lists files hidden from Files (across all folders)
   // instead of the normal visible listing. Coerced from the query string so
   // `?hidden=true` works; absent / "false" both resolve to `false`.
@@ -8083,6 +8111,17 @@ var ListFilesResponseSchema = external_exports.object({
   cursor: external_exports.string().nullable().optional(),
   hasMore: external_exports.boolean().optional()
 });
+var FileTabCountsQuerySchema = external_exports.object({
+  q: external_exports.string().optional(),
+  folderId: external_exports.union([external_exports.string().uuid(), external_exports.literal("root")]).optional()
+});
+var FileTabCountsResponseSchema = external_exports.object({
+  // "All assets" — always uploads + generations (a file is one or the other).
+  all: external_exports.number().int(),
+  uploads: external_exports.number().int(),
+  generations: external_exports.number().int(),
+  favorites: external_exports.number().int()
+});
 var AGENT_ASSET_SEARCH_PAGE_SIZE = 20;
 var AgentAssetSearchQuerySchema = external_exports.object({
   query: external_exports.string().trim().min(1).max(500).optional().describe(
@@ -8097,6 +8136,9 @@ var AgentAssetSearchQuerySchema = external_exports.object({
   folderId: external_exports.string().uuid().optional().describe(
     'Optional. Scope to one Files folder AND its subfolders. Omit to search the whole team library \u2014 the default, and what nearly every request wants. Set it when the member names a specific folder \u2014 either to FILTER within it (pass `folderId` + `query`, e.g. "find the shark shot in my ocean folder") or to bring in EVERYTHING in it (pass `folderId` and OMIT `query`, e.g. "add all my assets from the ocean folder"). Resolve the id with list_asset_folders (match by name; if several plausibly match, ask which one); never guess a folder id.'
   ),
+  tags: external_exports.string().trim().optional().describe(
+    'Optional. Filter to assets carrying ALL of these tags (AND). Pass a tag name ONLY when the member explicitly asks to filter by a tag (e.g. "find my assets tagged brand", "my hero tag") \u2014 never infer one from ordinary words in their request. Comma-separated (e.g. "brand" or "brand,hero"), case-insensitive. Combine with `query` to search within tagged assets, or omit `query` (with tags and/or a folderId) to bring in every asset carrying them. An unknown or misspelled tag name matches nothing, so pass only tags the member actually named.'
+  ),
   showInThread: external_exports.boolean().optional().describe(
     'Slack only. Set true when the member only wants to SEE the matched asset(s) \u2014 "find X and show it to me", "do I have Y?" \u2014 and is NOT asking to place, edit, or build on them. Skips the selection card and posts every match straight into the Slack thread as image files. Leave unset (the default) whenever the member wants to USE an asset on the canvas, so the selection card renders and a canvas gets bound.'
   )
@@ -8125,7 +8167,10 @@ var AgentAssetSearchResponseSchema = external_exports.object({
   folderId: external_exports.string().uuid().optional(),
   canvasId: external_exports.string().uuid().optional(),
   source: FileSourceSchema.optional(),
-  fileType: FileTypeSchema.optional()
+  fileType: FileTypeSchema.optional(),
+  // Echoed comma-separated tag filter, so the picker's "More results" re-pages
+  // with the same tags.
+  tags: external_exports.string().optional()
 });
 var AgentListAssetFoldersQuerySchema = external_exports.object({});
 var AgentAssetFolderSchema = external_exports.object({
@@ -8169,6 +8214,46 @@ var EmbeddingStorageUsageResponseSchema = external_exports.object({
   usedBytes: external_exports.number(),
   limitBytes: external_exports.number()
 });
+var AssetTagResponseSchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  teamId: external_exports.string().uuid(),
+  name: external_exports.string(),
+  color: external_exports.string(),
+  createdByUserId: external_exports.string().uuid().nullable(),
+  createdByName: external_exports.string().nullable(),
+  createdAt: external_exports.string().datetime(),
+  updatedAt: external_exports.string().datetime(),
+  // How many of the team's assets carry this tag. Present in listAssetTags;
+  // omitted on single-tag create/update responses (which don't recount).
+  assetCount: external_exports.number().int().nonnegative().optional()
+});
+var AssetTagListResponseSchema = external_exports.object({
+  data: external_exports.array(AssetTagResponseSchema)
+});
+var AssetTagIdParamsSchema = external_exports.object({
+  tagId: external_exports.string().uuid()
+});
+var FileAssetTagParamsSchema = external_exports.object({
+  assetId: external_exports.string().uuid(),
+  tagId: external_exports.string().uuid()
+});
+var CreateAssetTagBodySchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(MAX_ASSET_TAG_NAME_LENGTH),
+  color: TagColorSchema
+});
+var UpdateAssetTagBodySchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(MAX_ASSET_TAG_NAME_LENGTH).optional(),
+  color: TagColorSchema.optional()
+}).refine((body) => body.name !== void 0 || body.color !== void 0, {
+  message: "Provide a name or color to update"
+});
+var AssetTagAssignmentBodySchema = external_exports.object({
+  tagId: external_exports.string().uuid()
+});
+var BulkAssetTagBodySchema = external_exports.object({
+  assetIds: BulkFileAssetIdsSchema,
+  tagId: external_exports.string().uuid()
+});
 var ErrorBodySchema = MessageResponseSchema;
 var filesContract = c2.router({
   createFileFolder: {
@@ -8215,6 +8300,97 @@ var filesContract = c2.router({
     },
     summary: "Delete a Files folder"
   },
+  listAssetTags: {
+    method: "GET",
+    path: "/files/tags",
+    responses: {
+      200: AssetTagListResponseSchema,
+      403: ErrorBodySchema
+    },
+    summary: "List team asset tags"
+  },
+  createAssetTag: {
+    method: "POST",
+    path: "/files/tags",
+    body: CreateAssetTagBodySchema,
+    responses: {
+      201: AssetTagResponseSchema,
+      403: ErrorBodySchema,
+      409: ErrorBodySchema
+    },
+    summary: "Create an asset tag"
+  },
+  updateAssetTag: {
+    method: "PATCH",
+    path: "/files/tags/:tagId",
+    pathParams: AssetTagIdParamsSchema,
+    body: UpdateAssetTagBodySchema,
+    responses: {
+      200: AssetTagResponseSchema,
+      403: ErrorBodySchema,
+      404: ErrorBodySchema,
+      409: ErrorBodySchema
+    },
+    summary: "Rename or recolor an asset tag"
+  },
+  deleteAssetTag: {
+    method: "DELETE",
+    path: "/files/tags/:tagId",
+    pathParams: AssetTagIdParamsSchema,
+    body: null,
+    responses: {
+      204: c2.noBody(),
+      403: ErrorBodySchema,
+      404: ErrorBodySchema
+    },
+    summary: "Delete an asset tag"
+  },
+  addAssetTag: {
+    method: "POST",
+    path: "/files/:assetId/tags",
+    pathParams: FileAssetIdParamsSchema,
+    body: AssetTagAssignmentBodySchema,
+    responses: {
+      200: FileCardSchema,
+      403: ErrorBodySchema,
+      404: ErrorBodySchema
+    },
+    summary: "Add a tag to a file"
+  },
+  removeAssetTag: {
+    method: "DELETE",
+    path: "/files/:assetId/tags/:tagId",
+    pathParams: FileAssetTagParamsSchema,
+    body: null,
+    responses: {
+      200: FileCardSchema,
+      403: ErrorBodySchema,
+      404: ErrorBodySchema
+    },
+    summary: "Remove a tag from a file"
+  },
+  bulkAddAssetTag: {
+    method: "POST",
+    path: "/files/bulk/tag",
+    body: BulkAssetTagBodySchema,
+    responses: {
+      200: BulkFileActionResponseSchema,
+      403: ErrorBodySchema,
+      404: ErrorBodySchema
+    },
+    summary: "Add a tag to files"
+  },
+  bulkRemoveAssetTag: {
+    method: "POST",
+    path: "/files/bulk/untag",
+    body: BulkAssetTagBodySchema,
+    responses: {
+      200: BulkFileActionResponseSchema,
+      403: ErrorBodySchema,
+      404: ErrorBodySchema
+    },
+    summary: "Remove a tag from files"
+  },
   bulkMoveFiles: {
     method: "POST",
     path: "/files/bulk/move",
@@ -8305,6 +8481,16 @@ var filesContract = c2.router({
     },
     summary: "List team files"
   },
+  getFileTabCounts: {
+    method: "GET",
+    path: "/files/tab-counts",
+    query: FileTabCountsQuerySchema,
+    responses: {
+      200: FileTabCountsResponseSchema,
+      403: ErrorBodySchema
+    },
+    summary: "Per-tab asset counts for the Assets page, scoped to the search"
+  },
   searchAgentAssets: {
     method: "GET",
     path: "/files/agent-search",
@@ -8344,6 +8530,29 @@ var filesContract = c2.router({
     },
     summary: "Get a file's details with generation metadata"
   },
+  getAssetShareMode: {
+    method: "GET",
+    path: "/files/:assetId/share-mode",
+    pathParams: FileAssetIdParamsSchema,
+    responses: {
+      200: external_exports.object({ shareMode: AssetShareModeSchema }),
+      403: ErrorBodySchema,
+      404: ErrorBodySchema
+    },
+    summary: "Get an asset's share mode"
+  },
+  updateAssetShareMode: {
+    method: "PATCH",
+    path: "/files/:assetId/share-mode",
+    pathParams: FileAssetIdParamsSchema,
+    body: external_exports.object({ shareMode: AssetShareModeSchema }),
+    responses: {
+      200: external_exports.object({ shareMode: AssetShareModeSchema }),
+      403: ErrorBodySchema,
+      404: ErrorBodySchema
+    },
+    summary: "Set who can view an asset"
+  },
   initFileUpload: {
     method: "POST",
     path: "/files/upload/init",
@@ -9040,38 +9249,44 @@ var AUTO_MODEL_REGISTRY = [
   {
     nodeType: "video",
     inputPattern: "text-only",
-    standard: { model: "kling-o3", variant: "text-to-video" },
-    fast: { model: "grok-imagine-video", variant: "text-to-video" }
+    model: "kling-o3",
+    variant: "text-to-video"
   },
   {
     nodeType: "video",
     inputPattern: "image-to-video",
-    standard: { model: "kling-o3", variant: "image-to-video" },
-    fast: { model: "wan-2.2", variant: "image-to-video" }
+    model: "kling-o3",
+    variant: "image-to-video"
   },
   {
     nodeType: "video",
     inputPattern: "first-last-frame-to-video",
-    standard: { model: "kling-o3", variant: "image-to-video" },
-    fast: { model: "kling-o3", variant: "image-to-video" }
+    model: "kling-o3",
+    variant: "image-to-video"
   },
   {
     nodeType: "video",
     inputPattern: "reference-to-video",
-    standard: { model: "kling-o3", variant: "reference-to-video" },
-    fast: { model: "kling-o3", variant: "reference-to-video" }
+    model: "kling-o3",
+    variant: "reference-to-video"
   },
   {
     nodeType: "video",
     inputPattern: "reference-with-frames-to-video",
-    standard: { model: "kling-o3", variant: "reference-to-video" },
-    fast: { model: "kling-o3", variant: "reference-to-video" }
+    model: "kling-o3",
+    variant: "reference-to-video"
   },
   {
     nodeType: "video",
     inputPattern: "video-with-audio",
-    standard: { model: "infinitalk", variant: "video-to-video" },
-    fast: { model: "infinitalk", variant: "video-to-video" }
+    model: "infinitalk",
+    variant: "video-to-video"
+  },
+  {
+    nodeType: "video",
+    inputPattern: "video-with-image-references",
+    model: "kling-o3",
+    variant: "video-to-video"
   },
   {
     nodeType: "video",
@@ -9081,85 +9296,79 @@ var AUTO_MODEL_REGISTRY = [
     // backend remaps reference → image_url at request build time
     // (see node-run-execution.ts → "primary image port" remap) since
     // kling-avatar's variant only accepts image_url.
-    standard: { model: "kling-avatar", variant: "image-to-video" },
-    fast: { model: "kling-avatar", variant: "image-to-video" }
+    model: "kling-avatar",
+    variant: "image-to-video"
   },
   {
     nodeType: "video",
     inputPattern: "frames-with-audio",
     // Kling Avatar does not accept end_image_url, so route frame+audio
     // runs through LTX's audio-capable image-to-video variant.
-    standard: { model: "ltx-2.3", variant: "image-to-video" },
-    fast: { model: "ltx-2.3", variant: "image-to-video" }
+    model: "ltx-2.3",
+    variant: "image-to-video"
   },
   {
     nodeType: "video",
     inputPattern: "video-to-video",
-    standard: { model: "grok-imagine-video", variant: "video-to-video" },
-    fast: { model: "grok-imagine-video", variant: "video-to-video" }
+    model: "kling-o3",
+    variant: "video-to-video"
   },
   // ── Image ───────────────────────────────────────────────────────────
   {
     nodeType: "image",
     inputPattern: "text-to-image",
-    standard: { model: "nano-banana-pro", variant: "text-to-image" },
-    fast: { model: "flux-schnell", variant: "text-to-image" }
+    model: "nano-banana-pro",
+    variant: "text-to-image"
   },
   {
     nodeType: "image",
     inputPattern: "image-to-image",
-    standard: { model: "nano-banana-pro", variant: "image-to-image" },
-    fast: { model: "grok-imagine", variant: "image-to-image" }
+    model: "nano-banana-pro",
+    variant: "image-to-image"
   },
   // ── Text ────────────────────────────────────────────────────────────
   {
     nodeType: "text",
     inputPattern: "default",
-    standard: { model: "gemini-3.1-pro", variant: "text" },
-    fast: { model: "gemini-3.1-pro", variant: "text" }
+    model: "gemini-3.1-pro",
+    variant: "text"
   },
   {
     nodeType: "text",
     inputPattern: "with-video",
-    standard: { model: "gemini-3.1-pro", variant: "text" },
-    fast: { model: "gemini-3.1-pro", variant: "text" }
+    model: "gemini-3.1-pro",
+    variant: "text"
   },
   // ── Audio ───────────────────────────────────────────────────────────
   {
     nodeType: "audio",
     inputPattern: "text-to-speech",
-    standard: { model: "eleven_v3", variant: "text-to-speech" },
-    fast: { model: "eleven_turbo_v2_5", variant: "text-to-speech" }
+    model: "eleven_v3",
+    variant: "text-to-speech"
   },
   {
     nodeType: "audio",
     inputPattern: "audio-to-audio",
-    standard: {
-      model: "elevenlabs-voice-changer",
-      variant: "audio-to-audio"
-    },
-    fast: {
-      model: "elevenlabs-voice-changer",
-      variant: "audio-to-audio"
-    }
+    model: "elevenlabs-voice-changer",
+    variant: "audio-to-audio"
   },
   {
     nodeType: "audio",
     inputPattern: "text-to-sfx",
-    standard: { model: "elevenlabs-sfx", variant: "text-to-sfx" },
-    fast: { model: "elevenlabs-sfx", variant: "text-to-sfx" }
+    model: "elevenlabs-sfx",
+    variant: "text-to-sfx"
   },
   {
     nodeType: "audio",
     inputPattern: "text-to-music",
-    standard: { model: "elevenlabs-music", variant: "text-to-music" },
-    fast: { model: "elevenlabs-music", variant: "text-to-music" }
+    model: "elevenlabs-music",
+    variant: "text-to-music"
   },
   {
     nodeType: "audio",
     inputPattern: "speech-to-text",
-    standard: { model: "scribe_v2", variant: "speech-to-text" },
-    fast: { model: "scribe_v2", variant: "speech-to-text" }
+    model: "scribe_v2",
+    variant: "speech-to-text"
   }
 ];
 var AutoModelProxy = class {
@@ -9183,15 +9392,14 @@ var AutoModelProxy = class {
       case "video":
         return this.resolveVideo(
           input.connectedInputs,
-          input.tier,
           input.canvasVideoInputRoutingEnabled === true
         );
       case "image":
-        return this.resolveImage(input.connectedInputs, input.tier);
+        return this.resolveImage(input.connectedInputs);
       case "text":
-        return this.resolveText(input.connectedInputs, input.tier);
+        return this.resolveText(input.connectedInputs);
       case "audio":
-        return this.resolveAudio(input.variant, input.tier);
+        return this.resolveAudio(input.variant);
       default:
         return {
           valid: false,
@@ -9204,13 +9412,22 @@ var AutoModelProxy = class {
     return this.registry;
   }
   // ── Private resolvers ───────────────────────────────────────────────
-  resolveVideo(ci, tier, canvasVideoInputRoutingEnabled) {
+  resolveVideo(ci, canvasVideoInputRoutingEnabled) {
     const hasAnyImage = ci.hasImage || ci.hasStartingImage || ci.hasEndImage || ci.hasReferenceImage;
     if (ci.hasVideo && hasAnyImage) {
-      return {
-        valid: false,
-        errorMessage: "You cannot have an image and a video as input at the same time"
-      };
+      if (ci.hasEndImage) {
+        return {
+          valid: false,
+          errorMessage: "A last frame cannot be used with a video input"
+        };
+      }
+      if (ci.hasAudio) {
+        return {
+          valid: false,
+          errorMessage: "Audio input is not supported with image and video inputs together"
+        };
+      }
+      return this.lookupRoute("video", "video-with-image-references");
     }
     if (ci.hasEndImage && !ci.hasStartingImage && !ci.hasReferenceImage && !ci.hasImage && !ci.hasVideo) {
       return {
@@ -9225,17 +9442,17 @@ var AutoModelProxy = class {
       };
     }
     if (ci.hasAudio && ci.hasVideo) {
-      return this.lookupRoute("video", "video-with-audio", tier);
+      return this.lookupRoute("video", "video-with-audio");
     }
     if (ci.hasAudio && (ci.hasStartingImage || ci.hasImage) && ci.hasEndImage) {
-      return canvasVideoInputRoutingEnabled ? this.lookupRoute("video", "frames-with-audio", tier) : {
+      return canvasVideoInputRoutingEnabled ? this.lookupRoute("video", "frames-with-audio") : {
         valid: true,
         model: "ltx-2.3-audio",
         variant: "image-to-video"
       };
     }
     if (ci.hasAudio && hasAnyImage) {
-      return this.lookupRoute("video", "image-with-audio", tier);
+      return this.lookupRoute("video", "image-with-audio");
     }
     if (ci.hasAudio) {
       return {
@@ -9244,48 +9461,40 @@ var AutoModelProxy = class {
       };
     }
     if (ci.hasVideo) {
-      return this.lookupRoute("video", "video-to-video", tier);
+      return this.lookupRoute("video", "video-to-video");
     }
     const hasFrameInput = ci.hasStartingImage || ci.hasEndImage || ci.hasImage;
     if (ci.hasReferenceImage && hasFrameInput) {
-      return this.lookupRoute(
-        "video",
-        "reference-with-frames-to-video",
-        tier
-      );
+      return this.lookupRoute("video", "reference-with-frames-to-video");
     }
     if (ci.hasReferenceImage) {
-      return this.lookupRoute("video", "reference-to-video", tier);
+      return this.lookupRoute("video", "reference-to-video");
     }
     if (ci.hasStartingImage || ci.hasImage) {
       if (ci.hasEndImage) {
-        return this.lookupRoute(
-          "video",
-          "first-last-frame-to-video",
-          tier
-        );
+        return this.lookupRoute("video", "first-last-frame-to-video");
       }
-      return this.lookupRoute("video", "image-to-video", tier);
+      return this.lookupRoute("video", "image-to-video");
     }
-    return this.lookupRoute("video", "text-only", tier);
+    return this.lookupRoute("video", "text-only");
   }
-  resolveImage(ci, tier) {
+  resolveImage(ci) {
     if (ci.hasImage || ci.hasReferenceImage) {
-      return this.lookupRoute("image", "image-to-image", tier);
+      return this.lookupRoute("image", "image-to-image");
     }
-    return this.lookupRoute("image", "text-to-image", tier);
+    return this.lookupRoute("image", "text-to-image");
   }
-  resolveAudio(variant, tier) {
+  resolveAudio(variant) {
     const pattern = variant ?? "text-to-speech";
-    return this.lookupRoute("audio", pattern, tier);
+    return this.lookupRoute("audio", pattern);
   }
-  resolveText(ci, tier) {
+  resolveText(ci) {
     if (ci.hasVideo) {
-      return this.lookupRoute("text", "with-video", tier);
+      return this.lookupRoute("text", "with-video");
     }
-    return this.lookupRoute("text", "default", tier);
+    return this.lookupRoute("text", "default");
   }
-  lookupRoute(nodeType, inputPattern, tier) {
+  lookupRoute(nodeType, inputPattern) {
     const route = this.lookup.get(`${nodeType}:${inputPattern}`);
     if (!route) {
       return {
@@ -9293,8 +9502,7 @@ var AutoModelProxy = class {
         errorMessage: `No auto model route for ${nodeType}:${inputPattern}`
       };
     }
-    const entry = tier === "fast" ? route.fast : route.standard;
-    return { valid: true, model: entry.model, variant: entry.variant };
+    return { valid: true, model: route.model, variant: route.variant };
   }
 };
 
@@ -9329,6 +9537,19 @@ var AUDIO_NODE_WIDTH = 380;
 var AUDIO_NODE_ESTIMATED_HEIGHT = 420;
 var PDF_NODE_DEFAULT_WIDTH = 440;
 var NODE_CARD_OVERHEAD = 252;
+var ASPECT_RATIOS = [
+  "21:9",
+  "16:9",
+  "3:2",
+  "4:3",
+  "5:4",
+  "1:1",
+  "4:5",
+  "3:4",
+  "2:3",
+  "9:16",
+  "9:21"
+];
 var MODALITIES = {
   text: { modelCategory: "text" },
   image: { modelCategory: "image" },
@@ -10072,7 +10293,8 @@ var TemplatePortSummarySchema = external_exports.object({
   label: external_exports.string(),
   handleType: external_exports.string(),
   required: external_exports.boolean().optional(),
-  maxConnections: external_exports.number().int().positive().optional()
+  maxConnections: external_exports.number().int().positive().optional(),
+  outputAspectRatio: external_exports.enum(ASPECT_RATIOS).nullable().optional()
 });
 
 // ../api-contract/src/canvas.ts
@@ -10122,6 +10344,8 @@ var ModelConfigSchema = external_exports.object({
   model: external_exports.string(),
   variant: external_exports.string(),
   tier: external_exports.string().nullable().optional(),
+  /** HeyGen Avatar V only: the Runware avatar id for this node. */
+  heygenAvatar: external_exports.string().optional(),
   // Magic-resize stores its per-run config here so each version carries the
   // ratios + resolution that produced it.
   ratios: external_exports.array(external_exports.string()).optional(),
@@ -10146,25 +10370,15 @@ var ModelConfigInputSchema = external_exports.object({
   model: external_exports.string(),
   variant: external_exports.string().refine(isValidGenerationMode, "Invalid generation mode"),
   tier: external_exports.string().nullable().optional(),
+  /** HeyGen Avatar V only: the Runware avatar id for this node. */
+  heygenAvatar: external_exports.string().trim().min(1).optional(),
   /** better-font-32b only: the font the model renders the requested text in (supplied to the model as a rendered reference image). */
   font: external_exports.object({
     source: external_exports.enum(["custom", "google"]),
     familyName: external_exports.string()
   }).optional()
 });
-var OutputAspectRatioSchema = external_exports.enum([
-  "21:9",
-  "16:9",
-  "4:3",
-  "5:4",
-  "3:2",
-  "1:1",
-  "2:3",
-  "3:4",
-  "4:5",
-  "9:16",
-  "9:21"
-]);
+var OutputAspectRatioSchema = external_exports.enum(ASPECT_RATIOS);
 var OutputResolutionPresetSchema = external_exports.enum([
   "360p",
   "480p",
@@ -12073,6 +12287,8 @@ var GenerationRunBodySchema = external_exports.object({
   model: external_exports.string().trim().min(1),
   tier: external_exports.string().optional(),
   prompt: external_exports.string().trim().min(1).optional(),
+  /** Selected avatar id from Runware's HeyGen Avatar V catalog. */
+  heygenAvatar: external_exports.string().trim().min(1).optional(),
   imageUrls: external_exports.array(external_exports.string().url()).optional(),
   endImageUrls: external_exports.array(external_exports.string().url()).optional(),
   referenceImageUrls: external_exports.array(external_exports.string().url()).optional(),
@@ -12415,6 +12631,13 @@ var generationContract = c9.router({
       200: ListGenerativeModelsResponseSchema
     }
   },
+  listHeygenAvatarVAvatars: {
+    method: "GET",
+    path: "/generation/heygen-avatar-v-avatars",
+    responses: {
+      200: external_exports.object({ avatars: external_exports.array(external_exports.string()) })
+    }
+  },
   getAutoModelDefaults: {
     method: "GET",
     path: "/generation/auto-model-defaults",
@@ -12700,6 +12923,17 @@ var profileContract = c11.router({
 // ../api-contract/src/share.ts
 var c12 = initContract();
 var ShareModeSchema = external_exports.enum(["restricted", "view"]);
+var SharedAssetResponseSchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  filename: external_exports.string(),
+  fileType: FileTypeSchema,
+  contentType: external_exports.string().nullable(),
+  // Presigned media URL; null only when the underlying storage is missing.
+  mediaUrl: external_exports.string().nullable(),
+  width: external_exports.number().int().nullable(),
+  height: external_exports.number().int().nullable(),
+  durationInMs: external_exports.number().int().nullable()
+});
 var ShareCanvasResponseSchema = external_exports.object({
   id: external_exports.string().uuid(),
   projectId: external_exports.string().uuid(),
@@ -12759,6 +12993,16 @@ var shareContract = c12.router({
     }
   },
   // Public endpoint — no auth required
+  getSharedAsset: {
+    method: "GET",
+    path: "/share/assets/:assetId",
+    pathParams: external_exports.object({ assetId: external_exports.string().uuid() }),
+    responses: {
+      200: SharedAssetResponseSchema,
+      404: MessageResponseSchema
+    }
+  },
+  // Public endpoint — no auth required
   getSharedCanvas: {
     method: "GET",
     path: "/share/projects/:projectId/canvases/:canvasId",
@@ -13894,7 +14138,7 @@ function isMajorUpgrade(current, latest) {
   return l[0] > c17[0];
 }
 function shouldShowUpgradeNotice(ctx = {}) {
-  const current = ctx.current ?? "0.7.0";
+  const current = ctx.current ?? "0.8.0";
   const latest = ctx.latest ?? serverLatestVersion;
   const env = ctx.env ?? process.env;
   const isTty = ctx.isTty ?? Boolean(process.stderr.isTTY);
@@ -13915,7 +14159,7 @@ Upgrade: npm install -g @melius-ai/cli@latest  (or: brew update && brew upgrade
 function printUpgradeNoticeIfNeeded(ctx = {}) {
   try {
     if (!shouldShowUpgradeNotice(ctx)) return;
-    const current = ctx.current ?? "0.7.0";
+    const current = ctx.current ?? "0.8.0";
     const latest = ctx.latest ?? serverLatestVersion;
     process.stderr.write(formatUpgradeNotice(current, latest));
   } catch {
@@ -18599,7 +18843,7 @@ function registerAssetCommands(program2, getOutputOpts) {
     "Search and place the team's Files (DAM) library assets. Requires a Pro or Enterprise plan"
   );
   asset.command("search").description(
-    "Search the team's Files/DAM library (uploads + past generations) by meaning (semantic), with exact filename/title matches ranked first. Returns up to 20 relevant matches per page. Scope to a folder with --folder-id; omit the query and pass --folder-id to bring in the WHOLE folder"
+    "Search the team's Files/DAM library (uploads + past generations) by meaning (semantic), with exact filename/title matches ranked first. Returns up to 20 relevant matches per page. Scope to a folder with --folder-id; filter by tag with --tags; omit the query and pass --folder-id or --tags to bring in the whole folder / all tagged assets"
   ).argument(
     "[query]",
     'Search terms \u2014 a filename or a description of the content, e.g. "Product_Shot_05" or "black jacket shot". Optional: OMIT it and pass --folder-id to list EVERY asset in that folder'
@@ -18616,6 +18860,9 @@ function registerAssetCommands(program2, getOutputOpts) {
   ).option(
     "--folder-id <folderId>",
     "Scope to one Files folder AND its subfolders. WITH a query, filters within the folder; WITHOUT a query, returns every asset in the folder. Get folder ids from mel asset folders"
+  ).option(
+    "--tags <names>",
+    "Filter to assets carrying ALL of these tags (AND), comma-separated names (case-insensitive), e.g. --tags brand or --tags brand,hero. An unknown or misspelled name matches nothing. Combine with a query, or use alone (or with --folder-id) to bring in every asset carrying them"
   ).addHelpText(
     "after",
     `
@@ -18629,16 +18876,18 @@ Examples:
   $ mel asset search "logo" --file-type image --limit 10
   $ mel asset search "logo" --limit 20 --offset 20
   $ mel asset search "shark" --folder-id <folderId>   # find within a folder
-  $ mel asset search --folder-id <folderId>           # bring in the WHOLE folder`
+  $ mel asset search --folder-id <folderId>           # bring in the WHOLE folder
+  $ mel asset search "logo" --tags brand              # find tagged assets
+  $ mel asset search --tags brand,hero                # every asset with BOTH tags`
   ).action(
     async (query, opts) => {
-      if (query === void 0 && opts.folderId === void 0) {
+      if (query === void 0 && opts.folderId === void 0 && opts.tags === void 0) {
         writeError(
           formatError(
             "USAGE_ERROR",
-            "Provide a search query, or --folder-id to bring in a whole folder",
+            "Provide a search query, --folder-id to bring in a whole folder, or --tags to bring in tagged assets",
             {
-              suggestion: "Run mel asset folders to list folder ids, then: mel asset search --folder-id <folderId>"
+              suggestion: "Run mel asset folders to list folder ids, then: mel asset search --folder-id <folderId> (or: mel asset search --tags <name>)"
             }
           ),
           EXIT_USAGE_ERROR
@@ -18658,7 +18907,8 @@ Examples:
           },
           ...opts.folderId !== void 0 && {
             folderId: opts.folderId
-          }
+          },
+          ...opts.tags !== void 0 && { tags: opts.tags }
         }
       });
       if (result.status !== 200) {
@@ -18865,7 +19115,7 @@ function withDefaultHelp(args) {
 }
 function createProgram() {
   const program2 = new Command();
-  program2.name("mel").description("Mel \u2014 Melius agent CLI").version("0.7.0").showSuggestionAfterError(true).option("--json", "Force JSON output (default)").option("--text", "Human-readable output").option(
+  program2.name("mel").description("Mel \u2014 Melius agent CLI").version("0.8.0").showSuggestionAfterError(true).option("--json", "Force JSON output (default)").option("--text", "Human-readable output").option(
     "--fields <fields>",
     "Select specific output fields (comma-separated)"
   ).option("--quiet", "Suppress output, exit code only").option("--verbose", "Log request/response metadata to stderr").addHelpText(

package/dist/src/index.js

@@ -2,7 +2,7 @@ import { createRequire } from 'node:module'; const require = createRequire(impor
 import {
   createProgram,
   withDefaultHelp
-} from "../chunk-5QT6WMID.js";
+} from "../chunk-3PBGQVUH.js";
 export {
   createProgram,
   withDefaultHelp

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melius-ai/cli",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "The Melius command-line interface — create canvases and run AI image/video generations from your terminal",
   "keywords": [
     "ai",