@melius-ai/cli 0.7.0 → 0.9.0

package/README.md

@@ -265,21 +265,29 @@ Requires the Pro or Enterprise plan.
 | `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).
+`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. Pass an exact filename verbatim, including its extension. It returns `{ query, total, results: [{ assetId, filename, fileType, previewUrl, ... }] }`. Filter by origin with `--source <upload|generated>`, by media type with `--file-type <image|video|audio|pdf|text>`, and by page size with `--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 search "Product_Shot_05.PNG" --source upload
+mel asset search "shark close-up" --source generated
 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-5QT6WMID.js";
+} from "../chunk-24FW76XZ.js";
 
 // bin/mel.ts
 var program = createProgram();

package/dist/{chunk-5QT6WMID.js → chunk-24FW76XZ.js}

@@ -7736,6 +7736,7 @@ var MAX_INPUT_VIDEOS = 3;
 var MAX_INPUT_DOCUMENTS = 5;
 var MAX_AGENT_MESSAGE_CONTENT_LENGTH = 5e4;
 var MAX_SEED = 2147483647;
+var MAX_VARIATIONS = 10;
 
 // ../api-contract/src/common.ts
 var MessageResponseSchema = external_exports.object({ message: external_exports.string() });
@@ -7911,6 +7912,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 +7958,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
@@ -8020,6 +8042,9 @@ var BulkDownloadFilesResponseSchema = external_exports.object({
 var BulkHideFilesBodySchema = external_exports.object({
   assetIds: BulkFileAssetIdsSchema
 });
+var BulkDeleteFilesBodySchema = external_exports.object({
+  assetIds: BulkFileAssetIdsSchema
+});
 var BulkUnhideFilesBodySchema = external_exports.object({
   assetIds: BulkFileAssetIdsSchema
 });
@@ -8049,6 +8074,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,19 +8115,35 @@ 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(
-    '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`.'
+    'The semantic search query \u2014 an exact filename or a description of the asset (e.g. "Product_Shot_05.png", "red logo", "the shark photo"). When the member gives an exact filename, pass it verbatim, including its extension; exact matches rank first. Provide a query 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(),
+  source: FileSourceSchema.optional().describe(
+    "Optional. Filter by where the asset came from: `upload` for files uploaded by a member, or `generated` for media created in Melius. Set this only when the member explicitly asks for uploads or generations; omit it to search both."
+  ),
   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.'
+    '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: prefer a case-insensitive exact name or path before considering partial matches; if several exact or partial matches remain, 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 +8173,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 +8220,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 +8306,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",
@@ -8260,6 +8442,17 @@ var filesContract = c2.router({
     },
     summary: "Hide files from Files"
   },
