@mindstudio-ai/agent 0.1.144 → 0.1.146

package/dist/index.d.ts

@@ -303,6 +303,13 @@ interface StepLogEvent {
     tag: string;
     /** Unix timestamp in milliseconds. */
     ts: number;
+    /**
+     * A passing status the next one replaces (how far a render or a model's
+     * queue is), rather than a line worth keeping.
+     */
+    ephemeral?: boolean;
+    /** How far the action is, 0 to 1, on a passing status, when it knows. */
+    progress?: number;
 }
 /** Options for a single step execution call. */
 interface StepExecutionOptions {
@@ -325,7 +332,9 @@ interface StepExecutionOptions {
      *
      * Log content and frequency varies by step type — image generation emits
      * 2-3 logs, scrape steps emit per-URL progress, LLM steps may emit model
-     * selection and token info.
+     * selection and token info. A passing status is flagged `ephemeral`, and
+     * carries `progress` (0 to 1) when the action knows how far it is: a
+     * render's or a media job's.
      */
     onLog?: (event: StepLogEvent) => void;
     /**
@@ -10860,6 +10869,9 @@ interface StepMethods {
     /**
      * Resize a video file
      *
+     * @remarks
+     * - `mode` is required: `fit` scales the video down to fit within `maxWidth` x `maxHeight`, keeping its shape (a video already inside them is left that size); `exact` makes it `width` x `height`, padding (`strategy: 'pad'`, the default) or cropping (`'crop'`) where the shapes differ
+     *
      * @example
      * ```typescript
      * const result = await agent.resizeVideo({

package/dist/index.js

@@ -4863,7 +4863,7 @@ var stepMetadata = {
   "resizeVideo": {
     stepType: "resizeVideo",
     description: "Resize a video file",
-    usageNotes: "",
+    usageNotes: "- `mode` is required: `fit` scales the video down to fit within `maxWidth` x `maxHeight`, keeping its shape (a video already inside them is left that size); `exact` makes it `width` x `height`, padding (`strategy: 'pad'`, the default) or cropping (`'crop'`) where the shapes differ",
     inputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the source video to resize" }, "mode": { "enum": ["fit", "exact"], "type": "string", "description": "Resize mode: 'fit' scales within max dimensions, 'exact' forces exact dimensions" }, "maxWidth": { "type": "number", "description": "Maximum width in pixels (used with 'fit' mode)" }, "maxHeight": { "type": "number", "description": "Maximum height in pixels (used with 'fit' mode)" }, "width": { "type": "number", "description": "Exact width in pixels (used with 'exact' mode)" }, "height": { "type": "number", "description": "Exact height in pixels (used with 'exact' mode)" }, "strategy": { "enum": ["pad", "crop"], "type": "string", "description": "Strategy for handling aspect ratio mismatch in 'exact' mode" }, "intermediateAsset": { "type": "boolean", "description": "When true, the asset is created but hidden from the user's gallery (tagged as intermediate)" } }, "required": ["videoUrl", "mode"] },
     outputSchema: { "type": "object", "properties": { "videoUrl": { "type": "string", "description": "URL of the resized video" } }, "required": ["videoUrl"] }
   },
@@ -6478,6 +6478,13 @@ function applyStepMethods(AgentClass) {
 // src/client.ts
 var DEFAULT_BASE_URL = "https://v1.mindstudio-api.com";
 var DEFAULT_MAX_RETRIES = 3;
+var toStepLogEvent = (event) => ({
+  value: event.value,
+  tag: event.tag,
+  ts: event.ts,
+  ...event.ephemeral === true ? { ephemeral: true } : {},
+  ...typeof event.progress === "number" ? { progress: event.progress } : {}
+});
 var MindStudioAgent = class {
   /** @internal */
   _httpConfig;
@@ -6791,11 +6798,7 @@ var MindStudioAgent = class {
           try {
             const event = JSON.parse(line.slice(6));
             if (event.type === "log") {
-              options.onLog({
-                value: event.value,
-                tag: event.tag,
-                ts: event.ts
-              });
+              options.onLog(toStepLogEvent(event));
             } else if (event.type === "done") {
               doneEvent = {
                 output: event.output,
@@ -6834,11 +6837,7 @@ var MindStudioAgent = class {
               500
             );
           } else if (event.type === "log") {
-            options.onLog({
-              value: event.value,
-              tag: event.tag,
-              ts: event.ts
-            });
+            options.onLog(toStepLogEvent(event));
           }
         } catch (err) {
           if (err instanceof MindStudioError) {