@aiscene/core 9.0.0 → 9.0.2

package/dist/types/ai-model/prompt/util.d.ts

@@ -1,4 +1,4 @@
-import type { SubGoal } from '../../types';
+import type { AIMemory, SubGoal } from '../../types';
 /**
  * Extract content from an XML tag in a string, searching from the end.
  * This approach handles cases where models prepend thinking content (like <think>...</think>)
@@ -23,6 +23,9 @@ export declare function parseSubGoalsFromXML(xmlContent: string): SubGoal[];
  * Extract indexes of sub-goals marked as finished from <mark-sub-goal-done> content
  */
 export declare function parseMarkFinishedIndexes(xmlContent: string): number[];
+export declare function normalizeAIMemory(memory?: AIMemory): string[];
+export declare function formatAIMemories(memories?: readonly string[]): string;
+export declare function appendAIMemoryToText(text: string, memories?: readonly string[]): string;
 export declare const distanceThreshold = 16;
 export declare function distance(point1: {
     x: number;

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

@@ -10,11 +10,14 @@ export type AnyValue<T> = {
 };
 interface ServiceOptions {
     taskInfo?: Omit<ServiceTaskInfo, 'durationMs'>;
+    memoryRetrieverFn?: () => readonly string[] | Promise<readonly string[]>;
 }
 export default class Service {
     contextRetrieverFn: () => Promise<UIContext> | UIContext;
     taskInfo?: Omit<ServiceTaskInfo, 'durationMs'>;
+    private memoryRetrieverFn?;
     constructor(context: UIContext | (() => Promise<UIContext> | UIContext), opt?: ServiceOptions);
+    private getAIMemory;
     locate(query: PlanningLocateParam, opt: LocateOpts, modelConfig: IModelConfig, abortSignal?: AbortSignal): Promise<LocateResultWithDump>;
     extract<T>(dataDemand: ServiceExtractParam, modelConfig: IModelConfig, opt?: ServiceExtractOption, pageDescription?: string, multimodalPrompt?: TMultimodalPrompt, context?: UIContext): Promise<ServiceExtractResult<T>>;
     describe(target: Rect | [number, number], modelConfig: IModelConfig, opt?: {

package/dist/types/types.d.ts

@@ -177,6 +177,8 @@ export type ServiceAssertionResponse = AIAssertionResponse & {
  * agent
  */
 export type OnTaskStartTip = (tip: string) => Promise<void> | void;
+export type AIMemory = string | readonly string[];
+export type AIMemoryRetriever = () => AIMemory | Promise<AIMemory>;
 export interface AgentWaitForOpt extends ServiceExtractOption {
     checkIntervalMs?: number;
     timeoutMs?: number;
@@ -601,6 +603,25 @@ export interface AgentOpt {
      */
     outputFormat?: 'single-html' | 'html-and-external-assets';
     onTaskStartTip?: OnTaskStartTip;
+    /**
+     * User-provided memories that will be included in model calls.
+     * Use this for stable task knowledge such as account hints, domain rules,
+     * app-specific labels, or previous facts the model should consider.
+     */
+    aiMemory?: AIMemory;
+    /**
+     * Alias for aiMemory.
+     */
+    memory?: AIMemory;
+    /**
+     * Dynamically resolves memories before each model call. Useful for services
+     * that maintain memory outside the Agent, for example in a database or cache.
+     */
+    aiMemoryRetriever?: AIMemoryRetriever;
+    /**
+     * Alias for aiMemoryRetriever.
+     */
+    memoryRetriever?: AIMemoryRetriever;
     aiActContext?: string;
     aiActionContext?: string;
     reportFileName?: string;

package/dist/types/yaml.d.ts

@@ -62,12 +62,14 @@ export interface MidsceneYamlTask {
  *   groupName: "E2E Test Suite"
  *   generateReport: true
  *   replanningCycleLimit: 30
+ *   aiMemory:
+ *     - "The Settings tab is represented by a gear icon."
  *   cache:
  *     id: "checkout-cache"
  *     strategy: "read-write"
  * ```
  */
-export type MidsceneYamlScriptAgentOpt = Pick<AgentOpt, 'testId' | 'groupName' | 'groupDescription' | 'generateReport' | 'persistExecutionDump' | 'autoPrintReportMsg' | 'reportFileName' | 'replanningCycleLimit' | 'aiActContext' | 'aiActionContext' | 'cache' | 'screenshotShrinkFactor'>;
+export type MidsceneYamlScriptAgentOpt = Pick<AgentOpt, 'testId' | 'groupName' | 'groupDescription' | 'generateReport' | 'persistExecutionDump' | 'autoPrintReportMsg' | 'reportFileName' | 'replanningCycleLimit' | 'aiMemory' | 'memory' | 'aiActContext' | 'aiActionContext' | 'cache' | 'screenshotShrinkFactor'>;
 export interface MidsceneYamlScriptConfig {
     output?: string;
     unstableLogContent?: boolean | string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aiscene/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": "9.0.0",
+  "version": "9.0.2",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "main": "./dist/lib/index.js",