@mindstudio-ai/agent 0.1.16 → 0.1.18

package/dist/index.d.ts

@@ -7562,6 +7562,14 @@ interface StepMethods {
      * - Source "system" echoes the message content directly (no AI call).
      * - Mode "background" saves the result to a variable. Mode "foreground" streams it to the user (not available in direct execution).
      * - Structured output (JSON/CSV) can be enforced via structuredOutputType and structuredOutputExample.
+     * - When executed inside a v2 app method (managed sandbox or local dev tunnel),
+     * LLM token output can be streamed to the frontend in real time via an SSE
+     * side-channel. The frontend opts in by passing { stream: true } to the method
+     * invocation via @mindstudio-ai/interface. Tokens are published to Redis
+     * pub/sub as they arrive and forwarded as SSE events on the invoke response.
+     * The method code itself is unchanged — streaming is transparent to the
+     * developer. See V2ExecutionService.ts and the invoke handler in V2Apps for
+     * the server-side plumbing.
      *
      * @example
      * ```typescript

package/dist/index.js

@@ -3152,7 +3152,15 @@ var stepMetadata = {
     usageNotes: `- Source "user" sends the message to an LLM and returns the model's response.
 - Source "system" echoes the message content directly (no AI call).
 - Mode "background" saves the result to a variable. Mode "foreground" streams it to the user (not available in direct execution).
-- Structured output (JSON/CSV) can be enforced via structuredOutputType and structuredOutputExample.`,
+- Structured output (JSON/CSV) can be enforced via structuredOutputType and structuredOutputExample.
+- When executed inside a v2 app method (managed sandbox or local dev tunnel),
+  LLM token output can be streamed to the frontend in real time via an SSE
+  side-channel. The frontend opts in by passing { stream: true } to the method
+  invocation via @mindstudio-ai/interface. Tokens are published to Redis
+  pub/sub as they arrive and forwarded as SSE events on the invoke response.
+  The method code itself is unchanged \u2014 streaming is transparent to the
+  developer. See V2ExecutionService.ts and the invoke handler in V2Apps for
+  the server-side plumbing.`,
     inputSchema: { "type": "object", "properties": { "message": { "type": "string", "description": "The message to send (prompt for AI, or text for system echo)" }, "source": { "enum": ["user", "system"], "type": "string", "description": 'Message source: "user" sends to AI model, "system" echoes message content directly. Defaults to "user"' }, "modelOverride": { "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", "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"], "description": "Model configuration override. Optional; uses the workflow's default model if not specified" }, "structuredOutputType": { "enum": ["text", "json", "csv"], "type": "string", "description": "Output format constraint for structured responses" }, "structuredOutputExample": { "type": "string", "description": "Sample showing the desired output shape (for JSON/CSV formats). A TypeScript interface is also useful here for more complex types." }, "chatHistoryMode": { "enum": ["include", "exclude"], "type": "string", "description": "Whether to include or exclude prior chat history in the AI context" } }, "required": ["message"], "description": "Configuration for the user message step" },
     outputSchema: { "type": "object", "properties": { "content": { "type": "string", "description": "The AI model's response or echoed system message content" } }, "required": ["content"] }
   },
@@ -3868,7 +3876,15 @@ var stepMetadata = {
     usageNotes: `- Source "user" sends the message to an LLM and returns the model's response.
 - Source "system" echoes the message content directly (no AI call).
 - Mode "background" saves the result to a variable. Mode "foreground" streams it to the user (not available in direct execution).
-- Structured output (JSON/CSV) can be enforced via structuredOutputType and structuredOutputExample.`,
+- Structured output (JSON/CSV) can be enforced via structuredOutputType and structuredOutputExample.
+- When executed inside a v2 app method (managed sandbox or local dev tunnel),
+  LLM token output can be streamed to the frontend in real time via an SSE
+  side-channel. The frontend opts in by passing { stream: true } to the method
+  invocation via @mindstudio-ai/interface. Tokens are published to Redis
+  pub/sub as they arrive and forwarded as SSE events on the invoke response.
+  The method code itself is unchanged \u2014 streaming is transparent to the
+  developer. See V2ExecutionService.ts and the invoke handler in V2Apps for
+  the server-side plumbing.`,
     inputSchema: { "type": "object", "properties": { "message": { "type": "string", "description": "The message to send (prompt for AI, or text for system echo)" }, "source": { "enum": ["user", "system"], "type": "string", "description": 'Message source: "user" sends to AI model, "system" echoes message content directly. Defaults to "user"' }, "modelOverride": { "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", "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"], "description": "Model configuration override. Optional; uses the workflow's default model if not specified" }, "structuredOutputType": { "enum": ["text", "json", "csv"], "type": "string", "description": "Output format constraint for structured responses" }, "structuredOutputExample": { "type": "string", "description": "Sample showing the desired output shape (for JSON/CSV formats). A TypeScript interface is also useful here for more complex types." }, "chatHistoryMode": { "enum": ["include", "exclude"], "type": "string", "description": "Whether to include or exclude prior chat history in the AI context" } }, "required": ["message"], "description": "Configuration for the user message step" },
     outputSchema: { "type": "object", "properties": { "content": { "type": "string", "description": "The AI model's response or echoed system message content" } }, "required": ["content"] }
   },