@mindstudio-ai/agent 0.1.78 → 0.1.80

package/dist/index.d.ts

@@ -1431,6 +1431,9 @@ declare class MindStudioAgent$1 {
     private _db;
     /** @internal Auth type — 'internal' for CALLBACK_TOKEN (managed mode), 'apiKey' otherwise. */
     private _authType;
+    /** @internal Usage source sent on step executions (from MINDSTUDIO_REQUEST_SOURCE).
+     *  Only set for api-key (CLI) auth so in-app/managed runtime is unaffected. */
+    private _requestSource;
     /**
      * @internal Resolve the current auth token. Checks ALS request context
      * first, then CALLBACK_TOKEN env var, then static config token.
@@ -1979,8 +1982,10 @@ interface AirtableGetTableRecordsStepOutput {
 interface AnalyzeImageStepInput {
     /** Instructions describing what to look for or extract from the image */
     prompt: string;
-    /** URL of the image to analyze */
-    imageUrl: string;
+    /** URL of a single image to analyze. Kept for backward compatibility; prefer imageUrls. */
+    imageUrl?: string;
+    /** One or more image URLs to analyze together in a single model request */
+    imageUrls?: string[];
     /** Optional model configuration override. Uses the workflow's default vision model if not specified */
     visionModelOverride?: {
         model: string;
@@ -6043,12 +6048,13 @@ interface StepMethods {
      * @remarks
      * - Uses the configured vision model to generate a text analysis of the image.
      * - The prompt should describe what to look for or extract from the image.
+     * - Pass imageUrl for a single image, or imageUrls for multiple images analyzed together in one request.
+     * - Most vision models (OpenAI, Grok, Gemini) accept multiple images in one request. Ideogram describe is single-image only.
      *
      * @example
      * ```typescript
      * const result = await agent.analyzeImage({
      *   prompt: ``,
-     *   imageUrl: ``,
      * });
      * ```
      */

package/dist/index.js

@@ -1978,8 +1978,8 @@ var stepMetadata = {
   "analyzeImage": {
     stepType: "analyzeImage",
     description: "Analyze an image using a vision model based on a text prompt.",
-    usageNotes: "- Uses the configured vision model to generate a text analysis of the image.\n- The prompt should describe what to look for or extract from the image.",
-    inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Instructions describing what to look for or extract from the image" }, "imageUrl": { "type": "string", "description": "URL of the image to analyze" }, "visionModelOverride": { "anyOf": [{ "type": "object", "properties": { "model": { "type": "string" }, "config": { "type": "object", "properties": {}, "required": [] } }, "required": ["model"] }, { "type": "object", "properties": { "model": { "type": "string", "description": 'Model identifier (e.g. "gpt-4", "claude-3-opus")' }, "temperature": { "type": "number", "description": "Sampling temperature for the model (0-2)" }, "maxResponseTokens": { "type": "number", "description": "Maximum number of tokens in the model's response" }, "ignorePreamble": { "type": "boolean", "description": "Whether to skip the system preamble/instructions" }, "userMessagePreprocessor": { "type": "object", "properties": { "dataSource": { "type": "string", "description": "Data source identifier for the preprocessor" }, "messageTemplate": { "type": "string", "description": "Template string applied to user messages before sending to the model" }, "maxResults": { "type": "number", "description": "Maximum number of results to include from the data source" }, "enabled": { "type": "boolean", "description": "Whether the preprocessor is active" }, "shouldInherit": { "type": "boolean", "description": "Whether child steps should inherit this preprocessor configuration" } }, "description": "Preprocessor applied to user messages before sending to the model" }, "preamble": { "type": "string", "description": "System preamble/instructions for the model" }, "multiModelEnabled": { "type": "boolean", "description": "Whether multi-model candidate generation is enabled" }, "editResponseEnabled": { "type": "boolean", "description": "Whether the user can edit the model's response" }, "config": { "type": "object", "properties": {}, "required": [], "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"] }] } }, "required": ["prompt", "imageUrl"] },
+    usageNotes: "- Uses the configured vision model to generate a text analysis of the image.\n- The prompt should describe what to look for or extract from the image.\n- Pass imageUrl for a single image, or imageUrls for multiple images analyzed together in one request.\n- Most vision models (OpenAI, Grok, Gemini) accept multiple images in one request. Ideogram describe is single-image only.",
+    inputSchema: { "type": "object", "properties": { "prompt": { "type": "string", "description": "Instructions describing what to look for or extract from the image" }, "imageUrl": { "type": "string", "description": "URL of a single image to analyze. Kept for backward compatibility; prefer imageUrls." }, "imageUrls": { "type": "array", "items": { "type": "string" }, "description": "One or more image URLs to analyze together in a single model request" }, "visionModelOverride": { "anyOf": [{ "type": "object", "properties": { "model": { "type": "string" }, "config": { "type": "object", "properties": {}, "required": [] } }, "required": ["model"] }, { "type": "object", "properties": { "model": { "type": "string", "description": 'Model identifier (e.g. "gpt-4", "claude-3-opus")' }, "temperature": { "type": "number", "description": "Sampling temperature for the model (0-2)" }, "maxResponseTokens": { "type": "number", "description": "Maximum number of tokens in the model's response" }, "ignorePreamble": { "type": "boolean", "description": "Whether to skip the system preamble/instructions" }, "userMessagePreprocessor": { "type": "object", "properties": { "dataSource": { "type": "string", "description": "Data source identifier for the preprocessor" }, "messageTemplate": { "type": "string", "description": "Template string applied to user messages before sending to the model" }, "maxResults": { "type": "number", "description": "Maximum number of results to include from the data source" }, "enabled": { "type": "boolean", "description": "Whether the preprocessor is active" }, "shouldInherit": { "type": "boolean", "description": "Whether child steps should inherit this preprocessor configuration" } }, "description": "Preprocessor applied to user messages before sending to the model" }, "preamble": { "type": "string", "description": "System preamble/instructions for the model" }, "multiModelEnabled": { "type": "boolean", "description": "Whether multi-model candidate generation is enabled" }, "editResponseEnabled": { "type": "boolean", "description": "Whether the user can edit the model's response" }, "config": { "type": "object", "properties": {}, "required": [], "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"] }] } }, "required": ["prompt"] },
     outputSchema: { "type": "object", "properties": { "analysis": { "type": "string", "description": "Text analysis of the image generated by the vision model" } }, "required": ["analysis"] }
   },
   "analyzeVideo": {
@@ -3928,6 +3928,9 @@ var MindStudioAgent = class {
   _db;
   /** @internal Auth type — 'internal' for CALLBACK_TOKEN (managed mode), 'apiKey' otherwise. */
   _authType;
+  /** @internal Usage source sent on step executions (from MINDSTUDIO_REQUEST_SOURCE).
+   *  Only set for api-key (CLI) auth so in-app/managed runtime is unaffected. */
+  _requestSource;
   /**
    * @internal Resolve the current auth token. Checks ALS request context
    * first, then CALLBACK_TOKEN env var, then static config token.
@@ -3983,6 +3986,7 @@ var MindStudioAgent = class {
     this._reuseThreadId = options.reuseThreadId ?? /^(true|1)$/i.test(process.env.MINDSTUDIO_REUSE_THREAD_ID ?? "");
     this._appId = options.appId ?? process.env.MINDSTUDIO_APP_ID ?? void 0;
     this._authType = authType;
+    this._requestSource = authType === "apiKey" ? process.env.MINDSTUDIO_REQUEST_SOURCE || void 0 : void 0;
     this._httpConfig = {
       baseUrl,
       token,
@@ -4016,7 +4020,8 @@ var MindStudioAgent = class {
       step,
       ...options?.appId != null && { appId: options.appId },
       ...threadId != null && { threadId },
-      ...this._currentStreamId != null && { streamId: this._currentStreamId }
+      ...this._currentStreamId != null && { streamId: this._currentStreamId },
+      ...this._requestSource != null && { requestSource: this._requestSource }
     });
     const remaining = headers.get("x-ratelimit-remaining");
     const returnedThreadId = asyncData.threadId ?? "";
@@ -4099,7 +4104,8 @@ var MindStudioAgent = class {
       step,
       ...options.appId != null && { appId: options.appId },
       ...threadId != null && { threadId },
-      ...this._currentStreamId != null && { streamId: this._currentStreamId }
+      ...this._currentStreamId != null && { streamId: this._currentStreamId },
+      ...this._requestSource != null && { requestSource: this._requestSource }
     };
     await this._httpConfig.rateLimiter.acquire();
     let res;
@@ -4285,7 +4291,8 @@ var MindStudioAgent = class {
         stepType: resolveStepType2(s.stepType)
       })),
       ...options?.appId != null && { appId: options.appId },
-      ...threadId != null && { threadId }
+      ...threadId != null && { threadId },
+      ...this._requestSource != null && { requestSource: this._requestSource }
     });
     const pollUrl = `${this._currentHttpConfig.baseUrl}/developer/v2/steps/execute-batch-async/poll/${asyncData.batchToken}`;
     let pollDelay = 300;
@@ -5212,7 +5219,7 @@ var monacoSnippets = {
   "airtableDeleteRecord": { fields: [["baseId", "string"], ["tableId", "string"], ["recordId", "string"]], outputKeys: ["deleted"] },
   "airtableGetRecord": { fields: [["baseId", "string"], ["tableId", "string"], ["recordId", "string"]], outputKeys: ["record"] },
   "airtableGetTableRecords": { fields: [["baseId", "string"], ["tableId", "string"]], outputKeys: ["records"] },
-  "analyzeImage": { fields: [["prompt", "string"], ["imageUrl", "string"]], outputKeys: ["analysis"] },
+  "analyzeImage": { fields: [["prompt", "string"]], outputKeys: ["analysis"] },
   "analyzeVideo": { fields: [["prompt", "string"], ["videoUrl", "string"]], outputKeys: ["analysis"] },
   "captureThumbnail": { fields: [["videoUrl", "string"], ["at", "string"]], outputKeys: ["thumbnailUrl"] },
   "checkAppRole": { fields: [["roleName", "string"]], outputKeys: ["hasRole", "userRoles"] },