page-agent 0.0.13 → 0.0.16

package/README.md

@@ -73,6 +73,7 @@ PageAgent adopts a simplified monorepo structure:
 ```
 packages/
 ├── page-agent/          # AI agent (npm: page-agent)
+├── llms/                # LLM client (npm: @page-agent/llms)
 ├── page-controller/     # DOM operations (npm: @page-agent/page-controller)
 ├── ui/                  # Panel & Mask & Mouse Animation (npm: @page-agent/ui)
 └── website/             # Demo & Documentation site

package/dist/esm/PageAgent.d.ts

@@ -1,3 +1,7 @@
+import { AgentBrain } from '@page-agent/llms';
+import { LLMConfig } from '@page-agent/llms';
+import { MacroToolInput } from '@page-agent/llms';
+import { MacroToolResult } from '@page-agent/llms';
 import { PageController } from '@page-agent/page-controller';
 import { PageControllerConfig } from '@page-agent/page-controller';
 import { Panel } from '@page-agent/ui';
@@ -5,11 +9,7 @@ import { SimulatorMask } from '@page-agent/ui';
 import { SupportedLanguage } from '@page-agent/ui';
 import { z } from 'zod';
 
-export declare interface AgentBrain {
-    evaluation_previous_goal: string;
-    memory: string;
-    next_goal: string;
-}
+export { AgentBrain }
 
 declare interface AgentConfig {
     language?: SupportedLanguage;
@@ -95,32 +95,9 @@ export declare interface ExecutionResult {
     history: AgentHistory[];
 }
 
-declare interface LLMConfig {
-    baseURL?: string;
-    apiKey?: string;
-    model?: string;
-    temperature?: number;
-    maxTokens?: number;
-    maxRetries?: number;
-}
+export { MacroToolInput }
 
-/**
- * MacroTool input structure
- */
-export declare interface MacroToolInput {
-    evaluation_previous_goal?: string;
-    memory?: string;
-    next_goal?: string;
-    action: Record<string, any>;
-}
-
-/**
- * MacroTool output structure
- */
-export declare interface MacroToolResult {
-    input: MacroToolInput;
-    output: string;
-}
+export { MacroToolResult }
 
 export declare class PageAgent extends EventTarget {
     #private;

package/dist/esm/page-agent.js

@@ -11,389 +11,12 @@ var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot
 var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
 var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
 var _llm, _totalWaitTime, _abortController, _llmRetryListener, _llmErrorListener, _beforeUnloadListener, _PageAgent_instances, packMacroTool_fn, getSystemPrompt_fn, assembleUserPrompt_fn, onDone_fn, getBrowserState_fn;
+import { LLM } from "@page-agent/llms";
 import { PageController } from "@page-agent/page-controller";
 import { SimulatorMask, Panel } from "@page-agent/ui";
 import chalk from "chalk";
-import zod, { z } from "zod";
-const DEFAULT_MODEL_NAME = "PAGE-AGENT-FREE-TESTING-RANDOM";
-const DEFAULT_API_KEY = "PAGE-AGENT-FREE-TESTING-RANDOM";
-const DEFAULT_BASE_URL = "https://hwcxiuzfylggtcktqgij.supabase.co/functions/v1/llm-testing-proxy";
-const LLM_MAX_RETRIES = 2;
+import zod from "zod";
 const MAX_STEPS = 20;
-const DEFAULT_TEMPERATURE = 0.7;
-const DEFAULT_MAX_TOKENS = 4096;
-function parseLLMConfig(config) {
-  return {
-    baseURL: config.baseURL ?? DEFAULT_BASE_URL,
-    apiKey: config.apiKey ?? DEFAULT_API_KEY,
-    model: config.model ?? DEFAULT_MODEL_NAME,
-    temperature: config.temperature ?? DEFAULT_TEMPERATURE,
-    maxTokens: config.maxTokens ?? DEFAULT_MAX_TOKENS,
-    maxRetries: config.maxRetries ?? LLM_MAX_RETRIES
-  };
-}
-__name(parseLLMConfig, "parseLLMConfig");
-const InvokeErrorType = {
-  // Retryable
-  NETWORK_ERROR: "network_error",
-  // Network error, retry
-  RATE_LIMIT: "rate_limit",
-  // Rate limit, retry
-  SERVER_ERROR: "server_error",
-  // 5xx, retry
-  NO_TOOL_CALL: "no_tool_call",
-  // Model did not call tool
-  INVALID_TOOL_ARGS: "invalid_tool_args",
-  // Tool args don't match schema
-  TOOL_EXECUTION_ERROR: "tool_execution_error",
-  // Tool execution error
-  UNKNOWN: "unknown",
-  // Non-retryable
-  AUTH_ERROR: "auth_error",
-  // Authentication failed
-  CONTEXT_LENGTH: "context_length",
-  // Prompt too long
-  CONTENT_FILTER: "content_filter"
-  // Content filtered
-};
-const _InvokeError = class _InvokeError extends Error {
-  type;
-  retryable;
-  statusCode;
-  rawError;
-  constructor(type, message, rawError) {
-    super(message);
-    this.name = "InvokeError";
-    this.type = type;
-    this.retryable = this.isRetryable(type);
-    this.rawError = rawError;
-  }
-  isRetryable(type) {
-    const retryableTypes = [
-      InvokeErrorType.NETWORK_ERROR,
-      InvokeErrorType.RATE_LIMIT,
-      InvokeErrorType.SERVER_ERROR,
-      InvokeErrorType.NO_TOOL_CALL,
-      InvokeErrorType.INVALID_TOOL_ARGS,
-      InvokeErrorType.TOOL_EXECUTION_ERROR,
-      InvokeErrorType.UNKNOWN
-    ];
-    return retryableTypes.includes(type);
-  }
-};
-__name(_InvokeError, "InvokeError");
-let InvokeError = _InvokeError;
-function zodToOpenAITool(name, tool2) {
-  return {
-    type: "function",
-    function: {
-      name,
-      description: tool2.description,
-      parameters: z.toJSONSchema(tool2.inputSchema, { target: "openapi-3.0" })
-    }
-  };
-}
-__name(zodToOpenAITool, "zodToOpenAITool");
-function lenientParseMacroToolCall(responseData, inputSchema) {
-  const choice = responseData.choices?.[0];
-  if (!choice) {
-    throw new InvokeError(InvokeErrorType.UNKNOWN, "No choices in response", responseData);
-  }
-  switch (choice.finish_reason) {
-    case "tool_calls":
-    case "function_call":
-    // gemini
-    case "stop":
-      break;
-    case "length":
-      throw new InvokeError(
-        InvokeErrorType.CONTEXT_LENGTH,
-        "Response truncated: max tokens reached"
-      );
-    case "content_filter":
-      throw new InvokeError(InvokeErrorType.CONTENT_FILTER, "Content filtered by safety system");
-    default:
-      throw new InvokeError(
-        InvokeErrorType.UNKNOWN,
-        `Unexpected finish_reason: ${choice.finish_reason}`
-      );
-  }
-  const actionSchema = inputSchema.shape.action;
-  if (!actionSchema) {
-    throw new Error('inputSchema must have an "action" field');
-  }
-  let arg = null;
-  const toolCall = choice.message?.tool_calls?.[0]?.function;
-  arg = toolCall?.arguments ?? null;
-  if (arg && toolCall.name !== "AgentOutput") {
-    console.log(chalk.yellow("lenientParseMacroToolCall: #1 fixing incorrect tool call"));
-    let tmpArg;
-    try {
-      tmpArg = JSON.parse(arg);
-    } catch (error) {
-      throw new InvokeError(
-        InvokeErrorType.INVALID_TOOL_ARGS,
-        "Failed to parse tool arguments as JSON",
-        error
-      );
-    }
-    arg = JSON.stringify({ action: { [toolCall.name]: tmpArg } });
-  }
-  if (!arg) {
-    arg = choice.message?.content.trim() || null;
-  }
-  if (!arg) {
-    throw new InvokeError(
-      InvokeErrorType.NO_TOOL_CALL,
-      "No tool call or content found in response",
-      responseData
-    );
-  }
-  let parsedArgs;
-  try {
-    parsedArgs = JSON.parse(arg);
-  } catch (error) {
-    throw new InvokeError(
-      InvokeErrorType.INVALID_TOOL_ARGS,
-      "Failed to parse tool arguments as JSON",
-      error
-    );
-  }
-  if (parsedArgs.action || parsedArgs.evaluation_previous_goal || parsedArgs.next_goal) {
-    if (!parsedArgs.action) {
-      console.log(chalk.yellow("lenientParseMacroToolCall: #2 fixing incorrect tool call"));
-      parsedArgs.action = {
-        wait: { seconds: 1 }
-      };
-    }
-  } else if (parsedArgs.type && parsedArgs.function) {
-    if (parsedArgs.function.name !== "AgentOutput")
-      throw new InvokeError(
-        InvokeErrorType.INVALID_TOOL_ARGS,
-        `Expected function name "AgentOutput", got "${parsedArgs.function.name}"`,
-        null
-      );
-    console.log(chalk.yellow("lenientParseMacroToolCall: #3 fixing incorrect tool call"));
-    parsedArgs = parsedArgs.function.arguments;
-  } else if (parsedArgs.name && parsedArgs.arguments) {
-    if (parsedArgs.name !== "AgentOutput")
-      throw new InvokeError(
-        InvokeErrorType.INVALID_TOOL_ARGS,
-        `Expected function name "AgentOutput", got "${parsedArgs.name}"`,
-        null
-      );
-    console.log(chalk.yellow("lenientParseMacroToolCall: #4 fixing incorrect tool call"));
-    parsedArgs = parsedArgs.arguments;
-  } else {
-    console.log(chalk.yellow("lenientParseMacroToolCall: #5 fixing incorrect tool call"));
-    parsedArgs = { action: parsedArgs };
-  }
-  if (typeof parsedArgs === "string") {
-    console.log(chalk.yellow("lenientParseMacroToolCall: #6 fixing incorrect tool call"));
-    try {
-      parsedArgs = JSON.parse(parsedArgs);
-    } catch (error) {
-      throw new InvokeError(
-        InvokeErrorType.INVALID_TOOL_ARGS,
-        "Failed to parse nested tool arguments as JSON",
-        error
-      );
-    }
-  }
-  const validation = inputSchema.safeParse(parsedArgs);
-  if (validation.success) {
-    return validation.data;
-  } else {
-    const action = parsedArgs.action ?? {};
-    const actionName = Object.keys(action)[0] || "unknown";
-    const actionArgs = JSON.stringify(action[actionName] || "unknown");
-    throw new InvokeError(
-      InvokeErrorType.INVALID_TOOL_ARGS,
-      `Tool arguments validation failed: action "${actionName}" with args ${actionArgs}`,
-      validation.error
-    );
-  }
-}
-__name(lenientParseMacroToolCall, "lenientParseMacroToolCall");
-function modelPatch(body) {
-  const model = body.model || "";
-  if (model.toLowerCase().startsWith("claude")) {
-    body.tool_choice = { type: "tool", name: "AgentOutput" };
-    body.thinking = { type: "disabled" };
-  }
-  if (model.toLowerCase().includes("grok")) {
-    console.log("Applying Grok patch: removing tool_choice");
-    delete body.tool_choice;
-    console.log("Applying Grok patch: disable reasoning and thinking");
-    body.thinking = { type: "disabled", effort: "minimal" };
-    body.reasoning = { enabled: false, effort: "low" };
-  }
-  return body;
-}
-__name(modelPatch, "modelPatch");
-const _OpenAIClient = class _OpenAIClient {
-  config;
-  constructor(config) {
-    this.config = config;
-  }
-  async invoke(messages, tools2, abortSignal) {
-    const openaiTools = Object.entries(tools2).map(([name, tool22]) => zodToOpenAITool(name, tool22));
-    let response;
-    try {
-      response = await fetch(`${this.config.baseURL}/chat/completions`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${this.config.apiKey}`
-        },
-        body: JSON.stringify(
-          modelPatch({
-            model: this.config.model,
-            temperature: this.config.temperature,
-            max_tokens: this.config.maxTokens,
-            messages,
-            tools: openaiTools,
-            // tool_choice: 'required',
-            tool_choice: { type: "function", function: { name: "AgentOutput" } },
-            // model specific params
-            // reasoning_effort: 'minimal',
-            // verbosity: 'low',
-            parallel_tool_calls: false
-          })
-        ),
-        signal: abortSignal
-      });
-    } catch (error) {
-      throw new InvokeError(InvokeErrorType.NETWORK_ERROR, "Network request failed", error);
-    }
-    if (!response.ok) {
-      const errorData = await response.json().catch();
-      const errorMessage = errorData.error?.message || response.statusText;
-      if (response.status === 401 || response.status === 403) {
-        throw new InvokeError(
-          InvokeErrorType.AUTH_ERROR,
-          `Authentication failed: ${errorMessage}`,
-          errorData
-        );
-      }
-      if (response.status === 429) {
-        throw new InvokeError(
-          InvokeErrorType.RATE_LIMIT,
-          `Rate limit exceeded: ${errorMessage}`,
-          errorData
-        );
-      }
-      if (response.status >= 500) {
-        throw new InvokeError(
-          InvokeErrorType.SERVER_ERROR,
-          `Server error: ${errorMessage}`,
-          errorData
-        );
-      }
-      throw new InvokeError(
-        InvokeErrorType.UNKNOWN,
-        `HTTP ${response.status}: ${errorMessage}`,
-        errorData
-      );
-    }
-    const data = await response.json();
-    const tool2 = tools2.AgentOutput;
-    const macroToolInput = lenientParseMacroToolCall(data, tool2.inputSchema);
-    let toolResult;
-    try {
-      toolResult = await tool2.execute(macroToolInput);
-    } catch (e) {
-      throw new InvokeError(
-        InvokeErrorType.TOOL_EXECUTION_ERROR,
-        `Tool execution failed: ${e.message}`,
-        e
-      );
-    }
-    return {
-      toolCall: {
-        // id: toolCall.id,
-        name: "AgentOutput",
-        args: macroToolInput
-      },
-      toolResult,
-      usage: {
-        promptTokens: data.usage?.prompt_tokens ?? 0,
-        completionTokens: data.usage?.completion_tokens ?? 0,
-        totalTokens: data.usage?.total_tokens ?? 0,
-        cachedTokens: data.usage?.prompt_tokens_details?.cached_tokens,
-        reasoningTokens: data.usage?.completion_tokens_details?.reasoning_tokens
-      },
-      rawResponse: data
-    };
-  }
-};
-__name(_OpenAIClient, "OpenAIClient");
-let OpenAIClient = _OpenAIClient;
-const _LLM = class _LLM extends EventTarget {
-  config;
-  client;
-  constructor(config) {
-    super();
-    this.config = parseLLMConfig(config);
-    this.client = new OpenAIClient({
-      model: this.config.model,
-      apiKey: this.config.apiKey,
-      baseURL: this.config.baseURL,
-      temperature: this.config.temperature,
-      maxTokens: this.config.maxTokens
-    });
-  }
-  /**
-   * - call llm api *once*
-   * - invoke tool call *once*
-   * - return the result of the tool
-   */
-  async invoke(messages, tools2, abortSignal) {
-    return await withRetry(
-      async () => {
-        const result = await this.client.invoke(messages, tools2, abortSignal);
-        return result;
-      },
-      // retry settings
-      {
-        maxRetries: this.config.maxRetries,
-        onRetry: /* @__PURE__ */ __name((current) => {
-          this.dispatchEvent(
-            new CustomEvent("retry", { detail: { current, max: this.config.maxRetries } })
-          );
-        }, "onRetry"),
-        onError: /* @__PURE__ */ __name((error) => {
-          this.dispatchEvent(new CustomEvent("error", { detail: { error } }));
-        }, "onError")
-      }
-    );
-  }
-};
-__name(_LLM, "LLM");
-let LLM = _LLM;
-async function withRetry(fn, settings) {
-  let retries = 0;
-  let lastError = null;
-  while (retries <= settings.maxRetries) {
-    if (retries > 0) {
-      settings.onRetry(retries);
-      await new Promise((resolve) => setTimeout(resolve, 100));
-    }
-    try {
-      return await fn();
-    } catch (error) {
-      console.error(error);
-      settings.onError(error);
-      if (error?.name === "AbortError") throw error;
-      if (error instanceof InvokeError && !error.retryable) throw error;
-      lastError = error;
-      retries++;
-      await new Promise((resolve) => setTimeout(resolve, 100));
-    }
-  }
-  throw lastError;
-}
-__name(withRetry, "withRetry");
 const SYSTEM_PROMPT = 'You are an AI agent designed to operate in an iterative loop to automate browser tasks. Your ultimate goal is accomplishing the task provided in <user_request>.\n\n<intro>\nYou excel at following tasks:\n1. Navigating complex websites and extracting precise information\n2. Automating form submissions and interactive web actions\n3. Gathering and saving information \n4. Operate effectively in an agent loop\n5. Efficiently performing diverse web tasks\n</intro>\n\n<language_settings>\n- Default working language: **中文**\n- Use the language that user is using. Return in user\'s language.\n</language_settings>\n\n<input>\nAt every step, your input will consist of: \n1. <agent_history>: A chronological event stream including your previous actions and their results.\n2. <agent_state>: Current <user_request> and <step_info>.\n3. <browser_state>: Current URL, interactive elements indexed for actions, and visible page content.\n</input>\n\n<agent_history>\nAgent history will be given as a list of step information as follows:\n\n<step_{step_number}>:\nEvaluation of Previous Step: Assessment of last action\nMemory: Your memory of this step\nNext Goal: Your goal for this step\nAction Results: Your actions and their results\n</step_{step_number}>\n\nand system messages wrapped in <sys> tag.\n</agent_history>\n\n<user_request>\nUSER REQUEST: This is your ultimate objective and always remains visible.\n- This has the highest priority. Make the user happy.\n- If the user request is very specific - then carefully follow each step and dont skip or hallucinate steps.\n- If the task is open ended you can plan yourself how to get it done.\n</user_request>\n\n<browser_state>\n1. Browser State will be given as:\n\nCurrent URL: URL of the page you are currently viewing.\nInteractive Elements: All interactive elements will be provided in format as [index]<type>text</type> where\n- index: Numeric identifier for interaction\n- type: HTML element type (button, input, etc.)\n- text: Element description\n\nExamples:\n[33]<div>User form</div>\n\\t*[35]<button aria-label=\'Submit form\'>Submit</button>\n\nNote that:\n- Only elements with numeric indexes in [] are interactive\n- (stacked) indentation (with \\t) is important and means that the element is a (html) child of the element above (with a lower index)\n- Elements tagged with `*[` are the new clickable elements that appeared on the website since the last step - if url has not changed.\n- Pure text elements without [] are not interactive.\n</browser_state>\n\n<browser_rules>\nStrictly follow these rules while using the browser and navigating the web:\n- Only interact with elements that have a numeric [index] assigned.\n- Only use indexes that are explicitly provided.\n- If the page changes after, for example, an input text action, analyze if you need to interact with new elements, e.g. selecting the right option from the list.\n- By default, only elements in the visible viewport are listed. Use scrolling actions if you suspect relevant content is offscreen which you need to interact with. Scroll ONLY if there are more pixels below or above the page.\n- You can scroll by a specific number of pages using the num_pages parameter (e.g., 0.5 for half page, 2.0 for two pages).\n- All the elements that are scrollable are marked with `data-scrollable` attribute. Including the scrollable distance in every directions. You can scroll *the element* in case some area are overflowed.\n- If a captcha appears, tell user you can not solve captcha. finished the task and ask user to solve it.\n- If expected elements are missing, try scrolling, or navigating back.\n- If the page is not fully loaded, use the `wait` action.\n- Do not repeat one action for more than 3 times unless some conditions changed.\n- If you fill an input field and your action sequence is interrupted, most often something changed e.g. suggestions popped up under the field.\n- If the <user_request> includes specific page information such as product type, rating, price, location, etc., try to apply filters to be more efficient.\n- The <user_request> is the ultimate goal. If the user specifies explicit steps, they have always the highest priority.\n- If you input_text into a field, you might need to press enter, click the search button, or select from dropdown for completion.\n- Don\'t login into a page if you don\'t have to. Don\'t login if you don\'t have the credentials. \n- There are 2 types of tasks always first think which type of request you are dealing with:\n1. Very specific step by step instructions:\n- Follow them as very precise and don\'t skip steps. Try to complete everything as requested.\n2. Open ended tasks. Plan yourself, be creative in achieving them.\n- If you get stuck e.g. with logins or captcha in open-ended tasks you can re-evaluate the task and try alternative ways, e.g. sometimes accidentally login pops up, even though there some part of the page is accessible or you get some information via web search.\n</browser_rules>\n\n<capability>\n- You can only handle single page app. Do not jump out of current page.\n- Do not click on link if it will open in a new page (etc. <a target="_blank">)\n- It is ok to fail the task.\n	- User can be wrong. If the request of user is not achievable, inappropriate or you do not have enough information or tools to achieve it. Tell user to make a better request.\n	- Webpage can be broken. All webpages or apps have bugs. Some bug will make it hard for your job. It\'s encouraged to tell user the problem of current page. Your feedbacks (including failing) are valuable for user.\n	- Trying to hard can be harmful. Repeating some action back and forth or pushing for a complex procedure with little knowledge can cause unwanted result and harmful side-effects. User would rather you to complete the task with a fail.\n- If you are not clear about the request or steps. `ask_user` to clarify it.\n- If you do not have knowledge for the current webpage or task. You must require user to give specific instructions and detailed steps.\n</capability>\n\n<task_completion_rules>\nYou must call the `done` action in one of three cases:\n- When you have fully completed the USER REQUEST.\n- When you reach the final allowed step (`max_steps`), even if the task is incomplete.\n- When you feel stuck or unable to solve user request. Or user request is not clear or contains inappropriate content.\n- If it is ABSOLUTELY IMPOSSIBLE to continue.\n\nThe `done` action is your opportunity to terminate and share your findings with the user.\n- Set `success` to `true` only if the full USER REQUEST has been completed with no missing components.\n- If any part of the request is missing, incomplete, or uncertain, set `success` to `false`.\n- You can use the `text` field of the `done` action to communicate your findings and to provide a coherent reply to the user and fulfill the USER REQUEST.\n- You are ONLY ALLOWED to call `done` as a single action. Don\'t call it together with other actions.\n- If the user asks for specified format, such as "return JSON with following structure", "return a list of format...", MAKE sure to use the right format in your answer.\n- If the user asks for a structured output, your `done` action\'s schema may be modified. Take this schema into account when solving the task!\n</task_completion_rules>\n\n<reasoning_rules>\nExhibit the following reasoning patterns to successfully achieve the <user_request>:\n\n- Reason about <agent_history> to track progress and context toward <user_request>.\n- Analyze the most recent "Next Goal" and "Action Result" in <agent_history> and clearly state what you previously tried to achieve.\n- Analyze all relevant items in <agent_history> and <browser_state> to understand your state.\n- Explicitly judge success/failure/uncertainty of the last action. Never assume an action succeeded just because it appears to be executed in your last step in <agent_history>. If the expected change is missing, mark the last action as failed (or uncertain) and plan a recovery.\n- Analyze whether you are stuck, e.g. when you repeat the same actions multiple times without any progress. Then consider alternative approaches e.g. scrolling for more context or ask user for help.\n- `ask_user` for help if you have any difficulty. Users want to be kept in the loop.\n- If you see information relevant to <user_request>, plan saving the information to memory.\n- Always reason about the <user_request>. Make sure to carefully analyze the specific steps and information required. E.g. specific filters, specific form fields, specific information to search. Make sure to always compare the current trajectory with the user request and think carefully if thats how the user requested it.\n</reasoning_rules>\n\n<examples>\nHere are examples of good output patterns. Use them as reference but never copy them directly.\n\n<evaluation_examples>\n- Positive Examples:\n"evaluation_previous_goal": "Successfully navigated to the product page and found the target information. Verdict: Success"\n"evaluation_previous_goal": "Clicked the login button and user authentication form appeared. Verdict: Success"\n</evaluation_examples>\n\n<memory_examples>\n"memory": "Found many pending reports that need to be analyzed in the main page. Successfully processed the first 2 reports on quarterly sales data and moving on to inventory analysis and customer feedback reports."\n</memory_examples>\n\n<next_goal_examples>\n"next_goal": "Click on the \'Add to Cart\' button to proceed with the purchase flow."\n"next_goal": "Extract details from the first item on the page."\n</next_goal_examples>\n</examples>\n\n<output>\nYou must ALWAYS respond with a valid JSON in this exact format:\n\n{\n  "evaluation_previous_goal": "Concise one-sentence analysis of your last action. Clearly state success, failure, or uncertain.",\n  "memory": "1-3 concise sentences of specific memory of this step and overall progress. You should put here everything that will help you track progress in future steps. Like counting pages visited, items found, etc.",\n  "next_goal": "State the next immediate goal and action to achieve it, in one clear sentence."\n  "action":{"one_action_name": {// action-specific parameter}}\n}\n</output>\n';
 async function waitUntil(check, timeout = 60 * 601e3) {
   if (check()) return true;