@melius-ai/cli 0.2.1 → 0.3.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,12 @@ 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>`.
+
 ## Sandbox setup
 
 In the Claude Code sandbox, only two environment variables are needed:
@@ -323,7 +329,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,16 @@ import {
   EXIT_API_ERROR,
   createProgram,
   formatError,
+  withDefaultHelp,
   writeError
-} from "../chunk-6IN2VKUC.js";
+} from "../chunk-JVD4O5T3.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(

package/dist/{chunk-6IN2VKUC.js → chunk-JVD4O5T3.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 ────────────────────────────────────────────────────────────
@@ -10222,6 +10258,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) => {
@@ -11319,6 +11358,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",
@@ -12090,6 +12158,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: c8.otherResponse({
+        contentType: "text/csv",
+        body: external_exports.string()
+      })
+    }
+  },
   getGenerationsByWeek: {
     method: "GET",
     path: "/generation/generations-by-week",
@@ -12586,7 +12673,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),
@@ -12661,6 +12766,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",
@@ -12747,6 +12869,42 @@ var teamContract = c12.router({
     pathParams: external_exports.object({ inviteId: external_exports.string().uuid() }),
     body: null,
     responses: { 204: c12.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: c12.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 }
   }
 });
 
@@ -13191,6 +13349,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 +13378,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
     );
@@ -13444,7 +13606,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
     );
@@ -13635,6 +13797,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:
@@ -16386,7 +16550,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 +18345,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.3.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 +18424,6 @@ export {
   EXIT_API_ERROR,
   formatError,
   writeError,
+  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-JVD4O5T3.js";
 export {
-  createProgram
+  createProgram,
+  withDefaultHelp
 };

package/package.json

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