@melius-ai/cli 0.8.0 → 0.9.0

package/README.md

@@ -265,7 +265,7 @@ 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.
 
@@ -276,6 +276,8 @@ Filter by **tag** with `--tags <names>` (comma-separated, case-insensitive): ass
 ```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

package/dist/bin/mel.js

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

package/dist/{chunk-3PBGQVUH.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() });
@@ -8041,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
 });
@@ -8125,16 +8129,18 @@ var FileTabCountsResponseSchema = external_exports.object({
 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.'
@@ -8436,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",
@@ -8448,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",
@@ -9390,10 +9419,7 @@ var AutoModelProxy = class {
   resolve(input) {
     switch (input.nodeType) {
       case "video":
-        return this.resolveVideo(
-          input.connectedInputs,
-          input.canvasVideoInputRoutingEnabled === true
-        );
+        return this.resolveVideo(input.connectedInputs);
       case "image":
         return this.resolveImage(input.connectedInputs);
       case "text":
@@ -9412,7 +9438,7 @@ var AutoModelProxy = class {
     return this.registry;
   }
   // ── Private resolvers ───────────────────────────────────────────────
-  resolveVideo(ci, canvasVideoInputRoutingEnabled) {
+  resolveVideo(ci) {
     const hasAnyImage = ci.hasImage || ci.hasStartingImage || ci.hasEndImage || ci.hasReferenceImage;
     if (ci.hasVideo && hasAnyImage) {
       if (ci.hasEndImage) {
@@ -9445,11 +9471,7 @@ var AutoModelProxy = class {
       return this.lookupRoute("video", "video-with-audio");
     }
     if (ci.hasAudio && (ci.hasStartingImage || ci.hasImage) && ci.hasEndImage) {
-      return canvasVideoInputRoutingEnabled ? this.lookupRoute("video", "frames-with-audio") : {
-        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");
@@ -10502,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(),
@@ -10524,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(),
@@ -10586,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()
@@ -10606,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(),
@@ -10615,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(),
@@ -10663,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,
   {
@@ -10698,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
@@ -10772,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()
 });
@@ -11446,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()
       }),
@@ -11775,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.
@@ -12306,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`.
@@ -12573,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(),
@@ -12631,6 +12696,15 @@ 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",
@@ -12645,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",
@@ -14138,7 +14220,7 @@ function isMajorUpgrade(current, latest) {
   return l[0] > c17[0];
 }
 function shouldShowUpgradeNotice(ctx = {}) {
-  const current = ctx.current ?? "0.8.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);
@@ -14159,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.8.0";
+    const current = ctx.current ?? "0.9.0";
     const latest = ctx.latest ?? serverLatestVersion;
     process.stderr.write(formatUpgradeNotice(current, latest));
   } catch {
@@ -18843,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; filter by tag with --tags; omit the query and pass --folder-id or --tags to bring in the whole folder / all tagged assets"
+    "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",
@@ -18854,6 +18936,9 @@ 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)"
@@ -18873,6 +18958,8 @@ 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
@@ -18902,6 +18989,9 @@ Examples:
           ...opts.fileType !== void 0 && {
             fileType: opts.fileType
           },
+          ...opts.source !== void 0 && {
+            source: opts.source
+          },
           ...opts.canvasId !== void 0 && {
             canvasId: opts.canvasId
           },
@@ -19115,7 +19205,7 @@ function withDefaultHelp(args) {
 }
 function createProgram() {
   const program2 = new Command();
-  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(
+  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-3PBGQVUH.js";
+} from "../chunk-24FW76XZ.js";
 export {
   createProgram,
   withDefaultHelp

package/package.json

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