@melius-ai/cli 0.2.1 → 0.4.0

package/README.md

@@ -8,7 +8,7 @@ The programmatic interface to the Melius platform. Built for AI agents running i
 npm install -g @melius-ai/cli
 # or with Homebrew (macOS/Linux): brew install melius-ai/tap/mel
 
-# Authenticate
+# Authenticate (see "Get an API key" below to obtain a key)
 mel auth login --api-key mel_<your-key>
 
 # Build a canvas
@@ -19,6 +19,26 @@ mel run start <nodeId> --canvas-id <canvasId>
 mel run wait <runId>
 ```
 
+## Get an API key
+
+1. Sign up at [app.melius.com/signup](https://app.melius.com/signup) if you don't have a Melius account yet.
+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:
@@ -323,7 +343,7 @@ All commands follow the same contract:
         "code": "UNAUTHORIZED",
         "message": "Invalid or expired API key",
         "status": 401,
-        "suggestion": "Run: mel auth login --api-key <key>"
+        "suggestion": "Sign up at https://app.melius.com/signup, then create an API key in the Melius app under Team settings → Integrations. Then run: mel auth login --api-key mel_..."
     }
 }
 ```

package/dist/bin/mel.js

@@ -4,13 +4,17 @@ import {
   EXIT_API_ERROR,
   createProgram,
   formatError,
+  printUpgradeNoticeIfNeeded,
+  withDefaultHelp,
   writeError
-} from "../chunk-6IN2VKUC.js";
+} from "../chunk-EXHDKHNG.js";
 
 // bin/mel.ts
 var program = createProgram();
 try {
-  await program.parseAsync(process.argv);
+  await program.parseAsync(withDefaultHelp(process.argv.slice(2)), {
+    from: "user"
+  });
 } catch (err) {
   writeError(
     formatError(
@@ -20,3 +24,6 @@ try {
     EXIT_API_ERROR
   );
 }
+printUpgradeNoticeIfNeeded({
+  quiet: Boolean(program.opts().quiet)
+});

package/dist/{chunk-6IN2VKUC.js → chunk-EXHDKHNG.js}

@@ -8112,6 +8112,18 @@ var BulkMoveFilesBodySchema = external_exports.object({
   assetIds: BulkFileAssetIdsSchema,
   folderId: external_exports.string().uuid().nullable()
 });
+var BulkDownloadableIdsSchema = external_exports.array(external_exports.string().uuid()).max(MAX_BULK_FILE_ACTION_ASSET_IDS).default([]);
+var BulkDownloadFilesBodySchema = external_exports.object({
+  assetIds: BulkDownloadableIdsSchema,
+  folderIds: BulkDownloadableIdsSchema
+}).refine((body) => body.assetIds.length + body.folderIds.length > 0, {
+  message: "Select at least one file or folder to download"
+});
+var BulkDownloadFilesResponseSchema = external_exports.object({
+  // Presigned URL of a freshly built zip archive of the requested assets.
+  url: external_exports.string().url(),
+  filename: external_exports.string()
+});
 var BulkHideFilesBodySchema = external_exports.object({
   assetIds: BulkFileAssetIdsSchema
 });
@@ -8218,6 +8230,10 @@ var CompleteFilesUploadBodySchema = external_exports.object({
 var CompleteFilesUploadResponseSchema = external_exports.object({
   file: FileCardSchema
 });
+var EmbeddingStorageUsageResponseSchema = external_exports.object({
+  usedBytes: external_exports.number(),
+  limitBytes: external_exports.number()
+});
 var ErrorBodySchema = MessageResponseSchema;
 var filesContract = c2.router({
   createFileFolder: {
@@ -8287,6 +8303,17 @@ var filesContract = c2.router({
     },
     summary: "Move a file to a folder"
   },
+  bulkDownloadFiles: {
+    method: "POST",
+    path: "/files/bulk/download",
+    body: BulkDownloadFilesBodySchema,
+    responses: {
+      200: BulkDownloadFilesResponseSchema,
+      403: ErrorBodySchema,
+      404: ErrorBodySchema
+    },
+    summary: "Download files and folders as a zip archive"
+  },
   bulkHideFiles: {
     method: "POST",
     path: "/files/bulk/hide",
@@ -8353,6 +8380,15 @@ var filesContract = c2.router({
     },
     summary: "Search team assets for the agent"
   },
+  getEmbeddingStorageUsage: {
+    method: "GET",
+    path: "/files/embedding-storage-usage",
+    responses: {
+      200: EmbeddingStorageUsageResponseSchema,
+      403: ErrorBodySchema
+    },
+    summary: "Get the team's DAM embedding-storage usage and cap"
+  },
   getFileDetail: {
     method: "GET",
     path: "/files/:assetId/detail",
@@ -9052,7 +9088,7 @@ var AUTO_MODEL_REGISTRY = [
   {
     nodeType: "video",
     inputPattern: "text-only",
-    standard: { model: "ltx-2.3", variant: "text-to-video" },
+    standard: { model: "kling-o3", variant: "text-to-video" },
     fast: { model: "grok-imagine-video", variant: "text-to-video" }
   },
   {
@@ -9070,7 +9106,7 @@ var AUTO_MODEL_REGISTRY = [
   {
     nodeType: "video",
     inputPattern: "reference-to-video",
-    standard: { model: "veo-3.1", variant: "reference-to-video" },
+    standard: { model: "kling-o3", variant: "reference-to-video" },
     fast: { model: "kling-o3", variant: "reference-to-video" }
   },
   {
@@ -9115,13 +9151,13 @@ var AUTO_MODEL_REGISTRY = [
   {
     nodeType: "image",
     inputPattern: "text-to-image",
-    standard: { model: "gpt-image-2-medium", variant: "text-to-image" },
+    standard: { model: "nano-banana-pro", variant: "text-to-image" },
     fast: { model: "flux-schnell", variant: "text-to-image" }
   },
   {
     nodeType: "image",
     inputPattern: "image-to-image",
-    standard: { model: "gpt-image-2-medium", variant: "image-to-image" },
+    standard: { model: "nano-banana-pro", variant: "image-to-image" },
     fast: { model: "grok-imagine", variant: "image-to-image" }
   },
   // ── Text ────────────────────────────────────────────────────────────
@@ -9773,6 +9809,128 @@ var ElevenLabsVoiceSettingsSchema = external_exports.object({
   outputFormat: ElevenLabsOutputFormatSchema.optional()
 });
 
+// ../api-contract/src/lora.ts
+var c6 = initContract();
+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 = 60;
+var MIN_SDXL_GUIDANCE_SCALE = 0;
+var MAX_SDXL_GUIDANCE_SCALE = 20;
+var LoraBaseModelSchema = external_exports.enum(["sdxl", "flux", "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({
+  /** Short-lived presigned PUT the client uploads the raw weights to. */
+  uploadUrl: external_exports.string(),
+  s3Bucket: external_exports.string(),
+  s3Key: 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),
+  /** Client-attested SHA-256 of the uploaded file (integrity reference). */
+  sha256: external_exports.string().min(1),
+  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 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 mints a presigned PUT.
+  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
+    }
+  },
+  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
+    }
+  },
+  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(),
@@ -9881,7 +10039,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(),
@@ -9939,7 +10097,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(),
@@ -10222,6 +10386,9 @@ var CanvasContentResponseSchema = external_exports.object({
   edges: external_exports.array(EdgeResponseSchema),
   modelPresets: CanvasMediaPresetSchema.optional().describe(
     "Canvas-wide default model + variant the user configured in canvas settings, per category (image/video/text/audio). When a node is created with no modelConfig, the server pins these defaults exactly. Use this to know what model+mode will apply, so you can pick correct edge handles and avoid hallucinating the default"
+  ),
+  videoDurationOptions: external_exports.array(external_exports.number().int().positive()).optional().describe(
+    "The exact clip durations (seconds) the canvas default video model supports, e.g. [3,4,5,\u2026,15]. Pick each video node's duration from this list \u2014 it is the real range, so you never need model_list just to find valid durations, and you can use short values (like 3s) and odd values, not only round 5s/10s. A value below a specific variant's floor is clamped up automatically."
   )
 });
 var QueryBooleanSchema = external_exports.preprocess((value) => {
@@ -10330,7 +10497,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(),
@@ -10759,7 +10936,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",
@@ -10813,7 +10990,7 @@ var canvasContract = c6.router({
       canvasId: external_exports.string().uuid()
     }),
     body: null,
-    responses: { 204: c6.noBody() }
+    responses: { 204: c7.noBody() }
   },
   duplicateCanvas: {
     method: "POST",
@@ -11228,7 +11405,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
     },
@@ -11319,6 +11496,35 @@ var canvasContract = c6.router({
       400: MessageResponseSchema
     }
   },
+  validateBulkRun: {
+    method: "POST",
+    path: "/canvases/:canvasId/bulk-run/validate",
+    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),
+      // Input nodes the author marked OPTIONAL (may be absent when the
+      // template is applied). Preflight validates the worst case by
+      // dropping edges from these sources, so a downstream node left
+      // without its only required input (e.g. every prompt-feeder made
+      // optional) fails here instead of only at apply time.
+      optionalSourceNodeIds: external_exports.array(external_exports.string().uuid()).optional()
+    }),
+    responses: {
+      // Read-only preflight: collect every reason a node (or the graph)
+      // can't run instead of failing on the first. `nodeId: null` is a
+      // graph-level issue (e.g. a cycle). Empty `issues` = runnable.
+      200: external_exports.object({
+        issues: external_exports.array(
+          external_exports.object({
+            nodeId: external_exports.string().uuid().nullable(),
+            message: external_exports.string()
+          })
+        )
+      }),
+      400: MessageResponseSchema
+    },
+    summary: "Validate that a set of nodes can run as a bulk run, collecting all blockers"
+  },
   getBulkNodeRun: {
     method: "GET",
     path: "/bulk-node-runs/:bulkNodeRunId",
@@ -11377,7 +11583,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: {
@@ -11392,7 +11598,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.
@@ -11432,7 +11638,7 @@ var canvasContract = c6.router({
     }),
     body: null,
     responses: {
-      204: c6.noBody(),
+      204: c7.noBody(),
       404: MessageResponseSchema,
       409: MessageResponseSchema
     }
@@ -11468,7 +11674,7 @@ var canvasContract = c6.router({
     }),
     body: null,
     responses: {
-      204: c6.noBody(),
+      204: c7.noBody(),
       404: MessageResponseSchema,
       409: MessageResponseSchema
     }
@@ -11561,7 +11767,7 @@ var canvasContract = c6.router({
     }),
     body: null,
     responses: {
-      204: c6.noBody(),
+      204: c7.noBody(),
       403: MessageResponseSchema,
       404: MessageResponseSchema,
       409: MessageResponseSchema
@@ -11645,7 +11851,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
@@ -11672,16 +11878,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(),
@@ -11705,7 +11911,7 @@ var CompleteCustomFontUploadBodySchema = external_exports.object({
   sizeInBytes: external_exports.number().int().positive(),
   parts: external_exports.array(CompletedPartSchema)
 });
-var customFontContract = c7.router({
+var customFontContract = c8.router({
   list: {
     method: "GET",
     path: "/custom-fonts",
@@ -11733,7 +11939,7 @@ var customFontContract = c7.router({
 });
 
 // ../api-contract/src/generation.ts
-var c8 = initContract();
+var c9 = initContract();
 var GenerationJobStatusSchema = external_exports.enum([
   "in_progress",
   "finished",
@@ -11791,7 +11997,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",
@@ -12044,7 +12264,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",
@@ -12090,6 +12310,25 @@ var generationContract = c8.router({
       200: ListGenerationHistoryResponseSchema
     }
   },
+  downloadGenerationHistory: {
+    method: "GET",
+    path: "/generation/history/download",
+    // Same filters as the paginated list, minus pagination: an export
+    // returns every matching row, not a page.
+    query: external_exports.object({
+      search: external_exports.string().optional(),
+      userId: external_exports.string().optional(),
+      projectId: external_exports.string().optional(),
+      since: external_exports.string().datetime().optional(),
+      until: external_exports.string().datetime().optional()
+    }),
+    responses: {
+      200: c9.otherResponse({
+        contentType: "text/csv",
+        body: external_exports.string()
+      })
+    }
+  },
   getGenerationsByWeek: {
     method: "GET",
     path: "/generation/generations-by-week",
@@ -12111,7 +12350,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(),
@@ -12213,7 +12452,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",
@@ -12227,7 +12466,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)
@@ -12258,7 +12497,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",
@@ -12317,7 +12556,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(),
@@ -12353,7 +12592,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",
@@ -12440,7 +12679,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",
@@ -12586,7 +12825,25 @@ var InternalEnterpriseOrderSchema = EnterpriseOrderSchema.extend({
 });
 var TeamAdvancedSettingsSchema = external_exports.object({
   negativePromptEnabled: external_exports.boolean().optional(),
-  customSeedEnabled: external_exports.boolean().optional()
+  customSeedEnabled: external_exports.boolean().optional(),
+  // Auto-approve join requests from signups whose email domain matches this
+  // enterprise team's owner domain. Admin-governed via the dedicated
+  // domain-join-settings endpoint, not the editor-facing advanced-settings write.
+  domainJoinAutoApprove: external_exports.boolean().optional()
+});
+var DomainJoinTargetSchema = external_exports.object({
+  teamId: external_exports.string().uuid(),
+  teamName: external_exports.string(),
+  teamPhotoUrl: external_exports.string().nullable(),
+  alreadyRequested: external_exports.boolean()
+});
+var JoinRequestSchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  userId: external_exports.string().uuid(),
+  userName: external_exports.string(),
+  userEmail: external_exports.string(),
+  avatarUrl: external_exports.string().nullable(),
+  createdAt: external_exports.string().datetime()
 });
 var ActiveProductFeatureOverrideSchema = external_exports.object({
   feature: external_exports.string().min(1),
@@ -12636,7 +12893,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",
@@ -12661,6 +12918,23 @@ var teamContract = c12.router({
     body: external_exports.object({ token: external_exports.string().min(1) }),
     responses: { 200: TeamMembershipSchema }
   },
+  getDomainJoinTarget: {
+    method: "GET",
+    path: "/teams/domain-join-target",
+    responses: {
+      200: external_exports.object({ target: DomainJoinTargetSchema.nullable() })
+    }
+  },
+  requestDomainJoin: {
+    method: "POST",
+    path: "/teams/domain-join-requests",
+    body: external_exports.object({ teamId: external_exports.string().uuid() }),
+    responses: {
+      // "joined" when the team auto-approves; "requested" when it awaits
+      // admin approval.
+      200: external_exports.object({ outcome: external_exports.enum(["joined", "requested"]) })
+    }
+  },
   // --- Team-scoped (requires X-Team-Id header) ---
   updateTeam: {
     method: "PATCH",
@@ -12684,7 +12958,7 @@ var teamContract = c12.router({
     method: "DELETE",
     path: "/teams/current",
     body: null,
-    responses: { 204: c12.noBody() }
+    responses: { 204: c13.noBody() }
   },
   listMembers: {
     method: "GET",
@@ -12705,7 +12979,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",
@@ -12746,12 +13020,48 @@ 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",
+    path: "/teams/current/join-requests",
+    responses: { 200: external_exports.array(JoinRequestSchema) }
+  },
+  approveJoinRequest: {
+    method: "POST",
+    path: "/teams/current/join-requests/:requestId/approve",
+    pathParams: external_exports.object({ requestId: external_exports.string().uuid() }),
+    body: external_exports.object({ role: InviteLinkRoleSchema }),
+    responses: { 200: MemberSchema }
+  },
+  denyJoinRequest: {
+    method: "DELETE",
+    path: "/teams/current/join-requests/:requestId",
+    pathParams: external_exports.object({ requestId: external_exports.string().uuid() }),
+    body: null,
+    responses: { 204: c13.noBody() }
+  },
+  updateDomainJoinSettings: {
+    method: "PATCH",
+    path: "/teams/current/domain-join-settings",
+    body: external_exports.object({ autoApprove: external_exports.boolean() }),
+    responses: {
+      200: external_exports.object({ advancedSettings: TeamAdvancedSettingsSchema })
+    }
+  },
+  // Admin directly adds a signup on the team's email domain — no invite for
+  // the user to accept. Only users whose email domain routes to this team can
+  // be added this way.
+  addDomainMember: {
+    method: "POST",
+    path: "/teams/current/domain-members",
+    body: external_exports.object({ email: external_exports.string().email() }),
+    responses: { 200: MemberSchema }
   }
 });
 
 // ../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(),
@@ -12850,7 +13160,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",
@@ -12887,14 +13197,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",
@@ -12994,12 +13304,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(),
@@ -13071,7 +13381,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",
@@ -13096,8 +13406,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,
@@ -13191,6 +13501,10 @@ var publicContract = c15.router(
   }
 );
 
+// src/lib/onboarding.ts
+var SIGNUP_URL = "https://app.melius.com/signup";
+var GET_API_KEY_STEPS = `Sign up at ${SIGNUP_URL}, then create an API key in the Melius app under Team settings \u2192 Integrations`;
+
 // src/lib/errors.ts
 var EXIT_API_ERROR = 1;
 var EXIT_USAGE_ERROR = 2;
@@ -13216,7 +13530,7 @@ function handleApiError(status, body, suggestion) {
     writeError(
       formatError("UNAUTHORIZED", "Invalid or expired API key", {
         status,
-        suggestion: suggestion ?? "Run: mel auth login --api-key <key>"
+        suggestion: suggestion ?? `${GET_API_KEY_STEPS}. Then run: mel auth login --api-key mel_...`
       }),
       EXIT_AUTH_ERROR
     );
@@ -13386,6 +13700,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.4.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.4.0";
+    const latest = ctx.latest ?? serverLatestVersion;
+    process.stderr.write(formatUpgradeNotice(current, latest));
+  } catch {
+  }
+}
+
 // src/lib/client.ts
 var _client = null;
 var _verbose = false;
@@ -13444,7 +13817,7 @@ function getClient() {
   if (!config.apiKey) {
     writeError(
       formatError("AUTH_REQUIRED", "No API key configured", {
-        suggestion: "Run: mel auth login --api-key <key>"
+        suggestion: `${GET_API_KEY_STEPS}. Then run: mel auth login --api-key mel_...`
       }),
       EXIT_AUTH_ERROR
     );
@@ -13516,6 +13889,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")) {
@@ -13635,6 +14011,8 @@ function registerAuthCommands(program2, getOutputOpts) {
   auth.command("login").description("Store an API key and validate it").requiredOption("--api-key <key>", "API key (mel_...)").addHelpText(
     "after",
     `
+Get an API key: ${GET_API_KEY_STEPS}.
+
 Returns: { message, user: { id, email, name } }
 
 Examples:
@@ -14064,8 +14442,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) => {
@@ -14255,7 +14633,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 });
@@ -14330,16 +14708,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;
       }
     }
   }
@@ -16386,7 +16764,7 @@ Destination handles for image/video edges to text nodes:
   --dst-handle image   when supportedInputs includes "image"
   --dst-handle video   when supportedInputs includes "video"
   Models with video+image: Gemini (3.1 Pro, 3 Flash, 2.5 Pro), Qwen 3.5 397B
-  Models with image-only: GPT-5.x, Claude Opus/Sonnet, Qwen3 VL 235B
+  Models with image-only: GPT-5.x, Claude Opus/Sonnet, Qwen 3 VL 235B
 
 Destination handles for image edges to video nodes (always set explicitly):
   Derive from the model's variant inputs (mel model list --category video):
@@ -18181,12 +18559,24 @@ Examples:
 }
 
 // src/index.ts
+function withDefaultHelp(args) {
+  return args.length === 0 ? ["--help"] : args;
+}
 function createProgram() {
   const program2 = new Command();
-  program2.name("mel").description("Mel \u2014 Melius agent CLI").version("0.2.1").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.4.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("after", "\nLearn more: https://docs.melius.com");
+  ).option("--quiet", "Suppress output, exit code only").option("--verbose", "Log request/response metadata to stderr").addHelpText(
+    "after",
+    `
+Getting started:
+  1. ${GET_API_KEY_STEPS}
+  2. mel auth login --api-key mel_...
+  3. mel project list
+
+Learn more: https://docs.melius.com`
+  );
   program2.hook("preAction", () => {
     const opts = program2.opts();
     if (opts.verbose) setVerbose(true);
@@ -18248,5 +18638,7 @@ export {
   EXIT_API_ERROR,
   formatError,
   writeError,
+  printUpgradeNoticeIfNeeded,
+  withDefaultHelp,
   createProgram
 };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { Command } from 'commander';
 
+declare function withDefaultHelp(args: string[]): string[];
 declare function createProgram(): Command;
 
-export { createProgram };
+export { createProgram, withDefaultHelp };

package/dist/src/index.js

@@ -1,7 +1,9 @@
 import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
 import {
-  createProgram
-} from "../chunk-6IN2VKUC.js";
+  createProgram,
+  withDefaultHelp
+} from "../chunk-EXHDKHNG.js";
 export {
-  createProgram
+  createProgram,
+  withDefaultHelp
 };

package/package.json

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