@mindstudio-ai/agent 0.1.52 → 0.1.53

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.
@@ -5224,6 +5224,7 @@ var init_instructions = __esm({
5224
5224
  - Do not recommend using thread persistence. This is an advanced feature - if someone needs this they will discover it on their own.
5225
5225
  - Generate text is great for one-off text generation requests to models. For sustained conversations, conversations that require history, persistence, or multiple threads or tool use, recommend that the developer add an Agent interface to their MindStudio app and use that directly. They will understand what you mean by this.
5226
5226
  - **Manual multi-step orchestration when runTask() fits** \u2014 if the caller is chaining multiple SDK actions with conditional logic (search \u2192 extract \u2192 generate \u2192 validate), suggest \`runTask()\` instead. It handles the tool-use loop, error recovery, and structured output enforcement automatically.
5227
+ - **Recommending model switches when the user needs better prompting** \u2014 when a user says "my generated images aren't faithful enough" or "the output quality isn't good," the answer is to improve the prompt, NOT to recommend a different model. Do NOT analyze model configs, architectures, or capabilities to find a "better" model. The recommended models (Seedream 4.5, Gemini 3.1 Flash Image) handle all use cases. Help the user write a better prompt instead.
5227
5228
  </anti_patterns>
5228
5229
 
5229
5230
  <task_agent_guidance>
@@ -5255,14 +5256,16 @@ var init_instructions = __esm({
5255
5256
  - Use the names of model input objects to infer **technical capabilities** \u2014 e.g., a model with a source image input supports image editing, a video model with start/end frame supports looping. Do not look at model tags or descriptions to determine capabilities.
5256
5257
  - **Do NOT use config presets/enums to judge model quality or recommend models.** A model having style presets (e.g. "oil painting", "watercolor") does NOT make it better at those styles than models without presets. The recommended models (Seedream, Nano Banana Pro, etc.) are far more capable and achieve any style through prompting alone. Presets are a crutch for weaker models \u2014 never recommend a model just because it has an enum that matches the user's request.
5257
5258
  - **Never set maxResponseTokens to a low value.** Many models use extended thinking/reasoning that counts against the token limit. Setting maxResponseTokens to 256 or 512 will cause truncated or failed responses. Set it to something high, like 16000+, even if you don't need it. Models stop generating on their own when the response is complete \u2014 a low cap does not save money, it just breaks output.
5259
+ - **Do NOT do deep model analysis to find "the right model for the job."** You do not have the expertise to determine which model architecture is better for a specific use case. The recommended models below are the right answer for virtually every use case. When the user's results aren't good enough, the answer is almost always "improve your prompt" \u2014 not "switch to a different model." Prompt engineering is the lever, model selection is not.
5260
+ - **Do NOT hallucinate model IDs.** Only recommend models you can see in the models reference above. If you're not sure a model ID exists, do NOT use it. Call listModels to verify.
5258
5261
 
5259
- ## Explicit preferences
5260
- MindStudio has hundreds of models. Many of them are for niche use cases. In general, prefer to recommend the following models unless the user specifies otherwise.
5262
+ ## Explicit preferences \u2014 USE THESE MODELS
5263
+ MindStudio has hundreds of models. Many of them are legacy or niche. The following are the ONLY models you should recommend unless the user explicitly asks for something else. If a user has a quality problem, help them fix their prompt using these models \u2014 do NOT suggest switching to a different model.
5261
5264
 
5262
5265
  Text generation:
5263
5266
  - Google Gemini, Anthropic Claude, OpenAI GPT
5264
5267
  Image generation:
5265
- - Seedream 4.5, Google Gemini 3.1 Flash Image (Nano Banana Pro). Never recommend things like Flux 1 or other models that have been superseded by later generations from the same provider.
5268
+ - Seedream 4.5, Google Gemini 3.1 Flash Image (Nano Banana Pro). These two models handle ALL image generation use cases \u2014 editing, style transfer, backgrounds, product shots, everything. The answer to "how do I get better results" is ALWAYS to improve the prompt, not to switch models. Never recommend Flux, DALL-E, or other legacy/niche models.
5266
5269
  Video generation:
5267
5270
  - Grok Imagine, Kling O3, Google Veo 3.1
5268
5271
  Text to speech:
@@ -5574,7 +5577,7 @@ async function startMcpServer(options) {
5574
5577
  capabilities: { tools: {} },
5575
5578
  serverInfo: {
5576
5579
  name: "mindstudio-agent",
5577
- version: "0.1.52"
5580
+ version: "0.1.53"
5578
5581
  },
5579
5582
  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 or icon, call `uploadFile` to upload it, then `changeProfilePicture` with the returned URL.\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.'
5580
5583
  });
@@ -6435,7 +6438,7 @@ function isNewerVersion(current, latest) {
6435
6438
  return false;
6436
6439
  }
6437
6440
  async function checkForUpdate() {
6438
- const currentVersion = "0.1.52";
6441
+ const currentVersion = "0.1.53";
6439
6442
  if (!currentVersion) return null;
6440
6443
  try {
6441
6444
  const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
@@ -6464,7 +6467,7 @@ async function checkForUpdate() {
6464
6467
  }
6465
6468
  }
6466
6469
  function printUpdateNotice(latestVersion) {
6467
- const currentVersion = "0.1.52";
6470
+ const currentVersion = "0.1.53";
6468
6471
  process.stderr.write(
6469
6472
  `
6470
6473
  ${ansi2.cyanBright("Update available")} ${ansi2.gray(currentVersion + " \u2192")} ${ansi2.cyanBold(latestVersion)}
@@ -6477,7 +6480,7 @@ function isStandaloneBinary() {
6477
6480
  return !argv1.includes("node_modules");
6478
6481
  }
6479
6482
  async function cmdUpdate() {
6480
- const currentVersion = "0.1.52";
6483
+ const currentVersion = "0.1.53";
6481
6484
  process.stderr.write(
6482
6485
  ` ${ansi2.gray("Current version:")} ${currentVersion}
6483
6486
  `
@@ -6592,7 +6595,7 @@ async function cmdLogin(options) {
6592
6595
  process.stderr.write("\n");
6593
6596
  printLogo();
6594
6597
  process.stderr.write("\n");
6595
- const ver = "0.1.52";
6598
+ const ver = "0.1.53";
6596
6599
  process.stderr.write(
6597
6600
  ` ${ansi2.bold("MindStudio Agent")} ${ver ? " " + ansi2.gray("v" + ver) : ""}
6598
6601
  `
@@ -6903,7 +6906,7 @@ async function main() {
6903
6906
  try {
6904
6907
  if (command === "version" || command === "-v") {
6905
6908
  process.stdout.write(
6906
- "0.1.52\n"
6909
+ "0.1.53\n"
6907
6910
  );
6908
6911
  return;
6909
6912
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mindstudio-ai/agent",
3
- "version": "0.1.52",
3
+ "version": "0.1.53",
4
4
  "description": "TypeScript SDK for MindStudio direct step execution",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",