@quanta-intellect/vessel-browser 0.1.143 → 0.1.145

package/out/main/index.js

@@ -1467,7 +1467,12 @@ function loadJsonFile({
     const decoded = decodeStoredData(raw, secure);
     return parse(JSON.parse(decoded));
   } catch (err) {
-    logger$A.warn(`Failed to load ${filePath2}, using fallback:`, err);
+    const isMissingFile = err instanceof Error && "code" in err && err.code === "ENOENT";
+    if (isMissingFile) {
+      logger$A.info(`Persistence file not found; using fallback defaults: ${filePath2}`);
+    } else {
+      logger$A.warn(`Failed to load ${filePath2}, using fallback:`, err);
+    }
     return fallback;
   }
 }
@@ -3867,7 +3872,14 @@ const AIChannels = {
   AGENT_CHECKPOINT_UPDATE_NOTE: "agent:checkpoint-update-note",
   AGENT_UNDO_LAST_ACTION: "agent:undo-last-action",
   AGENT_SESSION_CAPTURE: "agent:session-capture",
-  AGENT_SESSION_RESTORE: "agent:session-restore"
+  AGENT_SESSION_RESTORE: "agent:session-restore",
+  AGENT_TASK_START: "agent:task-start",
+  AGENT_TASK_UPDATE: "agent:task-update",
+  AGENT_TASK_NOTE: "agent:task-note",
+  AGENT_TASK_BLOCKER: "agent:task-blocker",
+  AGENT_TASK_RESOLVE: "agent:task-resolve",
+  AGENT_TASK_ABANDON: "agent:task-abandon",
+  AGENT_TASK_CLEAR: "agent:task-clear"
 };
 const AutofillChannels = {
   AUTOFILL_LIST: "autofill:list",
@@ -8683,6 +8695,106 @@ function recoverTextEncodedToolCalls(text, availableToolNames) {
   }
   return recovered;
 }
