@melius-ai/cli 0.11.0 → 0.13.0

package/README.md

@@ -130,6 +130,7 @@ Edge type determines data flow: `text` passes text output, `image` passes image
 | Command                                                                      | Description                                                                                          |
 | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
 | `mel run start <nodeId> --canvas-id <canvasId>`                              | Start a generation. Returns `{ id }`                                                                 |
+| `mel run tool <nodeId> --canvas-id <canvasId> --tool remove-background`      | Remove an image background in place. Returns `{ id }`                                                |
 | `mel run get <runId>`                                                        | Check run status: `pending`, `running`, `finished`, `failed`                                         |
 | `mel run wait <runId>`                                                       | **Block until done.** Exit 0 = finished, 1 = failed, 4 = timeout                                     |
 | `mel run latest <canvasId>`                                                  | Latest run status for every node on a canvas                                                         |
@@ -138,6 +139,8 @@ Edge type determines data flow: `text` passes text output, `image` passes image
 
 **Magic resize:** `mel run magic-resize` creates a magic-resize node, wires the source image in, and runs it — all in one call. The source node must already have a finished image asset. `--ratios` is comma-separated (1–5): presets `21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21` render at 1K, or pass custom `WxH` pixel sizes (each side 64–4096, e.g. `1080x1350`). Pass the returned `nodeId` to `mel run wait` to block until the variants are ready.
 
+**Node tools:** `mel run tool` post-processes a node's finished asset in place and creates a new active version. The currently supported tool is `remove-background` for image and image-backed file nodes. Pass the returned run ID to `mel run wait` before inspecting the result with `mel canvas content <canvasId> --node-id <nodeId> --include-all-versions`.
+
 **Auto-model resolution:** when `--model`/`--variant` are omitted, `mel run start` automatically resolves the correct model from the platform defaults. `--canvas-id` is required so the CLI can verify the node is on the canvas and the backend can do edge-aware detection (picks `image-to-image` when the node has incoming image edges). Always source the node ID from the latest `mel canvas content` output or the current-turn `idMap` returned by `mel node bulk-create`.
 
 ```bash
@@ -149,6 +152,9 @@ mel run start <nodeId> --canvas-id <canvasId> --model flux-pro --variant text-to
 
 # With overrides
 mel run start <nodeId> --canvas-id <canvasId> --prompt "Override prompt" --variations 3
+
+# Remove an image background in place
+mel run tool <imageNodeId> --canvas-id <canvasId> --tool remove-background
 ```
 
 ### Bulk runs (entire canvas)

package/dist/bin/mel.js

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

package/dist/{chunk-CHRQZMYE.js → chunk-5APS3BGT.js}

