@melius-ai/cli 0.3.0 → 0.5.0

package/README.md

@@ -25,6 +25,20 @@ mel run wait <runId>
 2. In the Melius app, go to **Team settings → Integrations** and create an API key (it starts with `mel_` and is shown once — copy it immediately).
 3. Authenticate the CLI with it: `mel auth login --api-key mel_<your-key>`.
 
+## Upgrading
+
+Check your installed version with `mel --version`. Upgrade with the same tool you installed with:
+
+```bash
+# npm
+npm install -g @melius-ai/cli@latest
+
+# Homebrew (macOS/Linux)
+brew update && brew upgrade mel
+```
+
+To see the latest published version, run `npm view @melius-ai/cli version` (or visit the [package page on npm](https://www.npmjs.com/package/@melius-ai/cli)). Releases follow [semantic versioning](https://semver.org) — a major version bump (for example `1.x` → `2.x`) can include breaking changes, so review what changed before upgrading across one.
+
 ## Sandbox setup
 
 In the Claude Code sandbox, only two environment variables are needed:
@@ -241,6 +255,25 @@ mel upload ./photo.png
 mel upload ./photo.png --node-id <nodeId> --canvas-id <canvasId>
 ```
 
+### Assets (Files / DAM library)
+
+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)                           |
+
+`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 place` creates a file node per asset (writes to CRDT, no re-upload) and returns `{ placed: [{ assetId, nodeId, mediaType }] }`. Wire the returned `nodeId`s into generations with `mel edge create`. This is the correct way to reuse an existing library asset — do **not** re-upload it.
+
+```bash
+# Find an asset, then bring it onto a canvas and wire it
+mel asset search "black jacket shot" --file-type image
+mel asset place <canvasId> <assetId1> <assetId2>
+```
+
 ### Shell completion
 
 `mel completion <shell>` prints a tab-completion script for `bash`, `zsh`, or `fish`. The script is generated from the live command tree, so it never drifts from the actual commands.

package/dist/bin/mel.js

@@ -4,9 +4,10 @@ import {
   EXIT_API_ERROR,
   createProgram,
   formatError,
+  printUpgradeNoticeIfNeeded,
   withDefaultHelp,
   writeError
-} from "../chunk-JVD4O5T3.js";
+} from "../chunk-UAK5HMFU.js";
 
 // bin/mel.ts
 var program = createProgram();
@@ -23,3 +24,6 @@ try {
     EXIT_API_ERROR
   );
 }
+printUpgradeNoticeIfNeeded({
+  quiet: Boolean(program.opts().quiet)
+});

package/dist/{chunk-JVD4O5T3.js → chunk-UAK5HMFU.js}

@@ -7757,9 +7757,6 @@ function paginationQuery({
 var c = initContract();
 var MAX_CUSTOM_CONTEXT_NAME_LENGTH = 80;
 var MAX_CUSTOM_CONTEXT_INSTRUCTIONS_LENGTH = 4e3;
-var MAX_CUSTOM_CONTEXT_ASSET_DESCRIPTION_LENGTH = 500;
-var MAX_CUSTOM_CONTEXT_FILE_SIZE_BYTES = 10 * 1024 * 1024;
-var CUSTOM_CONTEXT_UPLOAD_PART_SIZE = 16 * 1024 * 1024;
 var MAX_AGENT_CUSTOM_CONTEXTS_PER_MESSAGE = 1;
 var CustomContextAssetSchema = external_exports.object({
   id: external_exports.string().uuid(),
@@ -7772,9 +7769,6 @@ var CustomContextAssetSchema = external_exports.object({
   previewText: external_exports.string().nullable(),
   description: external_exports.string().nullable()
 });
-var UpdateCustomContextAssetBodySchema = external_exports.object({
-  description: external_exports.string().max(MAX_CUSTOM_CONTEXT_ASSET_DESCRIPTION_LENGTH).nullable()
-});
 var CustomContextSummarySchema = external_exports.object({
   id: external_exports.string().uuid(),
   name: external_exports.string(),
@@ -7811,26 +7805,6 @@ var UpdateCustomContextBodySchema = external_exports.object({
   (body) => body.name !== void 0 || body.instructions !== void 0,
   { message: "At least one field must be provided" }
 );
-var CustomContextAssetInitUploadSchema = external_exports.object({
-  filename: external_exports.string(),
-  contentType: external_exports.string(),
-  sizeInBytes: external_exports.number().int().positive().max(MAX_CUSTOM_CONTEXT_FILE_SIZE_BYTES)
-});
-var CustomContextAssetInitUploadResponseSchema = external_exports.object({
-  uploadId: external_exports.string(),
-  s3Bucket: external_exports.string(),
-  s3Key: external_exports.string(),
-  partSize: external_exports.number().int().positive()
-});
-var CustomContextAssetSignPartSchema = external_exports.object({
-  uploadId: external_exports.string(),
-  s3Bucket: external_exports.string(),
-  s3Key: external_exports.string(),
-  partNumber: external_exports.number().int().positive()
-});
-var CustomContextAssetSignPartResponseSchema = external_exports.object({
-  url: external_exports.string()
-});
 var ImportCustomContextToCanvasResponseSchema = external_exports.object({
   groupId: external_exports.string().uuid(),
   nodeIds: external_exports.array(external_exports.string().uuid()),
@@ -7845,17 +7819,6 @@ var ImportCustomContextToCanvasResponseSchema = external_exports.object({
     })
   ).default([])
 });
-var CustomContextAssetCompleteUploadSchema = external_exports.object({
-  uploadId: external_exports.string(),
-  s3Bucket: external_exports.string(),
-  s3Key: external_exports.string(),
-  filename: external_exports.string(),
-  contentType: external_exports.string(),
-  sizeInBytes: external_exports.number().int().positive().max(MAX_CUSTOM_CONTEXT_FILE_SIZE_BYTES),
-  previewText: external_exports.string().nullable().optional(),
-  description: external_exports.string().max(MAX_CUSTOM_CONTEXT_ASSET_DESCRIPTION_LENGTH).nullable().optional(),
-  parts: external_exports.array(CompletedPartSchema)
-});
 var customContextContract = c.router({
   listCustomContexts: {
     method: "GET",
@@ -7920,80 +7883,6 @@ var customContextContract = c.router({
       404: MessageResponseSchema
     }
   },
-  initCustomContextAssetUpload: {
-    method: "POST",
-    path: "/teams/:teamId/custom-contexts/:contextId/assets/init",
-    pathParams: external_exports.object({
-      teamId: external_exports.string().uuid(),
-      contextId: external_exports.string().uuid()
-    }),
-    body: CustomContextAssetInitUploadSchema,
-    responses: {
-      200: CustomContextAssetInitUploadResponseSchema,
-      400: MessageResponseSchema,
-      403: MessageResponseSchema,
-      404: MessageResponseSchema
-    }
-  },
-  signCustomContextAssetUploadPart: {
-    method: "POST",
-    path: "/teams/:teamId/custom-contexts/:contextId/assets/sign-part",
-    pathParams: external_exports.object({
-      teamId: external_exports.string().uuid(),
-      contextId: external_exports.string().uuid()
-    }),
-    body: CustomContextAssetSignPartSchema,
-    responses: {
-      200: CustomContextAssetSignPartResponseSchema,
-      403: MessageResponseSchema,
-      404: MessageResponseSchema
-    }
-  },
-  completeCustomContextAssetUpload: {
-    method: "POST",
-    path: "/teams/:teamId/custom-contexts/:contextId/assets/complete",
-    pathParams: external_exports.object({
-      teamId: external_exports.string().uuid(),
-      contextId: external_exports.string().uuid()
-    }),
-    body: CustomContextAssetCompleteUploadSchema,
-    responses: {
-      200: CustomContextDetailSchema,
-      400: MessageResponseSchema,
-      403: MessageResponseSchema,
-      404: MessageResponseSchema
-    }
-  },
-  removeCustomContextAsset: {
-    method: "DELETE",
-    path: "/teams/:teamId/custom-contexts/:contextId/assets/:assetId",
-    pathParams: external_exports.object({
-      teamId: external_exports.string().uuid(),
-      contextId: external_exports.string().uuid(),
-      assetId: external_exports.string().uuid()
-    }),
-    responses: {
-      200: CustomContextDetailSchema,
-      403: MessageResponseSchema,
-      404: MessageResponseSchema
-    }
-  },
-  updateCustomContextAsset: {
-    method: "PATCH",
-    path: "/teams/:teamId/custom-contexts/:contextId/assets/:assetId",
-    pathParams: external_exports.object({
-      teamId: external_exports.string().uuid(),
-      contextId: external_exports.string().uuid(),
-      assetId: external_exports.string().uuid()
-    }),
-    body: UpdateCustomContextAssetBodySchema,
-    responses: {
-      200: CustomContextDetailSchema,
-      400: MessageResponseSchema,
-      403: MessageResponseSchema,
-      404: MessageResponseSchema
-    }
-  },
   importCustomContextToCanvas: {
     method: "POST",
     path: "/teams/:teamId/custom-contexts/:contextId/import-to-canvas/:canvasId",
@@ -8191,7 +8080,7 @@ var ListFilesResponseSchema = external_exports.object({
   hasMore: external_exports.boolean().optional()
 });
 var AgentAssetSearchQuerySchema = external_exports.object({
-  query: external_exports.string().trim().min(1).max(500).describe("Semantic asset search query"),
+  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),
   source: FileSourceSchema.optional(),
   fileType: FileTypeSchema.optional(),
@@ -8199,6 +8088,12 @@ var AgentAssetSearchQuerySchema = external_exports.object({
     '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.'
   )
 });
+var AgentAssetSearchModeSchema = external_exports.enum(["semantic", "filename"]);
+var AgentAssetSearchRequestSchema = AgentAssetSearchQuerySchema.extend(
+  {
+    mode: AgentAssetSearchModeSchema.optional()
+  }
+);
 var AgentAssetSearchResponseSchema = external_exports.object({
   query: external_exports.string(),
   results: external_exports.array(FileCardSchema),
@@ -8373,7 +8268,7 @@ var filesContract = c2.router({
   searchAgentAssets: {
     method: "GET",
     path: "/files/agent-search",
-    query: AgentAssetSearchQuerySchema,
+    query: AgentAssetSearchRequestSchema,
     responses: {
       200: AgentAssetSearchResponseSchema,
       403: ErrorBodySchema
@@ -9135,11 +9030,10 @@ var AUTO_MODEL_REGISTRY = [
   {
     nodeType: "video",
     inputPattern: "frames-with-audio",
-    // Start + end frame + audio falls back to ltx-2.3-audio because
-    // kling-avatar's variant does not accept end_image_url, so
-    // variant selection would reject the second image.
-    standard: { model: "ltx-2.3-audio", variant: "image-to-video" },
-    fast: { model: "ltx-2.3-audio", variant: "image-to-video" }
+    // 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" }
   },
   {
     nodeType: "video",
@@ -9230,7 +9124,11 @@ var AutoModelProxy = class {
   resolve(input) {
     switch (input.nodeType) {
       case "video":
-        return this.resolveVideo(input.connectedInputs, input.tier);
+        return this.resolveVideo(
+          input.connectedInputs,
+          input.tier,
+          input.canvasVideoInputRoutingEnabled === true
+        );
       case "image":
         return this.resolveImage(input.connectedInputs, input.tier);
       case "text":
@@ -9249,7 +9147,7 @@ var AutoModelProxy = class {
     return this.registry;
   }
   // ── Private resolvers ───────────────────────────────────────────────
-  resolveVideo(ci, tier) {
+  resolveVideo(ci, tier, canvasVideoInputRoutingEnabled) {
     const hasAnyImage = ci.hasImage || ci.hasStartingImage || ci.hasEndImage || ci.hasReferenceImage;
     if (ci.hasVideo && hasAnyImage) {
       return {
@@ -9273,7 +9171,11 @@ var AutoModelProxy = class {
       return this.lookupRoute("video", "video-with-audio", tier);
     }
     if (ci.hasAudio && (ci.hasStartingImage || ci.hasImage) && ci.hasEndImage) {
-      return this.lookupRoute("video", "frames-with-audio", tier);
+      return canvasVideoInputRoutingEnabled ? this.lookupRoute("video", "frames-with-audio", tier) : {
+        valid: true,
+        model: "ltx-2.3-audio",
+        variant: "image-to-video"
+      };
     }
     if (ci.hasAudio && hasAnyImage) {
       return this.lookupRoute("video", "image-with-audio", tier);
@@ -9423,6 +9325,7 @@ var GENERATION_MODES = [
   "video-to-video",
   "reference-to-video",
   "first-last-frame-to-video",
+  "audio-to-video",
   "text-to-speech",
   "audio-to-audio",
   "text-to-sfx",
@@ -9809,6 +9712,181 @@ var ElevenLabsVoiceSettingsSchema = external_exports.object({
   outputFormat: ElevenLabsOutputFormatSchema.optional()
 });
 
+// ../api-contract/src/lora.ts
+var c6 = initContract();
+var LORA_UPLOAD_PART_SIZE_BYTES = 16 * 1024 * 1024;
+var MAX_LORA_NAME_LENGTH = 80;
+var MAX_LORA_DESCRIPTION_LENGTH = 1e3;
+var MAX_LORA_TRIGGER_WORDS_LENGTH = 500;
+var MAX_LORA_FILE_SIZE_BYTES = 2 * 1024 * 1024 * 1024;
+var MAX_LORAS_PER_GENERATION = 5;
+var MIN_LORA_WEIGHT = 0;
+var MAX_LORA_WEIGHT = 1.5;
+var MIN_SDXL_STEPS = 1;
+var MAX_SDXL_STEPS = 50;
+var MIN_SDXL_GUIDANCE_SCALE = 0;
+var MAX_SDXL_GUIDANCE_SCALE = 20;
+var LoraBaseModelSchema = external_exports.enum(["sdxl", "flux", "flux-2", "other"]);
+var LoraSelectionSchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  weight: external_exports.number().min(MIN_LORA_WEIGHT).max(MAX_LORA_WEIGHT)
+});
+var LoraStackSchema = external_exports.array(LoraSelectionSchema).max(MAX_LORAS_PER_GENERATION);
+var AppliedLoraSchema = external_exports.object({
+  id: external_exports.string(),
+  name: external_exports.string(),
+  weight: external_exports.number()
+});
+var SdxlStepsSchema = external_exports.number().int().min(MIN_SDXL_STEPS).max(MAX_SDXL_STEPS);
+var SdxlGuidanceScaleSchema = external_exports.number().min(MIN_SDXL_GUIDANCE_SCALE).max(MAX_SDXL_GUIDANCE_SCALE);
+var LoraSummarySchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  name: external_exports.string(),
+  description: external_exports.string(),
+  /** Activation tokens parsed from the file (best-effort); null if none. */
+  triggerWords: external_exports.string().nullable(),
+  baseModel: LoraBaseModelSchema,
+  /** Recommended blend weight the picker pre-fills. */
+  defaultScale: external_exports.number(),
+  previewUrl: external_exports.string().nullable(),
+  /** teamId is null ⇒ a global/curated LoRA owned by Melius (added by us). */
+  isGlobal: external_exports.boolean(),
+  fileSizeBytes: external_exports.number(),
+  createdAt: external_exports.string(),
+  updatedAt: external_exports.string()
+});
+var ListLorasResponseSchema = external_exports.object({
+  loras: external_exports.array(LoraSummarySchema)
+});
+var InitLoraUploadBodySchema = external_exports.object({
+  filename: external_exports.string().min(1),
+  sizeInBytes: external_exports.number().int().positive().max(MAX_LORA_FILE_SIZE_BYTES)
+});
+var InitLoraUploadResponseSchema = external_exports.object({
+  /** S3 multipart upload id the client threads into sign-part + create. */
+  uploadId: external_exports.string(),
+  s3Bucket: external_exports.string(),
+  s3Key: external_exports.string(),
+  /** Byte size of each part except the last (see LORA_UPLOAD_PART_SIZE_BYTES). */
+  partSize: external_exports.number().int().positive()
+});
+var SignLoraUploadPartBodySchema = external_exports.object({
+  uploadId: external_exports.string().min(1),
+  s3Bucket: external_exports.string().min(1),
+  s3Key: external_exports.string().min(1),
+  partNumber: external_exports.number().int().positive()
+});
+var SignLoraUploadPartResponseSchema = external_exports.object({
+  /** Short-lived presigned PUT for this one part. */
+  url: external_exports.string()
+});
+var CreateLoraBodySchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(MAX_LORA_NAME_LENGTH),
+  description: external_exports.string().max(MAX_LORA_DESCRIPTION_LENGTH).optional(),
+  /** Uploader override; server falls back to the parsed metadata when omitted. */
+  triggerWords: external_exports.string().max(MAX_LORA_TRIGGER_WORDS_LENGTH).optional(),
+  baseModel: LoraBaseModelSchema,
+  s3Bucket: external_exports.string().min(1),
+  s3Key: external_exports.string().min(1),
+  /** Multipart upload id + parts to finalize before validating the object. */
+  uploadId: external_exports.string().min(1),
+  parts: external_exports.array(CompletedPartSchema).min(1),
+  /**
+   * Optional client-attested SHA-256 (integrity reference, never verified).
+   * Omitted for large files — hashing gigabytes in the browser OOMs the tab —
+   * where S3 multipart part ETags already guarantee integrity.
+   */
+  sha256: external_exports.string().optional(),
+  fileSizeBytes: external_exports.number().int().positive().max(MAX_LORA_FILE_SIZE_BYTES),
+  defaultScale: external_exports.number().min(MIN_LORA_WEIGHT).max(MAX_LORA_WEIGHT).optional()
+});
+var UpdateLoraBodySchema = external_exports.object({
+  name: external_exports.string().trim().min(1).max(MAX_LORA_NAME_LENGTH).optional(),
+  description: external_exports.string().max(MAX_LORA_DESCRIPTION_LENGTH).optional(),
+  triggerWords: external_exports.string().max(MAX_LORA_TRIGGER_WORDS_LENGTH).optional()
+});
+var ForbiddenSchema = MessageResponseSchema;
+var NotFoundSchema = MessageResponseSchema;
+var BadRequestSchema = MessageResponseSchema;
+var ConflictSchema = MessageResponseSchema;
+var loraContract = c6.router({
+  listLoras: {
+    method: "GET",
+    path: "/teams/:teamId/loras",
+    pathParams: external_exports.object({ teamId: external_exports.string().uuid() }),
+    responses: {
+      200: ListLorasResponseSchema,
+      403: ForbiddenSchema,
+      404: NotFoundSchema
+    }
+  },
+  // @SkipManagedTransaction on the handler — only starts an S3 multipart.
+  initLoraUpload: {
+    method: "POST",
+    path: "/teams/:teamId/loras/upload",
+    pathParams: external_exports.object({ teamId: external_exports.string().uuid() }),
+    body: InitLoraUploadBodySchema,
+    responses: {
+      200: InitLoraUploadResponseSchema,
+      400: BadRequestSchema,
+      403: ForbiddenSchema
+    }
+  },
+  // @SkipManagedTransaction on the handler — only mints a presigned part PUT.
+  signLoraUploadPart: {
+    method: "POST",
+    path: "/teams/:teamId/loras/upload/sign-part",
+    pathParams: external_exports.object({ teamId: external_exports.string().uuid() }),
+    body: SignLoraUploadPartBodySchema,
+    responses: {
+      200: SignLoraUploadPartResponseSchema,
+      400: BadRequestSchema,
+      403: ForbiddenSchema
+    }
+  },
+  createLora: {
+    method: "POST",
+    path: "/teams/:teamId/loras",
+    pathParams: external_exports.object({ teamId: external_exports.string().uuid() }),
+    body: CreateLoraBodySchema,
+    responses: {
+      201: LoraSummarySchema,
+      400: BadRequestSchema,
+      403: ForbiddenSchema,
+      409: ConflictSchema
+    }
+  },
+  updateLora: {
+    method: "PATCH",
+    path: "/teams/:teamId/loras/:loraId",
+    pathParams: external_exports.object({
+      teamId: external_exports.string().uuid(),
+      loraId: external_exports.string().uuid()
+    }),
+    body: UpdateLoraBodySchema,
+    responses: {
+      200: LoraSummarySchema,
+      400: BadRequestSchema,
+      403: ForbiddenSchema,
+      404: NotFoundSchema,
+      409: ConflictSchema
+    }
+  },
+  deleteLora: {
+    method: "DELETE",
+    path: "/teams/:teamId/loras/:loraId",
+    pathParams: external_exports.object({
+      teamId: external_exports.string().uuid(),
+      loraId: external_exports.string().uuid()
+    }),
+    responses: {
+      200: external_exports.object({ id: external_exports.string().uuid() }),
+      403: ForbiddenSchema,
+      404: NotFoundSchema
+    }
+  }
+});
+
 // ../api-contract/src/preview-asset.ts
 var PreviewAssetSchema = external_exports.object({
   url: external_exports.string(),
@@ -9917,7 +9995,7 @@ var TemplatePortSummarySchema = external_exports.object({
 });
 
 // ../api-contract/src/canvas.ts
-var c6 = initContract();
+var c7 = initContract();
 var CanvasResponseSchema = external_exports.object({
   id: external_exports.string().uuid(),
   teamId: external_exports.string().uuid(),
@@ -9975,7 +10053,13 @@ var ModelConfigSchema = external_exports.object({
   font: external_exports.object({
     source: external_exports.enum(["custom", "google"]),
     familyName: external_exports.string()
-  }).optional()
+  }).optional(),
+  /** SDXL only: the LoRA stack applied to this version (name denormalized so history survives deletion). */
+  loras: external_exports.array(AppliedLoraSchema).optional(),
+  /** SDXL only: sampler steps used for this version. */
+  steps: external_exports.number().optional(),
+  /** SDXL only: classifier-free guidance scale used for this version. */
+  guidanceScale: external_exports.number().optional()
 });
 var ModelConfigInputSchema = external_exports.object({
   model: external_exports.string(),
@@ -10369,7 +10453,17 @@ var RunNodeBodySchema = external_exports.object({
    * ElevenLabs voice tuning for TTS / voice-changer runs. Applied when
    * provided; the `voice-granular-controls` flag only gates the toolbar UI.
    */
-  elevenLabsVoiceSettings: ElevenLabsVoiceSettingsSchema.optional()
+  elevenLabsVoiceSettings: ElevenLabsVoiceSettingsSchema.optional(),
+  /**
+   * LoRA adapters to stack on a self-hosted SDXL generation (`{ id, weight }`).
+   * The server resolves each id to a presigned weights URL and validates team
+   * access. Only honored on the SDXL model.
+   */
+  loras: LoraStackSchema.optional(),
+  /** SDXL sampler steps. Only honored on the SDXL model. */
+  steps: SdxlStepsSchema.optional(),
+  /** SDXL guidance scale. Only honored on the SDXL model. */
+  guidanceScale: SdxlGuidanceScaleSchema.optional()
 });
 var RunImageToolBodySchema = external_exports.object({
   canvasId: external_exports.string().uuid().optional(),
@@ -10798,7 +10892,7 @@ var CanvasSettingsResponseSchema = external_exports.object({
   createdAt: external_exports.string().datetime(),
   updatedAt: external_exports.string().datetime()
 });
-var canvasContract = c6.router({
+var canvasContract = c7.router({
   createCanvas: {
     method: "POST",
     path: "/projects/:projectId/canvases",
@@ -10852,7 +10946,7 @@ var canvasContract = c6.router({
       canvasId: external_exports.string().uuid()
     }),
     body: null,
-    responses: { 204: c6.noBody() }
+    responses: { 204: c7.noBody() }
   },
   duplicateCanvas: {
     method: "POST",
@@ -11267,7 +11361,7 @@ var canvasContract = c6.router({
     pathParams: external_exports.object({ nodeRunId: external_exports.string().uuid() }),
     body: external_exports.object({}),
     responses: {
-      204: c6.noBody(),
+      204: c7.noBody(),
       404: NodeRunErrorResponseSchema,
       409: NodeRunErrorResponseSchema
     },
@@ -11445,7 +11539,7 @@ var canvasContract = c6.router({
     path: "/comment-threads/:threadId",
     pathParams: external_exports.object({ threadId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c6.noBody() }
+    responses: { 204: c7.noBody() }
   },
   // ── Comments ────────────────────────────────────────────────────────
   addComment: {
@@ -11460,7 +11554,7 @@ var canvasContract = c6.router({
     path: "/comments/:commentId",
     pathParams: external_exports.object({ commentId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c6.noBody() }
+    responses: { 204: c7.noBody() }
   },
   // ── Direct CRDT Mutations (CLI/Agent) ───────────────────────────────
   // These endpoints write directly to the Y.Doc (CRDT) for the canvas.
@@ -11500,7 +11594,7 @@ var canvasContract = c6.router({
     }),
     body: null,
     responses: {
-      204: c6.noBody(),
+      204: c7.noBody(),
       404: MessageResponseSchema,
       409: MessageResponseSchema
     }
@@ -11536,7 +11630,7 @@ var canvasContract = c6.router({
     }),
     body: null,
     responses: {
-      204: c6.noBody(),
+      204: c7.noBody(),
       404: MessageResponseSchema,
       409: MessageResponseSchema
     }
@@ -11629,7 +11723,7 @@ var canvasContract = c6.router({
     }),
     body: null,
     responses: {
-      204: c6.noBody(),
+      204: c7.noBody(),
       403: MessageResponseSchema,
       404: MessageResponseSchema,
       409: MessageResponseSchema
@@ -11675,6 +11769,35 @@ var canvasContract = c6.router({
       404: MessageResponseSchema
     }
   },
+  // Server-side placement of existing library assets onto a canvas, by id.
+  // Unlike `linkLibraryAsset` (which links an asset to a node the in-app
+  // client already created in the CRDT), this CREATES the file node(s)
+  // server-side and references the ORIGINAL asset (no duplicate) — the path
+  // MCP/CLI need, since they have no browser canvas store. Positions are
+  // planned server-side into open space. Gated by the same asset-search
+  // entitlement (`isAgentSearchToolAvailable`) as `searchAgentAssets`.
+  placeLibraryAssets: {
+    method: "POST",
+    path: "/canvases/:canvasId/library-assets/place",
+    pathParams: external_exports.object({ canvasId: external_exports.string().uuid() }),
+    body: external_exports.object({
+      assetIds: external_exports.array(external_exports.string().uuid()).min(1).max(10)
+    }),
+    responses: {
+      200: external_exports.object({
+        placed: external_exports.array(
+          external_exports.object({
+            assetId: external_exports.string().uuid(),
+            nodeId: external_exports.string().uuid(),
+            mediaType: external_exports.enum(["image", "video", "audio", "pdf"])
+          })
+        )
+      }),
+      403: external_exports.object({ message: external_exports.string() }),
+      404: external_exports.object({ message: external_exports.string() })
+    },
+    summary: "Place library assets onto a canvas"
+  },
   // ── Canvas Settings ──────────────────────────────────────────────
   getCanvasSettings: {
     method: "GET",
@@ -11713,7 +11836,7 @@ var canvasContract = c6.router({
     path: "/canvases/:canvasId/settings",
     pathParams: external_exports.object({ canvasId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c6.noBody() }
+    responses: { 204: c7.noBody() }
   },
   // ── Agent presence ──────────────────────────────────────────────────
   // Broadcast an agent's "claim region" to all connected canvas
@@ -11740,16 +11863,16 @@ var canvasContract = c6.router({
         }).nullable().optional(),
         status: external_exports.string().min(1).max(80)
       }).refine(
-        (c16) => c16.nodeIds.length > 0 || c16.bounds != null,
+        (c17) => c17.nodeIds.length > 0 || c17.bounds != null,
         "claim must include nodeIds or bounds"
       ).nullable()
     }),
-    responses: { 204: c6.noBody() }
+    responses: { 204: c7.noBody() }
   }
 });
 
 // ../api-contract/src/custom-font.ts
-var c7 = initContract();
+var c8 = initContract();
 var CustomFontResponseSchema = external_exports.object({
   id: external_exports.string().uuid(),
   familyName: external_exports.string(),
@@ -11773,10 +11896,16 @@ var CompleteCustomFontUploadBodySchema = external_exports.object({
   sizeInBytes: external_exports.number().int().positive(),
   parts: external_exports.array(CompletedPartSchema)
 });
-var customFontContract = c7.router({
+var ListCustomFontsQuerySchema = external_exports.object({
+  // Optional name filter (matches family name or original filename). Used by
+  // the Assets page fonts view; the node font pickers omit it to list all.
+  search: external_exports.string().trim().optional()
+});
+var customFontContract = c8.router({
   list: {
     method: "GET",
     path: "/custom-fonts",
+    query: ListCustomFontsQuerySchema,
     responses: { 200: ListCustomFontsResponseSchema },
     summary: "List custom fonts for the team"
   },
@@ -11801,7 +11930,7 @@ var customFontContract = c7.router({
 });
 
 // ../api-contract/src/generation.ts
-var c8 = initContract();
+var c9 = initContract();
 var GenerationJobStatusSchema = external_exports.enum([
   "in_progress",
   "finished",
@@ -11859,7 +11988,21 @@ var GenerationRunBodySchema = external_exports.object({
    * by every other model. When absent, the server falls back to a
    * default Google font (Inter).
    */
-  font: BetterFontSelectionSchema.optional()
+  font: BetterFontSelectionSchema.optional(),
+  /**
+   * LoRA adapters to stack on a LoRA-capable image generation (`{ id, weight }`;
+   * the server resolves each id to a presigned weights URL). Only honored on
+   * LoRA-capable models (SDXL on Modal, Flux on fal); ignored by every other
+   * model.
+   */
+  loras: LoraStackSchema.optional(),
+  /** Sampler steps. Only honored on LoRA-capable models (SDXL, Flux). */
+  steps: SdxlStepsSchema.optional(),
+  /**
+   * Classifier-free guidance scale. Only honored on LoRA-capable models
+   * (SDXL, Flux).
+   */
+  guidanceScale: SdxlGuidanceScaleSchema.optional()
 });
 var ModelCategorySchema = external_exports.enum([
   "image",
@@ -12014,6 +12157,14 @@ var ModelVariantResponseSchema = external_exports.object({
   maxReferenceImagesWithEndImage: external_exports.number().nullable().optional(),
   maxVideoInputs: external_exports.number().nullable().optional(),
   maxAudioInputs: external_exports.number().nullable().optional(),
+  /**
+   * For variants accepting both video and audio: whether the connected
+   * durations must line up. `false` for lipsync models (e.g. Kling Lipsync)
+   * whose endpoint takes audio independent of the video length, so the
+   * frontend preflight must not block a mismatch. Omitted/null means the
+   * default duration-match requirement applies.
+   */
+  requiresMatchingAudioVideoDuration: external_exports.boolean().nullable().optional(),
   maxNativeOutputs: external_exports.number().nullable(),
   maxInputArea: external_exports.number().nullable(),
   inputImageFileSizeConstraints: InputFileSizeConstraintsResponseSchema.nullable().optional(),
@@ -12036,7 +12187,13 @@ var ModelVariantResponseSchema = external_exports.object({
   estimatedLatencySeconds: external_exports.number().nullable().optional(),
   defaultResolution: OutputResolutionSchema.nullable().optional(),
   featuredDescription: external_exports.string().nullable(),
-  cost: ModelCostSchema.optional()
+  cost: ModelCostSchema.optional(),
+  /**
+   * Per-second credit multiplier applied to connected input video duration,
+   * using the resolution-adjusted output per-second price as the base. Lets
+   * the cost preview include the input-video surcharge that the server bills.
+   */
+  inputVideoCreditMultiplier: external_exports.number().optional()
 });
 var ModelResponseSchema = external_exports.object({
   name: external_exports.string(),
@@ -12112,7 +12269,7 @@ var SeedancePrecheckResponseSchema = external_exports.object({
   reason: external_exports.string(),
   cacheKey: external_exports.string()
 });
-var generationContract = c8.router({
+var generationContract = c9.router({
   listGenerativeModels: {
     method: "GET",
     path: "/generation/models",
@@ -12171,7 +12328,7 @@ var generationContract = c8.router({
       until: external_exports.string().datetime().optional()
     }),
     responses: {
-      200: c8.otherResponse({
+      200: c9.otherResponse({
         contentType: "text/csv",
         body: external_exports.string()
       })
@@ -12198,7 +12355,7 @@ var generationContract = c8.router({
 });
 
 // ../api-contract/src/presets.ts
-var c9 = initContract();
+var c10 = initContract();
 var TextNodeDataSchema = external_exports.object({
   title: external_exports.string(),
   mode: external_exports.string(),
@@ -12300,7 +12457,7 @@ var PresetResponseSchema = external_exports.object({
   nodes: external_exports.array(PresetNodeSchema),
   edges: external_exports.array(PresetEdgeSchema)
 });
-var presetsContract = c9.router({
+var presetsContract = c10.router({
   listPresets: {
     method: "GET",
     path: "/presets",
@@ -12314,7 +12471,7 @@ var presetsContract = c9.router({
 });
 
 // ../api-contract/src/profile.ts
-var c10 = initContract();
+var c11 = initContract();
 var MagicResizeCustomResolutionSchema = external_exports.object({
   width: external_exports.number().int().min(64).max(4096),
   height: external_exports.number().int().min(64).max(4096)
@@ -12345,7 +12502,7 @@ var ReferralRewardNotificationSchema = external_exports.object({
   counterpartName: external_exports.string(),
   redeemedAt: external_exports.string().datetime()
 });
-var profileContract = c10.router({
+var profileContract = c11.router({
   getMyProfile: {
     method: "GET",
     path: "/profile/me",
@@ -12404,7 +12561,7 @@ var profileContract = c10.router({
 });
 
 // ../api-contract/src/share.ts
-var c11 = initContract();
+var c12 = initContract();
 var ShareModeSchema = external_exports.enum(["restricted", "view"]);
 var ShareCanvasResponseSchema = external_exports.object({
   id: external_exports.string().uuid(),
@@ -12440,7 +12597,7 @@ var ShareProjectInfoResponseSchema = external_exports.object({
     avatarUrl: external_exports.string().nullable()
   }).nullable()
 });
-var shareContract = c11.router({
+var shareContract = c12.router({
   // Public endpoint — no auth required
   getSharedProjectInfo: {
     method: "GET",
@@ -12527,7 +12684,7 @@ var shareContract = c11.router({
 });
 
 // ../api-contract/src/team.ts
-var c12 = initContract();
+var c13 = initContract();
 var TeamRoleSchema = external_exports.enum(["owner", "admin", "editor", "viewer"]);
 var TeamPlanSchema = external_exports.enum([
   "TIER_0",
@@ -12558,6 +12715,34 @@ var EnterpriseStripeBillingInputSchema = external_exports.object({
     path: ["contractEndAt"]
   }
 );
+var CustomPlanCreditRolloverPolicySchema = external_exports.discriminatedUnion(
+  "mode",
+  [
+    external_exports.object({ mode: external_exports.literal("none") }),
+    external_exports.object({ mode: external_exports.literal("unlimited") }),
+    external_exports.object({
+      mode: external_exports.literal("months"),
+      months: external_exports.number().int().nonnegative()
+    }),
+    external_exports.object({
+      mode: external_exports.literal("percentage"),
+      percentage: external_exports.number().int().min(0).max(100)
+    })
+  ]
+);
+var EnterpriseOrderDetailsSchema = external_exports.object({
+  orderType: external_exports.string().min(1),
+  customPlanType: CustomPlanTypeSchema.optional(),
+  creditPackageAmount: external_exports.number().int().nonnegative(),
+  creditPackageUnit: external_exports.string().min(1),
+  creditRolloverPolicy: CustomPlanCreditRolloverPolicySchema.optional(),
+  orderDate: external_exports.string().date(),
+  /** Omit for plans with no fixed contract term (e.g. monthly Stripe plans). */
+  termCount: external_exports.number().int().positive().optional(),
+  termUnit: external_exports.string().min(1).optional(),
+  lineItems: external_exports.array(EnterpriseOrderLineItemSchema),
+  totalContractValue: external_exports.string().min(1)
+});
 var EnterprisePendingExpansionSchema = external_exports.object({
   /** Stable id minted at prepare; also the credit-grant idempotency key. */
   id: external_exports.string(),
@@ -12571,6 +12756,13 @@ var EnterprisePendingExpansionSchema = external_exports.object({
   /** New contract end when the operator chose a new term; absent means keep the existing term. */
   contractEndAt: external_exports.string().datetime().optional(),
   keepContractEnd: external_exports.boolean(),
+  /**
+   * Operator-authored replacement order details (line items, total contract
+   * value, credit package, term) applied to the stored order when the customer
+   * activates. Absent keeps the existing terms. Purely presentational — the
+   * actual charge/credits come from the billing figures above.
+   */
+  newOrderDetails: EnterpriseOrderDetailsSchema.optional(),
   preparedAt: external_exports.string().datetime(),
   preparedByEmail: external_exports.string().nullable()
 });
@@ -12606,33 +12798,7 @@ var EnterpriseStripeBillingAuditEntrySchema = external_exports.object({
   previousStripePriceId: external_exports.string().optional(),
   notes: external_exports.string().optional()
 });
-var CustomPlanCreditRolloverPolicySchema = external_exports.discriminatedUnion(
-  "mode",
-  [
-    external_exports.object({ mode: external_exports.literal("none") }),
-    external_exports.object({ mode: external_exports.literal("unlimited") }),
-    external_exports.object({
-      mode: external_exports.literal("months"),
-      months: external_exports.number().int().nonnegative()
-    }),
-    external_exports.object({
-      mode: external_exports.literal("percentage"),
-      percentage: external_exports.number().int().min(0).max(100)
-    })
-  ]
-);
-var EnterpriseOrderSchema = external_exports.object({
-  orderType: external_exports.string().min(1),
-  customPlanType: CustomPlanTypeSchema.optional(),
-  creditPackageAmount: external_exports.number().int().nonnegative(),
-  creditPackageUnit: external_exports.string().min(1),
-  creditRolloverPolicy: CustomPlanCreditRolloverPolicySchema.optional(),
-  orderDate: external_exports.string().date(),
-  /** Omit for plans with no fixed contract term (e.g. monthly Stripe plans). */
-  termCount: external_exports.number().int().positive().optional(),
-  termUnit: external_exports.string().min(1).optional(),
-  lineItems: external_exports.array(EnterpriseOrderLineItemSchema),
-  totalContractValue: external_exports.string().min(1),
+var EnterpriseOrderSchema = EnterpriseOrderDetailsSchema.extend({
   stripeBilling: EnterpriseStripeBillingInputSchema.optional()
 });
 var CustomerEnterpriseOrderSchema = EnterpriseOrderSchema.extend({
@@ -12741,7 +12907,7 @@ var EmailInviteSchema = external_exports.object({
   senderName: external_exports.string(),
   createdAt: external_exports.string().datetime()
 });
-var teamContract = c12.router({
+var teamContract = c13.router({
   createTeam: {
     method: "POST",
     path: "/teams",
@@ -12806,7 +12972,7 @@ var teamContract = c12.router({
     method: "DELETE",
     path: "/teams/current",
     body: null,
-    responses: { 204: c12.noBody() }
+    responses: { 204: c13.noBody() }
   },
   listMembers: {
     method: "GET",
@@ -12827,7 +12993,7 @@ var teamContract = c12.router({
     path: "/teams/current/members/:userId",
     pathParams: external_exports.object({ userId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c12.noBody() }
+    responses: { 204: c13.noBody() }
   },
   getShareableLink: {
     method: "GET",
@@ -12868,7 +13034,7 @@ var teamContract = c12.router({
     path: "/teams/current/invite-email/:inviteId",
     pathParams: external_exports.object({ inviteId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c12.noBody() }
+    responses: { 204: c13.noBody() }
   },
   listJoinRequests: {
     method: "GET",
@@ -12887,7 +13053,7 @@ var teamContract = c12.router({
     path: "/teams/current/join-requests/:requestId",
     pathParams: external_exports.object({ requestId: external_exports.string().uuid() }),
     body: null,
-    responses: { 204: c12.noBody() }
+    responses: { 204: c13.noBody() }
   },
   updateDomainJoinSettings: {
     method: "PATCH",
@@ -12909,7 +13075,7 @@ var teamContract = c12.router({
 });
 
 // ../api-contract/src/project.ts
-var c13 = initContract();
+var c14 = initContract();
 var CanvasSummarySchema = external_exports.object({
   id: external_exports.string().uuid(),
   title: external_exports.string(),
@@ -13008,7 +13174,7 @@ var ProjectSettingsResponseSchema = external_exports.object({
   createdAt: external_exports.string().datetime(),
   updatedAt: external_exports.string().datetime()
 });
-var projectContract = c13.router({
+var projectContract = c14.router({
   createProject: {
     method: "POST",
     path: "/projects",
@@ -13045,14 +13211,14 @@ var projectContract = c13.router({
     path: "/projects/:projectId",
     pathParams: ProjectIdParamsSchema,
     body: null,
-    responses: { 204: c13.noBody() }
+    responses: { 204: c14.noBody() }
   },
   recordProjectView: {
     method: "POST",
     path: "/projects/:projectId/view",
     pathParams: ProjectIdParamsSchema,
     body: null,
-    responses: { 204: c13.noBody() }
+    responses: { 204: c14.noBody() }
   },
   listRecentProjects: {
     method: "GET",
@@ -13152,12 +13318,12 @@ var projectContract = c13.router({
     path: "/projects/:projectId/settings",
     pathParams: ProjectIdParamsSchema,
     body: null,
-    responses: { 204: c13.noBody() }
+    responses: { 204: c14.noBody() }
   }
 });
 
 // ../api-contract/src/upload.ts
-var c14 = initContract();
+var c15 = initContract();
 var InitUploadBodySchema = external_exports.object({
   nodeId: external_exports.string().uuid().optional(),
   filename: external_exports.string(),
@@ -13229,7 +13395,7 @@ var CompleteUploadResponseSchema = external_exports.object({
   // clients tolerate deploy skew with older core versions.
   nodeVersionId: external_exports.string().uuid().nullable().optional()
 });
-var uploadContract = c14.router({
+var uploadContract = c15.router({
   init: {
     method: "POST",
     path: "/upload/init",
@@ -13254,8 +13420,8 @@ var uploadContract = c14.router({
 });
 
 // ../api-contract/src/public/index.ts
-var c15 = initContract();
-var publicContract = c15.router(
+var c16 = initContract();
+var publicContract = c16.router(
   {
     project: {
       create: projectContract.createProject,
@@ -13315,6 +13481,13 @@ var publicContract = c15.router(
       signPart: uploadContract.signPart,
       complete: uploadContract.complete
     },
+    asset: {
+      // Semantic/filename search of the team's Files (DAM) library, and
+      // placing a found asset onto a canvas by reference (no duplicate).
+      // Both are gated to Pro + Enterprise by the handlers.
+      search: filesContract.searchAgentAssets,
+      place: canvasContract.placeLibraryAssets
+    },
     model: {
       list: generationContract.listGenerativeModels,
       autoDefaults: generationContract.getAutoModelDefaults
@@ -13548,6 +13721,65 @@ function setConfigValue(key, value) {
   writeConfigFile({ [key]: value });
 }
 
+// src/lib/update-notice.ts
+var MEL_CLI_LATEST_VERSION_HEADER = "x-mel-cli-latest-version";
+var serverLatestVersion = null;
+function recordServerLatestVersion(value) {
+  if (value) serverLatestVersion = value;
+}
+var SEMVER_PATTERN = /^v?\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
+function parseVersion(version) {
+  const trimmed = version.trim();
+  if (!SEMVER_PATTERN.test(trimmed)) return null;
+  const core = trimmed.replace(/^v/, "").split(/[-+]/)[0];
+  const [major, minor, patch] = core.split(".").map((p) => Number.parseInt(p, 10));
+  return [major, minor, patch];
+}
+function isNewerVersion(current, latest) {
+  const c17 = parseVersion(current);
+  const l = parseVersion(latest);
+  if (!c17 || !l) return false;
+  for (let i = 0; i < 3; i++) {
+    if (l[i] > c17[i]) return true;
+    if (l[i] < c17[i]) return false;
+  }
+  return false;
+}
+function isMajorUpgrade(current, latest) {
+  const c17 = parseVersion(current);
+  const l = parseVersion(latest);
+  if (!c17 || !l) return false;
+  return l[0] > c17[0];
+}
+function shouldShowUpgradeNotice(ctx = {}) {
+  const current = ctx.current ?? "0.5.0";
+  const latest = ctx.latest ?? serverLatestVersion;
+  const env = ctx.env ?? process.env;
+  const isTty = ctx.isTty ?? Boolean(process.stderr.isTTY);
+  if (!latest) return false;
+  if (ctx.quiet) return false;
+  if (!isTty) return false;
+  if (env["MEL_NO_UPDATE_NOTIFIER"]) return false;
+  if (env["CI"]) return false;
+  return isNewerVersion(current, latest);
+}
+function formatUpgradeNotice(current, latest) {
+  const breaking = isMajorUpgrade(current, latest) ? " This is a new major version that may include breaking changes." : "";
+  return `
+mel ${latest} is available (you have ${current}).${breaking}
+Upgrade: npm install -g @melius-ai/cli@latest  (or: brew upgrade mel)   Silence: MEL_NO_UPDATE_NOTIFIER=1
+`;
+}
+function printUpgradeNoticeIfNeeded(ctx = {}) {
+  try {
+    if (!shouldShowUpgradeNotice(ctx)) return;
+    const current = ctx.current ?? "0.5.0";
+    const latest = ctx.latest ?? serverLatestVersion;
+    process.stderr.write(formatUpgradeNotice(current, latest));
+  } catch {
+  }
+}
+
 // src/lib/client.ts
 var _client = null;
 var _verbose = false;
@@ -13678,6 +13910,9 @@ function createClient(config) {
         }
         const t0 = _verbose ? Date.now() : 0;
         const response = await fetchWithRateLimitRetry(path4, fetchOpts);
+        recordServerLatestVersion(
+          response.headers.get(MEL_CLI_LATEST_VERSION_HEADER)
+        );
         const contentType = response.headers.get("content-type");
         let responseBody;
         if (contentType?.includes("application/json")) {
@@ -14228,8 +14463,8 @@ function computeAutoformat(allNodes, allEdges, nodeIds) {
     topologyEdges.push({ ...edge, srcNodeId: src, dstNodeId: dst });
   }
   const rawComponents = findConnectedComponents(targetIds, topologyEdges);
-  const connectedComponents = rawComponents.filter((c16) => c16.length > 1);
-  const isolatedIds = rawComponents.filter((c16) => c16.length === 1).flat().sort();
+  const connectedComponents = rawComponents.filter((c17) => c17.length > 1);
+  const isolatedIds = rawComponents.filter((c17) => c17.length === 1).flat().sort();
   if (isolatedIds.length > 0) connectedComponents.push(isolatedIds);
   const components = connectedComponents.sort((a, b) => {
     const aHasText = a.some((id) => {
@@ -14419,7 +14654,7 @@ function computeAutoformat(allNodes, allEdges, nodeIds) {
       const col = i % cols;
       const row = Math.floor(i / cols);
       let cx = originX;
-      for (let c16 = 0; c16 < col; c16++) cx += colWidths[c16] + COL_GAP2;
+      for (let c17 = 0; c17 < col; c17++) cx += colWidths[c17] + COL_GAP2;
       let cy = originY;
       for (let r = 0; r < row; r++) cy += rowHeights[r] + ROW_GAP2;
       posMap.set(targets[i].id, { x: cx, y: cy });
@@ -14494,16 +14729,16 @@ function findNearestClearPosition(idealX, idealY, blockW, blockH, obstacles) {
   let bestPos = null;
   let bestMaxDim = Infinity;
   let bestDist = Infinity;
-  for (const c16 of candidates) {
-    if (!overlapsAny(c16.x, c16.y, blockW, blockH, obstacles)) {
-      const totalW = Math.max(allMaxX, c16.x + blockW) - Math.min(allMinX, c16.x);
-      const totalH = Math.max(allMaxY, c16.y + blockH) - Math.min(allMinY, c16.y);
+  for (const c17 of candidates) {
+    if (!overlapsAny(c17.x, c17.y, blockW, blockH, obstacles)) {
+      const totalW = Math.max(allMaxX, c17.x + blockW) - Math.min(allMinX, c17.x);
+      const totalH = Math.max(allMaxY, c17.y + blockH) - Math.min(allMinY, c17.y);
       const maxDim = Math.max(totalW, totalH);
-      const dist = Math.abs(c16.x - idealX) + Math.abs(c16.y - idealY);
+      const dist = Math.abs(c17.x - idealX) + Math.abs(c17.y - idealY);
       if (maxDim < bestMaxDim || maxDim === bestMaxDim && dist < bestDist) {
         bestMaxDim = maxDim;
         bestDist = dist;
-        bestPos = c16;
+        bestPos = c17;
       }
     }
   }
@@ -18215,6 +18450,82 @@ Examples:
   );
 }
 
+// src/commands/asset.ts
+function registerAssetCommands(program2, getOutputOpts) {
+  const asset = program2.command("asset").description(
+    "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"
+  ).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(
+    "--file-type <type>",
+    "Filter by media type: image, video, audio, pdf, or text"
+  ).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)"
+  ).addHelpText(
+    "after",
+    `
+Returns: { query, total, results: [{ assetId, filename, displayName, fileType, contentType, previewUrl, assetUrl, durationInMs }] }.
+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`
+  ).action(
+    async (query, opts) => {
+      const client = getClient();
+      const result = await client.asset.search({
+        query: {
+          query,
+          limit: Number(opts.limit),
+          ...opts.fileType !== void 0 && {
+            fileType: opts.fileType
+          },
+          ...opts.canvasId !== void 0 && {
+            canvasId: opts.canvasId
+          }
+        }
+      });
+      if (result.status !== 200) {
+        handleApiError(result.status, result.body);
+      }
+      writeJson(result.body, getOutputOpts());
+    }
+  );
+  asset.command("place").description(
+    "Place existing library assets onto a canvas by id, referencing the ORIGINAL asset (no duplicate, no re-upload). Creates file nodes server-side (writes to CRDT) and returns their node ids"
+  ).argument(
+    "<canvasId>",
+    "Canvas ID to place onto (from mel canvas create or mel canvas list)"
+  ).argument(
+    "<assetIds...>",
+    "One or more asset IDs from mel asset search (max 10)"
+  ).addHelpText(
+    "after",
+    `
+Returns: { placed: [{ assetId, nodeId, mediaType }] }.
+Wire the returned nodeIds into generations with mel edge create.
+
+Examples:
+  $ mel asset place <canvasId> <assetId>
+  $ mel asset place <canvasId> <assetId1> <assetId2>`
+  ).action(async (canvasId, assetIds) => {
+    const client = getClient();
+    const result = await client.asset.place({
+      params: { canvasId },
+      body: { assetIds }
+    });
+    if (result.status !== 200) {
+      handleApiError(result.status, result.body);
+    }
+    writeJson(result.body, getOutputOpts());
+  });
+}
+
 // src/commands/completion.ts
 var GLOBAL_FLAGS = [
   "--json",
@@ -18350,7 +18661,7 @@ function withDefaultHelp(args) {
 }
 function createProgram() {
   const program2 = new Command();
-  program2.name("mel").description("Mel \u2014 Melius agent CLI").version("0.3.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.5.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(
@@ -18394,6 +18705,7 @@ Learn more: https://docs.melius.com`
     registerSkillCommands(program2, getOutputOpts);
   }
   registerUploadCommands(program2, getOutputOpts);
+  registerAssetCommands(program2, getOutputOpts);
   registerCompletionCommands(program2);
   applyStructuredErrors(program2);
   return program2;
@@ -18424,6 +18736,7 @@ export {
   EXIT_API_ERROR,
   formatError,
   writeError,
+  printUpgradeNoticeIfNeeded,
   withDefaultHelp,
   createProgram
 };

package/dist/src/index.js

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

package/package.json

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