@melius-ai/cli 0.6.0 → 0.8.0

package/README.md

@@ -261,17 +261,31 @@ Requires the Pro or Enterprise plan.
 
 | Command                                    | Description                                                                                                                              |
 | ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| `mel asset search <query>`                 | Search the team's Files/DAM library (uploads + past generations) by meaning; exact matches rank first. Returns up to 20 matches per page |
+| `mel asset search [query]`                 | Search the team's Files/DAM library (uploads + past generations) by meaning; exact matches rank first. Returns up to 20 matches per page |
+| `mel asset folders`                        | List the library's folders (`id`, `name`, `path`, `fileCount`) so you can resolve a folder name to an id for `--folder-id`               |
 | `mel asset place <canvasId> <assetIds...>` | Place existing library assets onto a canvas by id — references the **original** asset (no duplicate)                                     |
 
 `mel asset search` searches by meaning (semantic), with exact filename/title matches ranked first, so query with a filename or a description of the content. It returns `{ query, total, results: [{ assetId, filename, fileType, previewUrl, ... }] }`. Filter with `--file-type <image|video|audio|pdf|text>` and `--limit <1-20>`; page deeper with `--offset <n>` (skip the first N matches — page until the running count reaches `total`); scope to one canvas with `--canvas-id` (omit to search the whole team library).
 
+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
 # Find an asset, then bring it onto a canvas and wire it
 mel asset search "black jacket shot" --file-type image
 mel asset place <canvasId> <assetId1> <assetId2>
+
+# Bring in a whole folder: resolve the folder, then search it with no query
+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-EN744KKV.js";
+} from "../chunk-3PBGQVUH.js";
 
 // bin/mel.ts
 var program = createProgram();

package/dist/{chunk-EN744KKV.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,15 +8111,34 @@ 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).describe("Asset search query"),
+  query: external_exports.string().trim().min(1).max(500).optional().describe(
+    'The semantic search query \u2014 a filename or a description of the asset (e.g. "red logo", "the shark photo"). Provide it to FIND specific assets. OMIT it entirely to bring in EVERY asset from a folder: when the member says "bring in all my assets from the X folder" / "add everything in X to the canvas", resolve the folder with list_asset_folders and call asset_search with just that `folderId` and NO query. Never invent a query when the member asked for everything in a folder \u2014 a query filters and will drop assets they wanted. Omitting the query requires a `folderId`.'
+  ),
   limit: external_exports.coerce.number().int().min(1).max(AGENT_ASSET_SEARCH_PAGE_SIZE).default(AGENT_ASSET_SEARCH_PAGE_SIZE),
   source: FileSourceSchema.optional(),
   fileType: FileTypeSchema.optional(),
   canvasId: external_exports.string().uuid().optional().describe(
     'Optional. Omit to search the whole team library \u2014 this is the default and what nearly every request wants (e.g. "use the asset I have"). Only set this to scope to a DIFFERENT canvas the member explicitly names ("search my other canvas"), resolving the id from canvas_list. Do NOT pass the canvas the chat is currently on (its assets are already visible via canvas_content, and scoping there hides whole-library matches), and never guess an id.'
   ),
+  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.'
   )
