@midscene/core 0.28.12-beta-20250923080328.0 → 0.28.12-beta-20250923091649.0

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

@@ -1,3 +1,4 @@
+import { type ChatCompletionMessageParam } from '../ai-model';
 import type { AbstractInterface } from '../device';
 import { type DetailedLocateParam, type ExecutionTaskApply, type ExecutionTaskProgressOptions, Executor, type Insight, type InsightExtractOption, type InsightExtractParam, type MidsceneYamlFlowItem, type PlanningAction, type PlanningActionParamWaitFor, type PlanningLocateParam, type TMultimodalPrompt, type TUserPrompt } from '../index';
 import { type IModelConfig } from '@midscene/shared/env';
@@ -12,7 +13,7 @@ export declare class TaskExecutor {
     interface: AbstractInterface;
     insight: Insight;
     taskCache?: TaskCache;
-    private conversationHistory;
+    conversationHistory: ChatCompletionMessageParam[];
     onTaskStartCallback?: ExecutionTaskProgressOptions['onTaskStart'];
     replanningCycleLimit?: number;
     get page(): AbstractInterface;
@@ -31,15 +32,28 @@ export declare class TaskExecutor {
     loadYamlFlowAsPlanning(userInstruction: string, yamlString: string): Promise<{
         executor: Executor;
     }>;
-    private createPlanningTask;
+    private planningTaskFromPrompt;
+    private planningTaskToGoal;
     runPlans(title: string, plans: PlanningAction[], modelConfig: IModelConfig): Promise<ExecutionResult>;
-    private getReplanningCycleLimit;
     action(userPrompt: string, modelConfig: IModelConfig, actionContext?: string): Promise<ExecutionResult<{
         yamlFlow?: MidsceneYamlFlowItem[];
     } | undefined>>;
+    actionToGoal(userPrompt: string, modelConfig: IModelConfig): Promise<ExecutionResult<{
+        yamlFlow?: MidsceneYamlFlowItem[];
+    } | undefined>>;
     private createTypeQueryTask;
     createTypeQueryExecution<T>(type: 'Query' | 'Boolean' | 'Number' | 'String' | 'Assert', demand: InsightExtractParam, modelConfig: IModelConfig, opt?: InsightExtractOption, multimodalPrompt?: TMultimodalPrompt): Promise<ExecutionResult<T>>;
     assert(assertion: TUserPrompt, modelConfig: IModelConfig, opt?: InsightExtractOption): Promise<ExecutionResult<boolean>>;
+    /**
+     * Append a message to the conversation history
+     * For user messages with images:
+     * - Keep max 4 user image messages in history
+     * - Remove oldest user image message when limit reached
+     * For assistant messages:
+     * - Simply append to history
+     * @param conversationHistory Message to append
+     */
+    private appendConversationHistory;
     private appendErrorPlan;
     waitFor(assertion: TUserPrompt, opt: PlanningActionParamWaitFor, modelConfig: IModelConfig): Promise<ExecutionResult<void>>;
 }

package/dist/types/ai-model/index.d.ts

@@ -8,6 +8,5 @@ export { AiLocateElement, AiExtractElementInfo, AiLocateSection, } from './inspe
 export { plan } from './llm-planning';
 export { adaptBboxToRect } from './common';
 export { vlmPlanning, resizeImageForUiTars } from './ui-tars-planning';
-export { ConversationHistory, type ConversationHistoryOptions, } from './conversation-history';
 export { AIActionType, type AIArgs } from './common';
 export { getMidsceneLocationSchema, type MidsceneLocationResultType, PointSchema, SizeSchema, RectSchema, TMultimodalPromptSchema, TUserPromptSchema, type TMultimodalPrompt, type TUserPrompt, findAllMidsceneLocatorField, dumpActionParam, loadActionParam, } from './common';

package/dist/types/ai-model/llm-planning.d.ts

@@ -1,6 +1,5 @@
 import type { DeviceAction, InterfaceType, PlanningAIResponse, UIContext } from '../types';
 import type { IModelConfig } from '@midscene/shared/env';
-import type { ConversationHistory } from './conversation-history';
 export declare function plan(userInstruction: string, opts: {
     context: UIContext;
     interfaceType: InterfaceType;
@@ -8,5 +7,4 @@ export declare function plan(userInstruction: string, opts: {
     log?: string;
     actionContext?: string;
     modelConfig: IModelConfig;
-    conversationHistory?: ConversationHistory;
 }): Promise<PlanningAIResponse>;

package/dist/types/ai-model/ui-tars-planning.d.ts

@@ -1,12 +1,24 @@
-import type { PlanningAIResponse, Size, UIContext } from '../types';
+import type { AIUsageInfo, MidsceneYamlFlowItem, PlanningAction, Size } from '../types';
 import { type IModelConfig, UITarsModelVersion } from '@midscene/shared/env';
-import type { ConversationHistory } from './conversation-history';
+import { actionParser } from '@ui-tars/action-parser';
+import type { ChatCompletionMessageParam } from 'openai/resources/index';
 type ActionType = 'click' | 'drag' | 'type' | 'hotkey' | 'finished' | 'scroll' | 'wait';
-export declare function vlmPlanning(userInstruction: string, options: {
-    conversationHistory: ConversationHistory;
-    context: UIContext;
+export declare function vlmPlanning(options: {
+    userInstruction: string;
+    conversationHistory: ChatCompletionMessageParam[];
+    size: {
+        width: number;
+        height: number;
+    };
     modelConfig: IModelConfig;
-}): Promise<PlanningAIResponse>;
+}): Promise<{
+    actions: PlanningAction<any>[];
+    actionsFromModel: ReturnType<typeof actionParser>['parsed'];
+    action_summary: string;
+    yamlFlow?: MidsceneYamlFlowItem[];
+    usage?: AIUsageInfo;
+    rawResponse?: string;
+}>;
 interface BaseAction {
     action_type: ActionType;
     action_inputs: Record<string, any>;

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": "0.28.12-beta-20250923080328.0",
+  "version": "0.28.12-beta-20250923091649.0",
   "repository": "https://github.com/web-infra-dev/midscene",
   "homepage": "https://midscenejs.com/",
   "main": "./dist/lib/index.js",
@@ -87,8 +87,8 @@
     "zod": "3.24.3",
     "semver": "7.5.2",
     "js-yaml": "4.1.0",
-    "@midscene/recorder": "0.28.12-beta-20250923080328.0",
-    "@midscene/shared": "0.28.12-beta-20250923080328.0"
+    "@midscene/recorder": "0.28.12-beta-20250923091649.0",
+    "@midscene/shared": "0.28.12-beta-20250923091649.0"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.52.10",

package/dist/es/ai-model/conversation-history.mjs

@@ -1,58 +0,0 @@
-function _define_property(obj, key, value) {
-    if (key in obj) Object.defineProperty(obj, key, {
-        value: value,
-        enumerable: true,
-        configurable: true,
-        writable: true
-    });
-    else obj[key] = value;
-    return obj;
-}
-var _computedKey;
-_computedKey = Symbol.iterator;
-let _computedKey1 = _computedKey;
-class ConversationHistory {
-    append(message) {
-        if ('user' === message.role) this.pruneOldestUserMessageIfNecessary();
-        this.messages.push(message);
-    }
-    seed(messages) {
-        this.reset();
-        messages.forEach((message)=>{
-            this.append(message);
-        });
-    }
-    reset() {
-        this.messages.length = 0;
-    }
-    snapshot() {
-        return [
-            ...this.messages
-        ];
-    }
-    get length() {
-        return this.messages.length;
-    }
-    [_computedKey1]() {
-        return this.messages[Symbol.iterator]();
-    }
-    toJSON() {
-        return this.snapshot();
-    }
-    pruneOldestUserMessageIfNecessary() {
-        const userMessages = this.messages.filter((item)=>'user' === item.role);
-        if (userMessages.length < this.maxUserImageMessages) return;
-        const firstUserMessageIndex = this.messages.findIndex((item)=>'user' === item.role);
-        if (firstUserMessageIndex >= 0) this.messages.splice(firstUserMessageIndex, 1);
-    }
-    constructor(options){
-        var _options_initialMessages;
-        _define_property(this, "maxUserImageMessages", void 0);
-        _define_property(this, "messages", []);
-        this.maxUserImageMessages = (null == options ? void 0 : options.maxUserImageMessages) ?? 4;
-        if (null == options ? void 0 : null == (_options_initialMessages = options.initialMessages) ? void 0 : _options_initialMessages.length) this.seed(options.initialMessages);
-    }
-}
-export { ConversationHistory };
-
-//# sourceMappingURL=conversation-history.mjs.map

package/dist/es/ai-model/conversation-history.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-model/conversation-history.mjs","sources":["webpack://@midscene/core/./src/ai-model/conversation-history.ts"],"sourcesContent":["import type { ChatCompletionMessageParam } from 'openai/resources/index';\n\nexport interface ConversationHistoryOptions {\n  maxUserImageMessages?: number;\n  initialMessages?: ChatCompletionMessageParam[];\n}\n\nexport class ConversationHistory {\n  private readonly maxUserImageMessages: number;\n  private readonly messages: ChatCompletionMessageParam[] = [];\n\n  constructor(options?: ConversationHistoryOptions) {\n    this.maxUserImageMessages = options?.maxUserImageMessages ?? 4;\n    if (options?.initialMessages?.length) {\n      this.seed(options.initialMessages);\n    }\n  }\n\n  append(message: ChatCompletionMessageParam) {\n    if (message.role === 'user') {\n      this.pruneOldestUserMessageIfNecessary();\n    }\n\n    this.messages.push(message);\n  }\n\n  seed(messages: ChatCompletionMessageParam[]) {\n    this.reset();\n    messages.forEach((message) => {\n      this.append(message);\n    });\n  }\n\n  reset() {\n    this.messages.length = 0;\n  }\n\n  snapshot(): ChatCompletionMessageParam[] {\n    return [...this.messages];\n  }\n\n  get length(): number {\n    return this.messages.length;\n  }\n\n  [Symbol.iterator](): IterableIterator<ChatCompletionMessageParam> {\n    return this.messages[Symbol.iterator]();\n  }\n\n  toJSON(): ChatCompletionMessageParam[] {\n    return this.snapshot();\n  }\n\n  private pruneOldestUserMessageIfNecessary() {\n    const userMessages = this.messages.filter((item) => item.role === 'user');\n    if (userMessages.length < this.maxUserImageMessages) {\n      return;\n    }\n\n    const firstUserMessageIndex = this.messages.findIndex(\n      (item) => item.role === 'user',\n    );\n\n    if (firstUserMessageIndex >= 0) {\n      this.messages.splice(firstUserMessageIndex, 1);\n    }\n  }\n}\n"],"names":["Symbol","ConversationHistory","message","messages","userMessages","item","firstUserMessageIndex","options","_options_initialMessages"],"mappings":";;;;;;;;;;;eA6CGA,OAAO,QAAQ;;AAtCX,MAAMC;IAWX,OAAOC,OAAmC,EAAE;QAC1C,IAAIA,AAAiB,WAAjBA,QAAQ,IAAI,EACd,IAAI,CAAC,iCAAiC;QAGxC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAACA;IACrB;IAEA,KAAKC,QAAsC,EAAE;QAC3C,IAAI,CAAC,KAAK;QACVA,SAAS,OAAO,CAAC,CAACD;YAChB,IAAI,CAAC,MAAM,CAACA;QACd;IACF;IAEA,QAAQ;QACN,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG;IACzB;IAEA,WAAyC;QACvC,OAAO;eAAI,IAAI,CAAC,QAAQ;SAAC;IAC3B;IAEA,IAAI,SAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM;IAC7B;IAEA,CAAC,cAAD,GAAkE;QAChE,OAAO,IAAI,CAAC,QAAQ,CAACF,OAAO,QAAQ,CAAC;IACvC;IAEA,SAAuC;QACrC,OAAO,IAAI,CAAC,QAAQ;IACtB;IAEQ,oCAAoC;QAC1C,MAAMI,eAAe,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAACC,OAASA,AAAc,WAAdA,KAAK,IAAI;QAC7D,IAAID,aAAa,MAAM,GAAG,IAAI,CAAC,oBAAoB,EACjD;QAGF,MAAME,wBAAwB,IAAI,CAAC,QAAQ,CAAC,SAAS,CACnD,CAACD,OAASA,AAAc,WAAdA,KAAK,IAAI;QAGrB,IAAIC,yBAAyB,GAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAACA,uBAAuB;IAEhD;IAvDA,YAAYC,OAAoC,CAAE;YAE5CC;QALN,uBAAiB,wBAAjB;QACA,uBAAiB,YAAyC,EAAE;QAG1D,IAAI,CAAC,oBAAoB,GAAGD,AAAAA,CAAAA,QAAAA,UAAAA,KAAAA,IAAAA,QAAS,oBAAoB,AAAD,KAAK;QAC7D,IAAIC,QAAAA,UAAAA,KAAAA,IAAAA,QAAAA,CAAAA,2BAAAA,QAAS,eAAe,AAAD,IAAvBA,KAAAA,IAAAA,yBAA0B,MAAM,EAClC,IAAI,CAAC,IAAI,CAACD,QAAQ,eAAe;IAErC;AAmDF"}

package/dist/lib/ai-model/conversation-history.js

@@ -1,92 +0,0 @@
-"use strict";
-var __webpack_require__ = {};
-(()=>{
-    __webpack_require__.d = (exports1, definition)=>{
-        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
-            enumerable: true,
-            get: definition[key]
-        });
-    };
-})();
-(()=>{
-    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
-})();
-(()=>{
-    __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
-            value: 'Module'
-        });
-        Object.defineProperty(exports1, '__esModule', {
-            value: true
-        });
-    };
-})();
-var __webpack_exports__ = {};
-__webpack_require__.r(__webpack_exports__);
-__webpack_require__.d(__webpack_exports__, {
-    ConversationHistory: ()=>ConversationHistory
-});
-function _define_property(obj, key, value) {
-    if (key in obj) Object.defineProperty(obj, key, {
-        value: value,
-        enumerable: true,
-        configurable: true,
-        writable: true
-    });
-    else obj[key] = value;
-    return obj;
-}
-var _computedKey;
-_computedKey = Symbol.iterator;
-let _computedKey1 = _computedKey;
-class ConversationHistory {
-    append(message) {
-        if ('user' === message.role) this.pruneOldestUserMessageIfNecessary();
-        this.messages.push(message);
-    }
-    seed(messages) {
-        this.reset();
-        messages.forEach((message)=>{
-            this.append(message);
-        });
-    }
-    reset() {
-        this.messages.length = 0;
-    }
-    snapshot() {
-        return [
-            ...this.messages
-        ];
-    }
-    get length() {
-        return this.messages.length;
-    }
-    [_computedKey1]() {
-        return this.messages[Symbol.iterator]();
-    }
-    toJSON() {
-        return this.snapshot();
-    }
-    pruneOldestUserMessageIfNecessary() {
-        const userMessages = this.messages.filter((item)=>'user' === item.role);
-        if (userMessages.length < this.maxUserImageMessages) return;
-        const firstUserMessageIndex = this.messages.findIndex((item)=>'user' === item.role);
-        if (firstUserMessageIndex >= 0) this.messages.splice(firstUserMessageIndex, 1);
-    }
-    constructor(options){
-        var _options_initialMessages;
-        _define_property(this, "maxUserImageMessages", void 0);
-        _define_property(this, "messages", []);
-        this.maxUserImageMessages = (null == options ? void 0 : options.maxUserImageMessages) ?? 4;
-        if (null == options ? void 0 : null == (_options_initialMessages = options.initialMessages) ? void 0 : _options_initialMessages.length) this.seed(options.initialMessages);
-    }
-}
-exports.ConversationHistory = __webpack_exports__.ConversationHistory;
-for(var __webpack_i__ in __webpack_exports__)if (-1 === [
-    "ConversationHistory"
-].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
-Object.defineProperty(exports, '__esModule', {
-    value: true
-});
-
-//# sourceMappingURL=conversation-history.js.map

package/dist/lib/ai-model/conversation-history.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-model/conversation-history.js","sources":["webpack://@midscene/core/webpack/runtime/define_property_getters","webpack://@midscene/core/webpack/runtime/has_own_property","webpack://@midscene/core/webpack/runtime/make_namespace_object","webpack://@midscene/core/./src/ai-model/conversation-history.ts"],"sourcesContent":["__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","import type { ChatCompletionMessageParam } from 'openai/resources/index';\n\nexport interface ConversationHistoryOptions {\n  maxUserImageMessages?: number;\n  initialMessages?: ChatCompletionMessageParam[];\n}\n\nexport class ConversationHistory {\n  private readonly maxUserImageMessages: number;\n  private readonly messages: ChatCompletionMessageParam[] = [];\n\n  constructor(options?: ConversationHistoryOptions) {\n    this.maxUserImageMessages = options?.maxUserImageMessages ?? 4;\n    if (options?.initialMessages?.length) {\n      this.seed(options.initialMessages);\n    }\n  }\n\n  append(message: ChatCompletionMessageParam) {\n    if (message.role === 'user') {\n      this.pruneOldestUserMessageIfNecessary();\n    }\n\n    this.messages.push(message);\n  }\n\n  seed(messages: ChatCompletionMessageParam[]) {\n    this.reset();\n    messages.forEach((message) => {\n      this.append(message);\n    });\n  }\n\n  reset() {\n    this.messages.length = 0;\n  }\n\n  snapshot(): ChatCompletionMessageParam[] {\n    return [...this.messages];\n  }\n\n  get length(): number {\n    return this.messages.length;\n  }\n\n  [Symbol.iterator](): IterableIterator<ChatCompletionMessageParam> {\n    return this.messages[Symbol.iterator]();\n  }\n\n  toJSON(): ChatCompletionMessageParam[] {\n    return this.snapshot();\n  }\n\n  private pruneOldestUserMessageIfNecessary() {\n    const userMessages = this.messages.filter((item) => item.role === 'user');\n    if (userMessages.length < this.maxUserImageMessages) {\n      return;\n    }\n\n    const firstUserMessageIndex = this.messages.findIndex(\n      (item) => item.role === 'user',\n    );\n\n    if (firstUserMessageIndex >= 0) {\n      this.messages.splice(firstUserMessageIndex, 1);\n    }\n  }\n}\n"],"names":["__webpack_require__","definition","key","Object","obj","prop","Symbol","ConversationHistory","message","messages","userMessages","item","firstUserMessageIndex","options","_options_initialMessages"],"mappings":";;;IAAAA,oBAAoB,CAAC,GAAG,CAAC,UAASC;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGD,oBAAoB,CAAC,CAACC,YAAYC,QAAQ,CAACF,oBAAoB,CAAC,CAAC,UAASE,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAF,oBAAoB,CAAC,GAAG,CAACI,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFL,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,eAAlB,OAAOM,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D;;;;;;;;;;;;;;;;;;eCuCGG,OAAO,QAAQ;;AAtCX,MAAMC;IAWX,OAAOC,OAAmC,EAAE;QAC1C,IAAIA,AAAiB,WAAjBA,QAAQ,IAAI,EACd,IAAI,CAAC,iCAAiC;QAGxC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAACA;IACrB;IAEA,KAAKC,QAAsC,EAAE;QAC3C,IAAI,CAAC,KAAK;QACVA,SAAS,OAAO,CAAC,CAACD;YAChB,IAAI,CAAC,MAAM,CAACA;QACd;IACF;IAEA,QAAQ;QACN,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG;IACzB;IAEA,WAAyC;QACvC,OAAO;eAAI,IAAI,CAAC,QAAQ;SAAC;IAC3B;IAEA,IAAI,SAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM;IAC7B;IAEA,CAAC,cAAD,GAAkE;QAChE,OAAO,IAAI,CAAC,QAAQ,CAACF,OAAO,QAAQ,CAAC;IACvC;IAEA,SAAuC;QACrC,OAAO,IAAI,CAAC,QAAQ;IACtB;IAEQ,oCAAoC;QAC1C,MAAMI,eAAe,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAACC,OAASA,AAAc,WAAdA,KAAK,IAAI;QAC7D,IAAID,aAAa,MAAM,GAAG,IAAI,CAAC,oBAAoB,EACjD;QAGF,MAAME,wBAAwB,IAAI,CAAC,QAAQ,CAAC,SAAS,CACnD,CAACD,OAASA,AAAc,WAAdA,KAAK,IAAI;QAGrB,IAAIC,yBAAyB,GAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAACA,uBAAuB;IAEhD;IAvDA,YAAYC,OAAoC,CAAE;YAE5CC;QALN,uBAAiB,wBAAjB;QACA,uBAAiB,YAAyC,EAAE;QAG1D,IAAI,CAAC,oBAAoB,GAAGD,AAAAA,CAAAA,QAAAA,UAAAA,KAAAA,IAAAA,QAAS,oBAAoB,AAAD,KAAK;QAC7D,IAAIC,QAAAA,UAAAA,KAAAA,IAAAA,QAAAA,CAAAA,2BAAAA,QAAS,eAAe,AAAD,IAAvBA,KAAAA,IAAAA,yBAA0B,MAAM,EAClC,IAAI,CAAC,IAAI,CAACD,QAAQ,eAAe;IAErC;AAmDF"}

package/dist/types/ai-model/conversation-history.d.ts

@@ -1,18 +0,0 @@
-import type { ChatCompletionMessageParam } from 'openai/resources/index';
-export interface ConversationHistoryOptions {
-    maxUserImageMessages?: number;
-    initialMessages?: ChatCompletionMessageParam[];
-}
-export declare class ConversationHistory {
-    private readonly maxUserImageMessages;
-    private readonly messages;
-    constructor(options?: ConversationHistoryOptions);
-    append(message: ChatCompletionMessageParam): void;
-    seed(messages: ChatCompletionMessageParam[]): void;
-    reset(): void;
-    snapshot(): ChatCompletionMessageParam[];
-    get length(): number;
-    [Symbol.iterator](): IterableIterator<ChatCompletionMessageParam>;
-    toJSON(): ChatCompletionMessageParam[];
-    private pruneOldestUserMessageIfNecessary;
-}