@midscene/core 1.0.1-beta-20251209112631.0 → 1.0.1-beta-20251211124955.0

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

@@ -23,13 +23,16 @@ 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;
     /**
      * Frozen page context for consistent AI operations
      */
     private frozenUIContext?;
+    private get aiActContext();
     /**
      * Flag to track if VL model warning has been shown
      */
@@ -57,7 +60,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;
@@ -139,6 +146,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;

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

@@ -46,7 +46,7 @@ export declare class TaskExecutor {
         runner: TaskRunner;
     }>;
     runPlans(title: string, plans: PlanningAction[], modelConfigForPlanning: IModelConfig, modelConfigForDefaultIntent: IModelConfig): Promise<ExecutionResult>;
-    action(userPrompt: string, modelConfigForPlanning: IModelConfig, modelConfigForDefaultIntent: IModelConfig, includeBboxInPlanning: boolean, backgroundKnowledge?: string, cacheable?: boolean, replanningCycleLimitOverride?: number, imagesIncludeCount?: number): Promise<ExecutionResult<{
+    action(userPrompt: string, modelConfigForPlanning: IModelConfig, modelConfigForDefaultIntent: IModelConfig, includeBboxInPlanning: boolean, aiActContext?: string, cacheable?: boolean, replanningCycleLimitOverride?: number, imagesIncludeCount?: number): Promise<ExecutionResult<{
         yamlFlow?: MidsceneYamlFlowItem[];
     } | undefined>>;
     private createTypeQueryTask;

package/dist/types/types.d.ts

@@ -274,7 +274,7 @@ export interface ExecutionDump extends DumpMeta {
     name: string;
     description?: string;
     tasks: ExecutionTask[];
-    aiActionContext?: string;
+    aiActContext?: string;
 }
 export type ExecutionTaskInsightLocateParam = PlanningLocateParam;
 export interface ExecutionTaskInsightLocateOutput {
@@ -304,7 +304,7 @@ export type ExecutionTaskLogApply<LogParam = {
 export type ExecutionTaskLog = ExecutionTask<ExecutionTaskLogApply>;
 export type ExecutionTaskPlanningApply = ExecutionTaskApply<'Planning', {
     userInstruction: string;
-    aiActionContext?: string;
+    aiActContext?: string;
 }, PlanningAIResponse>;
 export type ExecutionTaskPlanning = ExecutionTask<ExecutionTaskPlanningApply>;
 export type ExecutionTaskPlanningLocateParam = PlanningLocateParam;
@@ -399,6 +399,7 @@ export interface AgentOpt {
     generateReport?: boolean;
     autoPrintReportMsg?: boolean;
     onTaskStartTip?: OnTaskStartTip;
+    aiActContext?: string;
     aiActionContext?: string;
     reportFileName?: string;
     modelConfig?: TModelConfig;

package/dist/types/yaml.d.ts

@@ -67,7 +67,7 @@ export interface MidsceneYamlTask {
  *     strategy: "read-write"
  * ```
  */
-export type MidsceneYamlScriptAgentOpt = Pick<AgentOpt, 'testId' | 'groupName' | 'groupDescription' | 'generateReport' | 'autoPrintReportMsg' | 'reportFileName' | 'replanningCycleLimit' | 'aiActionContext' | 'cache'>;
+export type MidsceneYamlScriptAgentOpt = Pick<AgentOpt, 'testId' | 'groupName' | 'groupDescription' | 'generateReport' | 'autoPrintReportMsg' | 'reportFileName' | 'replanningCycleLimit' | 'aiActContext' | 'aiActionContext' | 'cache'>;
 export interface MidsceneYamlScriptConfig {
     output?: string;
     unstableLogContent?: boolean | string;

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-20251209112631.0",
+  "version": "1.0.1-beta-20251211124955.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-20251209112631.0"
+    "@midscene/shared": "1.0.1-beta-20251211124955.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.18.3",