@@ -8112,7 +8159,30 @@ var AgentAssetSearchRequestSchema = AgentAssetSearchQuerySchema.extend(
 var AgentAssetSearchResponseSchema = external_exports.object({
   query: external_exports.string(),
   results: external_exports.array(FileCardSchema),
-  total: external_exports.number().int().nonnegative()
+  total: external_exports.number().int().nonnegative(),
+  // Echo the search scope so the picker's "More results" button can re-page
+  // with the SAME scope. Without this, page 2 drops the folder/canvas filter
+  // and pages the whole library (and a query-less folder browse can't page at
+  // all). Absent when the corresponding filter wasn't set.
+  folderId: external_exports.string().uuid().optional(),
+  canvasId: external_exports.string().uuid().optional(),
+  source: FileSourceSchema.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({
+  id: external_exports.string().uuid(),
+  name: external_exports.string(),
+  // Full path from the team root (e.g. "Brand / Logos") so the agent can
+  // disambiguate when several folders share a name.
+  path: external_exports.string(),
+  fileCount: external_exports.number().int().nonnegative()
+});
+var AgentListAssetFoldersResponseSchema = external_exports.object({
+  folders: external_exports.array(AgentAssetFolderSchema)
 });
 var InitFilesUploadBodySchema = external_exports.object({
   filename: external_exports.string(),
@@ -8144,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: {
@@ -8190,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",
@@ -8280,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",
@@ -8290,6 +8501,15 @@ var filesContract = c2.router({
     },
     summary: "Search team assets for the agent"
   },
+  listAgentAssetFolders: {
+    method: "GET",
+    path: "/files/agent-folders",
+    responses: {
+      200: AgentListAssetFoldersResponseSchema,
+      403: ErrorBodySchema
+    },
+    summary: "List team asset folders for the agent"
+  },
   getEmbeddingStorageUsage: {
     method: "GET",
     path: "/files/embedding-storage-usage",
@@ -8310,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",
@@ -9006,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",
@@ -9047,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 {
@@ -9149,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,
@@ -9170,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 {
@@ -9191,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 {
@@ -9210,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 {
@@ -9259,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 };
   }
 };
 
@@ -9295,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" },
@@ -10038,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
@@ -10088,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(),
@@ -10112,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",
@@ -10165,9 +10413,10 @@ var CropRectSchema = external_exports.object({
 });
 var StitchClipOrderSchema = external_exports.array(external_exports.string());
 var StitchScaleFitSchema = external_exports.enum(["fit", "stretch"]);
+var roundMs = (value) => typeof value === "number" ? Math.round(value) : value;
 var StitchTrimWindowFields = {
-  trimStartMs: external_exports.number().int().nonnegative().optional(),
-  trimEndMs: external_exports.number().int().positive().optional()
+  trimStartMs: external_exports.preprocess(roundMs, external_exports.number().int().nonnegative()).optional(),
+  trimEndMs: external_exports.preprocess(roundMs, external_exports.number().int().positive()).optional()
 };
 var StitchAudioOverlaySchema = external_exports.object({
   nodeId: external_exports.string(),
@@ -12038,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(),
@@ -12202,6 +12453,10 @@ var ModelCostSchema = external_exports.discriminatedUnion("type", [
     maxCreditCost: external_exports.number()
   })
 ]);
+var TextTokenPricingSchema = external_exports.object({
+  inputCreditsPerMillionTokens: external_exports.number(),
+  outputCreditsPerMillionTokens: external_exports.number()
+});
 var InputFileSizeConstraintsResponseSchema = external_exports.object({
   maximumFileBytes: external_exports.number().int().nonnegative().optional(),
   maximumTotalBytes: external_exports.number().int().nonnegative().optional()
@@ -12307,7 +12562,9 @@ var ModelResponseSchema = external_exports.object({
   hiddenFromAgent: external_exports.boolean().optional(),
   promoRateLimit: PromoRateLimitSchema.optional(),
   /** Maximum prompt length in characters. Used by text models that lack variants. */
-  maxPromptLength: external_exports.number().nullable().optional()
+  maxPromptLength: external_exports.number().nullable().optional(),
+  /** Per-1M-token credit rates for text models; drives the live cost-range estimate. */
+  textTokenPricing: TextTokenPricingSchema.optional()
 });
 var ListGenerativeModelsResponseSchema = external_exports.object({
   models: external_exports.array(ModelResponseSchema)
@@ -12374,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",
@@ -12659,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(),
@@ -12718,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",
@@ -12800,7 +13085,8 @@ var EnterpriseOrderLineItemSchema = external_exports.object({
 var EnterpriseBillingIntervalSchema = external_exports.enum(["monthly", "annual"]);
 var EnterpriseStripeBillingInputSchema = external_exports.object({
   unitAmount: external_exports.number().int().positive(),
-  currency: external_exports.string().length(3).transform((value) => value.toLowerCase()),
+  // Expose the transform output to OpenAPI generation.
+  currency: external_exports.string().length(3).transform((value) => value.toLowerCase()).pipe(external_exports.string()),
   billingInterval: EnterpriseBillingIntervalSchema,
   creditsPerPeriod: external_exports.number().int().positive(),
   contractEndAt: external_exports.string().datetime().optional()
@@ -12864,7 +13150,8 @@ var EnterprisePendingExpansionSchema = external_exports.object({
 });
 var EnterpriseStripeBillingSchema = external_exports.object({
   unitAmount: external_exports.number().int().positive(),
-  currency: external_exports.string().length(3).transform((value) => value.toLowerCase()),
+  // Expose the transform output to OpenAPI generation.
+  currency: external_exports.string().length(3).transform((value) => value.toLowerCase()).pipe(external_exports.string()),
   billingInterval: EnterpriseBillingIntervalSchema,
   creditsPerPeriod: external_exports.number().int().positive(),
   contractEndAt: external_exports.string().datetime().optional(),
@@ -13578,10 +13865,13 @@ var publicContract = c16.router(
       complete: uploadContract.complete
     },
     asset: {
-      // Semantic/filename search of the team's Files (DAM) library, and
-      // placing a found asset onto a canvas by reference (no duplicate).
-      // Both are gated to Pro + Enterprise by the handlers.
+      // Semantic/filename search of the team's Files (DAM) library,
+      // listing the library's folders (to resolve a folder name → id for a
+      // folder-scoped search), and placing a found asset onto a canvas by
+      // reference (no duplicate). All gated to Pro + Enterprise by the
+      // handlers.
       search: filesContract.searchAgentAssets,
+      folders: filesContract.listAgentAssetFolders,
       place: canvasContract.placeLibraryAssets
     },
     model: {
@@ -13848,7 +14138,7 @@ function isMajorUpgrade(current, latest) {
   return l[0] > c17[0];
 }
 function shouldShowUpgradeNotice(ctx = {}) {
-  const current = ctx.current ?? "0.6.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);
@@ -13869,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.6.0";
+    const current = ctx.current ?? "0.8.0";
     const latest = ctx.latest ?? serverLatestVersion;
     process.stderr.write(formatUpgradeNotice(current, latest));
   } catch {
@@ -18553,10 +18843,10 @@ 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"
+    "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"'
+    "[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'
   ).option("--limit <n>", "Max results per page (1-20, default 20)", "20").option(
     "--offset <n>",
     "Skip the first N matches to page deeper (default 0). Page with --limit until the running count reaches the response's total",
@@ -18567,23 +18857,46 @@ function registerAssetCommands(program2, getOutputOpts) {
   ).option(
     "--canvas-id <canvasId>",
     "Scope to one canvas's assets (a filename match within that canvas). Omit to search the whole team library by meaning, exact matches first (the default)"
+  ).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",
     `
 Returns: { query, total, results: [{ assetId, filename, displayName, fileType, contentType, previewUrl, assetUrl, durationInMs }] }.
 total is the full match count; page through it with --limit + --offset.
 Use the returned assetId values with mel asset place to bring them onto a canvas.
+Resolve a folder name to an id with mel asset folders first.
 
 Examples:
   $ mel asset search "black jacket shot"
   $ mel asset search "logo" --file-type image --limit 10
-  $ mel asset search "logo" --limit 20 --offset 20`
+  $ 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 "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 && opts.tags === void 0) {
+        writeError(
+          formatError(
+            "USAGE_ERROR",
+            "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> (or: mel asset search --tags <name>)"
+            }
+          ),
+          EXIT_USAGE_ERROR
+        );
+      }
       const client = getClient();
       const result = await client.asset.search({
         query: {
-          query,
+          ...query !== void 0 && { query },
           limit: Number(opts.limit),
           offset: Number(opts.offset),
           ...opts.fileType !== void 0 && {
@@ -18591,7 +18904,11 @@ Examples:
           },
           ...opts.canvasId !== void 0 && {
             canvasId: opts.canvasId
-          }
+          },
+          ...opts.folderId !== void 0 && {
+            folderId: opts.folderId
+          },
+          ...opts.tags !== void 0 && { tags: opts.tags }
         }
       });
       if (result.status !== 200) {
@@ -18604,6 +18921,31 @@ Examples:
       writeJson(result.body, getOutputOpts());
     }
   );
+  asset.command("folders").description(
+    "List the team's Files/DAM folders (id, name, full path, file count). Use a folder's id with mel asset search --folder-id to scope a search or bring in the whole folder"
+  ).addHelpText(
+    "after",
+    `
+Returns: an array of { id, name, path, fileCount }.
+path is the folder's location from the library root (e.g. "Brand / Logos") \u2014 use it to disambiguate same-named folders.
+Pass a folder id to mel asset search --folder-id <folderId>.
+
+Examples:
+  $ mel asset folders
+  $ mel asset folders --text`
+  ).action(async () => {
+    const client = getClient();
+    const result = await client.asset.folders();
+    if (result.status !== 200) {
+      handleApiError(
+        result.status,
+        result.body,
+        result.status === 403 ? ASSET_PLAN_REQUIRED_SUGGESTION : void 0
+      );
+    }
+    const body = result.body;
+    writeJson(body.folders, getOutputOpts());
+  });
   asset.command("place").description(
     "Place existing library assets onto a canvas by id, referencing the ORIGINAL asset (no duplicate, no re-upload). Creates file nodes server-side (writes to CRDT) and returns their node ids"
   ).argument(
@@ -18773,7 +19115,7 @@ function withDefaultHelp(args) {
 }
 function createProgram() {
   const program2 = new Command();
-  program2.name("mel").description("Mel \u2014 Melius agent CLI").version("0.6.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-EN744KKV.js";
+} from "../chunk-3PBGQVUH.js";
 export {
   createProgram,
   withDefaultHelp

package/package.json

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