@melius-ai/cli 0.5.2 → 0.6.0

package/README.md

@@ -259,12 +259,12 @@ mel upload ./photo.png --node-id <nodeId> --canvas-id <canvasId>
 
 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 5 matches |
-| `mel asset place <canvasId> <assetIds...>` | Place existing library assets onto a canvas by id — references the **original** asset (no duplicate)                           |
+| 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 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-5>`; 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. 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 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.
 

package/dist/bin/mel.js

@@ -7,7 +7,7 @@ import {
   printUpgradeNoticeIfNeeded,
   withDefaultHelp,
   writeError
-} from "../chunk-4GUG5TD2.js";
+} from "../chunk-EN744KKV.js";
 
 // bin/mel.ts
 var program = createProgram();

package/dist/{chunk-4GUG5TD2.js → chunk-EN744KKV.js}

@@ -7914,7 +7914,11 @@ var FileTypeSchema = external_exports.enum([
 var FileCanvasBacklinkSchema = external_exports.object({
   canvasId: external_exports.string().uuid(),
   projectId: external_exports.string().uuid(),
-  canvasTitle: external_exports.string()
+  canvasTitle: external_exports.string(),
+  // A node on this canvas whose active version holds the asset, so opening
+  // the canvas can center on it. Null when no such node survives (e.g. it was
+  // deleted but the asset is still referenced elsewhere on the canvas).
+  nodeId: external_exports.string().uuid().nullable().optional()
 });
 var FileCardSchema = external_exports.object({
   assetId: external_exports.string().uuid(),
@@ -8079,9 +8083,10 @@ var ListFilesResponseSchema = external_exports.object({
   cursor: external_exports.string().nullable().optional(),
   hasMore: external_exports.boolean().optional()
 });
+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"),
-  limit: external_exports.coerce.number().int().min(1).max(5).default(5),
+  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(
@@ -8094,7 +8099,14 @@ var AgentAssetSearchQuerySchema = external_exports.object({
 var AgentAssetSearchModeSchema = external_exports.enum(["semantic", "filename"]);
 var AgentAssetSearchRequestSchema = AgentAssetSearchQuerySchema.extend(
   {
-    mode: AgentAssetSearchModeSchema.optional()
+    mode: AgentAssetSearchModeSchema.optional(),
+    // Pagination offset for the picker's "More results" button. Like
+    // `mode`, it lives here and NOT on `AgentAssetSearchQuerySchema` (the
+    // LLM tool input) so the model can never paginate — paging is a member
+    // action. Optional (not `.default(0)`): a default would make `offset`
+    // required in the inferred type and break assignment from the tool
+    // input, which has no offset. The service treats an absent offset as 0.
+    offset: external_exports.coerce.number().int().min(0).optional()
   }
 );
 var AgentAssetSearchResponseSchema = external_exports.object({
@@ -8703,7 +8715,15 @@ var agentContract = c3.router({
         // clients that predate selection persistence.
         assetIds: external_exports.array(external_exports.string()).optional()
       }),
-      external_exports.object({ action: external_exports.literal("decline") })
+      external_exports.object({
+        action: external_exports.literal("decline"),
+        // When the member declines these results and instead types a new
+        // query into the card's "search for something else" input, the
+        // resumed turn re-runs asset_search with exactly this query
+        // instead of the agent asking a clarify. Bounds mirror
+        // `AgentAssetSearchQuerySchema.query`. Omitted = plain decline.
+        searchAgainQuery: external_exports.string().trim().min(1).max(500).optional()
+      })
     ]),
     responses: {
       200: AgentToolApprovalResponseSchema,
@@ -9061,14 +9081,14 @@ var AUTO_MODEL_REGISTRY = [
   {
     nodeType: "text",
     inputPattern: "default",
-    standard: { model: "gemini-3-flash", variant: "text" },
-    fast: { model: "gemini-3-flash", variant: "text" }
+    standard: { model: "gemini-3.1-pro", variant: "text" },
+    fast: { model: "gemini-3.1-pro", variant: "text" }
   },
   {
     nodeType: "text",
     inputPattern: "with-video",
-    standard: { model: "gemini-3-flash", variant: "text" },
-    fast: { model: "gemini-3-flash", variant: "text" }
+    standard: { model: "gemini-3.1-pro", variant: "text" },
+    fast: { model: "gemini-3.1-pro", variant: "text" }
   },
   // ── Audio ───────────────────────────────────────────────────────────
   {
@@ -9928,15 +9948,22 @@ var TemplatePortSchema = external_exports.discriminatedUnion("direction", [
     /** Creator-set cap on connections into this input. Absent = unlimited. */
     maxConnections: external_exports.number().int().positive().optional(),
     /**
-     * Hidden input: not exposed as a connectable handle on the collapsed box
+     * Locked input: not exposed as a connectable handle on the collapsed box
      * — its value comes from the source baked into the template definition
      * (used as-is for an upload/custom text, regenerated for a generation
      * node). The port is still recorded (rather than dropped) so it
-     * round-trips for editing in the internal tool. At apply, hidden input
+     * round-trips for editing in the internal tool. At apply, locked input
      * ports are not materialized as instance bindings, so no handle renders
      * and they never gate a run.
      */
-    hidden: external_exports.boolean().optional(),
+    locked: external_exports.boolean().optional(),
+    /**
+     * For a locked input only: the template node key of the baked source
+     * whose value is frozen in. Lets apply resolve the materialized source
+     * node so "Expand template" can surface it into the input column.
+     * Absent for visible inputs (the user supplies their own source).
+     */
+    sourceNodeKey: external_exports.string().optional(),
     /**
      * Every internal handle this input fans out to. Absent/empty = the
      * single `nodeKey`/`internalHandle` binding (pre-fan-out templates).
@@ -9971,12 +9998,12 @@ var InstancePortBindingSchema = external_exports.discriminatedUnion("direction",
     required: external_exports.boolean().optional(),
     maxConnections: external_exports.number().int().positive().optional(),
     /**
-     * Mirror of `TemplatePort.hidden`. Hidden input ports are not
+     * Mirror of `TemplatePort.locked`. Locked input ports are not
      * materialized as instance bindings today (the box never renders them),
      * so this is carried for symmetry/forward-compat rather than read at
      * runtime.
      */
-    hidden: external_exports.boolean().optional(),
+    locked: external_exports.boolean().optional(),
     /**
      * Every internal endpoint this input fans out to (resolved form of
      * `TemplatePort.internalTargets`). Absent/empty = the single
@@ -10156,6 +10183,8 @@ var AssetSummaryDetailsSchema = external_exports.object({
   summary: external_exports.string()
 });
 var AssetResponseSchema = external_exports.object({
+  /** Omitted from persisted snapshots created before this field existed. */
+  assetId: external_exports.string().uuid().optional(),
   url: external_exports.string().nullable(),
   originalUrl: external_exports.string().nullable(),
   previewUrl: external_exports.string().nullable(),
@@ -10302,6 +10331,8 @@ var NodeResponseSchema = external_exports.object({
   templatePorts: external_exports.array(InstancePortBindingSchema).nullable().optional(),
   /** The source template id on a template-instance group (from CRDT). */
   templateId: external_exports.string().uuid().nullable().optional(),
+  /** Whether a template-instance group may be expanded to its workflow (from CRDT). */
+  isExpandable: external_exports.boolean().nullable().optional(),
   /** Direct child node IDs when nodeType is group (for agent wiring). */
   childNodeIds: external_exports.array(external_exports.string().uuid()).optional(),
   /** Per-ratio outputs for magic-resize nodes (from CRDT); one per variant. */
@@ -10407,8 +10438,11 @@ var NodeRunStatusSchema = external_exports.enum([
 var CreateNodeRunResponseSchema = external_exports.object({
   id: external_exports.string().uuid()
 });
+var RunOriginSchema = external_exports.enum(["canvas", "playground"]);
 var RunNodeBodySchema = external_exports.object({
   canvasId: external_exports.string().uuid().optional(),
+  /** Product surface this run originated on. Defaults to `canvas` server-side. */
+  origin: RunOriginSchema.optional(),
   textPrompt: external_exports.string().optional(),
   modelConfig: ModelConfigInputSchema.optional(),
   outputAspectRatio: OutputAspectRatioSchema.optional(),
@@ -10723,7 +10757,13 @@ var CreateDirectNodeBodyObjectSchema = external_exports.object({
   /** For template-instance groups only: resolved input/output port bindings. */
   templatePorts: external_exports.array(InstancePortBindingSchema).nullable().optional(),
   /** For template-instance groups only: the id of the source template. */
-  templateId: external_exports.string().uuid().nullable().optional()
+  templateId: external_exports.string().uuid().nullable().optional(),
+  /** For template-instance groups only: whether the box may be expanded to its
+   *  workflow (snapshot of the template's setting at apply time). */
+  isExpandable: external_exports.boolean().nullable().optional(),
+  /** For template-instance groups only: node ids of the baked locked-input
+   *  sources, surfaced into the input column when the box is expanded. */
+  lockedInputNodeIds: external_exports.array(external_exports.string().uuid()).nullable().optional()
 });
 var CreateDirectNodeBodySchema = CreateDirectNodeBodyObjectSchema.superRefine(
   validateDirectFileNodeAssetFields
@@ -11060,6 +11100,31 @@ var canvasContract = c7.router({
       404: MessageResponseSchema
     }
   },
+  // Mint per-node presigned download URLs (Content-Disposition: attachment)
+  // so a client can trigger a real file download. Used by the display_canvas
+  // MCP App, whose sandboxed iframe cannot download directly and must hand a
+  // download-forcing URL to the host. Returns only nodes with a downloadable
+  // active-version asset; nodes without one are omitted.
+  getNodeDownloadUrls: {
+    method: "POST",
+    path: "/canvases/:canvasId/node-download-urls",
+    pathParams: external_exports.object({ canvasId: external_exports.string().uuid() }),
+    body: external_exports.object({
+      nodeIds: external_exports.array(external_exports.string().uuid()).min(1).max(100)
+    }),
+    responses: {
+      200: external_exports.object({
+        urls: external_exports.array(
+          external_exports.object({
+            nodeId: external_exports.string().uuid(),
+            downloadUrl: external_exports.string().url(),
+            filename: external_exports.string()
+          })
+        )
+      }),
+      404: MessageResponseSchema
+    }
+  },
   listCanvasAssets: {
     method: "GET",
     path: "/canvases/:canvasId/assets",
@@ -11451,6 +11516,8 @@ var canvasContract = c7.router({
     pathParams: external_exports.object({ canvasId: external_exports.string().uuid() }),
     body: external_exports.object({
       nodeIds: external_exports.array(external_exports.string().uuid()).min(1).max(500),
+      /** Product surface this run originated on. Defaults to `canvas` server-side. */
+      origin: RunOriginSchema.optional(),
       /** Explicit image URLs applied to every node in the bulk run (merged with edge-resolved images). */
       imageUrls: external_exports.array(external_exports.string().url()).optional(),
       /**
@@ -13781,7 +13848,7 @@ function isMajorUpgrade(current, latest) {
   return l[0] > c17[0];
 }
 function shouldShowUpgradeNotice(ctx = {}) {
-  const current = ctx.current ?? "0.5.2";
+  const current = ctx.current ?? "0.6.0";
   const latest = ctx.latest ?? serverLatestVersion;
   const env = ctx.env ?? process.env;
   const isTty = ctx.isTty ?? Boolean(process.stderr.isTTY);
@@ -13802,7 +13869,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.5.2";
+    const current = ctx.current ?? "0.6.0";
     const latest = ctx.latest ?? serverLatestVersion;
     process.stderr.write(formatUpgradeNotice(current, latest));
   } catch {
@@ -18486,11 +18553,15 @@ 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 5 relevant matches"
+    "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"
   ).argument(
     "<query>",
     'Search terms \u2014 a filename or a description of the content, e.g. "Product_Shot_05" or "black jacket shot"'
-  ).option("--limit <n>", "Max results (1-5, default 5)", "5").option(
+  ).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",
+    "0"
+  ).option(
     "--file-type <type>",
     "Filter by media type: image, video, audio, pdf, or text"
   ).option(
@@ -18500,11 +18571,13 @@ function registerAssetCommands(program2, getOutputOpts) {
     "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.
 
 Examples:
   $ mel asset search "black jacket shot"
-  $ mel asset search "logo" --file-type image --limit 3`
+  $ mel asset search "logo" --file-type image --limit 10
+  $ mel asset search "logo" --limit 20 --offset 20`
   ).action(
     async (query, opts) => {
       const client = getClient();
@@ -18512,6 +18585,7 @@ Examples:
         query: {
           query,
           limit: Number(opts.limit),
+          offset: Number(opts.offset),
           ...opts.fileType !== void 0 && {
             fileType: opts.fileType
           },
@@ -18699,7 +18773,7 @@ function withDefaultHelp(args) {
 }
 function createProgram() {
   const program2 = new Command();
-  program2.name("mel").description("Mel \u2014 Melius agent CLI").version("0.5.2").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.6.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-4GUG5TD2.js";
+} from "../chunk-EN744KKV.js";
 export {
   createProgram,
   withDefaultHelp

package/package.json

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