@melius-ai/cli 0.10.1 → 0.12.0

package/README.md

@@ -228,6 +228,21 @@ mel template apply <canvasId> <templateId> \
 mel bulk-run start <canvasId> --node-ids <groupId> --wait
 ```
 
+Each `--inputs` entry targets an input `portId` from `mel template list`. Three kinds are supported (`mediaType` is `image`, `video`, `audio`, or `pdf`):
+
+| Kind       | Shape                             | Use for                                                      |
+| ---------- | --------------------------------- | ------------------------------------------------------------ |
+| `text`     | `{kind,portId,text}`              | A text prompt/value                                          |
+| `asset`    | `{kind,portId,assetId,mediaType}` | A stored library asset (from `mel asset search`)             |
+| `assetUrl` | `{kind,portId,url,mediaType}`     | A remote media URL — fetched and stored server-side on apply |
+
+`assetUrl` lets you wire an image already hosted on your own site (e.g. a product image) without a separate upload round-trip:
+
+```bash
+mel template apply <canvasId> <templateId> \
+  --inputs '[{"kind":"assetUrl","portId":"<portId>","url":"https://example.com/image.jpg","mediaType":"image"}]'
+```
+
 ### Models
 
 | Command                                          | Description                                                   |

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,93 @@
+# Third-party notices
+
+`@melius-ai/cli` is distributed as a bundle: the source of the packages below
+is compiled into `dist` and redistributed inside the npm tarball. Their
+licenses and copyright notices are reproduced here as those licenses require.
+
+Generated by `pnpm --filter @melius-ai/cli run notices` from the build output —
+do not edit by hand. `test/bundle-licenses.test.ts` fails when it drifts.
+
+## @ts-rest/core@3.52.1
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2022 Oliver Butler
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## commander@13.1.0
+
+License: MIT
+
+```
+(The MIT License)
+
+Copyright (c) 2011 TJ Holowaychuk <tj@vision-media.ca>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+## zod@3.25.76
+
+License: MIT
+
+```
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/dist/bin/mel.js

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

package/dist/{chunk-NNJE574V.js → chunk-2PWVQ3PC.js}

@@ -7740,6 +7740,7 @@ var MAX_VARIATIONS = 10;
 
 // ../api-contract/src/common.ts
 var MessageResponseSchema = external_exports.object({ message: external_exports.string() });
+var ShareVisibilitySchema = external_exports.enum(["team", "anyone"]);
 var CompletedPartSchema = external_exports.object({
   partNumber: external_exports.number().int().positive(),
   etag: external_exports.string()
@@ -7912,7 +7913,7 @@ var FileTypeSchema = external_exports.enum([
   "pdf",
   "text"
 ]);
-var AssetShareModeSchema = external_exports.enum(["team", "anyone"]);
+var AssetShareModeSchema = ShareVisibilitySchema;
 var TAG_COLOR_PALETTE = [
   "hsl(189deg, 72%, 46%)",
   "hsl(280deg, 60%, 50%)",
@@ -7979,7 +7980,14 @@ var FileCardSchema = external_exports.object({
 var FileGenerationSchema = external_exports.object({
   prompt: external_exports.string().nullable(),
   modelDisplayName: external_exports.string().nullable(),
-  aspectRatio: external_exports.string().nullable()
+  aspectRatio: external_exports.string().nullable(),
+  /** The node tool that produced the asset (e.g. `video-background-removal`),
+   * when it came from a tool run rather than a plain model generation. The
+   * viewer labels the row "Tool used" instead of "Model" when set.
+   *
+   * Optional so a client that ships ahead of the server keeps validating —
+   * absent reads the same as "not a tool run". */
+  sourceToolName: external_exports.string().nullable().optional()
 });
 var FileDetailSchema = FileCardSchema.extend({
   width: external_exports.number().int().nullable(),
@@ -8216,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()
@@ -8601,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"
   }
 });
 
@@ -8613,7 +8655,12 @@ var AgentMessageFeedbackTypeSchema = external_exports.enum(["positive", "negativ
 var AgentClarificationQuestionSchema = external_exports.object({
   id: external_exports.string().min(1),
   prompt: external_exports.string().min(1),
-  suggestedAnswers: external_exports.array(external_exports.string().min(1)).min(1).max(3).optional(),
+  // Tolerates an explicit null and normalizes it to absent: models write
+  // `"suggestedAnswers": null` for no-suggestion questions, and a
+  // present-but-undefined key survives some JSON serializers as null in
+  // persisted metadata. Rejecting it here silently dropped the whole
+  // clarification form for the turn.
+  suggestedAnswers: external_exports.array(external_exports.string().min(1)).min(1).max(3).nullish().transform((value) => value ?? void 0),
   /**
    * Marks the Slack project/canvas routing question so the Slack renderer
    * can offer a "Last used canvas" shortcut + "Select other" instead of a
@@ -8873,7 +8920,22 @@ var agentContract = c3.router({
       enabledSources: external_exports.array(AgentMessageSourceSchema).optional(),
       // Per-turn override for the persisted profile setting.
       // Omitted = use the user's saved preference.
-      agentAutoRunOverride: external_exports.boolean().optional()
+      agentAutoRunOverride: external_exports.boolean().optional(),
+      // Plan mode (flag `agent-plan-mode`): run this turn on the
+      // execution model with high reasoning and a read-only toolset
+      // so the agent drafts or refines a plan instead of executing.
+      // Ignored (normal turn) when the flag is off for the caller.
+      planMode: external_exports.boolean().optional(),
+      // First planning send after the member scrapped a plan: the
+      // server skips the current-plan injection so the planning
+      // model drafts fresh instead of reviving the dead plan.
+      // Ignored when `planMode` is not set.
+      discardPlan: external_exports.boolean().optional(),
+      // Execution handoff from plan mode: the server injects the
+      // session's latest agreed plan into this (normal-mode) turn
+      // so the execution model implements exactly what was
+      // approved. Ignored when the flag is off or no plan exists.
+      implementPlan: external_exports.boolean().optional()
     }).refine(
       (b) => b.content.trim().length > 0 || (b.imageUrls?.length ?? 0) > 0 || (b.images?.length ?? 0) > 0 || (b.videoUrls?.length ?? 0) > 0 || (b.videos?.length ?? 0) > 0 || (b.documents?.length ?? 0) > 0,
       {
@@ -9299,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 ───────────────────────────────────────────────────────────
@@ -9414,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",
@@ -9656,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"
@@ -10445,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(),
@@ -10471,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"]),
@@ -10595,8 +10691,8 @@ var NodeVersionResponseSchema = external_exports.object({
    * back to a kebab/snake → title-case rendering of the key when the
    * model isn't in the registry (newly added or since-removed).
    *
-   * Optional + nullable so historical gallery snapshots that pre-date
-   * this field keep validating; the gallery viewer falls back to the
+   * Optional + nullable so historical snapshots that pre-date this
+   * field keep validating; the snapshot viewer falls back to the
    * client-side `formatModelLabel` helper when this is missing.
    */
   modelDisplayName: external_exports.string().nullable().optional(),
@@ -10662,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). */
@@ -11116,6 +11214,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(),
@@ -11165,6 +11264,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(),
@@ -11199,6 +11299,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(),
@@ -11252,6 +11353,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(),
@@ -11340,6 +11442,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() })),
@@ -11349,9 +11461,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
     }
   },
@@ -11460,8 +11575,8 @@ var canvasContract = c7.router({
     }
   },
   // Returns canvases across every team the authenticated user is a
-  // member of. Used by surfaces (e.g. gallery submission) where the
-  // active team header should not constrain the picker.
+  // member of, for pickers where the active team header should not
+  // constrain the results.
   listUserCanvases: {
     method: "GET",
     path: "/users/me/canvases",
@@ -11591,6 +11706,30 @@ var canvasContract = c7.router({
       404: MessageResponseSchema
     }
   },
+  // Who can view this node as a shared playground generation. `anyone`
+  // publishes it behind the public `/g/:nodeId` link; `team` (default)
+  // revokes it. Team-scoped like the asset share toggle.
+  getNodeShareMode: {
+    method: "GET",
+    path: "/nodes/:nodeId/share-mode",
+    pathParams: external_exports.object({ nodeId: external_exports.string().uuid() }),
+    responses: {
+      200: external_exports.object({ shareMode: ShareVisibilitySchema }),
+      403: MessageResponseSchema,
+      404: MessageResponseSchema
+    }
+  },
+  setNodeShareMode: {
+    method: "PATCH",
+    path: "/nodes/:nodeId/share-mode",
+    pathParams: external_exports.object({ nodeId: external_exports.string().uuid() }),
+    body: external_exports.object({ shareMode: ShareVisibilitySchema }),
+    responses: {
+      200: external_exports.object({ shareMode: ShareVisibilitySchema }),
+      403: MessageResponseSchema,
+      404: MessageResponseSchema
+    }
+  },
   listNodeVersionAssets: {
     method: "GET",
     path: "/node-versions/:versionId/assets",
@@ -12455,6 +12594,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(),
@@ -12575,6 +12716,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()
@@ -12745,6 +12889,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(),
@@ -12755,7 +12902,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),
@@ -13125,6 +13280,90 @@ var SharedAssetResponseSchema = external_exports.object({
   height: external_exports.number().int().nullable(),
   durationInMs: external_exports.number().int().nullable()
 });
+var SharedGenerationMediaTypeSchema = external_exports.enum(["image", "video", "audio"]);
+var SharedGenerationTypeSchema = external_exports.enum(["text", "image", "video", "audio"]);
+var SharedGenerationReferenceSchema = external_exports.object({
+  mediaType: SharedGenerationMediaTypeSchema,
+  url: external_exports.string().nullable(),
+  previewUrl: external_exports.string().nullable(),
+  // The input handle the reference was wired to (e.g. starting_image), so the
+  // viewer can render the role. Null when the source used the default slot.
+  targetHandle: external_exports.string().nullable()
+});
+var SharedGenerationOutputSchema = external_exports.object({
+  mediaUrl: external_exports.string().nullable(),
+  mediaType: SharedGenerationMediaTypeSchema.nullable(),
+  width: external_exports.number().int().nullable(),
+  height: external_exports.number().int().nullable(),
+  durationInMs: external_exports.number().int().nullable(),
+  // Optional for independent web/core deployments.
+  text: external_exports.string().nullable().optional()
+});
+var SharedCreatorSchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  name: external_exports.string(),
+  email: external_exports.string(),
+  avatarUrl: external_exports.string().nullable()
+});
+var SharedGenerationResponseSchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  type: SharedGenerationTypeSchema,
+  prompt: external_exports.string(),
+  modelName: external_exports.string().nullable(),
+  modelLabel: external_exports.string().nullable(),
+  tier: external_exports.string().nullable(),
+  aspectRatio: OutputAspectRatioSchema.nullable(),
+  output: SharedGenerationOutputSchema.nullable(),
+  references: external_exports.array(SharedGenerationReferenceSchema),
+  // Display name of the member who created the generation, for the
+  // "Created by …" tag. Null when the creator is unknown/deleted.
+  createdByName: external_exports.string().nullable(),
+  // Optional to support version-skew between web and core deployments.
+  createdByUser: SharedCreatorSchema.nullable().optional(),
+  // Set when the generation was produced by a template — the viewer's "Create
+  // in my playground" then opens that template to try, instead of staging a
+  // plain playground run. Null for playground generations.
+  templateId: external_exports.string().uuid().nullable(),
+  createdAt: external_exports.string().nullable()
+});
+var RecreateGenerationReferenceSchema = external_exports.object({
+  assetId: external_exports.string().uuid(),
+  displayName: external_exports.string(),
+  mediaType: SharedGenerationMediaTypeSchema,
+  url: external_exports.string().nullable(),
+  previewUrl: external_exports.string().nullable(),
+  targetHandle: external_exports.string().nullable()
+});
+var RecreateGenerationResponseSchema = external_exports.object({
+  type: SharedGenerationTypeSchema,
+  prompt: external_exports.string(),
+  modelName: external_exports.string(),
+  // The model variant the source ran (e.g. image-to-video), so the viewer's
+  // composer can pre-select the matching recipe and wire the references into
+  // its input slots. Null when the source recorded no variant.
+  variant: external_exports.string().nullable(),
+  tier: external_exports.string().nullable(),
+  aspectRatio: OutputAspectRatioSchema.nullable(),
+  resolution: external_exports.string().nullable(),
+  duration: external_exports.number().int().positive().nullable(),
+  references: external_exports.array(RecreateGenerationReferenceSchema),
+  // Display name of the member who created the source generation, for the
+  // "Created by …" tag shown on the recreated example in the viewer's
+  // playground. Null when the creator is unknown/deleted.
+  createdByName: external_exports.string().nullable(),
+  // The owned copy of the shared generation. Optional so a newer web client
+  // continues to accept a response from an already-deployed backend while it
+  // rolls out.
+  recreatedGeneration: external_exports.object({
+    nodeId: external_exports.string().uuid(),
+    projectId: external_exports.string().uuid(),
+    canvasId: external_exports.string().uuid()
+  }).optional()
+});
+var SharedGenerationHandoffSchema = RecreateGenerationResponseSchema.extend({
+  modelLabel: external_exports.string().nullable(),
+  output: SharedGenerationOutputSchema.nullable()
+});
 var ShareCanvasResponseSchema = external_exports.object({
   id: external_exports.string().uuid(),
   projectId: external_exports.string().uuid(),
@@ -13152,12 +13391,7 @@ var ShareProjectInfoResponseSchema = external_exports.object({
   // The user who created the project — used to render "X shared Y" copy in
   // link previews and the owner card on the shared canvas view. Null for
   // legacy projects with no recorded creator.
-  createdByUser: external_exports.object({
-    id: external_exports.string().uuid(),
-    name: external_exports.string(),
-    email: external_exports.string(),
-    avatarUrl: external_exports.string().nullable()
-  }).nullable()
+  createdByUser: SharedCreatorSchema.nullable()
 });
 var shareContract = c12.router({
   // Public endpoint — no auth required
@@ -13193,6 +13427,18 @@ var shareContract = c12.router({
       404: MessageResponseSchema
     }
   },
+  // Public endpoint — no auth required. Resolves one playground generation
+  // (a node) for an anonymous viewer; 404s unless the node's shareMode is
+  // `anyone`.
+  getSharedGeneration: {
+    method: "GET",
+    path: "/share/generations/:nodeId",
+    pathParams: external_exports.object({ nodeId: external_exports.string().uuid() }),
+    responses: {
+      200: SharedGenerationResponseSchema,
+      404: MessageResponseSchema
+    }
+  },
   // Public endpoint — no auth required
   getSharedCanvas: {
     method: "GET",
@@ -13225,6 +13471,20 @@ var shareContract = c12.router({
       200: external_exports.object({ shareMode: ShareModeSchema })
     }
   },
+  // Authenticated. Clone a shared generation's referenced assets into the
+  // caller's team + files and return a run-ready payload the client feeds into
+  // the Playground run path. 404s unless the node's shareMode is `anyone`.
+  recreateSharedGeneration: {
+    method: "POST",
+    path: "/share/generations/:nodeId/recreate",
+    pathParams: external_exports.object({ nodeId: external_exports.string().uuid() }),
+    body: external_exports.object({}),
+    responses: {
+      200: RecreateGenerationResponseSchema,
+      403: MessageResponseSchema,
+      404: MessageResponseSchema
+    }
+  },
   copySharedCanvas: {
     method: "POST",
     path: "/share/projects/:projectId/canvases/:canvasId/copy",
@@ -13675,10 +13935,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;
@@ -13702,6 +13969,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)
 });
@@ -13715,8 +13986,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
@@ -13724,7 +14002,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()
 });
@@ -13755,7 +14033,7 @@ var projectContract = c14.router({
     body: CreateProjectBodySchema,
     responses: {
       201: ProjectResponseSchema,
-      409: MessageResponseSchema
+      409: ProjectConflictResponseSchema
     }
   },
   listDeletedProjects: {
@@ -13764,6 +14042,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",
@@ -13777,7 +14061,7 @@ var projectContract = c14.router({
     body: UpdateProjectBodySchema,
     responses: {
       200: ProjectResponseSchema,
-      409: MessageResponseSchema
+      409: ProjectConflictResponseSchema
     }
   },
   deleteProject: {
@@ -13897,18 +14181,31 @@ var projectContract = c14.router({
 });
 
 // ../api-contract/src/template-apply-input.ts
+var templateApplyTextInput = external_exports.object({
+  kind: external_exports.literal("text"),
+  portId: external_exports.string(),
+  text: external_exports.string().min(1)
+});
+var templateApplyAssetInput = external_exports.object({
+  kind: external_exports.literal("asset"),
+  portId: external_exports.string(),
+  assetId: external_exports.string().uuid(),
+  mediaType: external_exports.enum(["image", "video", "audio", "pdf"])
+});
+var templateApplyAssetUrlInput = external_exports.object({
+  kind: external_exports.literal("assetUrl"),
+  portId: external_exports.string(),
+  url: external_exports.string().url(),
+  mediaType: external_exports.enum(["image", "video", "audio", "pdf"])
+});
+var TemplateApplyLibraryInputSchema = external_exports.discriminatedUnion("kind", [
+  templateApplyTextInput,
+  templateApplyAssetInput
+]);
 var TemplateApplyInputSchema = external_exports.discriminatedUnion("kind", [
-  external_exports.object({
-    kind: external_exports.literal("asset"),
-    portId: external_exports.string(),
-    assetId: external_exports.string().uuid(),
-    mediaType: external_exports.enum(["image", "video", "audio", "pdf"])
-  }),
-  external_exports.object({
-    kind: external_exports.literal("text"),
-    portId: external_exports.string(),
-    text: external_exports.string().min(1)
-  })
+  templateApplyTextInput,
+  templateApplyAssetInput,
+  templateApplyAssetUrlInput
 ]);
 
 // ../api-contract/src/template-public-api.ts
@@ -14409,7 +14706,7 @@ function isMajorUpgrade(current, latest) {
   return l[0] > c17[0];
 }
 function shouldShowUpgradeNotice(ctx = {}) {
-  const current = ctx.current ?? "0.10.1";
+  const current = ctx.current ?? "0.12.0";
   const latest = ctx.latest ?? serverLatestVersion;
   const env = ctx.env ?? process.env;
   const isTty = ctx.isTty ?? Boolean(process.stderr.isTTY);
@@ -14430,7 +14727,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.10.1";
+    const current = ctx.current ?? "0.12.0";
     const latest = ctx.latest ?? serverLatestVersion;
     process.stderr.write(formatUpgradeNotice(current, latest));
   } catch {
@@ -16629,7 +16926,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:
@@ -16840,7 +17137,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):
@@ -18280,7 +18577,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:
@@ -19026,7 +19323,7 @@ function parseInputs(value) {
       "USAGE_ERROR",
       result.error.issues.map((issue) => issue.message).join("; "),
       {
-        suggestion: 'Use text inputs {"kind":"text","portId":"<portId>","text":"<text>"} or asset inputs {"kind":"asset","portId":"<portId>","assetId":"<assetId>","mediaType":"image|video|audio|pdf"}'
+        suggestion: 'Use text inputs {"kind":"text","portId":"<portId>","text":"<text>"}, library-asset inputs {"kind":"asset","portId":"<portId>","assetId":"<assetId>","mediaType":"image|video|audio|pdf"}, or image-URL inputs {"kind":"assetUrl","portId":"<portId>","url":"https://...","mediaType":"image|video|audio|pdf"}'
       }
     ),
     EXIT_USAGE_ERROR
@@ -19067,18 +19364,22 @@ Examples:
     "Y center for the template box. Omit for automatic non-overlapping placement"
   ).option(
     "--inputs <json>",
-    "JSON array of text or library-asset inputs targeting port IDs from mel template list"
+    "JSON array of text, library-asset, or image-URL inputs targeting port IDs from mel template list"
   ).addHelpText(
     "after",
     `
 Returns: { instanceId, groupId }. Internal workflow node IDs are never returned.
