@mindstudio-ai/agent 0.1.180 → 0.1.181

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,14 @@ What changed in `@mindstudio-ai/agent`, newest first, each version under its own
4
4
 
5
5
  Versions before 0.1.163 aren't recorded here.
6
6
 
7
+ ## 0.1.181
8
+
9
+ ### Changed behavior
10
+
11
+ - A database error over the socket throws with the status the platform answered with, as the HTTP path always has, where it was always 400: a parked database server's `database_lease_parked` and `database_unavailable` are 503s, a query past its time a 504, the platform's own fault a 500, and the app's own SQL stays a 400. The code is unchanged. Check code that branches on `err.status === 400` for every database error: branch on `err.code` instead.
12
+ - `generate3dModel`'s usage notes list `wavespeed-meshy-t2.5`, Meshy's low-poly model, which makes a triangle mesh of up to 30,000 polygons from the prompt or one `image`. App code isn't affected.
13
+ - `generateImage`'s usage notes name `ideogram-v4.5` among the models that take one `image`, in place of the MAI models, which retired onto it on 2026-11-05. App code isn't affected.
14
+
7
15
  ## 0.1.180
8
16
 
9
17
  ### Changed behavior
package/dist/cli.js CHANGED
@@ -376,7 +376,7 @@ var init_metadata = __esm({
376
376
  "generate3dModel": {
377
377
  stepType: "generate3dModel",
378
378
  description: "Generate a 3D model using a 3D generation model.",
379
- usageNotes: "- The default model is wavespeed-tripo3d-h3.1 (Tripo v3.1), which makes a model from the prompt, from one `image`, or from `images`: 2\u20134 views of the same object, in order front, left, back, right.\n- Models and what they take, set in `threeDModelOverride.config`:\n - From text or an image: wavespeed-tripo3d-h3.1, wavespeed-meshy7.1 (also `images`, 1\u20134 views), wavespeed-hunyuan3d-v3 (an `image`, plus optional `back_image_url`, `left_image_url`, `right_image_url`), wavespeed-hunyuan-3d-v3.1-rapid, wavespeed-tripo3d-p2, wavespeed-rodin-v2.5 (`images`, 1\u20135).\n - From an image only: trellis-2, wavespeed-meshy7 (or `images`, 1\u20134 views), seed3d-2.0.\n - From views: wavespeed-hi3d-v3.0 (`front_image`, and optional `back_image`, `left_image`, `right_image`).\n- `$mode` in the config picks a model's mode (`text-to-3d`, `image-to-3d`, or its multi-view mode). Left out, `images` picks the multi-view mode and `image` picks image-to-3d; with neither, the model's default mode. A text mode needs the prompt; in the others the prompt is optional guidance.\n- The output is standardized as a GLB URL plus optional FBX/OBJ/USDZ, thumbnail, texture maps, and provider task ID.",
379
+ usageNotes: "- The default model is wavespeed-tripo3d-h3.1 (Tripo v3.1), which makes a model from the prompt, from one `image`, or from `images`: 2\u20134 views of the same object, in order front, left, back, right.\n- Models and what they take, set in `threeDModelOverride.config`:\n - From text or an image: wavespeed-tripo3d-h3.1, wavespeed-meshy7.1 (also `images`, 1\u20134 views), wavespeed-meshy-t2.5 (a low-poly mesh of up to 30,000 polygons), wavespeed-hunyuan3d-v3 (an `image`, plus optional `back_image_url`, `left_image_url`, `right_image_url`), wavespeed-hunyuan-3d-v3.1-rapid, wavespeed-tripo3d-p2, wavespeed-rodin-v2.5 (`images`, 1\u20135).\n - From an image only: trellis-2, wavespeed-meshy7 (or `images`, 1\u20134 views), seed3d-2.0.\n - From views: wavespeed-hi3d-v3.0 (`front_image`, and optional `back_image`, `left_image`, `right_image`).\n- `$mode` in the config picks a model's mode (`text-to-3d`, `image-to-3d`, or its multi-view mode). Left out, `images` picks the multi-view mode and `image` picks image-to-3d; with neither, the model's default mode. A text mode needs the prompt; in the others the prompt is optional guidance.\n- The output is standardized as a GLB URL plus optional FBX/OBJ/USDZ, thumbnail, texture maps, and provider task ID.",
380
380
  inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Text prompt for text-to-3D models, or optional guidance for image-to-3D models" }, "intermediateAsset": { "type": "boolean", "description": "When true, the asset is created but hidden from the user's gallery (tagged as intermediate)" }, "threeDModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "3D generation model identifier" }, "config": { "type": "object", "properties": {}, "required": [], "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default 3D model if not specified" } } },
381
381
  outputSchema: { "type": "object", "properties": { "prompt": { "type": "string" }, "glbUrl": { "type": "string" }, "fbxUrl": { "type": "string" }, "objUrl": { "type": "string" }, "usdzUrl": { "type": "string" }, "thumbnailUrl": { "type": "string" }, "textureUrls": { "type": "array", "items": { "type": "object", "properties": {}, "required": [] } }, "providerTaskId": { "type": "string" }, "resolvedConfig": { "type": "object", "properties": {}, "required": [] } }, "required": ["glbUrl"] }
382
382
  },
@@ -390,7 +390,7 @@ var init_metadata = __esm({
390
390
  "generateImage": {
391
391
  stepType: "generateImage",
392
392
  description: "Generate an image from a text prompt, or edit one, using an AI model.",
393
- usageNotes: "- Prompts should be descriptive but concise (roughly 3\u20136 sentences).\n- The default model is seedream-4.5. Options go in `imageModelOverride.config` under the model's own names, and differ by model, so look the model up before writing the call. Images to edit or draw from go there too, as URLs: `images` on most models, `source_images` on the Gemini and GPT Image models, one `image` on qwen-image, z-image-turbo, krea-v2-turbo, ideogram-v4 and the MAI models, `source_image` on Grok Imagine, `image_url` on the Ideogram remix and FLUX Kontext models, and `reference` on krea-v2-large.\n- A model that makes and edits images by separate means takes `$mode` in its config (`text-to-image`, and `edit`, `image-edit` or `image-to-image`, as it lists). Left out, images in the config pick the edit mode, and otherwise the model makes the image from the prompt.\n- Images are hosted on the public CDN by default, or in one of the app's own file stores when the call passes `store` \u2014 a private store keeps the image private.\n- In foreground mode, the image is displayed to the user. In background mode, the URL is saved to a variable.\n- When generateVariants is true with numVariants > 1 (up to 10), the images are generated in parallel. One that fails is left out of the URLs returned, and the step fails only when every one does.\n- In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.",
393
+ usageNotes: "- Prompts should be descriptive but concise (roughly 3\u20136 sentences).\n- The default model is seedream-4.5. Options go in `imageModelOverride.config` under the model's own names, and differ by model, so look the model up before writing the call. Images to edit or draw from go there too, as URLs: `images` on most models, `source_images` on the Gemini and GPT Image models, one `image` on qwen-image, z-image-turbo, krea-v2-turbo, ideogram-v4 and ideogram-v4.5, `source_image` on Grok Imagine, `image_url` on the Ideogram remix and FLUX Kontext models, and `reference` on krea-v2-large.\n- A model that makes and edits images by separate means takes `$mode` in its config (`text-to-image`, and `edit`, `image-edit` or `image-to-image`, as it lists). Left out, images in the config pick the edit mode, and otherwise the model makes the image from the prompt.\n- Images are hosted on the public CDN by default, or in one of the app's own file stores when the call passes `store` \u2014 a private store keeps the image private.\n- In foreground mode, the image is displayed to the user. In background mode, the URL is saved to a variable.\n- When generateVariants is true with numVariants > 1 (up to 10), the images are generated in parallel. One that fails is left out of the URLs returned, and the step fails only when every one does.\n- In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.",
394
394
  inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Text prompt describing the image to generate" }, "intermediateAsset": { "type": "boolean", "description": "When true, the asset is created but hidden from the user's gallery (tagged as intermediate)" }, "imageModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "Image generation model identifier" }, "config": { "type": "object", "properties": {}, "required": [], "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default image model if not specified" }, "generateVariants": { "type": "boolean", "description": "Whether to generate multiple image variants in parallel" }, "numVariants": { "type": "number", "description": "Number of variants to generate (max 10)" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated image.\n\nThe watermark is a product mark on assets generated in the MindStudio UI. A step run directly via the SDK or API is producing the app's own asset, so it is never watermarked and this flag has no effect there." } }, "required": ["prompt"] },
395
395
  outputSchema: { "type": "object", "properties": { "imageUrl": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["imageUrl"] }
396
396
  },
@@ -1446,11 +1446,12 @@ function deliver(self, msg) {
1446
1446
  clearPendingTimer(p);
1447
1447
  dropSettledRequest(self, msg.id);
1448
1448
  if (msg.error) {
1449
+ const status = typeof msg.error.status === "number" && Number.isInteger(msg.error.status) && msg.error.status >= 400 && msg.error.status <= 599 ? msg.error.status : 400;
1449
1450
  p.reject(
1450
1451
  new MindStudioError(
1451
1452
  `[db] ${msg.error.message || "Database query failed"}`,
1452
1453
  msg.error.code || "db_query_error",
1453
- 400,
1454
+ status,
1454
1455
  msg.error
1455
1456
  )
1456
1457
  );
@@ -10086,7 +10087,7 @@ async function startMcpServer(options) {
10086
10087
  capabilities: { tools: {} },
10087
10088
  serverInfo: {
10088
10089
  name: "mindstudio-agent",
10089
- version: "0.1.180"
10090
+ version: "0.1.181"
10090
10091
  },
10091
10092
  instructions: 'Welcome to MindStudio \u2014 a platform with 200+ AI models, 850+ third-party integrations, and pre-built agents.\n\nGetting started:\n1. Call `ask` with any question about the SDK \u2014 it knows every action, model, and connector and returns working code with real model IDs and config options. Examples: ask("generate an image with FLUX"), ask("what models support vision?"), ask("how do I send a Slack message?").\n2. Call `changeName` to set your display name \u2014 use your name or whatever your user calls you. This is how you\'ll appear in MindStudio request logs.\n3. If you have a profile picture, pass its public image URL to `changeProfilePicture`.\n4. For manual browsing, call `listActions` to discover all available actions.\n\nThen use the tools to generate text, images, video, audio, search the web, work with data sources, run agents, and more.\n\nImportant:\n- AI-powered actions (text generation, image generation, video, audio, etc.) cost money. Before running these, call `estimateActionCost` and confirm with the user before proceeding \u2014 unless they\'ve explicitly told you to go ahead.\n- Not all agents from `listAgents` are configured for API use. Do not try to run an agent just because it appears in the list \u2014 it will likely fail. Only run agents the user specifically asks you to run.'
10092
10093
  });
@@ -11126,7 +11127,7 @@ function isNewerVersion(current, latest) {
11126
11127
  return false;
11127
11128
  }
11128
11129
  async function checkForUpdate() {
11129
- const currentVersion = "0.1.180";
11130
+ const currentVersion = "0.1.181";
11130
11131
  if (!currentVersion || process.env.MINDSTUDIO_NO_UPDATE_CHECK) {
11131
11132
  return null;
11132
11133
  }
@@ -11161,7 +11162,7 @@ async function checkForUpdate() {
11161
11162
  }
11162
11163
  }
11163
11164
  function printUpdateNotice(latestVersion) {
11164
- const currentVersion = "0.1.180";
11165
+ const currentVersion = "0.1.181";
11165
11166
  process.stderr.write(
11166
11167
  `
11167
11168
  ${ansi2.cyanBright("Update available")} ${ansi2.gray(currentVersion + " \u2192")} ${ansi2.cyanBold(latestVersion)}
@@ -11174,7 +11175,7 @@ function isStandaloneBinary() {
11174
11175
  return !argv1.includes("node_modules");
11175
11176
  }
11176
11177
  async function cmdUpdate() {
11177
- const currentVersion = "0.1.180";
11178
+ const currentVersion = "0.1.181";
11178
11179
  process.stderr.write(
11179
11180
  ` ${ansi2.gray("Current version:")} ${currentVersion}
11180
11181
  `
@@ -11315,7 +11316,7 @@ async function cmdLogin(options) {
11315
11316
  process.stderr.write("\n");
11316
11317
  printLogo();
11317
11318
  process.stderr.write("\n");
11318
- const ver = "0.1.180";
11319
+ const ver = "0.1.181";
11319
11320
  process.stderr.write(
11320
11321
  ` ${ansi2.bold("MindStudio Agent")} ${ver ? " " + ansi2.gray("v" + ver) : ""}
11321
11322
  `
@@ -11643,7 +11644,7 @@ async function main() {
11643
11644
  const updatePromise = command !== "mcp" && command !== "login" && command !== "update" ? checkForUpdate() : Promise.resolve(null);
11644
11645
  try {
11645
11646
  if (command === "version" || command === "-v") {
11646
- process.stdout.write("0.1.180\n");
11647
+ process.stdout.write("0.1.181\n");
11647
11648
  return;
11648
11649
  }
11649
11650
  if (command === "login") {
@@ -811,7 +811,7 @@ export interface StepMethods {
811
811
  * @remarks
812
812
  * - The default model is wavespeed-tripo3d-h3.1 (Tripo v3.1), which makes a model from the prompt, from one `image`, or from `images`: 2–4 views of the same object, in order front, left, back, right.
813
813
  * - Models and what they take, set in `threeDModelOverride.config`:
814
- * - From text or an image: wavespeed-tripo3d-h3.1, wavespeed-meshy7.1 (also `images`, 1–4 views), wavespeed-hunyuan3d-v3 (an `image`, plus optional `back_image_url`, `left_image_url`, `right_image_url`), wavespeed-hunyuan-3d-v3.1-rapid, wavespeed-tripo3d-p2, wavespeed-rodin-v2.5 (`images`, 1–5).
814
+ * - From text or an image: wavespeed-tripo3d-h3.1, wavespeed-meshy7.1 (also `images`, 1–4 views), wavespeed-meshy-t2.5 (a low-poly mesh of up to 30,000 polygons), wavespeed-hunyuan3d-v3 (an `image`, plus optional `back_image_url`, `left_image_url`, `right_image_url`), wavespeed-hunyuan-3d-v3.1-rapid, wavespeed-tripo3d-p2, wavespeed-rodin-v2.5 (`images`, 1–5).
815
815
  * - From an image only: trellis-2, wavespeed-meshy7 (or `images`, 1–4 views), seed3d-2.0.
816
816
  * - From views: wavespeed-hi3d-v3.0 (`front_image`, and optional `back_image`, `left_image`, `right_image`).
817
817
  * - `$mode` in the config picks a model's mode (`text-to-3d`, `image-to-3d`, or its multi-view mode). Left out, `images` picks the multi-view mode and `image` picks image-to-3d; with neither, the model's default mode. A text mode needs the prompt; in the others the prompt is optional guidance.
@@ -828,7 +828,7 @@ export interface StepMethods {
828
828
  *
829
829
  * @remarks
830
830
  * - Prompts should be descriptive but concise (roughly 3–6 sentences).
831
- * - The default model is seedream-4.5. Options go in `imageModelOverride.config` under the model's own names, and differ by model, so look the model up before writing the call. Images to edit or draw from go there too, as URLs: `images` on most models, `source_images` on the Gemini and GPT Image models, one `image` on qwen-image, z-image-turbo, krea-v2-turbo, ideogram-v4 and the MAI models, `source_image` on Grok Imagine, `image_url` on the Ideogram remix and FLUX Kontext models, and `reference` on krea-v2-large.
831
+ * - The default model is seedream-4.5. Options go in `imageModelOverride.config` under the model's own names, and differ by model, so look the model up before writing the call. Images to edit or draw from go there too, as URLs: `images` on most models, `source_images` on the Gemini and GPT Image models, one `image` on qwen-image, z-image-turbo, krea-v2-turbo, ideogram-v4 and ideogram-v4.5, `source_image` on Grok Imagine, `image_url` on the Ideogram remix and FLUX Kontext models, and `reference` on krea-v2-large.
832
832
  * - A model that makes and edits images by separate means takes `$mode` in its config (`text-to-image`, and `edit`, `image-edit` or `image-to-image`, as it lists). Left out, images in the config pick the edit mode, and otherwise the model makes the image from the prompt.
833
833
  * - Images are hosted on the public CDN by default, or in one of the app's own file stores when the call passes `store` — a private store keeps the image private.
834
834
  * - In foreground mode, the image is displayed to the user. In background mode, the URL is saved to a variable.
package/dist/index.js CHANGED
@@ -216,11 +216,12 @@ function deliver(self, msg) {
216
216
  clearPendingTimer(p);
217
217
  dropSettledRequest(self, msg.id);
218
218
  if (msg.error) {
219
+ const status = typeof msg.error.status === "number" && Number.isInteger(msg.error.status) && msg.error.status >= 400 && msg.error.status <= 599 ? msg.error.status : 400;
219
220
  p.reject(
220
221
  new MindStudioError(
221
222
  `[db] ${msg.error.message || "Database query failed"}`,
222
223
  msg.error.code || "db_query_error",
223
- 400,
224
+ status,
224
225
  msg.error
225
226
  )
226
227
  );
@@ -5188,7 +5189,7 @@ var stepMetadata = {
5188
5189
  "generate3dModel": {
5189
5190
  stepType: "generate3dModel",
5190
5191
  description: "Generate a 3D model using a 3D generation model.",
5191
- usageNotes: "- The default model is wavespeed-tripo3d-h3.1 (Tripo v3.1), which makes a model from the prompt, from one `image`, or from `images`: 2\u20134 views of the same object, in order front, left, back, right.\n- Models and what they take, set in `threeDModelOverride.config`:\n - From text or an image: wavespeed-tripo3d-h3.1, wavespeed-meshy7.1 (also `images`, 1\u20134 views), wavespeed-hunyuan3d-v3 (an `image`, plus optional `back_image_url`, `left_image_url`, `right_image_url`), wavespeed-hunyuan-3d-v3.1-rapid, wavespeed-tripo3d-p2, wavespeed-rodin-v2.5 (`images`, 1\u20135).\n - From an image only: trellis-2, wavespeed-meshy7 (or `images`, 1\u20134 views), seed3d-2.0.\n - From views: wavespeed-hi3d-v3.0 (`front_image`, and optional `back_image`, `left_image`, `right_image`).\n- `$mode` in the config picks a model's mode (`text-to-3d`, `image-to-3d`, or its multi-view mode). Left out, `images` picks the multi-view mode and `image` picks image-to-3d; with neither, the model's default mode. A text mode needs the prompt; in the others the prompt is optional guidance.\n- The output is standardized as a GLB URL plus optional FBX/OBJ/USDZ, thumbnail, texture maps, and provider task ID.",
5192
+ usageNotes: "- The default model is wavespeed-tripo3d-h3.1 (Tripo v3.1), which makes a model from the prompt, from one `image`, or from `images`: 2\u20134 views of the same object, in order front, left, back, right.\n- Models and what they take, set in `threeDModelOverride.config`:\n - From text or an image: wavespeed-tripo3d-h3.1, wavespeed-meshy7.1 (also `images`, 1\u20134 views), wavespeed-meshy-t2.5 (a low-poly mesh of up to 30,000 polygons), wavespeed-hunyuan3d-v3 (an `image`, plus optional `back_image_url`, `left_image_url`, `right_image_url`), wavespeed-hunyuan-3d-v3.1-rapid, wavespeed-tripo3d-p2, wavespeed-rodin-v2.5 (`images`, 1\u20135).\n - From an image only: trellis-2, wavespeed-meshy7 (or `images`, 1\u20134 views), seed3d-2.0.\n - From views: wavespeed-hi3d-v3.0 (`front_image`, and optional `back_image`, `left_image`, `right_image`).\n- `$mode` in the config picks a model's mode (`text-to-3d`, `image-to-3d`, or its multi-view mode). Left out, `images` picks the multi-view mode and `image` picks image-to-3d; with neither, the model's default mode. A text mode needs the prompt; in the others the prompt is optional guidance.\n- The output is standardized as a GLB URL plus optional FBX/OBJ/USDZ, thumbnail, texture maps, and provider task ID.",
5192
5193
  inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Text prompt for text-to-3D models, or optional guidance for image-to-3D models" }, "intermediateAsset": { "type": "boolean", "description": "When true, the asset is created but hidden from the user's gallery (tagged as intermediate)" }, "threeDModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "3D generation model identifier" }, "config": { "type": "object", "properties": {}, "required": [], "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default 3D model if not specified" } } },
5193
5194
  outputSchema: { "type": "object", "properties": { "prompt": { "type": "string" }, "glbUrl": { "type": "string" }, "fbxUrl": { "type": "string" }, "objUrl": { "type": "string" }, "usdzUrl": { "type": "string" }, "thumbnailUrl": { "type": "string" }, "textureUrls": { "type": "array", "items": { "type": "object", "properties": {}, "required": [] } }, "providerTaskId": { "type": "string" }, "resolvedConfig": { "type": "object", "properties": {}, "required": [] } }, "required": ["glbUrl"] }
5194
5195
  },
@@ -5202,7 +5203,7 @@ var stepMetadata = {
5202
5203
  "generateImage": {
5203
5204
  stepType: "generateImage",
5204
5205
  description: "Generate an image from a text prompt, or edit one, using an AI model.",
5205
- usageNotes: "- Prompts should be descriptive but concise (roughly 3\u20136 sentences).\n- The default model is seedream-4.5. Options go in `imageModelOverride.config` under the model's own names, and differ by model, so look the model up before writing the call. Images to edit or draw from go there too, as URLs: `images` on most models, `source_images` on the Gemini and GPT Image models, one `image` on qwen-image, z-image-turbo, krea-v2-turbo, ideogram-v4 and the MAI models, `source_image` on Grok Imagine, `image_url` on the Ideogram remix and FLUX Kontext models, and `reference` on krea-v2-large.\n- A model that makes and edits images by separate means takes `$mode` in its config (`text-to-image`, and `edit`, `image-edit` or `image-to-image`, as it lists). Left out, images in the config pick the edit mode, and otherwise the model makes the image from the prompt.\n- Images are hosted on the public CDN by default, or in one of the app's own file stores when the call passes `store` \u2014 a private store keeps the image private.\n- In foreground mode, the image is displayed to the user. In background mode, the URL is saved to a variable.\n- When generateVariants is true with numVariants > 1 (up to 10), the images are generated in parallel. One that fails is left out of the URLs returned, and the step fails only when every one does.\n- In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.",
5206
+ usageNotes: "- Prompts should be descriptive but concise (roughly 3\u20136 sentences).\n- The default model is seedream-4.5. Options go in `imageModelOverride.config` under the model's own names, and differ by model, so look the model up before writing the call. Images to edit or draw from go there too, as URLs: `images` on most models, `source_images` on the Gemini and GPT Image models, one `image` on qwen-image, z-image-turbo, krea-v2-turbo, ideogram-v4 and ideogram-v4.5, `source_image` on Grok Imagine, `image_url` on the Ideogram remix and FLUX Kontext models, and `reference` on krea-v2-large.\n- A model that makes and edits images by separate means takes `$mode` in its config (`text-to-image`, and `edit`, `image-edit` or `image-to-image`, as it lists). Left out, images in the config pick the edit mode, and otherwise the model makes the image from the prompt.\n- Images are hosted on the public CDN by default, or in one of the app's own file stores when the call passes `store` \u2014 a private store keeps the image private.\n- In foreground mode, the image is displayed to the user. In background mode, the URL is saved to a variable.\n- When generateVariants is true with numVariants > 1 (up to 10), the images are generated in parallel. One that fails is left out of the URLs returned, and the step fails only when every one does.\n- In direct execution, foreground mode behaves as background, and userSelect variant behavior behaves as saveAll.",
5206
5207
  inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Text prompt describing the image to generate" }, "intermediateAsset": { "type": "boolean", "description": "When true, the asset is created but hidden from the user's gallery (tagged as intermediate)" }, "imageModelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": "Image generation model identifier" }, "config": { "type": "object", "properties": {}, "required": [], "description": "Additional model-specific configuration" } }, "required": ["model"], "description": "Optional model configuration override. Uses the workflow's default image model if not specified" }, "generateVariants": { "type": "boolean", "description": "Whether to generate multiple image variants in parallel" }, "numVariants": { "type": "number", "description": "Number of variants to generate (max 10)" }, "addWatermark": { "type": "boolean", "description": "Whether to add a MindStudio watermark to the generated image.\n\nThe watermark is a product mark on assets generated in the MindStudio UI. A step run directly via the SDK or API is producing the app's own asset, so it is never watermarked and this flag has no effect there." } }, "required": ["prompt"] },
5207
5208
  outputSchema: { "type": "object", "properties": { "imageUrl": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["imageUrl"] }
5208
5209
  },