+  bulkDeleteFiles: {
+    method: "POST",
+    path: "/files/bulk/delete",
+    body: BulkDeleteFilesBodySchema,
+    responses: {
+      200: BulkFileActionResponseSchema,
+      403: ErrorBodySchema,
+      404: ErrorBodySchema
+    },
+    summary: "Delete files from Files"
+  },
   hideFile: {
     method: "POST",
     path: "/files/:assetId/hide",
@@ -8272,6 +8465,18 @@ var filesContract = c2.router({
     },
     summary: "Hide a file from Files"
   },
+  deleteFile: {
+    method: "DELETE",
+    path: "/files/:assetId",
+    pathParams: FileAssetIdParamsSchema,
+    body: null,
+    responses: {
+      204: c2.noBody(),
+      403: ErrorBodySchema,
+      404: ErrorBodySchema
+    },
+    summary: "Delete a file from Files"
+  },
   bulkUnhideFiles: {
     method: "POST",
     path: "/files/bulk/unhide",
@@ -8305,6 +8510,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 +8559,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 +9278,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 +9325,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 {
@@ -9181,17 +9419,13 @@ var AutoModelProxy = class {
   resolve(input) {
     switch (input.nodeType) {
       case "video":
-        return this.resolveVideo(
-          input.connectedInputs,
-          input.tier,
-          input.canvasVideoInputRoutingEnabled === true
-        );
+        return this.resolveVideo(input.connectedInputs);
       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 +9438,22 @@ var AutoModelProxy = class {
     return this.registry;
   }
   // ── Private resolvers ───────────────────────────────────────────────
-  resolveVideo(ci, tier, canvasVideoInputRoutingEnabled) {
+  resolveVideo(ci) {
     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 +9468,13 @@ 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) : {
-        valid: true,
-        model: "ltx-2.3-audio",
-        variant: "image-to-video"
-      };
+      return this.lookupRoute("video", "frames-with-audio");
     }
     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 +9483,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 +9524,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 +9559,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 +10315,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 +10366,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 +10392,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",
@@ -10288,6 +10524,16 @@ var NodeVersionResponseSchema = external_exports.object({
    */
   modelDisplayName: external_exports.string().nullable().optional(),
   asset: AssetResponseSchema.nullable(),
+  /**
+   * For a version produced by a node tool (background removal, subtitles,
+   * GIF, upscale — i.e. `sourceToolName` is set), the source asset the tool
+   * transformed. A tool runs in place on a file node, so the input lives on
+   * an earlier version that the bulk content response does not ship; this
+   * surfaces it so consumers (e.g. Playground history) can show what the tool
+   * ran on without re-fetching the node's full version list. Populated only
+   * when the caller opts in via `includeToolInputReferences`.
+   */
+  toolInputAsset: AssetResponseSchema.nullable().optional(),
   pdfExtraction: PdfExtractionSchema.nullable().optional(),
   /** Present when an active node run exists for this version (e.g. PDF extraction in progress). */
   nodeRunId: external_exports.string().uuid().nullable().optional(),
@@ -10310,7 +10556,12 @@ var MagicResizeOutputSchema = external_exports.object({
   assetId: external_exports.string().nullable(),
   assetUrl: external_exports.string().nullable(),
   previewUrl: external_exports.string().nullable(),
-  failed: external_exports.boolean().optional()
+  failed: external_exports.boolean().optional(),
+  // User-facing failure reason for a `failed` layer, mirroring the error
+  // message + severity a regular media node shows (e.g. a provider error vs.
+  // a content-moderation warning). Absent on successful layers.
+  errorMessage: external_exports.string().nullish(),
+  errorSeverity: external_exports.enum(["error", "warning"]).nullish()
 });
 var NodeResponseSchema = external_exports.object({
   id: external_exports.string().uuid(),
@@ -10372,6 +10623,8 @@ var NodeResponseSchema = external_exports.object({
   childNodeIds: external_exports.array(external_exports.string().uuid()).optional(),
   /** Per-ratio outputs for magic-resize nodes (from CRDT); one per variant. */
   magicResizeOutputs: external_exports.array(MagicResizeOutputSchema).nullable().optional(),
+  /** User id of the team member who created the node, or null when unknown. */
+  createdByUserId: external_exports.string().uuid().nullable().optional(),
   versions: external_exports.array(NodeVersionResponseSchema),
   createdAt: external_exports.string().datetime(),
   updatedAt: external_exports.string().datetime()
@@ -10392,7 +10645,7 @@ var CanvasMediaPresetSchema = external_exports.object({
     aspectRatio: OutputAspectRatioSchema.optional(),
     resolution: OutputResolutionSchema.optional(),
     fast: external_exports.boolean().optional(),
-    numVariations: external_exports.number().int().min(1).max(10).optional()
+    numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).optional()
   }).optional(),
   video: external_exports.object({
     model: external_exports.string().optional(),
@@ -10401,13 +10654,13 @@ var CanvasMediaPresetSchema = external_exports.object({
     resolution: OutputResolutionSchema.optional(),
     duration: external_exports.number().int().positive().optional(),
     fast: external_exports.boolean().optional(),
-    numVariations: external_exports.number().int().min(1).max(10).optional()
+    numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).optional()
   }).optional(),
   text: external_exports.object({
     model: external_exports.string().optional(),
     mode: external_exports.string().optional(),
     fast: external_exports.boolean().optional(),
-    numVariations: external_exports.number().int().min(1).max(10).optional()
+    numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).optional()
   }).optional(),
   audio: external_exports.object({
     model: external_exports.string().optional(),
@@ -10449,7 +10702,24 @@ var CanvasContentQuerySchema = external_exports.object({
    * so the model reads the summary instead of a URL. The web app does
    * not set this, so it always receives URLs.
    */
-  mediaSummaries: QueryBooleanSchema.optional()
+  mediaSummaries: QueryBooleanSchema.optional(),
+  /**
+   * Opt-in: resolve the source asset each node-tool version transformed
+   * onto `version.toolInputAsset` (see that field). Off by default so the
+   * common canvas/agent/MCP reads never pay the extra version lookup; the
+   * Playground history loader sets it to restore tool-run input previews.
+   */
+  includeToolInputReferences: QueryBooleanSchema.optional(),
+  /**
+   * Opt-in: ship EVERY asset-bearing version for generation nodes
+   * (image/video/audio) with more than one output, so a
+   * native-variations node (one node, N output versions) can rebuild
+   * its full output set from a bulk read. Resolved in a bounded batched
+   * pass like `includeToolInputReferences`; off by default so common
+   * reads pay nothing. Unlike `includeAllVersions` it needs no nodeId
+   * scoping.
+   */
+  includeVariationVersions: QueryBooleanSchema.optional()
 }).refine(
   (query) => query.includeAllVersions !== true || query.nodeId !== void 0,
   {
@@ -10484,7 +10754,7 @@ var RunNodeBodySchema = external_exports.object({
   outputDuration: external_exports.number().int().positive().optional(),
   outputResolution: OutputResolutionSchema.optional(),
   seed: external_exports.number().int().nonnegative().max(MAX_SEED).optional(),
-  numVariations: external_exports.number().int().min(1).max(10).optional(),
+  numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).optional(),
   /**
    * Dev-only: force a specific generation provider for the run. When set,
    * `prepareGenerationRequest` restricts variant selection to the named
@@ -10558,7 +10828,7 @@ var RunImageToolBodySchema = external_exports.object({
   canvasId: external_exports.string().uuid().optional(),
   toolName: external_exports.string().trim().min(1),
   toolConfig: external_exports.record(external_exports.unknown()).optional(),
-  numVariations: external_exports.number().int().min(1).max(10).optional(),
+  numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).optional(),
   /** Base64-encoded PNG mask image for inpainting (white = areas to regenerate). */
   maskImageBase64: external_exports.string().optional()
 });
@@ -11232,7 +11502,12 @@ var canvasContract = c7.router({
         failedLayers: external_exports.array(
           external_exports.object({
             layerIndex: external_exports.number().int(),
-            ratio: external_exports.string()
+            ratio: external_exports.string(),
+            // User-facing failure reason + severity (mirrors a
+            // regular media node's error/warning). Optional so
+            // a new client tolerates an older backend.
+            errorMessage: external_exports.string().nullish(),
+            errorSeverity: external_exports.enum(["error", "warning"]).nullish()
           })
         ).nullish()
       }),
@@ -11561,7 +11836,7 @@ var canvasContract = c7.router({
        * every intermediate node — see `BulkNodeRunService`. Used by the
        * template box's variation stepper. Defaults to 1 when omitted.
        */
-      numVariations: external_exports.number().int().min(1).max(10).optional(),
+      numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).optional(),
       /**
        * Node ids whose audio-to-video duration should be matched to
        * connected generated audio after upstream audio nodes finish.
@@ -12073,6 +12348,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(),
@@ -12090,7 +12367,7 @@ var GenerationRunBodySchema = external_exports.object({
   duration: external_exports.number().int().positive().optional(),
   resolution: OutputResolutionSchema.optional(),
   seed: external_exports.number().int().nonnegative().max(MAX_SEED).optional(),
-  numVariations: external_exports.number().int().min(1).max(10).optional(),
+  numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).optional(),
   /**
    * Whether the variant should generate audio. Only honored on variants
    * whose registry entry declares `falAudioField`. Defaults to `true`.
@@ -12357,6 +12634,10 @@ var GenerationHistoryItemSchema = external_exports.object({
   id: external_exports.string(),
   type: external_exports.enum(["media", "text"]),
   model: external_exports.string(),
+  // Speed tier (e.g. "fast") the job ran at, when it ran at a non-standard
+  // one. Optional so older clients ignore it and the field is absent for
+  // standard-tier and text generations.
+  tier: external_exports.string().nullable().optional(),
   status: GenerationJobStatusSchema,
   creditCost: external_exports.number().nullable(),
   createdAt: external_exports.string(),
@@ -12415,6 +12696,22 @@ var generationContract = c9.router({
       200: ListGenerativeModelsResponseSchema
     }
   },
+  listPublicGenerativeModels: {
+    method: "GET",
+    path: "/generation/models/public",
+    query: external_exports.object({ category: ModelCategorySchema }),
+    responses: {
+      200: ListGenerativeModelsResponseSchema
+    },
+    summary: "List generally-available models without authentication (logged-out home)"
+  },
+  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",
@@ -12422,6 +12719,14 @@ var generationContract = c9.router({
       200: AutoModelDefaultsResponseSchema
     }
   },
+  getPublicAutoModelDefaults: {
+    method: "GET",
+    path: "/generation/auto-model-defaults/public",
+    responses: {
+      200: AutoModelDefaultsResponseSchema
+    },
+    summary: "Auto-model defaults without authentication (logged-out home)"
+  },
   listGenerationHistory: {
     method: "GET",
     path: "/generation/history",
@@ -12700,6 +13005,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 +13075,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 +14220,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.9.0";
   const latest = ctx.latest ?? serverLatestVersion;
   const env = ctx.env ?? process.env;
   const isTty = ctx.isTty ?? Boolean(process.stderr.isTTY);
@@ -13915,7 +14241,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.9.0";
     const latest = ctx.latest ?? serverLatestVersion;
     process.stderr.write(formatUpgradeNotice(current, latest));
   } catch {
@@ -18599,10 +18925,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. 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. Filter by asset source with --source, scope to a folder with --folder-id, or 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'
+    'Search terms \u2014 an exact filename (including its extension) or a description of the content, e.g. "Product_Shot_05.png" 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",
@@ -18610,12 +18936,18 @@ function registerAssetCommands(program2, getOutputOpts) {
   ).option(
     "--file-type <type>",
     "Filter by media type: image, video, audio, pdf, or text"
+  ).option(
+    "--source <source>",
+    "Filter by asset source: upload (member-uploaded files) or generated (media created in Melius)"
   ).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",
     `
@@ -18626,19 +18958,23 @@ Resolve a folder name to an id with mel asset folders first.
 
 Examples:
   $ mel asset search "black jacket shot"
+  $ mel asset search "Product_Shot_05.PNG" --source upload
+  $ mel asset search "shark close-up" --source generated
   $ 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
@@ -18653,12 +18989,16 @@ Examples:
           ...opts.fileType !== void 0 && {
             fileType: opts.fileType
           },
+          ...opts.source !== void 0 && {
+            source: opts.source
+          },
           ...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) {
@@ -18865,7 +19205,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.9.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-24FW76XZ.js";
 export {
   createProgram,
   withDefaultHelp

package/package.json

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