@midscene/core 1.9.7 → 1.9.8-beta-20260618091332.0

package/dist/types/agent/agent.d.ts

@@ -1,6 +1,6 @@
 import type { TUserPrompt } from '../ai-model/index';
 import Service from '../service/index';
-import { type ActionParam, type ActionReturn, type AgentAssertOpt, type AgentDescribeElementAtPointResult, type AgentOpt, type AgentWaitForOpt, type DeepThinkOption, type DeviceAction, ExecutionDump, type LocateOption, type LocateResultElement, type LocateValidatorResult, type LocatorValidatorOption, type OnTaskStartTip, ReportActionDump, type ScrollParam, type ServiceAction, type ServiceExtractOption, type ServiceExtractParam, type Size, type UIContext } from '../types';
+import { type ActionParam, type ActionReturn, type AgentAssertOpt, type AgentDescribeElementAtPointResult, type AgentOpt, type AgentWaitForOpt, type DeepThinkOption, type DeviceAction, ExecutionDump, type LocateOption, type LocateResultElement, type LocateValidatorResult, type LocatorValidatorOption, type OnTaskStartTip, type RecordToReportOptions, ReportActionDump, type ScrollParam, type ServiceAction, type ServiceExtractOption, type ServiceExtractParam, type Size, type UIContext } from '../types';
 import type { AbstractInterface } from '../device';
 import type { TaskRunner } from '../task-runner';
 import { ModelConfigManager } from '@midscene/shared/env';
@@ -200,10 +200,7 @@ export declare class Agent<InterfaceType extends AbstractInterface = AbstractInt
     clearDumpUpdateListeners(): void;
     private notifyDumpUpdateListeners;
     destroy(): Promise<void>;
-    recordToReport(title?: string, opt?: {
-        content?: string;
-        screenshotBase64?: string;
-    }): Promise<void>;
+    recordToReport(title?: string, opt?: RecordToReportOptions): Promise<void>;
     recordErrorToReport(title: string, opt: {
         error: Error;
         content?: string;

package/dist/types/agent/index.d.ts

@@ -6,4 +6,5 @@ export { type LocateCache, type PlanningCache, TaskCache } from './task-cache';
 export { cacheFileExt } from './task-cache';
 export { TaskExecutor } from './tasks';
 export type { AgentOpt } from '../types';
+export type { RecordToReportOptions, RecordToReportScreenshot } from '../types';
 export type { AiActOptions, DescribeElementAtPointOptions, DescribeElementCoordinateSpace, } from './agent';

package/dist/types/agent/record-to-report.d.ts

@@ -0,0 +1,2 @@
+import type { RecordToReportScreenshot } from '../types';
+export declare function normalizeRecordToReportScreenshot(screenshot: RecordToReportScreenshot, index: number): RecordToReportScreenshot;

package/dist/types/agent/utils.d.ts

@@ -1,7 +1,8 @@
 import type { TMultimodalPrompt, TUserPrompt } from '../common';
 import type { AbstractInterface } from '../device';
-import type { ElementCacheFeature, LocateResultElement, PixelBbox, PlanningLocateParam, PlanningLocateParamWithLocatedPixelBbox, Rect, Size, UIContext } from '../types';
+import type { ElementCacheFeature, LocateResultElement, PixelBbox, PlanningLocateParam, PlanningLocateParamWithLocatedPixelBbox, Rect, ScrollParam, Size, UIContext } from '../types';
 import type { TaskCache } from './task-cache';
+export declare const normalizeScrollType: (scrollType: string | undefined) => ScrollParam["scrollType"] | undefined;
 export declare function commonContextParser(interfaceInstance: AbstractInterface, _opt: {
     uploadServerUrl?: string;
     screenshotShrinkFactor?: number;

package/dist/types/index.d.ts

@@ -10,7 +10,7 @@ export { z };
 export default Service;
 export { TaskRunner, Service, getVersion };
 export type { MidsceneYamlScript, MidsceneYamlTask, MidsceneYamlFlowItem, MidsceneYamlConfigResult, MidsceneYamlConfig, MidsceneYamlScriptWebEnv, MidsceneYamlScriptAndroidEnv, MidsceneYamlScriptIOSEnv, MidsceneYamlScriptEnv, LocateOption, DetailedLocateParam, } from './yaml';
-export { Agent, type AgentOpt, type AiActOptions, createAgent } from './agent';
+export { Agent, type AgentOpt, type AiActOptions, createAgent, } from './agent';
 export { restoreImageReferences, escapeContent, unescapeContent, parseImageScripts, parseDumpScript, parseDumpScriptAttributes, generateImageScriptTag, generateDumpScriptTag, } from './dump';
 export { getTaskSearchArea, getTaskServiceDump, } from './dump/task-service-dump';
 export type { IReportGenerator } from './report-generator';

package/dist/types/types.d.ts

@@ -291,8 +291,27 @@ export interface ExecutionRecorderItem {
     type: 'screenshot';
     ts: number;
     screenshot?: ScreenshotItem;
+    description?: string;
     timing?: string;
 }
+export interface RecordToReportScreenshot {
+    /**
+     * PNG/JPEG data URI, or raw PNG base64 body.
+     */
+    base64: string;
+    description?: string;
+}
+export interface RecordToReportOptions {
+    content?: string;
+    /**
+     * @deprecated Use `screenshots: [{ base64 }]` instead.
+     */
+    screenshotBase64?: string;
+    /**
+     * Custom screenshots to display under a single report entry.
+     */
+    screenshots?: RecordToReportScreenshot[];
+}
 export type ExecutionTaskType = 'Planning' | 'Insight' | 'Action Space' | 'Log';
 export interface ExecutorContext {
     task: ExecutionTask;

package/dist/types/yaml.d.ts

@@ -109,6 +109,19 @@ export interface MidsceneYamlScriptWebEnv extends MidsceneYamlScriptConfig, Mids
      */
     extraHTTPHeaders?: Record<string, string>;
     forceSameTabNavigation?: boolean;
+    /**
+     * Chrome download directory (Puppeteer only, not supported in bridge mode).
+     *
+     * Relative paths are resolved from the current working directory.
+     *
+     * @example
+     * ```yaml
+     * web:
+     *   url: https://example.com
+     *   downloadPath: ./downloads
+     * ```
+     */
+    downloadPath?: string;
     /**
      * Custom Chrome launch arguments (Puppeteer only, not supported in bridge mode).
      *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@midscene/core",
   "description": "Automate browser actions, extract data, and perform assertions using AI. It offers JavaScript SDK, Chrome extension, and support for scripting in YAML. See https://midscenejs.com/ for details.",
-  "version": "1.9.7",
+  "version": "1.9.8-beta-20260618091332.0",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "main": "./dist/lib/index.js",
@@ -107,7 +107,7 @@
     "semver": "7.5.2",
     "undici": "^6.0.0",
     "zod": "^3.25.1",
-    "@midscene/shared": "1.9.7"
+    "@midscene/shared": "1.9.8-beta-20260618091332.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",