@melius-ai/cli 0.12.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-2PWVQ3PC.js";
+} from "../chunk-5APS3BGT.js";
 
 // bin/mel.ts
 var program = createProgram();

package/dist/{chunk-2PWVQ3PC.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;
@@ -11007,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()
@@ -11892,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",
@@ -13678,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(),
@@ -14404,6 +14431,7 @@ var publicContract = c16.router(
     },
     run: {
       start: canvasContract.runNode,
+      tool: canvasContract.runNodeTool,
       get: canvasContract.getNodeRun,
       cancel: canvasContract.cancelNodeRun,
       latest: canvasContract.getLatestNodeRuns,
@@ -14706,7 +14734,7 @@ function isMajorUpgrade(current, latest) {
   return l[0] > c17[0];
 }
 function shouldShowUpgradeNotice(ctx = {}) {
-  const current = ctx.current ?? "0.12.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);
@@ -14727,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.12.0";
+    const current = ctx.current ?? "0.13.0";
     const latest = ctx.latest ?? serverLatestVersion;
     process.stderr.write(formatUpgradeNotice(current, latest));
   } catch {
@@ -18036,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(
@@ -18134,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) {
@@ -18178,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(
@@ -19864,7 +19951,7 @@ function withDefaultHelp(args) {
 }
 function createProgram() {
   const program2 = new Command();
-  program2.name("mel").description("Mel \u2014 Melius agent CLI").version("0.12.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-2PWVQ3PC.js";
+} from "../chunk-5APS3BGT.js";
 export {
   createProgram,
   withDefaultHelp

package/package.json

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