@mindstudio-ai/agent 0.1.141 → 0.1.143

package/dist/cli.js

@@ -5169,9 +5169,11 @@ function logTaskResult(result) {
   if (!isDevMode()) {
     return;
   }
-  const toolSummary = result.toolCalls.map((tc) => `${tc.name} (${tc.durationMs}ms) ${tc.success ? "\u2713" : "\u2717"}`).join(", ");
+  const toolSummary = result.toolCalls.map(
+    (tc) => `${tc.name} (${tc.durationMs}ms) ${tc.success ? "\u2713" : "\u2717"}` + (tc.truncated ? " \u26A0 result cut" : "")
+  ).join(", ");
   console.log(
-    `[task] ${result.turns} turn${result.turns === 1 ? "" : "s"}` + (toolSummary ? `: ${toolSummary}` : "") + ` | ${result.parsedSuccessfully ? "output OK" : "\u26A0 output not valid JSON"} | cost: ${result.usage.totalBillingCost} | trace: ${result.traceId}`
+    `[task] ${result.turns} turn${result.turns === 1 ? "" : "s"}` + (toolSummary ? `: ${toolSummary}` : "") + (result.hitMaxTurns ? " | \u26A0 ran out of turns" : "") + (result.stopReason === "max_tokens" ? " | \u26A0 answer cut at the output limit" : "") + ` | ${result.parsedSuccessfully ? "output OK" : "\u26A0 output not valid JSON"} | cost: ${result.usage.totalBillingCost} | trace: ${result.traceId}`
   );
 }
 var init_task = __esm({
@@ -5356,9 +5358,20 @@ function mergeToolInput(modelInput, defaults) {
   }
   return merged;
 }
-function truncateToolOutput(output) {
+function truncateToolOutput(output, maxChars) {
   const serialized = JSON.stringify(output);
-  return serialized && serialized.length > MAX_TOOL_OUTPUT_CHARS ? serialized.slice(0, MAX_TOOL_OUTPUT_CHARS) + "... [truncated]" : output;
+  if (!serialized || serialized.length <= maxChars) {
+    return { output, truncated: false };
+  }
+  return {
+    output: {
+      truncated: true,
+      totalChars: serialized.length,
+      shownChars: maxChars,
+      content: serialized.slice(0, maxChars)
+    },
+    truncated: true
+  };
 }
 async function attemptTurn(httpConfig, body) {
   const url = `${httpConfig.baseUrl}/developer/v2/task/turn`;
@@ -5569,6 +5582,7 @@ ${structuredOutputExample}
     Math.max(options.maxTurns || DEFAULT_MAX_TURNS, 1),
     MAX_TURNS_LIMIT
   );
+  const maxToolOutputChars = options.maxToolOutputChars ?? MAX_TOOL_OUTPUT_CHARS;
   const traceId = randomUUID2();
   const messages = [
     { role: "user", content: JSON.stringify(options.input) }
@@ -5583,11 +5597,13 @@ ${structuredOutputExample}
     cacheReadTokens: 0,
     totalBillingCost: 0
   };
-  const buildResult = (output2, outputRaw, parsedSuccessfully2, turns) => ({
+  const buildResult = (output2, outputRaw, parsedSuccessfully2, turns, stopReason, hitMaxTurns = false) => ({
     output: output2,
     outputRaw,
     parsedSuccessfully: parsedSuccessfully2,
     turns,
+    hitMaxTurns,
+    stopReason,
     usage: totalUsage,
     toolCalls: toolCallLog,
     traceId
@@ -5645,7 +5661,7 @@ ${structuredOutputExample}
           }
         );
       }
-      return finish(buildResult(null, "", false, loopCount));
+      return finish(buildResult(null, "", false, loopCount, null));
     }
     if (err instanceof TurnError) {
       throw new MindStudioError(
@@ -5692,11 +5708,11 @@ ${structuredOutputExample}
           let result;
           if (kind === "function") {
             try {
-              const output3 = await functionTools.get(toolCall.name)(
+              const output4 = await functionTools.get(toolCall.name)(
                 mergedInput
               );
               result = {
-                output: output3 ?? null,
+                output: output4 ?? null,
                 billingCost: 0,
                 isError: false
               };
@@ -5717,29 +5733,40 @@ ${structuredOutputExample}
           } else {
             result = await deps.executeStepTool(toolCall.name, mergedInput);
           }
+          const { output: output3, truncated } = truncateToolOutput(
+            result.output,
+            maxToolOutputChars
+          );
           toolCallLog.push({
             name: toolCall.name,
             success: !result.isError,
-            durationMs: Date.now() - startTime
+            durationMs: Date.now() - startTime,
+            truncated
           });
-          return { toolCall, ...result };
+          return { toolCall, ...result, output: output3, truncated };
         })
       );
-      for (const { toolCall, output: output3, billingCost, isError } of results) {
+      for (const {
+        toolCall,
+        output: output3,
+        truncated,
+        billingCost,
+        isError
+      } of results) {
         if (billingCost) {
           totalUsage.totalBillingCost += billingCost;
         }
-        const truncated = truncateToolOutput(output3);
         messages.push({
           role: "user",
-          content: JSON.stringify(truncated),
+          content: JSON.stringify(output3),
           toolCallId: toolCall.id,
           ...isError && { isToolError: true }
         });
         onEvent?.({
           type: "tool_call_result",
           id: toolCall.id,
-          output: truncated
+          output: output3,
+          ...truncated && { truncated: true }
         });
       }
       if (isDevMode()) {
@@ -5759,11 +5786,15 @@ ${structuredOutputExample}
     }
     if (parseOk) {
       if (!outputSchema) {
-        return finish(buildResult(output2, turn.text, true, loopCount));
+        return finish(
+          buildResult(output2, turn.text, true, loopCount, turn.stopReason)
+        );
       }
       const errors = validateAgainstSchema(output2, outputSchema);
       if (errors.length === 0) {
-        return finish(buildResult(output2, turn.text, true, loopCount));
+        return finish(
+          buildResult(output2, turn.text, true, loopCount, turn.stopReason)
+        );
       }
       if (loopCount < maxTurns && schemaRepairCount < MAX_SCHEMA_REPAIR_ATTEMPTS) {
         schemaRepairCount++;
@@ -5788,13 +5819,16 @@ ${formatValidationErrors(errors)}`
         { path: "$", message: "output was not valid JSON" }
       ]);
     }
-    return finish(buildResult(turn.text, turn.text, false, loopCount));
+    return finish(
+      buildResult(turn.text, turn.text, false, loopCount, turn.stopReason)
+    );
   }
   messages.push({
     role: "user",
     content: "You have reached the maximum number of turns. Please provide your final output now as JSON."
   });
   let finalText = "";
+  let finalStopReason = null;
   try {
     const turn = await runTurnWithRetry(httpConfig, {
       model: options.model,
@@ -5805,6 +5839,7 @@ ${formatValidationErrors(errors)}`
     });
     accumulate(turn);
     finalText = turn.text;
+    finalStopReason = turn.stopReason;
   } catch (err) {
     if (err instanceof TurnError && err.phase === "model") {
       if (isDevMode()) {
@@ -5834,7 +5869,14 @@ ${formatValidationErrors(errors)}`
     }
   }
   return finish(
-    buildResult(output, finalText, parsedSuccessfully, loopCount + 1)
+    buildResult(
+      output,
+      finalText,
+      parsedSuccessfully,
+      loopCount + 1,
+      finalStopReason,
+      true
+    )
   );
 }
 var DEFAULT_MAX_TURNS, MAX_TURNS_LIMIT, MAX_SCHEMA_REPAIR_ATTEMPTS, MAX_TOOL_OUTPUT_CHARS, MAX_TURN_ATTEMPTS, INITIAL_BACKOFF_MS, STALL_TIMEOUT_MS, UNSAFE_KEYS, TurnError;
@@ -9156,7 +9198,7 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.1.141"
+            version: "0.1.143"
           },
           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.'
         });
@@ -10168,7 +10210,7 @@ function isNewerVersion(current, latest) {
   return false;
 }
 async function checkForUpdate() {
-  const currentVersion = "0.1.141";
+  const currentVersion = "0.1.143";
   if (!currentVersion || process.env.MINDSTUDIO_NO_UPDATE_CHECK) {
     return null;
   }
@@ -10203,7 +10245,7 @@ async function checkForUpdate() {
   }
 }
 function printUpdateNotice(latestVersion) {
-  const currentVersion = "0.1.141";
+  const currentVersion = "0.1.143";
   process.stderr.write(
     `
   ${ansi2.cyanBright("Update available")} ${ansi2.gray(currentVersion + " \u2192")} ${ansi2.cyanBold(latestVersion)}
@@ -10216,7 +10258,7 @@ function isStandaloneBinary() {
   return !argv1.includes("node_modules");
 }
 async function cmdUpdate() {
-  const currentVersion = "0.1.141";
+  const currentVersion = "0.1.143";
   process.stderr.write(
     `  ${ansi2.gray("Current version:")} ${currentVersion}
 `
@@ -10357,7 +10399,7 @@ async function cmdLogin(options) {
   process.stderr.write("\n");
   printLogo();
   process.stderr.write("\n");
-  const ver = "0.1.141";
+  const ver = "0.1.143";
   process.stderr.write(
     `  ${ansi2.bold("MindStudio Agent")} ${ver ? " " + ansi2.gray("v" + ver) : ""}
 `
@@ -10685,7 +10727,7 @@ async function main() {
   const updatePromise = command !== "mcp" && command !== "login" && command !== "update" ? checkForUpdate() : Promise.resolve(null);
   try {
     if (command === "version" || command === "-v") {
-      process.stdout.write("0.1.141\n");
+      process.stdout.write("0.1.143\n");
       return;
     }
     if (command === "login") {

package/dist/index.d.ts

@@ -4169,6 +4169,17 @@ interface RunTaskOptionsBase {
     model: string;
     /** Max loop iterations before forcing final output. Default 20, max 100. */
     maxTurns?: number;
+    /**
+     * How much of each tool result reaches the model, in characters of its
+     * JSON. Default 50,000. A larger result is cut to this, and the model gets
+     * a record that says so instead: `{ truncated: true, totalChars, shownChars,
+     * content }`, `content` being the beginning of the result's JSON. The call's
+     * entry in `toolCalls` is marked `truncated` too. Every result stays in the
+     * transcript, which is resent on every later turn, so raising this costs
+     * tokens on every turn after a large result, and the whole transcript has to
+     * fit the model's context window.
+     */
+    maxToolOutputChars?: number;
     /** App ID to execute within. */
     appId?: string;
     /** Thread ID for state persistence. */
@@ -4217,6 +4228,8 @@ interface TaskToolCall {
     name: string;
     success: boolean;
     durationMs: number;
+    /** The result was over `maxToolOutputChars`, so the model got only its beginning. */
+    truncated?: boolean;
 }
 /** Usage stats from a task agent execution. */
 interface TaskUsage {
@@ -4238,6 +4251,19 @@ interface RunTaskResult<T = unknown> {
     parsedSuccessfully: boolean;
     /** Number of loop iterations used. */
     turns: number;
+    /**
+     * The task used every turn in `maxTurns` and was then asked, with its
+     * tools taken away, for its final output: `output` is whatever it could
+     * say from what it had gathered by then.
+     */
+    hitMaxTurns: boolean;
+    /**
+     * Why the model stopped on the turn that produced `output`: `end_turn`, or
+     * `max_tokens` when the answer was cut at the output limit (`repetition`
+     * when the platform cut an answer that had begun repeating itself). Null
+     * when that model call failed, and `output` is empty.
+     */
+    stopReason: string | null;
     /** Token and cost usage. */
     usage: TaskUsage;
     /** Summary of every tool call made during execution. */

package/dist/index.js

@@ -4975,9 +4975,11 @@ function logTaskResult(result) {
   if (!isDevMode()) {
     return;
   }
-  const toolSummary = result.toolCalls.map((tc) => `${tc.name} (${tc.durationMs}ms) ${tc.success ? "\u2713" : "\u2717"}`).join(", ");
+  const toolSummary = result.toolCalls.map(
+    (tc) => `${tc.name} (${tc.durationMs}ms) ${tc.success ? "\u2713" : "\u2717"}` + (tc.truncated ? " \u26A0 result cut" : "")
+  ).join(", ");
   console.log(
-    `[task] ${result.turns} turn${result.turns === 1 ? "" : "s"}` + (toolSummary ? `: ${toolSummary}` : "") + ` | ${result.parsedSuccessfully ? "output OK" : "\u26A0 output not valid JSON"} | cost: ${result.usage.totalBillingCost} | trace: ${result.traceId}`
+    `[task] ${result.turns} turn${result.turns === 1 ? "" : "s"}` + (toolSummary ? `: ${toolSummary}` : "") + (result.hitMaxTurns ? " | \u26A0 ran out of turns" : "") + (result.stopReason === "max_tokens" ? " | \u26A0 answer cut at the output limit" : "") + ` | ${result.parsedSuccessfully ? "output OK" : "\u26A0 output not valid JSON"} | cost: ${result.usage.totalBillingCost} | trace: ${result.traceId}`
   );
 }
 
@@ -5155,9 +5157,20 @@ function mergeToolInput(modelInput, defaults) {
   }
   return merged;
 }
-function truncateToolOutput(output) {
+function truncateToolOutput(output, maxChars) {
   const serialized = JSON.stringify(output);
-  return serialized && serialized.length > MAX_TOOL_OUTPUT_CHARS ? serialized.slice(0, MAX_TOOL_OUTPUT_CHARS) + "... [truncated]" : output;
+  if (!serialized || serialized.length <= maxChars) {
+    return { output, truncated: false };
+  }
+  return {
+    output: {
+      truncated: true,
+      totalChars: serialized.length,
+      shownChars: maxChars,
+      content: serialized.slice(0, maxChars)
+    },
+    truncated: true
+  };
 }
 var TurnError = class extends Error {
   constructor(message, retryable, phase, status, errorCode) {
@@ -5381,6 +5394,7 @@ ${structuredOutputExample}
     Math.max(options.maxTurns || DEFAULT_MAX_TURNS, 1),
     MAX_TURNS_LIMIT
   );
+  const maxToolOutputChars = options.maxToolOutputChars ?? MAX_TOOL_OUTPUT_CHARS;
   const traceId = randomUUID2();
   const messages = [
     { role: "user", content: JSON.stringify(options.input) }
@@ -5395,11 +5409,13 @@ ${structuredOutputExample}
     cacheReadTokens: 0,
     totalBillingCost: 0
   };
-  const buildResult = (output2, outputRaw, parsedSuccessfully2, turns) => ({
+  const buildResult = (output2, outputRaw, parsedSuccessfully2, turns, stopReason, hitMaxTurns = false) => ({
     output: output2,
     outputRaw,
     parsedSuccessfully: parsedSuccessfully2,
     turns,
+    hitMaxTurns,
+    stopReason,
     usage: totalUsage,
     toolCalls: toolCallLog,
     traceId
@@ -5457,7 +5473,7 @@ ${structuredOutputExample}
           }
         );
       }
-      return finish(buildResult(null, "", false, loopCount));
+      return finish(buildResult(null, "", false, loopCount, null));
     }
     if (err instanceof TurnError) {
       throw new MindStudioError(
@@ -5504,11 +5520,11 @@ ${structuredOutputExample}
           let result;
           if (kind === "function") {
             try {
-              const output3 = await functionTools.get(toolCall.name)(
+              const output4 = await functionTools.get(toolCall.name)(
                 mergedInput
               );
               result = {
-                output: output3 ?? null,
+                output: output4 ?? null,
                 billingCost: 0,
                 isError: false
               };
@@ -5529,29 +5545,40 @@ ${structuredOutputExample}
           } else {
             result = await deps.executeStepTool(toolCall.name, mergedInput);
           }
+          const { output: output3, truncated } = truncateToolOutput(
+            result.output,
+            maxToolOutputChars
+          );
           toolCallLog.push({
             name: toolCall.name,
             success: !result.isError,
-            durationMs: Date.now() - startTime
+            durationMs: Date.now() - startTime,
+            truncated
           });
-          return { toolCall, ...result };
+          return { toolCall, ...result, output: output3, truncated };
         })
       );
-      for (const { toolCall, output: output3, billingCost, isError } of results) {
+      for (const {
+        toolCall,
+        output: output3,
+        truncated,
+        billingCost,
+        isError
+      } of results) {
         if (billingCost) {
           totalUsage.totalBillingCost += billingCost;
         }
-        const truncated = truncateToolOutput(output3);
         messages.push({
           role: "user",
-          content: JSON.stringify(truncated),
+          content: JSON.stringify(output3),
           toolCallId: toolCall.id,
           ...isError && { isToolError: true }
         });
         onEvent?.({
           type: "tool_call_result",
           id: toolCall.id,
-          output: truncated
+          output: output3,
+          ...truncated && { truncated: true }
         });
       }
       if (isDevMode()) {
@@ -5571,11 +5598,15 @@ ${structuredOutputExample}
     }
     if (parseOk) {
       if (!outputSchema) {
-        return finish(buildResult(output2, turn.text, true, loopCount));
+        return finish(
+          buildResult(output2, turn.text, true, loopCount, turn.stopReason)
+        );
       }
       const errors = validateAgainstSchema(output2, outputSchema);
       if (errors.length === 0) {
-        return finish(buildResult(output2, turn.text, true, loopCount));
+        return finish(
+          buildResult(output2, turn.text, true, loopCount, turn.stopReason)
+        );
       }
       if (loopCount < maxTurns && schemaRepairCount < MAX_SCHEMA_REPAIR_ATTEMPTS) {
         schemaRepairCount++;
@@ -5600,13 +5631,16 @@ ${formatValidationErrors(errors)}`
         { path: "$", message: "output was not valid JSON" }
       ]);
     }
-    return finish(buildResult(turn.text, turn.text, false, loopCount));
+    return finish(
+      buildResult(turn.text, turn.text, false, loopCount, turn.stopReason)
+    );
   }
   messages.push({
     role: "user",
     content: "You have reached the maximum number of turns. Please provide your final output now as JSON."
   });
   let finalText = "";
+  let finalStopReason = null;
   try {
     const turn = await runTurnWithRetry(httpConfig, {
       model: options.model,
@@ -5617,6 +5651,7 @@ ${formatValidationErrors(errors)}`
     });
     accumulate(turn);
     finalText = turn.text;
+    finalStopReason = turn.stopReason;
   } catch (err) {
     if (err instanceof TurnError && err.phase === "model") {
       if (isDevMode()) {
@@ -5646,7 +5681,14 @@ ${formatValidationErrors(errors)}`
     }
   }
   return finish(
-    buildResult(output, finalText, parsedSuccessfully, loopCount + 1)
+    buildResult(
+      output,
+      finalText,
+      parsedSuccessfully,
+      loopCount + 1,
+      finalStopReason,
+      true
+    )
   );
 }