+function findInlineToolMarkerBodies(text) {
+  const bodies = [];
+  const lowerText = text.toLowerCase();
+  let searchIndex = 0;
+  while (searchIndex < text.length) {
+    const start = lowerText.indexOf("<<tool", searchIndex);
+    if (start === -1) break;
+    let quote = null;
+    let escaped = false;
+    let end = -1;
+    for (let index = start + 2; index < text.length - 1; index += 1) {
+      const char = text[index];
+      if (quote) {
+        if (escaped) {
+          escaped = false;
+        } else if (char === "\\") {
+          escaped = true;
+        } else if (char === quote) {
+          quote = null;
+        }
+        continue;
+      }
+      if (char === '"' || char === "'") {
+        quote = char;
+        continue;
+      }
+      if (char === ">" && text[index + 1] === ">") {
+        end = index;
+        break;
+      }
+    }
+    if (end === -1) {
+      searchIndex = start + 2;
+      continue;
+    }
+    bodies.push(text.slice(start + 2, end));
+    searchIndex = end + 2;
+  }
+  return bodies;
+}
+function recoverInlineToolMarkerToolCalls(text, availableToolNames) {
+  const recovered = [];
+  for (const markerBody of findInlineToolMarkerBodies(text)) {
+    const match = markerBody.trim().match(/^tool[:=]([a-z_][a-z0-9_]*)(?:[:=]([\s\S]*))?$/i);
+    if (!match) continue;
+    const rawName = match[1] ?? "";
+    const rawArgs = (match[2] ?? "").trim();
+    const resolvedName = resolveToolCallName(
+      rawName,
+      {},
+      availableToolNames
+    );
+    if (!availableToolNames.has(resolvedName)) continue;
+    let parsedArgs = null;
+    if (rawArgs.startsWith("{")) {
+      const repaired = parseToolArgsWithRepair(resolvedName, rawArgs);
+      if (repaired) {
+        parsedArgs = repaired.args;
+      }
+    }
+    if (!parsedArgs) {
+      const kvArgs = {};
+      const kvPattern = /([a-z_][a-z0-9_]*)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^,\s]*))/gi;
+      let kvMatch;
+      while ((kvMatch = kvPattern.exec(rawArgs)) !== null) {
+        const key2 = kvMatch[1];
+        const value = kvMatch[2] ?? kvMatch[3] ?? kvMatch[4] ?? "";
+        kvArgs[key2] = value;
+      }
+      if (Object.keys(kvArgs).length > 0) {
+        parsedArgs = kvArgs;
+      }
+    }
+    if (!parsedArgs && rawArgs) {
+      const repaired = parseToolArgsWithRepair(resolvedName, rawArgs);
+      if (repaired) {
+        parsedArgs = repaired.args;
+      }
+    }
+    if (!parsedArgs) {
+      parsedArgs = {};
+    }
+    recovered.push({
+      id: `recovered_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+      name: resolvedName,
+      argsJson: JSON.stringify(parsedArgs)
+    });
+  }
+  return recovered;
+}
+function recoverAssistantTextToolCalls(text, availableToolNames) {
+  const textEncodedCalls = recoverTextEncodedToolCalls(text, availableToolNames);
+  if (textEncodedCalls.length > 0) return textEncodedCalls;
+  const inlineMarkerCalls = recoverInlineToolMarkerToolCalls(
+    text,
+    availableToolNames
+  );
+  if (inlineMarkerCalls.length > 0) return inlineMarkerCalls;
+  return recoverNarratedActionToolCalls(text, availableToolNames);
+}
 function recoverNarratedActionToolCalls(text, availableToolNames) {
   const trimmed = text.trim();
   if (!trimmed) return [];
@@ -8817,6 +8929,106 @@ function buildFlightPriceEvidenceRecoveryPrompt(userMessage, assistantText, late
     `Last unsupported answer: ${assistantText.replace(/\s+/g, " ").trim().slice(0, 500) || "(empty)"}`
   ].join("\n");
 }
+const SEARCH_HISTORY_LIMIT = 4;
+function normalizeSearchToolQuery(name, args) {
+  if (name !== "search" && name !== "web_search") return null;
+  const raw = typeof args.query === "string" ? args.query : typeof args.text === "string" ? args.text : typeof args.term === "string" ? args.term : "";
+  const normalized = raw.replace(/\s+/g, " ").trim().toLowerCase();
+  return normalized || null;
+}
+function buildLatestStateReminder(toolResultPreview) {
+  const text = (toolResultPreview || "").trim();
+  if (!text) return "";
+  const existingReminder = text.match(
+    /\bLatest browser state:\s*URL\s+.+?(?:Trust the latest tool result over the initial page context\.|$)/i
+  )?.[0]?.trim();
+  if (existingReminder) return existingReminder;
+  const stateMatch = text.match(
+    /\[state:\s+url=([^,\]\n]+),\s+title=(?:"([^"]*)"|([^,\]\n]+))/i
+  );
+  if (stateMatch) {
+    const url = stateMatch[1]?.trim();
+    const title = (stateMatch[2] ?? stateMatch[3] ?? "").trim();
+    if (url) {
+      return `Latest browser state: URL ${url}${title ? `, title "${title}"` : ""}. Trust the latest tool result over the initial page context.`;
+    }
+  }
+  const structuredUrl = text.match(/\*\*URL:\*\*\s*([^\n]+)/i)?.[1]?.trim();
+  const structuredTitle = text.match(/\*\*Title:\*\*\s*([^\n]+)/i)?.[1]?.trim();
+  if (structuredUrl) {
+    return `Latest browser state: URL ${structuredUrl}${structuredTitle ? `, title "${structuredTitle}"` : ""}. Trust the latest tool result over the initial page context.`;
+  }
+  const navigatedUrl = text.match(
+    /\b(?:navigated to|went back to|went forward to|searched "[^"]+"(?: \(via search button\))? →)\s+([^\s\n]+)/i
+  )?.[1]?.trim() ?? text.match(
+    /\b(?:web\s+)?searched "[^"]+"[^\n]*?(?:->|→)\s+([^\s\n]+)/i
+  )?.[1]?.trim();
+  const pageTitle = text.match(/\bPage title:\s*([^\n]+)/i)?.[1]?.trim();
+  if (navigatedUrl) {
+    return `Latest browser state: URL ${navigatedUrl}${pageTitle ? `, title "${pageTitle}"` : ""}. Trust the latest tool result over the initial page context.`;
+  }
+  return "";
+}
+function buildRepeatedSearchError(previousTool, previousQuery, latestToolResultPreview, mode) {
+  const stateReminder = buildLatestStateReminder(latestToolResultPreview);
+  const lines = [
+    mode === "drifted" ? `Error: You already performed ${previousTool} successfully for this task.` : `Error: You already searched for "${previousQuery}" successfully with ${previousTool}.`,
+    mode === "drifted" ? `Do not rewrite or broaden the query with another ${previousTool}; use the current search results instead.` : `Do not search the same query again with ${previousTool} or its search/web_search alias; use the current search results instead.`,
+    `For named venues, businesses, organizations, schools, or local places, prefer opening the official site or clearly direct result from the current results page before answering. Do not switch to a site: restricted web_search when an official or direct result is already available.`,
+    `Take the next action from the results you already have: click a result, inspect a specific item, or provide the final answer to the user. Do not call any search tool again as preparation, and do not call read_page as preparation for another search.`
+  ];
+  if (stateReminder) {
+    lines.push(stateReminder);
+  }
+  return lines.join(" ");
+}
+class SearchLoopGuard {
+  recentSuccessfulSearchQueries = [];
+  recentSuccessfulSearchToolByQuery = /* @__PURE__ */ new Map();
+  lastSuccessfulWebSearchQuery = null;
+  isContextResettingTool;
+  constructor(isContextResettingTool) {
+    this.isContextResettingTool = isContextResettingTool;
+  }
+  /**
+   * Check whether a search/web_search call should be suppressed. Returns the
+   * details needed to build the corrective error, or null if the call is OK.
+   */
+  check(toolName, query) {
+    const isRepeatedSearchAcrossTools = query !== null && this.recentSuccessfulSearchQueries.includes(query);
+    const isQueryDriftedWebSearch = toolName === "web_search" && this.lastSuccessfulWebSearchQuery !== null && query !== null && query !== this.lastSuccessfulWebSearchQuery;
+    if (!isRepeatedSearchAcrossTools && !isQueryDriftedWebSearch) return null;
+    const mode = isRepeatedSearchAcrossTools ? "repeated" : "drifted";
+    const previousTool = isRepeatedSearchAcrossTools ? this.recentSuccessfulSearchToolByQuery.get(query ?? "") ?? (toolName === "web_search" ? "search" : "web_search") : "web_search";
+    const previousQuery = isRepeatedSearchAcrossTools ? query ?? "" : this.lastSuccessfulWebSearchQuery ?? "";
+    return { mode, previousTool, previousQuery };
+  }
+  /**
+   * Record a successfully executed tool. Search queries are added to the
+   * recent-history ring buffer, and real-progress tools clear the drift anchor
+   * so a later distinct search is not flagged as drift.
+   */
+  recordSuccess(toolName, query, wasSuccessful) {
+    if (wasSuccessful && this.isContextResettingTool(toolName)) {
+      this.lastSuccessfulWebSearchQuery = null;
+    }
+    if (wasSuccessful && query) {
+      if (!this.recentSuccessfulSearchQueries.includes(query)) {
+        this.recentSuccessfulSearchQueries.push(query);
+        this.recentSuccessfulSearchToolByQuery.set(query, toolName);
+        if (this.recentSuccessfulSearchQueries.length > SEARCH_HISTORY_LIMIT) {
+          const dropped = this.recentSuccessfulSearchQueries.shift();
+          if (dropped) {
+            this.recentSuccessfulSearchToolByQuery.delete(dropped);
+          }
+        }
+      }
+    }
+    if (wasSuccessful && toolName === "web_search" && query) {
+      this.lastSuccessfulWebSearchQuery = query;
+    }
+  }
+}
 const logger$v = createLogger("OpenAIProvider");
 function shouldDebugAgentLoop() {
   const value = process.env.VESSEL_DEBUG_AGENT_LOOP;
@@ -8886,7 +9098,7 @@ function buildOpenRouterAttributionHeaders() {
 function followUpReminderForProfile(profile, userMessage, assistantText, latestToolResultPreview) {
   if (profile !== "compact") return null;
   const phaseReminder = buildPhaseReminder(userMessage, assistantText || "");
-  const stateReminder = buildLatestStateReminder(latestToolResultPreview || "");
+  const stateReminder = buildLatestStateReminder(latestToolResultPreview);
   return {
     role: "user",
     content: `[System] Task reminder: Continue working on the user's original request until it is completed: ${userMessage}
@@ -8896,13 +9108,13 @@ ${phaseReminder}` : "")
   };
 }
 function extractSingleGoalDomain(goal) {
-  const matches = goal.toLowerCase().match(/\b(?:https?:\/\/)?(?:www\.)?([a-z0-9-]+\.(?:com|org|net|io|dev|app|ai|co|edu|gov))\b/g);
+  const matches = goal.toLowerCase().match(/\b(?:https?:\/\/)?(?:www\.)?([a-z0-9-]+\.[a-z]{2,})\b/g);
   if (!matches || matches.length !== 1) return null;
   return matches[0].replace(/^https?:\/\//, "").replace(/^www\./, "").toLowerCase();
 }
 function buildCompactRecoveryPrompt(userMessage, assistantText, latestToolResultPreview) {
   const phaseReminder = buildPhaseReminder(userMessage, assistantText);
-  const stateReminder = buildLatestStateReminder(latestToolResultPreview || "");
+  const stateReminder = buildLatestStateReminder(latestToolResultPreview);
   const goalDomain = extractSingleGoalDomain(userMessage);
   const latest = (latestToolResultPreview || "").toLowerCase();
   const assistant = assistantText.toLowerCase();
@@ -8999,38 +9211,7 @@ function buildPhaseReminder(userMessage, assistantText) {
   }
   return "";
 }
-function buildLatestStateReminder(toolResultPreview) {
-  const text = toolResultPreview.trim();
-  if (!text) return "";
-  const stateMatch = text.match(
-    /\[state:\s+url=([^,\]\n]+),\s+title=(?:"([^"]*)"|([^,\]\n]+))/i
-  );
-  if (stateMatch) {
-    const url = stateMatch[1]?.trim();
-    const title = (stateMatch[2] ?? stateMatch[3] ?? "").trim();
-    if (url) {
-      return `Latest browser state: URL ${url}${title ? `, title "${title}"` : ""}. Trust the latest tool result over the initial page context.`;
-    }
-  }
-  const structuredUrl = text.match(/\*\*URL:\*\*\s*([^\n]+)/i)?.[1]?.trim();
-  const structuredTitle = text.match(/\*\*Title:\*\*\s*([^\n]+)/i)?.[1]?.trim();
-  if (structuredUrl) {
-    return `Latest browser state: URL ${structuredUrl}${structuredTitle ? `, title "${structuredTitle}"` : ""}. Trust the latest tool result over the initial page context.`;
-  }
-  const navigatedUrl = text.match(/\b(?:navigated to|went back to|went forward to|searched "[^"]+"(?: \(via search button\))? →)\s+([^\s\n]+)/i)?.[1]?.trim();
-  const pageTitle = text.match(/\bPage title:\s*([^\n]+)/i)?.[1]?.trim();
-  if (navigatedUrl) {
-    return `Latest browser state: URL ${navigatedUrl}${pageTitle ? `, title "${pageTitle}"` : ""}. Trust the latest tool result over the initial page context.`;
-  }
-  return "";
-}
-function normalizedSearchToolQuery$1(name, args) {
-  if (name !== "search" && name !== "web_search") return null;
-  const raw = typeof args.query === "string" ? args.query : typeof args.text === "string" ? args.text : typeof args.term === "string" ? args.term : "";
-  const normalized = raw.replace(/\s+/g, " ").trim().toLowerCase();
-  return normalized || null;
-}
-function isOpenAIRealProgressToolForSearch(name) {
+function isSearchContextResettingTool(name) {
   return ![
     "read_page",
     "current_tab",
@@ -9043,18 +9224,6 @@ function isOpenAIRealProgressToolForSearch(name) {
     "search"
   ].includes(name);
 }
-function buildOpenAIRepeatedSearchError(previousTool, previousQuery, latestToolResultPreview, mode) {
-  const stateReminder = buildLatestStateReminder(latestToolResultPreview || "");
-  const lines = [
-    mode === "drifted" ? `Error: You already performed ${previousTool} successfully for this task.` : `Error: You already searched for "${previousQuery}" successfully with ${previousTool}.`,
-    mode === "drifted" ? `Do not rewrite or broaden the query with another ${previousTool}; use the current search results instead.` : `Do not search the same query again with ${previousTool} or its search/web_search alias; use the current search results instead.`,
-    `For named venues, businesses, organizations, schools, or local places, prefer opening the official site or clearly direct result from the current results page before answering. Do not switch to a site: restricted web_search when an official or direct result is already available. Next action: click a result, inspect a specific result, or answer from the result you already opened. Do not call any search tool again as preparation.`
-  ];
-  if (stateReminder) {
-    lines.push(stateReminder);
-  }
-  return lines.join(" ");
-}
 function shouldRecoverCompactStall(text, userMessage) {
   const trimmed = text.trim().toLowerCase();
   if (!trimmed) return true;
@@ -9138,15 +9307,24 @@ function logAgentLoopDebug(payload) {
   }
 }
 function formatOpenAICompatErrorMessage(providerId, message) {
-  if (providerId === "openrouter" && /(timed out after \d+(?:\.\d+)? seconds|request timed out|returned none after all retries|no content|empty response)/i.test(
+  if (providerId === "openrouter" && /(timed out after \d+(?:\.\d+)? seconds|request timed out|returned none after all retries|returned no content|empty response)/i.test(
     message
   )) {
-    return `${message} OpenRouter reported an upstream model timeout/no-content failure. If this persists, retry or pin a specific low-latency tool-calling model instead of the free router.`;
+    return [
+      message,
+      "OpenRouter reported an upstream model timeout/no-content failure.",
+      "If this persists, retry or pin a specific low-latency tool-calling model instead of the free router."
+    ].join(" ");
   }
   if (providerId === "llama_cpp" && /(available context size|context size exceeded|exceeds the available context size|try increasing it)/i.test(
     message
   )) {
-    return `${message} llama.cpp sets context size at server startup, not per request. Vessel's agent prompt plus tool schema is about 6.5k tokens before browsing history, so run llama-server with --ctx-size ${LLAMA_CPP_MIN_CTX_TOKENS} minimum (${LLAMA_CPP_RECOMMENDED_CTX_TOKENS} recommended).`;
+    return [
+      message,
+      "llama.cpp sets context size at server startup, not per request.",
+      `Vessel's agent prompt plus tool schema is about 6.5k tokens before browsing history, so run llama-server with`,
+      `--ctx-size ${LLAMA_CPP_MIN_CTX_TOKENS} minimum (${LLAMA_CPP_RECOMMENDED_CTX_TOKENS} recommended).`
+    ].join(" ");
   }
   return message;
 }