@@ -1166,7 +1166,7 @@ var require_command = __commonJS({
     var { Help: Help2, stripColor } = require_help();
     var { Option: Option2, DualOptions } = require_option();
     var { suggestSimilar } = require_suggestSimilar();
-    var Command2 = class _Command extends EventEmitter {
+    var Command3 = class _Command extends EventEmitter {
       /**
        * Initialize a new `Command`.
        *
@@ -3307,7 +3307,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         return true;
       return void 0;
     }
-    exports.Command = Command2;
+    exports.Command = Command3;
     exports.useColor = useColor;
   }
 });
@@ -3317,15 +3317,15 @@ var require_commander = __commonJS({
   "../../node_modules/.pnpm/commander@13.1.0/node_modules/commander/index.js"(exports) {
     "use strict";
     var { Argument: Argument2 } = require_argument();
-    var { Command: Command2 } = require_command();
+    var { Command: Command3 } = require_command();
     var { CommanderError: CommanderError3, InvalidArgumentError: InvalidArgumentError2 } = require_error();
     var { Help: Help2 } = require_help();
     var { Option: Option2 } = require_option();
-    exports.program = new Command2();
-    exports.createCommand = (name) => new Command2(name);
+    exports.program = new Command3();
+    exports.createCommand = (name) => new Command3(name);
     exports.createOption = (flags, description) => new Option2(flags, description);
     exports.createArgument = (name, description) => new Argument2(name, description);
-    exports.Command = Command2;
+    exports.Command = Command3;
     exports.Option = Option2;
     exports.Argument = Argument2;
     exports.Help = Help2;
@@ -8224,6 +8224,18 @@ var CompleteFilesUploadBodySchema = external_exports.object({
 var CompleteFilesUploadResponseSchema = external_exports.object({
   file: FileCardSchema
 });
+var ImportUploadcareFileBodySchema = external_exports.object({
+  uuid: external_exports.string().uuid(),
+  folderId: external_exports.string().uuid().nullable().optional()
+});
+var ImportUploadcareFileResponseSchema = external_exports.object({
+  file: FileCardSchema
+});
+var UploadcareUploadSignatureResponseSchema = external_exports.object({
+  signature: external_exports.string(),
+  /** Unix seconds, as a string — the exact bytes that were signed. */
+  expire: external_exports.string()
+});
 var EmbeddingStorageUsageResponseSchema = external_exports.object({
   usedBytes: external_exports.number(),
   limitBytes: external_exports.number()
@@ -8609,6 +8621,28 @@ var filesContract = c2.router({
       403: ErrorBodySchema
     },
     summary: "Complete a Files upload"
+  },
+  createUploadcareUploadSignature: {
+    method: "POST",
+    path: "/files/import/uploadcare/signature",
+    body: external_exports.object({}),
+    responses: {
+      200: UploadcareUploadSignatureResponseSchema,
+      403: ErrorBodySchema
+    },
+    summary: "Mint short-lived credentials for a signed Uploadcare upload"
+  },
+  importUploadcareFile: {
+    method: "POST",
+    path: "/files/import/uploadcare",
+    body: ImportUploadcareFileBodySchema,
+    responses: {
+      200: ImportUploadcareFileResponseSchema,
+      400: ErrorBodySchema,
+      403: ErrorBodySchema,
+      404: ErrorBodySchema
+    },
+    summary: "Import a file picked from a cloud source through Uploadcare"
   }
 });
 
@@ -9327,6 +9361,29 @@ var audioContract = c5.router({
   }
 });
 
+// ../api-contract/src/heygen.ts
+var HeygenAvatarSettingsSchema = external_exports.object({
+  backgroundColor: external_exports.string().regex(/^#[0-9a-f]{6}$/i, "Background color must be a hex color").optional(),
+  removeBackground: external_exports.boolean().optional(),
+  fit: external_exports.enum(["cover", "contain"]).optional(),
+  caption: external_exports.boolean().optional()
+});
+var HeygenAvatarVariantSchema = external_exports.object({
+  avatar: external_exports.string().describe(
+    "Raw avatar id. Pass this exact value as modelConfig.heygenAvatar"
+  ),
+  description: external_exports.string().describe("Pose, setting, and framing, e.g. 'Standing office front'")
+});
+var HeygenAvatarPersonSchema = external_exports.object({
+  name: external_exports.string().describe("The presenter's first name, e.g. 'Abigail'"),
+  variants: external_exports.array(HeygenAvatarVariantSchema).describe("Every pose available for this presenter")
+});
+var HeygenAvatarCatalogSchema = external_exports.object({
+  people: external_exports.array(HeygenAvatarPersonSchema),
+  totalPeople: external_exports.number(),
+  totalAvatars: external_exports.number()
+});
+
 // ../api-contract/src/auto-model-proxy.ts
 var AUTO_MODEL_REGISTRY = [
   // ── Video ───────────────────────────────────────────────────────────
@@ -9442,6 +9499,12 @@ var AUTO_MODEL_REGISTRY = [
     model: "elevenlabs-sfx",
     variant: "text-to-sfx"
   },
+  {
+    nodeType: "audio",
+    inputPattern: "video-to-sfx",
+    model: "sonilo-video-sfx",
+    variant: "video-to-sfx"
+  },
   {
     nodeType: "audio",
     inputPattern: "text-to-music",
@@ -9684,6 +9747,7 @@ var GENERATION_MODES = [
   "text-to-speech",
   "audio-to-audio",
   "text-to-sfx",
+  "video-to-sfx",
   "text-to-music",
   "speech-to-text",
   "voice-isolator"
@@ -10473,6 +10537,8 @@ var ModelConfigSchema = external_exports.object({
   tier: external_exports.string().nullable().optional(),
   /** HeyGen Avatar V only: the Runware avatar id for this node. */
   heygenAvatar: external_exports.string().optional(),
+  /** HeyGen Avatar V presentation, speech, and output controls. */
+  heygenSettings: HeygenAvatarSettingsSchema.optional(),
   // Magic-resize stores its per-run config here so each version carries the
   // ratios + resolution that produced it.
   ratios: external_exports.array(external_exports.string()).optional(),
@@ -10499,6 +10565,8 @@ var ModelConfigInputSchema = external_exports.object({
   tier: external_exports.string().nullable().optional(),
   /** HeyGen Avatar V only: the Runware avatar id for this node. */
   heygenAvatar: external_exports.string().trim().min(1).optional(),
+  /** HeyGen Avatar V presentation, speech, and output controls. */
+  heygenSettings: HeygenAvatarSettingsSchema.optional(),
   /** better-font-32b only: the font the model renders the requested text in (supplied to the model as a rendered reference image). */
   font: external_exports.object({
     source: external_exports.enum(["custom", "google"]),
@@ -10690,6 +10758,8 @@ var NodeResponseSchema = external_exports.object({
   outputResolution: OutputResolutionSchema.nullable().optional(),
   /** Current seed on the node (from CRDT). */
   seed: external_exports.number().int().nonnegative().max(MAX_SEED).nullable().optional(),
+  /** Current variation count on the node (from CRDT). */
+  numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).nullable().optional(),
   /** Current audio toggle on the node (from CRDT). */
   generateAudio: external_exports.boolean().nullable().optional(),
   /** Selected video model supports start/end image inputs (from CRDT). */
@@ -10937,6 +11007,14 @@ var RunImageToolBodySchema = external_exports.object({
   /** Base64-encoded PNG mask image for inpainting (white = areas to regenerate). */
   maskImageBase64: external_exports.string().optional()
 });
+var REMOVE_BACKGROUND_NODE_TOOL_NAME = "remove-background";
+var PUBLIC_NODE_TOOL_NAMES = [
+  REMOVE_BACKGROUND_NODE_TOOL_NAME
+];
+var RunNodeToolBodySchema = external_exports.object({
+  canvasId: external_exports.string().uuid(),
+  toolName: external_exports.enum(PUBLIC_NODE_TOOL_NAMES)
+});
 var RunSplitLayersBodySchema = external_exports.object({
   canvasId: external_exports.string().uuid().optional(),
   numLayers: external_exports.number().int().min(2).max(5).nullable()
@@ -11144,6 +11222,7 @@ var CreateDirectNodeBodyObjectSchema = external_exports.object({
   outputResolution: OutputResolutionSchema.nullable().optional(),
   matchAudioToVideoDuration: external_exports.boolean().nullable().optional(),
   seed: external_exports.number().int().nonnegative().max(MAX_SEED).nullable().optional(),
+  numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).nullable().optional(),
   negativePrompt: external_exports.string().nullable().optional(),
   stitchClipOrder: StitchClipOrderSchema.nullable().optional(),
   stitchScaleFit: StitchScaleFitSchema.nullable().optional(),
@@ -11193,6 +11272,7 @@ var UpdateDirectNodeBodySchema = external_exports.object({
   outputResolution: OutputResolutionSchema.nullable().optional(),
   matchAudioToVideoDuration: external_exports.boolean().nullable().optional(),
   seed: external_exports.number().int().nonnegative().max(MAX_SEED).nullable().optional(),
+  numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).nullable().optional(),
   negativePrompt: external_exports.string().nullable().optional(),
   stitchClipOrder: StitchClipOrderSchema.nullable().optional(),
   stitchScaleFit: StitchScaleFitSchema.nullable().optional(),
@@ -11227,6 +11307,7 @@ var DirectNodeResponseSchema = external_exports.object({
   outputResolution: OutputResolutionSchema.nullable(),
   matchAudioToVideoDuration: external_exports.boolean().nullable().optional(),
   seed: external_exports.number().int().nonnegative().max(MAX_SEED).nullable(),
+  numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).nullable(),
   negativePrompt: external_exports.string().nullable(),
   stitchClipOrder: StitchClipOrderSchema.nullable().optional(),
   stitchScaleFit: StitchScaleFitSchema.nullable().optional(),
@@ -11280,6 +11361,7 @@ var BulkUpdateDirectNodesItemSchema = external_exports.object({
   outputResolution: OutputResolutionSchema.nullable().optional(),
   matchAudioToVideoDuration: external_exports.boolean().nullable().optional(),
   seed: external_exports.number().int().nonnegative().max(MAX_SEED).nullable().optional(),
+  numVariations: external_exports.number().int().min(1).max(MAX_VARIATIONS).nullable().optional(),
   negativePrompt: external_exports.string().nullable().optional(),
   stitchClipOrder: StitchClipOrderSchema.nullable().optional(),
   stitchScaleFit: StitchScaleFitSchema.nullable().optional(),
@@ -11368,6 +11450,16 @@ var PlaygroundCanvasReferenceSchema = external_exports.object({
   projectId: external_exports.string().uuid(),
   canvasId: external_exports.string().uuid()
 });
+var PlaygroundCanvasDestinationSchema = external_exports.discriminatedUnion("kind", [
+  external_exports.object({
+    kind: external_exports.literal("existing"),
+    projectId: external_exports.string().uuid()
+  }),
+  external_exports.object({
+    kind: external_exports.literal("new"),
+    projectName: external_exports.string().trim().min(1).max(500)
+  })
+]);
 var PlaygroundCanvasPageSchema = external_exports.object({
   projectId: external_exports.string().uuid().nullable(),
   data: external_exports.array(external_exports.object({ id: external_exports.string().uuid() })),
@@ -11377,9 +11469,12 @@ var canvasContract = c7.router({
   createPlaygroundCanvas: {
     method: "POST",
     path: "/playground/canvases",
-    body: null,
+    body: external_exports.object({
+      destination: PlaygroundCanvasDestinationSchema.optional()
+    }).optional(),
     responses: {
       201: PlaygroundCanvasReferenceSchema,
+      404: MessageResponseSchema,
       409: MessageResponseSchema
     }
   },
@@ -11805,6 +11900,18 @@ var canvasContract = c7.router({
       404: NodeRunErrorResponseSchema
     }
   },
+  runNodeTool: {
+    method: "POST",
+    path: "/nodes/:nodeId/tool-runs",
+    pathParams: external_exports.object({ nodeId: external_exports.string().uuid() }),
+    body: RunNodeToolBodySchema,
+    responses: {
+      201: CreateNodeRunResponseSchema,
+      202: external_exports.object({ approvalId: external_exports.string().uuid() }),
+      400: NodeRunErrorResponseSchema,
+      404: NodeRunErrorResponseSchema
+    }
+  },
   runImageTool: {
     method: "POST",
     path: "/nodes/:nodeId/image-tool-runs",
@@ -12507,6 +12614,8 @@ var GenerationRunBodySchema = external_exports.object({
   prompt: external_exports.string().trim().min(1).optional(),
   /** Selected avatar id from Runware's HeyGen Avatar V catalog. */
   heygenAvatar: external_exports.string().trim().min(1).optional(),
+  /** HeyGen Avatar V presentation controls. */
+  heygenSettings: HeygenAvatarSettingsSchema.optional(),
   imageUrls: external_exports.array(external_exports.string().url()).optional(),
   endImageUrls: external_exports.array(external_exports.string().url()).optional(),
   referenceImageUrls: external_exports.array(external_exports.string().url()).optional(),
@@ -12627,6 +12736,9 @@ var AutoModelDefaultsCategorySchema = external_exports.object({
     textToSpeech: AutoModelDefaultEntrySchema,
     audioToAudio: AutoModelDefaultEntrySchema,
     textToSfx: AutoModelDefaultEntrySchema,
+    // Optional so deployed clients validating a response from an
+    // older backend (which omits it) keep working.
+    videoToSfx: AutoModelDefaultEntrySchema.optional(),
     textToMusic: AutoModelDefaultEntrySchema,
     speechToText: AutoModelDefaultEntrySchema
   }).optional()
@@ -12797,6 +12909,9 @@ var GenerationHistoryItemSchema = external_exports.object({
   tier: external_exports.string().nullable().optional(),
   status: GenerationJobStatusSchema,
   creditCost: external_exports.number().nullable(),
+  // Whether the debit was reversed — `creditCost` was charged and given back,
+  // so it did not count towards usage. Optional so older clients ignore it.
+  refunded: external_exports.boolean().optional(),
   createdAt: external_exports.string(),
   user: external_exports.object({
     id: external_exports.string(),
@@ -12807,7 +12922,15 @@ var GenerationHistoryItemSchema = external_exports.object({
     id: external_exports.string(),
     title: external_exports.string(),
     archived: external_exports.boolean()
-  }).nullable()
+  }).nullable(),
+  // Set when the generation was produced by running a template: the bulk run
+  // it belonged to plus the template's name. Lets a run's per-model rows be
+  // consolidated into one row (see `consolidateTemplateRuns`). Optional so
+  // older clients ignore it and it is absent for non-template generations.
+  templateRun: external_exports.object({
+    runId: external_exports.string(),
+    title: external_exports.string()
+  }).nullable().optional()
 });
 var ListGenerationHistoryResponseSchema = external_exports.object({
   items: external_exports.array(GenerationHistoryItemSchema),
@@ -13575,6 +13698,13 @@ var TeamAdvancedSettingsSchema = external_exports.object({
   // 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()
+  // NOTE: the team's approval policy config also lives in this jsonb column,
+  // but is deliberately NOT declared here — see `InternalTeamAdvancedSettings`
+  // in `apps/core/nagi/team/team.mappers.ts`, the same treatment
+  // `modelDiscounts` gets. Declaring it would publish the team's approver
+  // list into the public OpenAPI surface, and would make it writable through
+  // the editor-facing advanced-settings endpoint. It is read and written
+  // only through the admin-gated approvals endpoints.
 });
 var DomainJoinTargetSchema = external_exports.object({
   teamId: external_exports.string().uuid(),
@@ -13832,10 +13962,17 @@ var ProjectResponseSchema = external_exports.object({
   updatedAt: external_exports.string().datetime(),
   lastEditAt: external_exports.string().datetime()
 });
+var ProjectOptionSchema = ProjectResponseSchema.pick({
+  id: true,
+  title: true
+});
 var ProjectIdParamsSchema = external_exports.object({ projectId: external_exports.string().uuid() });
 var PaginationQuerySchema = external_exports.object(
   paginationQuery({ maxLimit: 100, defaultLimit: 50 })
 );
+var ProjectOptionsQuerySchema = PaginationQuerySchema.extend({
+  search: external_exports.string().max(500).optional()
+});
 var IncludePreviewAssetsQuerySchema = external_exports.preprocess((value) => {
   if (value === void 0) return void 0;
   if (value === "true" || value === true) return true;
@@ -13859,6 +13996,10 @@ var PaginatedProjectsResponseSchema = external_exports.object({
   data: external_exports.array(ProjectResponseSchema),
   total: external_exports.number().int()
 });
+var PaginatedProjectOptionsResponseSchema = external_exports.object({
+  data: external_exports.array(ProjectOptionSchema),
+  total: external_exports.number().int()
+});
 var ProjectListResponseSchema = external_exports.object({
   data: external_exports.array(ProjectResponseSchema)
 });
@@ -13872,8 +14013,15 @@ var ProjectThumbnailResponseSchema = external_exports.object({
 var ProjectThumbnailsResponseSchema = external_exports.object({
   data: external_exports.array(ProjectThumbnailResponseSchema)
 });
+var MAX_PROJECT_TITLE_LENGTH = 500;
+var PROJECT_CONFLICT_CODE = {
+  nameTaken: "PROJECT_NAME_TAKEN"
+};
+var ProjectConflictResponseSchema = MessageResponseSchema.extend({
+  code: external_exports.nativeEnum(PROJECT_CONFLICT_CODE).optional()
+});
 var CreateProjectBodySchema = external_exports.object({
-  title: external_exports.string().min(1).max(500).optional(),
+  title: external_exports.string().min(1).max(MAX_PROJECT_TITLE_LENGTH).optional(),
   description: external_exports.string().max(5e3).optional(),
   isPublic: external_exports.boolean().optional(),
   // Folder to create the project in. Omit (or `null`) to create at the team
@@ -13881,7 +14029,7 @@ var CreateProjectBodySchema = external_exports.object({
   folderId: external_exports.string().uuid().nullable().optional()
 });
 var UpdateProjectBodySchema = external_exports.object({
-  title: external_exports.string().min(1).max(500).optional(),
+  title: external_exports.string().min(1).max(MAX_PROJECT_TITLE_LENGTH).optional(),
   description: external_exports.string().max(5e3).nullable().optional(),
   isPublic: external_exports.boolean().optional()
 });
@@ -13912,7 +14060,7 @@ var projectContract = c14.router({
     body: CreateProjectBodySchema,
     responses: {
       201: ProjectResponseSchema,
-      409: MessageResponseSchema
+      409: ProjectConflictResponseSchema
     }
   },
   listDeletedProjects: {
@@ -13921,6 +14069,12 @@ var projectContract = c14.router({
     query: PaginationQuerySchema,
     responses: { 200: PaginatedProjectsResponseSchema }
   },
+  listProjectOptions: {
+    method: "GET",
+    path: "/projects/options",
+    query: ProjectOptionsQuerySchema,
+    responses: { 200: PaginatedProjectOptionsResponseSchema }
+  },
   getProject: {
     method: "GET",
     path: "/projects/:projectId",
@@ -13934,7 +14088,7 @@ var projectContract = c14.router({
     body: UpdateProjectBodySchema,
     responses: {
       200: ProjectResponseSchema,
-      409: MessageResponseSchema
+      409: ProjectConflictResponseSchema
     }
   },
   deleteProject: {
@@ -14277,6 +14431,7 @@ var publicContract = c16.router(
     },
     run: {
       start: canvasContract.runNode,
+      tool: canvasContract.runNodeTool,
       get: canvasContract.getNodeRun,
       cancel: canvasContract.cancelNodeRun,
       latest: canvasContract.getLatestNodeRuns,
@@ -14579,7 +14734,7 @@ function isMajorUpgrade(current, latest) {
   return l[0] > c17[0];
 }
 function shouldShowUpgradeNotice(ctx = {}) {
-  const current = ctx.current ?? "0.11.0";
+  const current = ctx.current ?? "0.13.0";
   const latest = ctx.latest ?? serverLatestVersion;
   const env = ctx.env ?? process.env;
   const isTty = ctx.isTty ?? Boolean(process.stderr.isTTY);
@@ -14600,7 +14755,7 @@ Upgrade: npm install -g @melius-ai/cli@latest  (or: brew update && brew upgrade
 function printUpgradeNoticeIfNeeded(ctx = {}) {
   try {
     if (!shouldShowUpgradeNotice(ctx)) return;
-    const current = ctx.current ?? "0.11.0";
+    const current = ctx.current ?? "0.13.0";
     const latest = ctx.latest ?? serverLatestVersion;
     process.stderr.write(formatUpgradeNotice(current, latest));
   } catch {
@@ -16799,7 +16954,7 @@ previewSrc, mediaType, generatedText, activeVersionId, voiceId, createdByUserId.
 ID is auto-generated if --id is omitted. Geometry defaults per type (text: 380x200, image: 520x293, audio: 380x280).
 Valid aspect ratios: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21.
 Resolutions vary per model (e.g. 720p, 1080p, 4k for video; 1K, 2K, 4K for images). Use mel model list to check supportedResolutions.
-Audio modes (set via --variant): text-to-speech (TTS, requires --voice-id), text-to-sfx (5/6/8/10/12/15/20/22 second SFX), text-to-music (10/30/60/90/120/180/240/300 second music), speech-to-text (requires an audio input edge), audio-to-audio (requires an audio input edge and --voice-id). Use mel audio voice list to discover voice ids.
+Audio modes (set via --variant): text-to-speech (TTS, requires --voice-id), text-to-sfx (5/6/8/10/12/15/20/22 second SFX), video-to-sfx (requires a video input edge; length follows the clip), text-to-music (10/30/60/90/120/180/240/300 second music), speech-to-text (requires an audio input edge), audio-to-audio (requires an audio input edge and --voice-id). Use mel audio voice list to discover voice ids.
 For stitch nodes, use --clip-order with connected source node IDs (video or image) in playback order and --scale-fit to control frame adaptation. Images render as 2-second still frames.
 
 Examples:
@@ -17010,7 +17165,7 @@ Valid node types: text, image, video, audio, file, group, custom_text, stitch.
     Stitch nodes also accept clipOrder (source node IDs \u2014 video or image \u2014 in playback order; images render as 2-second stills) and scaleFit (fit or stretch).
 	Valid aspect ratios: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21.
 	Valid edge types: text, image, video, audio, file.
-	Audio modes (set via variant): text-to-speech (TTS, requires voiceId), text-to-sfx (5/6/8/10/12/15/20/22 second SFX), text-to-music (10/30/60/90/120/180/240/300 second music), speech-to-text (requires an audio input edge), audio-to-audio (requires an audio input edge and voiceId).
+	Audio modes (set via variant): text-to-speech (TTS, requires voiceId), text-to-sfx (5/6/8/10/12/15/20/22 second SFX), video-to-sfx (requires a video input edge; length follows the clip), text-to-music (10/30/60/90/120/180/240/300 second music), speech-to-text (requires an audio input edge), audio-to-audio (requires an audio input edge and voiceId).
 
 	Use mel canvas plan-layout first to compute positions, then pass x/y/w/h into each node.
 	Accepts two JSON formats via stdin (or --json):
@@ -17909,6 +18064,38 @@ function assertNodeIdsExistOnCanvas(nodeIds, canvasId, canvasNodeIds) {
 }
 
 // src/commands/run.ts
+async function handleRunApproval(result, client, outputOpts, details) {
+  if (result.status !== 202) return false;
+  const body = result.body;
+  const signal = JSON.stringify({
+    type: "approval_required",
+    approvalId: body.approvalId,
+    tool: details.tool,
+    summary: details.summary
+  });
+  process.stdout.write(signal + "\n");
+  process.stderr.write(signal + "\n");
+  const approval = await pollApproval(
+    client,
+    body.approvalId,
+    18e5,
+    2e3
+  );
+  if (approval.status === "denied") {
+    writeError(
+      formatError(
+        "DENIED",
+        "The user denied this generation. Do NOT retry or re-run this command. Ask the user what they would like to do instead.",
+        {
+          suggestion: "Ask the user what they would like to do next"
+        }
+      ),
+      EXIT_API_ERROR
+    );
+  }
+  writeJson(approval.result, outputOpts);
+  return true;
+}
 function registerRunCommands(program2, getOutputOpts) {
   const run = program2.command("run").description("Start AI generations and poll for results");
   run.command("start").description("Start an AI generation run on a node").argument(
@@ -18007,35 +18194,10 @@ Examples:
           }
         }
       });
-      if (result.status === 202) {
-        const body = result.body;
-        const signal = JSON.stringify({
-          type: "approval_required",
-          approvalId: body.approvalId,
-          tool: "run_start",
-          summary: `mel run start ${nodeId} --canvas-id ${opts.canvasId}`
-        });
-        process.stdout.write(signal + "\n");
-        process.stderr.write(signal + "\n");
-        const approval = await pollApproval(
-          client,
-          body.approvalId,
-          18e5,
-          2e3
-        );
-        if (approval.status === "denied") {
-          writeError(
-            formatError(
-              "DENIED",
-              "The user denied this generation. Do NOT retry or re-run this command. Ask the user what they would like to do instead.",
-              {
-                suggestion: "Ask the user what they would like to do next"
-              }
-            ),
-            EXIT_API_ERROR
-          );
-        }
-        writeJson(approval.result, getOutputOpts());
+      if (await handleRunApproval(result, client, getOutputOpts(), {
+        tool: "run_start",
+        summary: `mel run start ${nodeId} --canvas-id ${opts.canvasId}`
+      })) {
         return;
       }
       if (result.status !== 201) {
@@ -18051,6 +18213,58 @@ Examples:
       writeJson(result.body, getOutputOpts());
     }
   );
+  run.command("tool").description(
+    "Run a node tool on an existing node in place and return its run ID"
+  ).argument(
+    "<nodeId>",
+    "Node ID with a finished asset (from mel canvas content)"
+  ).requiredOption(
+    "--canvas-id <id>",
+    "Canvas ID (from mel canvas create or mel canvas list output)"
+  ).addOption(
+    new Option(
+      "--tool <name>",
+      `Node tool name. Valid values: ${PUBLIC_NODE_TOOL_NAMES.join(", ")}`
+    ).choices([...PUBLIC_NODE_TOOL_NAMES]).makeOptionMandatory()
+  ).addHelpText(
+    "after",
+    `
+Returns: { id } \u2014 the run ID. Use mel run wait <id> to block until completion.
+Valid tools: ${PUBLIC_NODE_TOOL_NAMES.join(", ")}.
+Node tools post-process the node's finished asset in place and create a new active version.
+After completion, use mel canvas content <canvasId> --node-id <nodeId> --include-all-versions to inspect the result.
+
+Examples:
+  $ mel run tool <imageNodeId> --canvas-id <canvasId> --tool remove-background
+  $ RUN=$(mel run tool <imageNodeId> --canvas-id <canvasId> --tool remove-background); mel run wait $(echo $RUN | jq -r .id)`
+  ).action(
+    async (nodeId, opts) => {
+      const client = getClient();
+      const canvasNodeIds = await loadCanvasNodeIds(
+        client,
+        opts.canvasId
+      );
+      assertNodeExistsOnCanvas(nodeId, opts.canvasId, canvasNodeIds);
+      const result = await client.run.tool({
+        params: { nodeId },
+        body: {
+          canvasId: opts.canvasId,
+          toolName: opts.tool
+        }
+      });
+      if (await handleRunApproval(result, client, getOutputOpts(), {
+        tool: "run_node_tool",
+        summary: `mel run tool ${nodeId} --canvas-id ${opts.canvasId} --tool ${opts.tool}`
+      })) {
+        return;
+      }
+      if (result.status !== 201) {
+        const suggestion = result.status === 404 ? `Run: mel canvas content ${opts.canvasId} to refresh node IDs, then retry with a current node ID` : `Make sure the node has a finished image asset. Use mel canvas content ${opts.canvasId} --node-id ${nodeId} --include-all-versions to inspect it.`;
+        handleApiError(result.status, result.body, suggestion);
+      }
+      writeJson(result.body, getOutputOpts());
+    }
+  );
   run.command("magic-resize").description(
     "Resize an image into multiple aspect ratios in one call. Creates a magic-resize node, wires the source image in, and runs it (writes to CRDT + starts a run)"
   ).argument(
@@ -18450,7 +18664,7 @@ function registerModelCommands(program2, getOutputOpts) {
 Returns: Array of models, each with name, displayName, provider, variants[], and supportedInputs[].
 Each variant has: mode, supportedAspectRatios[], supportedDurations[], supportedResolutions[], requiredInputs[].
 For text models, supportedInputs lists accepted media types (e.g. ["image", "video"]) \u2014 use these to determine valid edge handles.
-For audio, variants are text-to-speech, text-to-sfx, text-to-music, speech-to-text, and audio-to-audio \u2014 supportedDurations applies to sfx and music only. For text-to-speech and audio-to-audio, also call mel audio voice list to discover voice ids.
+For audio, variants are text-to-speech, text-to-sfx, video-to-sfx, text-to-music, speech-to-text, and audio-to-audio \u2014 supportedDurations applies to sfx and music only. For text-to-speech and audio-to-audio, also call mel audio voice list to discover voice ids.
 Use this to discover valid --model and --variant values for mel run start and mel node create.
 
 Examples:
@@ -19737,7 +19951,7 @@ function withDefaultHelp(args) {
 }
 function createProgram() {
   const program2 = new Command();
-  program2.name("mel").description("Mel \u2014 Melius agent CLI").version("0.11.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.13.0").showSuggestionAfterError(true).option("--json", "Force JSON output (default)").option("--text", "Human-readable output").option(
     "--fields <fields>",
     "Select specific output fields (comma-separated)"
   ).option("--quiet", "Suppress output, exit code only").option("--verbose", "Log request/response metadata to stderr").addHelpText(

package/dist/src/index.js

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

package/package.json

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