@midscene/core 1.0.1-beta-20251209024153.0 → 1.0.1-beta-20251211095502.0

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

@@ -5,6 +5,10 @@ import type { TaskRunner } from '../task-runner';
 import { ModelConfigManager } from '@midscene/shared/env';
 import { TaskCache } from './task-cache';
 import { TaskExecutor } from './tasks';
+type AiActOptions = {
+    cacheable?: boolean;
+    planningStrategy?: 'fast' | 'standard' | 'max';
+};
 export declare class Agent<InterfaceType extends AbstractInterface = AbstractInterface> {
     interface: InterfaceType;
     service: Service;
@@ -19,7 +23,9 @@ export declare class Agent<InterfaceType extends AbstractInterface = AbstractInt
     dryMode: boolean;
     onTaskStartTip?: OnTaskStartTip;
     taskCache?: TaskCache;
-    onDumpUpdate?: (dump: string) => void;
+    private dumpUpdateListeners;
+    get onDumpUpdate(): ((dump: string, executionDump?: ExecutionDump) => void) | undefined;
+    set onDumpUpdate(callback: ((dump: string, executionDump?: ExecutionDump) => void) | undefined);
     destroyed: boolean;
     modelConfigManager: ModelConfigManager;
     /**
@@ -53,7 +59,11 @@ export declare class Agent<InterfaceType extends AbstractInterface = AbstractInt
     getActionSpace(): Promise<DeviceAction[]>;
     getUIContext(action?: ServiceAction): Promise<UIContext>;
     _snapshotContext(): Promise<UIContext>;
+    /**
+     * @deprecated Use {@link setAIActContext} instead.
+     */
     setAIActionContext(prompt: string): Promise<void>;
+    setAIActContext(prompt: string): Promise<void>;
     resetDump(): GroupedActionDump;
     appendExecutionDump(execution: ExecutionDump, runner?: TaskRunner): void;
     dumpDataString(): string;
@@ -93,10 +103,7 @@ export declare class Agent<InterfaceType extends AbstractInterface = AbstractInt
      * @deprecated Use aiScroll(locatePrompt, opt) instead where opt contains the scroll parameters
      */
     aiScroll(scrollParam: ScrollParam, locatePrompt?: TUserPrompt, opt?: LocateOption): Promise<any>;
-    aiAct(taskPrompt: string, opt?: {
-        cacheable?: boolean;
-        planningStrategy?: 'fast' | 'standard' | 'max';
-    }): Promise<{
+    aiAct(taskPrompt: string, opt?: AiActOptions): Promise<{
         result: Record<string, any>;
     } | {
         yamlFlow?: import("../yaml").MidsceneYamlFlowItem[];
@@ -104,9 +111,7 @@ export declare class Agent<InterfaceType extends AbstractInterface = AbstractInt
     /**
      * @deprecated Use {@link Agent.aiAct} instead.
      */
-    aiAction(taskPrompt: string, opt?: {
-        cacheable?: boolean;
-    }): Promise<{
+    aiAction(taskPrompt: string, opt?: AiActOptions): Promise<{
         result: Record<string, any>;
     } | {
         yamlFlow?: import("../yaml").MidsceneYamlFlowItem[];
@@ -140,6 +145,21 @@ export declare class Agent<InterfaceType extends AbstractInterface = AbstractInt
         result: Record<string, any>;
     }>;
     evaluateJavaScript(script: string): Promise<any>;
+    /**
+     * Add a dump update listener
+     * @param listener Listener function
+     * @returns A remove function that can be called to remove this listener
+     */
+    addDumpUpdateListener(listener: (dump: string, executionDump?: ExecutionDump) => void): () => void;
+    /**
+     * Remove a dump update listener
+     * @param listener The listener function to remove
+     */
+    removeDumpUpdateListener(listener: (dump: string, executionDump?: ExecutionDump) => void): void;
+    /**
+     * Clear all dump update listeners
+     */
+    clearDumpUpdateListeners(): void;
     destroy(): Promise<void>;
     recordToReport(title?: string, opt?: {
         content: string;
@@ -178,3 +198,4 @@ export declare class Agent<InterfaceType extends AbstractInterface = AbstractInt
     }): Promise<void>;
 }
 export declare const createAgent: (interfaceInstance: AbstractInterface, opts?: AgentOpt) => Agent<AbstractInterface>;
+export {};

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.0.1-beta-20251209024153.0",
+  "version": "1.0.1-beta-20251211095502.0",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "main": "./dist/lib/index.js",
@@ -89,7 +89,7 @@
     "semver": "7.5.2",
     "js-yaml": "4.1.0",
     "zod": "3.24.3",
-    "@midscene/shared": "1.0.1-beta-20251209024153.0"
+    "@midscene/shared": "1.0.1-beta-20251211095502.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",