@@ -9256,9 +9434,7 @@ class OpenAICompatProvider {
       const recentCompactToolSignatures = [];
       const recentToolNames = [];
       const successfulToolNames = [];
-      const recentSuccessfulSearchQueries = [];
-      const recentSuccessfulSearchToolByQuery = /* @__PURE__ */ new Map();
-      let lastSuccessfulWebSearchQuery = null;
+      const searchLoopGuard = new SearchLoopGuard(isSearchContextResettingTool);
       let clickReadLoopNudged = false;
       for (let i = 0; i < maxIterations; i++) {
         iterationsUsed = i + 1;
@@ -9334,22 +9510,13 @@ class OpenAICompatProvider {
           tc.name = resolveToolCallName(tc.name, parsedArgs, availableToolNames);
         }
         if (toolCalls.length === 0) {
-          const recoveredToolCalls = recoverTextEncodedToolCalls(
+          const recoveredToolCalls = recoverAssistantTextToolCalls(
             textAccum,
             availableToolNames
           );
           if (recoveredToolCalls.length > 0) {
             toolCalls = recoveredToolCalls;
             if (textAccum.trim()) onChunk("<<erase_prev>>");
-          } else {
-            const narratedToolCalls = recoverNarratedActionToolCalls(
-              textAccum,
-              availableToolNames
-            );
-            if (narratedToolCalls.length > 0) {
-              toolCalls = narratedToolCalls;
-              if (textAccum.trim()) onChunk("<<erase_prev>>");
-            }
           }
         }
         logAgentLoopDebug({
@@ -9493,24 +9660,20 @@ class OpenAICompatProvider {
           args = repairedArgs.args;
           args = coerceToolArgsForExecution(tc.name, args);
           const toolSignature = stableToolSignature(tc.name, args);
-          const searchToolQuery = normalizedSearchToolQuery$1(tc.name, args);
-          const isRepeatedSearchAcrossTools = searchToolQuery !== null && recentSuccessfulSearchQueries.includes(searchToolQuery);
-          const isQueryDriftedWebSearch = tc.name === "web_search" && lastSuccessfulWebSearchQuery !== null && searchToolQuery !== null && searchToolQuery !== lastSuccessfulWebSearchQuery;
-          if (isRepeatedSearchAcrossTools || isQueryDriftedWebSearch) {
+          const searchToolQuery = normalizeSearchToolQuery(tc.name, args);
+          const searchLoopCheck = searchLoopGuard.check(tc.name, searchToolQuery);
+          if (searchLoopCheck) {
             onChunk(`
 <<tool:${tc.name}:↻ duplicate suppressed>>
 `);
-            const previousTool = isRepeatedSearchAcrossTools ? recentSuccessfulSearchToolByQuery.get(searchToolQuery ?? "") ?? (tc.name === "web_search" ? "search" : "web_search") : "web_search";
-            const previousQuery = isRepeatedSearchAcrossTools ? searchToolQuery ?? "" : lastSuccessfulWebSearchQuery ?? "";
-            const mode = isRepeatedSearchAcrossTools ? "repeated" : "drifted";
             messages.push({
               role: "tool",
               tool_call_id: tc.id,
-              content: buildOpenAIRepeatedSearchError(
-                previousTool,
-                previousQuery,
+              content: buildRepeatedSearchError(
+                searchLoopCheck.previousTool,
+                searchLoopCheck.previousQuery,
                 latestToolMessage ? String(latestToolMessage.content || "") : null,
-                mode
+                searchLoopCheck.mode
               )
             });
             compactCorrectionCount += 1;
@@ -9590,25 +9753,15 @@ class OpenAICompatProvider {
               recentCompactToolSignatures.shift();
             }
           }
-          if (!/^Error:/i.test(toolContent.trim())) {
+          const toolSucceeded = !/^Error:/i.test(toolContent.trim());
+          if (toolSucceeded) {
             successfulToolNames.push(tc.name);
-            if (isOpenAIRealProgressToolForSearch(tc.name)) {
-              lastSuccessfulWebSearchQuery = null;
-            }
-            if (searchToolQuery && !recentSuccessfulSearchQueries.includes(searchToolQuery)) {
-              recentSuccessfulSearchQueries.push(searchToolQuery);
-              recentSuccessfulSearchToolByQuery.set(searchToolQuery, tc.name);
-              if (recentSuccessfulSearchQueries.length > 4) {
-                const dropped = recentSuccessfulSearchQueries.shift();
-                if (dropped) {
-                  recentSuccessfulSearchToolByQuery.delete(dropped);
-                }
-              }
-            }
-            if (tc.name === "web_search" && searchToolQuery) {
-              lastSuccessfulWebSearchQuery = searchToolQuery;
-            }
           }
+          searchLoopGuard.recordSuccess(
+            tc.name,
+            searchToolQuery,
+            toolSucceeded
+          );
           recentToolNames.push(tc.name);
           if (recentToolNames.length > 8) recentToolNames.shift();
           if (!clickReadLoopNudged && recentToolNames.length >= 6 && isClickReadLoop(recentToolNames)) {
@@ -10138,59 +10291,13 @@ function previewToolResult(text, maxLength = 800) {
   if (normalized.length <= maxLength) return normalized;
   return `${normalized.slice(0, maxLength)}...`;
 }
-function normalizedSearchToolQuery(name, args) {
-  if (name !== "search" && name !== "web_search") return null;
-  const raw = typeof args.query === "string" ? args.query : typeof args.text === "string" ? args.text : typeof args.term === "string" ? args.term : "";
-  const normalized = raw.replace(/\s+/g, " ").trim().toLowerCase();
-  return normalized || null;
-}
 function hasBlockingOverlaySignal(text) {
   if (!text) return false;
   if (/\bno blocking overlays detected\b/i.test(text)) return false;
   return /\bwarning:\s*blocking overlay detected\b/i.test(text) || /\bblocked-by-overlay\b/i.test(text) || /###\s*immediate blockers\b/i.test(text) || /\bblocking overlays\W+[1-9]\d*\b/i.test(text);
 }
-function buildCodexLatestStateReminder(toolResultPreview) {
-  const text = (toolResultPreview || "").trim();
-  if (!text) return "";
-  const existingReminder = text.match(
-    /\bLatest browser state:\s*URL\s+.+?(?:Trust the latest tool result over the initial page context\.|$)/i
-  )?.[0]?.trim();
-  if (existingReminder) return existingReminder;
-  const stateMatch = text.match(
-    /\[state:\s+url=([^,\]\n]+),\s+title=(?:"([^"]*)"|([^,\]\n]+))/i
-  );
-  if (stateMatch) {
-    const url = stateMatch[1]?.trim();
-    const title = (stateMatch[2] ?? stateMatch[3] ?? "").trim();
-    if (url) {
-      return `Latest browser state: URL ${url}${title ? `, title "${title}"` : ""}. Trust the latest tool result over the initial page context.`;
-    }
-  }
-  const navigatedUrl = text.match(/\b(?:navigated to|went back to|went forward to)\s+([^\s\n]+)/i)?.[1]?.trim() ?? text.match(/\b(?:web\s+)?searched "[^"]+"[^\n]*?(?:->|→)\s+([^\s\n]+)/i)?.[1]?.trim();
-  const pageTitle = text.match(/\bPage title:\s*([^\n]+)/i)?.[1]?.trim();
-  if (navigatedUrl) {
-    return `Latest browser state: URL ${navigatedUrl}${pageTitle ? `, title "${pageTitle}"` : ""}. Trust the latest tool result over the initial page context.`;
-  }
-  return "";
-}
-function buildCodexRepeatedSearchError(previousTool, previousQuery, latestToolResultPreview, mode) {
-  const stateReminder = buildCodexLatestStateReminder(latestToolResultPreview);
-  const header = mode === "drifted" ? `Error: You already performed ${previousTool} successfully for this task.` : `Error: You already searched for "${previousQuery}" successfully with ${previousTool}.`;
-  const lines = [
-    header,
-    mode === "drifted" ? `Do not rewrite or broaden the query with another ${previousTool}. The latest results from your previous ${previousTool} are already in the conversation context.` : `Do not search the same query again with ${previousTool} (or its alias search/web_search). The latest results from your previous ${previousTool} are already in the conversation context.`,
-    // The key change: do NOT suggest read_page as a "recovery" action.
-    // The model was using read_page as a no-op to reset the strike counter
-    // and then issue another web_search. The prior results are sufficient.
-    `Take the next action from the results you already have: click a result link, call inspect_element on a specific item, highlight, or provide the final answer to the user. Do not call any search tool again, and do not call read_page as preparation for another search.`
-  ];
-  if (stateReminder) {
-    lines.push(stateReminder);
-  }
-  return lines.join(" ");
-}
 function buildCodexUnsupportedClearOverlayError(latestToolResultPreview) {
-  const stateReminder = buildCodexLatestStateReminder(latestToolResultPreview);
+  const stateReminder = buildLatestStateReminder(latestToolResultPreview);
   const lines = [
     `Error: No blocking overlay signal is present in the latest browser state.`,
     `Do not call clear_overlays unless read_page or the page context explicitly reports a blocking overlay.`,
@@ -10310,7 +10417,7 @@ function shouldRetryCodexToolLoop(text, hasToolHistory) {
   return false;
 }
 function buildCodexRecoveryInput(userMessage, assistantText, latestToolResultPreview) {
-  const stateReminder = buildCodexLatestStateReminder(latestToolResultPreview);
+  const stateReminder = buildLatestStateReminder(latestToolResultPreview);
   const lines = [
     `[System] The task is still in progress: ${userMessage}`,
     `Do not ask the user what they want next unless the original request is genuinely ambiguous or blocked.`,
@@ -10343,7 +10450,7 @@ function buildCodexFlightPriceEvidenceRecoveryInput(userMessage, assistantText,
   };
 }
 function buildCodexFailedClickRecoveryInput(attemptedTarget, latestToolResultPreview, failedClickCount = 1) {
-  const stateReminder = buildCodexLatestStateReminder(latestToolResultPreview);
+  const stateReminder = buildLatestStateReminder(latestToolResultPreview);
   const lines = [
     `[System] The previous click did not complete${attemptedTarget ? ` for ${attemptedTarget}` : ""}.`,
     `Take the next step yourself: try a different target, refresh the page state with read_page, call inspect_element on the intended element, or answer from the results already visible in the conversation. Do not ask the user to inspect or click the result for you.`
@@ -10562,9 +10669,7 @@ class CodexProvider {
     let clickReadLoopNudged = false;
     let latestToolResultPreview = null;
     let failedClickCountSinceProgress = 0;
-    const recentSuccessfulSearchQueries = [];
-    const recentSuccessfulSearchToolByQuery = /* @__PURE__ */ new Map();
-    let lastSuccessfulWebSearchQuery = null;
+    const searchLoopGuard = new SearchLoopGuard(isRealProgressTool);
     try {
       for (let i = 0; i < maxIterations; i++) {
         iterationsUsed = i + 1;
@@ -10585,11 +10690,10 @@ class CodexProvider {
           (item) => item.type === "function_call"
         );
         if (functionCalls.length === 0) {
-          const recoveredTextCalls = recoverTextEncodedToolCalls(
+          const recoveredCalls = recoverAssistantTextToolCalls(
             result.text,
             availableToolNames
           );
-          const recoveredCalls = recoveredTextCalls.length > 0 ? recoveredTextCalls : recoverNarratedActionToolCalls(result.text, availableToolNames);
           if (recoveredCalls.length > 0) {
             if (result.text.trim()) onChunk("<<erase_prev>>");
             functionCalls = recoveredCalls.map((toolCall) => ({
@@ -10654,30 +10758,29 @@ class CodexProvider {
             prepared.prepared.name,
             prepared.prepared.args
           );
-          const searchToolQuery = normalizedSearchToolQuery(
+          const searchToolQuery = normalizeSearchToolQuery(
             prepared.prepared.name,
             prepared.prepared.args
           );
-          const isRepeatedSearchAcrossTools = searchToolQuery !== null && recentSuccessfulSearchQueries.includes(searchToolQuery);
-          const isQueryDriftedWebSearch = prepared.prepared.name === "web_search" && lastSuccessfulWebSearchQuery !== null && searchToolQuery !== null && searchToolQuery !== lastSuccessfulWebSearchQuery;
+          const searchLoopCheck = searchLoopGuard.check(
+            prepared.prepared.name,
+            searchToolQuery
+          );
           const isUnsupportedClearOverlay = prepared.prepared.name === "clear_overlays" && !hasBlockingOverlaySignal(
             `${systemPrompt}
 ${latestToolResultPreview || ""}`
           );
-          if (isRepeatedSearchAcrossTools || isQueryDriftedWebSearch) {
+          if (searchLoopCheck) {
             onChunk(`
 <<tool:${prepared.prepared.name}:↻ duplicate suppressed>>
 `);
-            const previousTool = isRepeatedSearchAcrossTools ? recentSuccessfulSearchToolByQuery.get(searchToolQuery ?? "") ?? (prepared.prepared.name === "web_search" ? "search" : "web_search") : "web_search";
-            const previousQuery = isRepeatedSearchAcrossTools ? searchToolQuery ?? "" : lastSuccessfulWebSearchQuery ?? "";
-            const mode = isRepeatedSearchAcrossTools ? "repeated" : "drifted";
             const output2 = createCodexToolOutput(
               prepared.prepared.callId,
-              buildCodexRepeatedSearchError(
-                previousTool,
-                previousQuery,
+              buildRepeatedSearchError(
+                searchLoopCheck.previousTool,
+                searchLoopCheck.previousQuery,
                 latestToolResultPreview,
-                mode
+                searchLoopCheck.mode
               )
             );
             currentInput.push(output2);
@@ -10731,30 +10834,15 @@ ${latestToolResultPreview || ""}`
           toolHistoryCount += 1;
           latestToolResultPreview = previewToolResult(output.output);
           const outputText = toolResultTextContent(output.output);
-          if (!looksLikeFailedToolOutput(outputText)) {
-            if (isRealProgressTool(prepared.prepared.name)) {
-              lastSuccessfulWebSearchQuery = null;
-              failedClickCountSinceProgress = 0;
-            }
-          }
-          if (searchToolQuery && !looksLikeFailedToolOutput(outputText) && !recentSuccessfulSearchQueries.includes(searchToolQuery)) {
-            recentSuccessfulSearchQueries.push(searchToolQuery);
-            recentSuccessfulSearchToolByQuery.set(
-              searchToolQuery,
-              prepared.prepared.name
-            );
-            if (recentSuccessfulSearchQueries.length > 4) {
-              const dropped = recentSuccessfulSearchQueries.shift();
-              if (dropped) {
-                recentSuccessfulSearchToolByQuery.delete(dropped);
-              }
-            }
-          }
-          if (prepared.prepared.name === "web_search" && !looksLikeFailedToolOutput(outputText)) {
-            if (searchToolQuery) {
-              lastSuccessfulWebSearchQuery = searchToolQuery;
-            }
+          const toolSucceeded = !looksLikeFailedToolOutput(outputText);
+          if (toolSucceeded && isRealProgressTool(prepared.prepared.name)) {
+            failedClickCountSinceProgress = 0;
           }
+          searchLoopGuard.recordSuccess(
+            prepared.prepared.name,
+            searchToolQuery,
+            toolSucceeded
+          );
           if (prepared.prepared.name === "click" && looksLikeFailedToolOutput(outputText)) {
             failedClickCountSinceProgress += 1;
             currentInput.push(
@@ -12711,17 +12799,23 @@ function formatCartSnapshot(page) {
 function isVisibleToUser(el) {
   return el.visible === true && el.inViewport === true && el.obscured !== true && el.blockedByOverlay !== true;
 }
+function elementSearchText(el, extraFields = []) {
+  const fields = [
+    el.text,
+    el.label,
+    el.name,
+    el.placeholder,
+    el.description,
+    el.href,
+    ...extraFields.map((field) => el[field])
+  ];
+  return normalizeComparable(fields.filter(Boolean).join(" "));
+}
+function formatElementOptions(options, maxOptions) {
+  return options?.slice(0, maxOptions).map((o) => typeof o === "string" ? o : o.label || o.value).join("|") ?? "";
+}
 function purchaseActionPriority(el) {
-  const haystack = normalizeComparable(
-    [
-      el.text,
-      el.label,
-      el.name,
-      el.placeholder,
-      el.description,
-      el.href
-    ].filter(Boolean).join(" ")
-  );
+  const haystack = elementSearchText(el);
   if (!haystack) return Number.POSITIVE_INFINITY;
   if (/\badd(?: item)? to (?:cart|bag|basket)\b/.test(haystack)) return 0;
   if (/\b(?:buy now|preorder|pre-order|reserve now|shop now)\b/.test(haystack)) {
@@ -12733,17 +12827,7 @@ function purchaseActionPriority(el) {
   return Number.POSITIVE_INFINITY;
 }
 function dateOrShowtimeControlPriority(el) {
-  const haystack = normalizeComparable(
-    [
-      el.text,
-      el.label,
-      el.name,
-      el.placeholder,
-      el.description,
-      el.href,
-      el.role
-    ].filter(Boolean).join(" ")
-  );
+  const haystack = elementSearchText(el, ["role"]);
   if (!haystack) return Number.POSITIVE_INFINITY;
   if (/\b(today|tomorrow|mon(?:day)?|tue(?:s|sday)?|wed(?:nesday)?|thu(?:rs|rsday)?|fri(?:day)?|sat(?:urday)?|sun(?:day)?)\b/.test(
     haystack
@@ -12852,24 +12936,34 @@ function formatDialogFocus(page) {
 }
 function formatInteractiveElements(elements) {
   if (elements.length === 0) return "None";
+  const DIALOG_PRIORITY_BONUS = 40;
+  const HIDDEN_VISIBILITY_PENALTY = 100;
+  const OFFSCREEN_PENALTY = 50;
+  const NAVIGATION_CONTEXT_PENALTY = 30;
+  const OBSCURED_PENALTY = 20;
+  const LINK_TYPE_PENALTY = 5;
+  const PURCHASE_BASE_WEIGHT = 25;
+  const PURCHASE_PRIORITY_MULTIPLIER = 5;
+  const DATE_BASE_WEIGHT = 18;
+  const DATE_PRIORITY_MULTIPLIER = 4;
   const sorted = [...elements].sort((a, b) => {
     const scoreEl = (el) => {
       let s = 0;
-      if (el.context === "dialog") s -= 40;
+      if (el.context === "dialog") s -= DIALOG_PRIORITY_BONUS;
       const purchasePriority = purchaseActionPriority(el);
       if (Number.isFinite(purchasePriority)) {
-        s -= 25 - purchasePriority * 5;
+        s -= PURCHASE_BASE_WEIGHT - purchasePriority * PURCHASE_PRIORITY_MULTIPLIER;
       }
       const datePriority = dateOrShowtimeControlPriority(el);
       if (Number.isFinite(datePriority)) {
-        s -= 18 - datePriority * 4;
+        s -= DATE_BASE_WEIGHT - datePriority * DATE_PRIORITY_MULTIPLIER;
       }
-      if (el.visible === false) s += 100;
-      if (el.inViewport === false) s += 50;
+      if (el.visible === false) s += HIDDEN_VISIBILITY_PENALTY;
+      if (el.inViewport === false) s += OFFSCREEN_PENALTY;
       if (el.context === "nav" || el.context === "footer" || el.context === "sidebar")
-        s += 30;
-      if (el.obscured) s += 20;
-      if (el.type === "link") s += 5;
+        s += NAVIGATION_CONTEXT_PENALTY;
+      if (el.obscured) s += OBSCURED_PENALTY;
+      if (el.type === "link") s += LINK_TYPE_PENALTY;
       return s;
     };
     return scoreEl(a) - scoreEl(b);
@@ -12901,9 +12995,7 @@ function formatInteractiveElements(elements) {
       appendFieldAffordances(parts, el);
       if (el.options?.length) {
         const maxOptions = isDateOrShowtimeControl(el) ? 10 : 5;
-        parts.push(
-          `options=${el.options.slice(0, maxOptions).map((o) => typeof o === "string" ? o : o.label || o.value).join("|")}`
-        );
+        parts.push(`options=${formatElementOptions(el.options, maxOptions)}`);
       }
     } else if (el.type === "textarea") {
       parts.push(`[${el.label || "Text Area"}]`);
@@ -12966,7 +13058,7 @@ function formatForms(forms) {
           if (field.options?.length) {
             const maxOptions = isDateOrShowtimeControl(field) ? 10 : 5;
             fieldParts.push(
-              `options=${field.options.slice(0, maxOptions).map((o) => typeof o === "string" ? o : o.label || o.value).join("|")}`
+              `options=${formatElementOptions(field.options, maxOptions)}`
             );
           }
         } else if (field.type === "textarea") {
@@ -13231,26 +13323,10 @@ function chooseAgentReadMode(page) {
       return "visible_only";
   }
 }
-function isSearchOrListingPage(page) {
-  if (isHackerNewsListingPage(page.url)) return true;
-  const haystack = normalizeComparable(
-    [
-      page.url,
-      page.title,
-      page.excerpt,
-      page.headings.map((heading) => heading.text).join(" ")
-    ].filter(Boolean).join(" ")
-  );
-  return /\b(search|results|find|discover|browse|repositories|repository|issues|pull requests|prs|users|events|listings)\b/.test(
-    haystack
-  );
-}
-function isHackerNewsListingPage(url) {
-  try {
-    const parsed = new URL(url);
-    if (parsed.hostname !== "news.ycombinator.com") return false;
-    const pathname = parsed.pathname.replace(/\/+$/, "") || "/";
-    return [
+const SITE_RESULT_FILTERS = [
+  {
+    hostname: "news.ycombinator.com",
+    listingPaths: [
       "/",
       "/news",
       "/newest",
@@ -13262,30 +13338,62 @@ function isHackerNewsListingPage(url) {
       "/active",
       "/classic",
       "/noobstories"
-    ].includes(pathname);
-  } catch {
-    return false;
+    ],
+    utilityPathnames: ["/hide", "/user"],
+    utilityTextPatterns: [
+      /^(hide|past|favorite|unfavorite|flag|unflag|discuss|reply|parent|more)$/,
+      /^\d+\s+(?:comments?|points?)$/
+    ]
   }
-}
-function isHackerNewsUtilityLink(element) {
-  if (!element.href) return false;
-  let url;
+];
+function matchesSiteFilter(url, filter, baseHostname) {
   try {
-    url = new URL(element.href);
+    const parsed = new URL(url, baseHostname ? `https://${baseHostname}` : void 0);
+    return parsed.hostname === filter.hostname;
   } catch {
     return false;
   }
-  if (url.hostname !== "news.ycombinator.com") return false;
-  const text = normalizeComparable(element.text || "");
-  const pathname = url.pathname.replace(/\/+$/, "") || "/";
-  if (/^(hide|past|favorite|unfavorite|flag|unflag|discuss|reply|parent|more)$/.test(
-    text
-  )) {
-    return true;
+}
+function isSiteListingPage(url) {
+  for (const filter of SITE_RESULT_FILTERS) {
+    if (!matchesSiteFilter(url, filter, "")) continue;
+    try {
+      const pathname = new URL(url).pathname.replace(/\/+$/, "") || "/";
+      if (filter.listingPaths?.includes(pathname)) return true;
+    } catch {
+    }
+  }
+  return false;
+}
+function isSiteUtilityLink(element) {
+  if (!element.href) return false;
+  for (const filter of SITE_RESULT_FILTERS) {
+    if (!matchesSiteFilter(element.href, filter, "")) continue;
+    const text = normalizeComparable(element.text || "");
+    for (const pattern of filter.utilityTextPatterns ?? []) {
+      if (pattern.test(text)) return true;
+    }
+    try {
+      const pathname = new URL(element.href).pathname.replace(/\/+$/, "") || "/";
+      if (filter.utilityPathnames?.includes(pathname)) return true;
+    } catch {
+    }
   }
-  if (/^\d+\s+(?:comments?|points?)$/.test(text)) return true;
-  if (pathname === "/hide" || pathname === "/user") return true;
-  return pathname === "/item" && /^(?:discuss|\d+\s+comments?)$/.test(text);
+  return false;
+}
+function isSearchOrListingPage(page) {
+  if (isSiteListingPage(page.url)) return true;
+  const haystack = normalizeComparable(
+    [
+      page.url,
+      page.title,
+      page.excerpt,
+      page.headings.map((heading) => heading.text).join(" ")
+    ].filter(Boolean).join(" ")
+  );
+  return /\b(search|results|find|discover|browse|repositories|repository|issues|pull requests|prs|users|events|listings)\b/.test(
+    haystack
+  );
 }
 function collectJsonLdEntityItems(input, results = []) {
   if (!input) return results;
@@ -13326,7 +13434,7 @@ function getResultCandidates(page) {
   const pageHost = normalizeUrlForMatch(page.url);
   const searchOrListingPage = isSearchOrListingPage(page);
   const scored = page.interactiveElements.filter(
-    (element) => element.type === "link" && element.text?.trim() && element.href && !isHackerNewsUtilityLink(element)
+    (element) => element.type === "link" && element.text?.trim() && element.href && !isSiteUtilityLink(element)
   ).map((element) => {
     const text = element.text?.trim() || "";
     const comparableText = normalizeComparable(text);
@@ -13786,7 +13894,7 @@ function detectPageType(page) {
   if (hasResults && hasSearchInput && listingLike) return "SEARCH_RESULTS";
   if (hasCart) return "SHOPPING";
   if (formCount > 0 && !hasPasswordField) return "FORM";
-  if (isHackerNewsListingPage(page.url)) return "PAGINATED_LIST";
+  if (isSiteListingPage(page.url)) return "PAGINATED_LIST";
   if (hasPagination && listingLike) return "PAGINATED_LIST";
   if (hasSearchInput && !listingLike) return "SEARCH_READY";
   if (page.content.length > 3e3 && page.interactiveElements.length < 10)
@@ -23306,7 +23414,10 @@ Recent checkpoints:
 ${input.recentCheckpoints || "- none"}
 
 Task tracker:
-${input.taskTrackerContext || "- none"}`;
+${input.taskTrackerContext || "- none"}
+
+Task memory:
+${input.taskMemoryContext || "- none"}`;
 }
 function buildAgentSystemPrompt(input) {
   const instructionBlocks = input.profile === "compact" ? [
@@ -23687,6 +23798,7 @@ async function handleAIQuery(query, provider, activeWebContents, onChunk, onEnd,
       const runtimeState = runtime2.getState();
       const recentCheckpoints = runtimeState.checkpoints.slice(-3).map((item) => `- ${item.name} (${item.id})`).join("\n");
       const taskTrackerContext = runtime2.getTaskTrackerContext();
+      const taskMemoryContext = runtime2.getTaskMemoryContext();
       const activeTabTitle = pageContent.title || "(untitled)";
       const activeTabUrl = pageContent.url || activeWebContents.getURL();
       const allTabs = tabManager.getAllStates();
@@ -23705,7 +23817,8 @@ All open tabs: ${allTabs.map((t) => `${t.id === activeTabId ? "→ " : ""}${t.ti
         approvalMode: runtimeState.supervisor.approvalMode,
         pendingApprovals: runtimeState.supervisor.pendingApprovals.length,
         recentCheckpoints: recentCheckpoints || "- none",
-        taskTrackerContext: taskTrackerContext || "- none"
+        taskTrackerContext: taskTrackerContext || "- none",
+        taskMemoryContext: taskMemoryContext || "- none"
       });
       const actionCtx = {
         tabManager,
@@ -24305,6 +24418,17 @@ function setMcpHealth(update) {
 }
 const ApprovalModeSchema = zod.z.enum(["auto", "confirm-dangerous", "manual"]);
 const CheckpointIdSchema = zod.z.string().min(1);
+const TaskTextSchema = zod.z.string().trim().min(1).max(2e4);
+const OptionalTaskTextSchema = zod.z.string().trim().max(2e4).optional();
+const OptionalNullableTaskTextSchema = zod.z.string().trim().max(2e4).nullable().optional();
+const TaskFactsSchema = zod.z.record(
+  zod.z.string().trim().min(1).max(200),
+  zod.z.string().max(2e4)
+);
+const TaskMemoryPatchSchema = zod.z.object({
+  nextStep: OptionalNullableTaskTextSchema,
+  facts: TaskFactsSchema.optional()
+});
 function registerAgentRuntimeHandlers(runtime2, chromeView, sidebarView, sendToRendererViews) {
   let runtimeUpdateTimer = null;
   let pendingRuntimeState = null;
@@ -24397,6 +24521,45 @@ function registerAgentRuntimeHandlers(runtime2, chromeView, sidebarView, sendToR
       return runtime2.restoreSession(snapshot2);
     }
   );
+  electron.ipcMain.handle(Channels.AGENT_TASK_START, (event, goal) => {
+    assertTrustedIpcSender(event);
+    return runtime2.startTaskMemory(parseIpc(TaskTextSchema, goal, "goal"));
+  });
+  electron.ipcMain.handle(
+    Channels.AGENT_TASK_UPDATE,
+    (event, patch) => {
+      assertTrustedIpcSender(event);
+      return runtime2.updateTaskMemory(
+        parseIpc(TaskMemoryPatchSchema, patch ?? {}, "patch")
+      );
+    }
+  );
+  electron.ipcMain.handle(Channels.AGENT_TASK_NOTE, (event, text) => {
+    assertTrustedIpcSender(event);
+    return runtime2.addTaskNote(parseIpc(TaskTextSchema, text, "text"));
+  });
+  electron.ipcMain.handle(Channels.AGENT_TASK_BLOCKER, (event, blocker) => {
+    assertTrustedIpcSender(event);
+    const validated = blocker == null ? null : parseIpc(OptionalNullableTaskTextSchema, blocker, "blocker");
+    return runtime2.setTaskBlocker(validated ?? null);
+  });
+  electron.ipcMain.handle(Channels.AGENT_TASK_RESOLVE, (event, summary) => {
+    assertTrustedIpcSender(event);
+    return runtime2.resolveTaskMemory(
+      summary == null ? void 0 : parseIpc(OptionalTaskTextSchema, summary, "summary")
+    );
+  });
+  electron.ipcMain.handle(Channels.AGENT_TASK_ABANDON, (event, reason) => {
+    assertTrustedIpcSender(event);
+    return runtime2.abandonTaskMemory(
+      reason == null ? void 0 : parseIpc(OptionalTaskTextSchema, reason, "reason")
+    );
+  });
+  electron.ipcMain.handle(Channels.AGENT_TASK_CLEAR, (event) => {
+    assertTrustedIpcSender(event);
+    runtime2.clearTaskMemory();
+    return null;
+  });
 }
 function asTextResponse$1(text) {
   return { content: [{ type: "text", text }] };
@@ -28123,6 +28286,137 @@ ${flow.steps.map((s, i) => `  ${i === 0 ? "→" : " "} ${s.label}`).join("\n")}`
     }
   );
 }
+function registerTaskMemoryTools(server, _tabManager, runtime2) {
+  server.registerTool(
+    "task_start",
+    {
+      title: "Start Task",
+      description: "Start tracking a task. Creates a task memory record with a goal that persists across actions and browser navigation. Use this at the beginning of a multi-step task so the human supervisor can see what you are working on.",
+      inputSchema: {
+        goal: zod.z.string().describe("What this task aims to accomplish"),
+        nextStep: zod.z.string().optional().describe("The first step you plan to take"),
+        facts: zod.z.record(zod.z.string()).optional().describe("Key-value facts relevant to this task (e.g. { username: alice })")
+      }
+    },
+    async ({ goal, nextStep, facts }) => {
+      const task = runtime2.startTaskMemory(goal, {
+        nextStep: nextStep ?? null,
+        facts: facts ?? {}
+      });
+      return asTextResponse(
+        `Task started: ${task.goal}
+Status: ${task.status}${task.nextStep ? `
+Next step: ${task.nextStep}` : ""}`
+      );
+    }
+  );
+  server.registerTool(
+    "task_update",
+    {
+      title: "Update Task",
+      description: "Update the current task's next step or facts. Facts are merged with existing facts. Use this to record progress and keep the human supervisor informed.",
+      inputSchema: {
+        nextStep: zod.z.string().optional().describe("The next step you plan to take"),
+        facts: zod.z.record(zod.z.string()).optional().describe("Key-value facts to merge into the task (existing keys are overwritten)")
+      }
+    },
+    async ({ nextStep, facts }) => {
+      const updated = runtime2.updateTaskMemory({
+        nextStep,
+        facts
+      });
+      if (!updated) return asTextResponse("No active task to update. Start one with task_start first.");
+      return asTextResponse(
+        `Task updated: ${updated.goal}
+Status: ${updated.status}${updated.nextStep ? `
+Next step: ${updated.nextStep}` : ""}${Object.keys(updated.facts).length > 0 ? `
+Facts: ${Object.entries(updated.facts).map(([k, v]) => `${k}=${v}`).join(", ")}` : ""}`
+      );
+    }
+  );
+  server.registerTool(
+    "task_note",
+    {
+      title: "Add Task Note",
+      description: "Add a note to the current task. Use this to record observations, intermediate results, or context for the human supervisor.",
+      inputSchema: {
+        text: zod.z.string().describe("The note text to add")
+      }
+    },
+    async ({ text }) => {
+      const updated = runtime2.addTaskNote(text);
+      if (!updated) return asTextResponse("No active task to add a note to. Start one with task_start first.");
+      return asTextResponse(`Note added to task: ${updated.goal}`);
+    }
+  );
+  server.registerTool(
+    "task_blocker",
+    {
+      title: "Set or Clear Task Blocker",
+      description: "Mark the task as blocked with a reason, or clear a blocker to resume. Use this when you are stuck and need human input to continue.",
+      inputSchema: {
+        blocker: zod.z.string().optional().describe("Description of what is blocking progress. Omit or empty string to clear a blocker.")
+      }
+    },
+    async ({ blocker }) => {
+      const updated = runtime2.setTaskBlocker(blocker?.trim() || null);
+      if (!updated) return asTextResponse("No active task. Start one with task_start first.");
+      if (updated.blocker) {
+        return asTextResponse(`Task blocked: ${updated.blocker}
+Status: ${updated.status}`);
+      }
+      return asTextResponse(`Blocker cleared. Task: ${updated.goal}
+Status: ${updated.status}`);
+    }
+  );
+  server.registerTool(
+    "task_resolve",
+    {
+      title: "Resolve Task",
+      description: "Mark the current task as completed. Optionally add a summary note. Use this when the task goal has been achieved.",
+      inputSchema: {
+        summary: zod.z.string().optional().describe("Brief summary of the completed task")
+      }
+    },
+    async ({ summary }) => {
+      const resolved = runtime2.resolveTaskMemory(summary);
+      if (!resolved) return asTextResponse("No active task to resolve. Start one with task_start first.");
+      return asTextResponse(
+        `Task completed: ${resolved.goal}${resolved.notes.length > 0 ? `
+Notes: ${resolved.notes.length} note(s)` : ""}`
+      );
+    }
+  );
+  server.registerTool(
+    "task_abandon",
+    {
+      title: "Abandon Task",
+      description: "Mark the current task as abandoned. Use this when the task cannot be completed or is no longer relevant.",
+      inputSchema: {
+        reason: zod.z.string().optional().describe("Reason for abandoning the task")
+      }
+    },
+    async ({ reason }) => {
+      const abandoned = runtime2.abandonTaskMemory(reason);
+      if (!abandoned) return asTextResponse("No active task to abandon. Start one with task_start first.");
+      return asTextResponse(
+        `Task abandoned: ${abandoned.goal}${reason ? ` (${reason})` : ""}`
+      );
+    }
+  );
+  server.registerTool(
+    "task_status",
+    {
+      title: "Task Status",
+      description: "Check the current task memory status including goal, progress, notes, and blocker."
+    },
+    async () => {
+      const ctx = runtime2.getTaskMemoryContext();
+      if (!ctx) return asTextResponse("No active task. Start one with task_start.");
+      return asTextResponse(ctx);
+    }
+  );
+}
 function registerMacroTools(server, tabManager, runtime2) {
   server.registerTool(
     "fill_form",
@@ -29423,6 +29717,7 @@ function registerTools(server, tabManager, runtime2) {
   registerSessionTools(server, tabManager, runtime2);
   registerMemoryTools(server, tabManager, runtime2);
   registerFlowTools(server, tabManager, runtime2);
+  registerTaskMemoryTools(server, tabManager, runtime2);
   registerMacroTools(server, tabManager, runtime2);
   registerVaultTools(server, tabManager);
   registerMetricsTools(server, tabManager, runtime2);
@@ -32666,6 +32961,121 @@ function formatTaskTracker(state2) {
 ${lines.join("\n")}
 ---`;
 }
+function createTaskMemory(goal, options = {}) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    id: crypto$1.randomUUID(),
+    goal: goal.trim(),
+    status: "active",
+    blocker: null,
+    notes: [],
+    nextStep: options.nextStep?.trim() || null,
+    facts: { ...options.facts ?? {} },
+    startedAt: now,
+    updatedAt: now,
+    completedAt: null
+  };
+}
+function updateTaskMemory(task, patch) {
+  const updated = {
+    ...task,
+    nextStep: patch.nextStep !== void 0 ? patch.nextStep : task.nextStep,
+    facts: {
+      ...task.facts,
+      ...patch.facts ?? {}
+    },
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  return updated;
+}
+function addTaskNote(task, text) {
+  const note = {
+    id: crypto$1.randomUUID(),
+    text: text.trim(),
+    createdAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const notes = [...task.notes, note].slice(-50);
+  return {
+    ...task,
+    notes,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function setTaskBlocker(task, blocker) {
+  const status = blocker ? "blocked" : task.status === "blocked" ? "active" : task.status;
+  return {
+    ...task,
+    status,
+    blocker,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function resolveTaskMemory(task, summary) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  let notes = task.notes;
+  if (summary?.trim()) {
+    const note = {
+      id: crypto$1.randomUUID(),
+      text: summary.trim(),
+      createdAt: now
+    };
+    notes = [...task.notes, note].slice(-50);
+  }
+  return {
+    ...task,
+    status: "completed",
+    blocker: null,
+    notes,
+    completedAt: now,
+    updatedAt: now
+  };
+}
+function abandonTaskMemory(task, reason) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  let notes = task.notes;
+  if (reason?.trim()) {
+    const note = {
+      id: crypto$1.randomUUID(),
+      text: `Abandoned: ${reason.trim()}`,
+      createdAt: now
+    };
+    notes = [...task.notes, note].slice(-50);
+  }
+  return {
+    ...task,
+    status: "abandoned",
+    blocker: null,
+    notes,
+    completedAt: now,
+    updatedAt: now
+  };
+}
+function formatTaskMemory(task) {
+  if (!task) return "";
+  const lines = [
+    "--- Task Memory ---",
+    `Goal: ${task.goal}`,
+    `Status: ${task.status}${task.blocker ? ` (blocked: ${task.blocker})` : ""}`
+  ];
+  if (task.nextStep) {
+    lines.push(`Next step: ${task.nextStep}`);
+  }
+  if (Object.keys(task.facts).length > 0) {
+    lines.push("Facts:");
+    for (const [key2, value] of Object.entries(task.facts)) {
+      lines.push(`  ${key2}: ${value}`);
+    }
+  }
+  if (task.notes.length > 0) {
+    lines.push("Notes:");
+    for (const note of task.notes.slice(-10)) {
+      const time = note.createdAt.slice(11, 16);
+      lines.push(`  [${time}] ${note.text}`);
+    }
+  }
+  lines.push("---");
+  return lines.join("\n");
+}
 const MAX_TRANSCRIPT_TEXT_LENGTH = 8e3;
 const PERSIST_DEBOUNCE_MS = 500;
 const INTERRUPTED_ACTION_STATUSES = /* @__PURE__ */ new Set([
@@ -32695,6 +33105,7 @@ function getRuntimeStatePath() {
 }
 function sanitizePersistence(persisted) {
   const recoveredAt = (/* @__PURE__ */ new Date()).toISOString();
+  const persistedTaskMemory = persisted?.taskMemory?.completedAt ? null : persisted?.taskMemory ?? null;
   const actions = Array.isArray(persisted?.actions) ? persisted.actions.slice(-120).map(
     (action) => INTERRUPTED_ACTION_STATUSES.has(action.status) ? {
       ...action,
@@ -32716,7 +33127,8 @@ function sanitizePersistence(persisted) {
     transcript: [],
     mcpStatus: "stopped",
     flowState: null,
-    taskTracker: null
+    taskTracker: null,
+    taskMemory: persistedTaskMemory
   };
 }
 class AgentRuntime {
@@ -32803,7 +33215,8 @@ class AgentRuntime {
       name: name?.trim() || `Checkpoint ${this.state.checkpoints.length + 1}`,
       createdAt: (/* @__PURE__ */ new Date()).toISOString(),
       note: note?.trim() || void 0,
-      snapshot: snapshot2
+      snapshot: snapshot2,
+      taskMemory: this.state.taskMemory ? clone(this.state.taskMemory) : null
     };
     this.state.checkpoints = [...this.state.checkpoints, checkpoint].slice(
       -20
@@ -32816,6 +33229,7 @@ class AgentRuntime {
     const checkpoint = this.state.checkpoints.find((item) => item.id === checkpointId) || null;
     if (!checkpoint) return null;
     this.tabManager.restoreSession(checkpoint.snapshot);
+    this.state.taskMemory = checkpoint.taskMemory ? clone(checkpoint.taskMemory) : null;
     this.captureSession(`Restored ${checkpoint.name}`);
     return clone(checkpoint);
   }
@@ -32932,6 +33346,54 @@ class AgentRuntime {
   getTaskTrackerContext() {
     return formatTaskTracker(this.state.taskTracker);
   }
+  // --- Task Memory ---
+  startTaskMemory(goal, options) {
+    this.state.taskMemory = createTaskMemory(goal, options);
+    this.emit();
+    return clone(this.state.taskMemory);
+  }
+  updateTaskMemory(patch) {
+    if (!this.state.taskMemory || this.state.taskMemory.completedAt) return null;
+    this.state.taskMemory = updateTaskMemory(this.state.taskMemory, patch);
+    this.emit();
+    return clone(this.state.taskMemory);
+  }
+  addTaskNote(text) {
+    if (!this.state.taskMemory || this.state.taskMemory.completedAt) return null;
+    this.state.taskMemory = addTaskNote(this.state.taskMemory, text);
+    this.emit();
+    return clone(this.state.taskMemory);
+  }
+  setTaskBlocker(blocker) {
+    if (!this.state.taskMemory || this.state.taskMemory.completedAt) return null;
+    this.state.taskMemory = setTaskBlocker(
+      this.state.taskMemory,
+      blocker
+    );
+    this.emit();
+    return clone(this.state.taskMemory);
+  }
+  resolveTaskMemory(summary) {
+    if (!this.state.taskMemory || this.state.taskMemory.completedAt) return null;
+    const resolved = resolveTaskMemory(this.state.taskMemory, summary);
+    this.state.taskMemory = null;
+    this.emit();
+    return clone(resolved);
+  }
+  abandonTaskMemory(reason) {
+    if (!this.state.taskMemory || this.state.taskMemory.completedAt) return null;
+    const abandoned = abandonTaskMemory(this.state.taskMemory, reason);
+    this.state.taskMemory = null;
+    this.emit();
+    return clone(abandoned);
+  }
+  clearTaskMemory() {
+    this.state.taskMemory = null;
+    this.emit();
+  }
+  getTaskMemoryContext() {
+    return formatTaskMemory(this.state.taskMemory);
+  }
   // --- Speedee Flow State ---
   startFlow(goal, steps, startUrl) {
     const flow = {
@@ -33157,7 +33619,8 @@ ${progress}
         lastError: this.state.supervisor.lastError
       },
       actions: this.state.actions.slice(-120),
-      checkpoints: this.state.checkpoints.slice(-20)
+      checkpoints: this.state.checkpoints.slice(-20),
+      taskMemory: this.state.taskMemory
     };
     return fs$1.promises.mkdir(path.dirname(getRuntimeStatePath()), { recursive: true }).then(
       () => fs$1.promises.writeFile(