-Input kinds: text {kind,portId,text}; asset {kind,portId,assetId,mediaType} where mediaType is image, video, audio, or pdf.
+Input kinds (mediaType is image, video, audio, or pdf):
+  text     {kind,portId,text}
+  asset    {kind,portId,assetId,mediaType} \u2014 a stored library asset (from mel asset search)
+  assetUrl {kind,portId,url,mediaType}     \u2014 a remote media URL fetched and stored server-side (e.g. a product image already hosted on your site)
 Omit --center-x/--center-y to place the box automatically. Use mel canvas content <canvasId> afterward to inspect its public ports.
 Run the applied template with mel bulk-run start <canvasId> --node-ids <groupId> --wait.
 
 Examples:
   $ mel template apply <canvasId> <templateId>
   $ mel template apply <canvasId> <templateId> --inputs '[{"kind":"text","portId":"<portId>","text":"A red shoe"}]'
+  $ mel template apply <canvasId> <templateId> --inputs '[{"kind":"assetUrl","portId":"<portId>","url":"https://example.com/image.jpg","mediaType":"image"}]'
   $ mel bulk-run start <canvasId> --node-ids <groupId> --wait`
   ).action(
     async (canvasId, templateId, opts) => {
@@ -19563,7 +19864,7 @@ function withDefaultHelp(args) {
 }
 function createProgram() {
   const program2 = new Command();
-  program2.name("mel").description("Mel \u2014 Melius agent CLI").version("0.10.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.12.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-NNJE574V.js";
+} from "../chunk-2PWVQ3PC.js";
 export {
   createProgram,
   withDefaultHelp

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melius-ai/cli",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "description": "The Melius command-line interface — create canvases and run AI image/video generations from your terminal",
   "keywords": [
     "ai",
@@ -21,7 +21,8 @@
     "mel": "./dist/bin/mel.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "THIRD-PARTY-NOTICES.md"
   ],
   "type": "module",
   "exports": {