Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
changed the threshold for compaction
Saurav Panda6b9910a5466e
diff --git a/browser_use/agent/message_manager/service.py b/browser_use/agent/message_manager/service.pyindex 7f4726e21..bfdf06fe7 100644--- a/browser_use/agent/message_manager/service.py+++ b/browser_use/agent/message_manager/service.py@@ -189,16 +189,11 @@ class MessageManager:sensitive_data=None,) -> None:"""Prepare state for the next LLM call without building the final state message."""- # Clear contextual messages from previous steps to prevent accumulationself.state.history.context_messages.clear()-- # Update the agent history items with the latest step resultsself._update_agent_history_description(model_output, result, step_info)- # Update sensitive data description for this pageeffective_sensitive_data = sensitive_data if sensitive_data is not None else self.sensitive_dataif effective_sensitive_data is not None:- # Update instance variable to keep it in syncself.sensitive_data = effective_sensitive_dataself.sensitive_data_description = self._get_sensitive_data_description(browser_state_summary.url)@@ -208,45 +203,32 @@ class MessageManager:settings: MessageCompactionSettings | None,step_info: AgentStepInfo | None = None,) -> bool:- """Compact message history into a short memory block when thresholds are exceeded."""+ """Summarize older history into a compact memory block.++ Step interval is the primary trigger; char count is a minimum floor.+ """if not settings or not settings.enabled:return Falseif llm is None:- logger.debug('Message compaction enabled but no LLM provided; skipping.')return False-- # Respect cooldown to avoid repeated compaction loops- if (- step_info is not None- and self.state.last_compaction_step is not None- and step_info.step_number - self.state.last_compaction_step < settings.cooldown_steps- ):+ if step_info is None:return False- history_items = self.state.agent_history_items- if settings.min_history_items and len(history_items) < settings.min_history_items:+ # Step cadence gate+ steps_since = step_info.step_number - (self.state.last_compaction_step or 0)+ if steps_since < settings.compact_every_n_steps:return False+ # Char floor gate+ history_items = self.state.agent_history_itemsfull_history_text = '\n'.join(item.to_string() for item in history_items).strip()- current_char_count = len(full_history_text)- # trigger_char_count is always resolved to an int by the model validator- trigger_char_count = settings.trigger_char_count or 250000- if current_char_count < trigger_char_count:+ trigger_char_count = settings.trigger_char_count or 40000+ if len(full_history_text) < trigger_char_count:return False- # After the first compaction, only re-trigger when history has grown by at least- # trigger_char_count beyond the post-compaction baseline. This prevents a cycle- # where verbose retained items immediately re-trigger compaction after cooldown.- if self.state.post_compaction_char_count > 0:- growth = current_char_count - self.state.post_compaction_char_count- if growth < trigger_char_count:- return False+ logger.debug(f'Compacting message history (items={len(history_items)}, chars={len(full_history_text)})')- logger.debug(- f'Compacting message history (items={len(history_items)}, chars={len(full_history_text)})'- )-- # Build compaction input, optionally including prior compacted memory+ # Build compaction inputcompaction_sections = []if self.state.compacted_memory:compaction_sections.append(@@ -257,7 +239,6 @@ class MessageManager:compaction_sections.append(f'<read_state>\n{self.state.read_state_description}\n</read_state>')compaction_input = '\n\n'.join(compaction_sections)- # Filter sensitive data before sending to LLMif self.sensitive_data:filtered = self._filter_sensitive_data(UserMessage(content=compaction_input))compaction_input = filtered.text@@ -280,7 +261,6 @@ class MessageManager:return Falseif not summary:- logger.debug('Message compaction produced empty summary; skipping.')return Falseif settings.summary_max_chars and len(summary) > settings.summary_max_chars:@@ -288,10 +268,9 @@ class MessageManager:self.state.compacted_memory = summaryself.state.compaction_count += 1- if step_info is not None:- self.state.last_compaction_step = step_info.step_number+ self.state.last_compaction_step = step_info.step_number- # Trim history to keep only the first item and the most recent items+ # Keep first item + most recent itemskeep_last = max(0, settings.keep_last_items)if len(history_items) > keep_last + 1:if keep_last == 0:@@ -299,13 +278,7 @@ class MessageManager:else:self.state.agent_history_items = [history_items[0]] + history_items[-keep_last:]- # Record post-compaction char count so we only re-trigger after meaningful growth- post_text = '\n'.join(item.to_string() for item in self.state.agent_history_items).strip()- self.state.post_compaction_char_count = len(post_text)-- logger.debug(- f'Compaction complete (summary_chars={len(summary)}, history_items={len(self.state.agent_history_items)})'- )+ logger.debug(f'Compaction complete (summary_chars={len(summary)}, history_items={len(self.state.agent_history_items)})')return Truediff --git a/browser_use/agent/message_manager/views.py b/browser_use/agent/message_manager/views.pyindex 9bab41777..1b11fbbc3 100644--- a/browser_use/agent/message_manager/views.py+++ b/browser_use/agent/message_manager/views.py@@ -97,6 +97,5 @@ class MessageManagerState(BaseModel):compacted_memory: str | None = Nonecompaction_count: int = 0last_compaction_step: int | None = None- post_compaction_char_count: int = 0 # History char count right after last compaction; used to gate re-triggersmodel_config = ConfigDict(arbitrary_types_allowed=True)diff --git a/browser_use/agent/views.py b/browser_use/agent/views.pyindex 8eaaf3f17..bbef9d9e5 100644--- a/browser_use/agent/views.py+++ b/browser_use/agent/views.py@@ -32,36 +32,26 @@ logger = logging.getLogger(__name__)class MessageCompactionSettings(BaseModel):- """Configuration options for message compaction.-- Thresholds can be specified as either char count or token count (not both).- Token counts are converted to char counts using chars_per_token as a rough- approximation — we deliberately avoid provider-specific tokenizers to keep- dependencies light. The default of ~4 chars/token is a reasonable average- for English text; set lower (~3) for code-heavy workloads.- """+ """Summarizes older history into a compact memory block to reduce prompt size."""enabled: bool = True- trigger_char_count: int | None = None # Trigger when history exceeds this many chars; set via trigger_token_count if preferred- trigger_token_count: int | None = None # Trigger when history exceeds this many estimated tokens- chars_per_token: float = 4.0 # Rough chars-per-token ratio for token estimation- min_history_items: int = 12+ compact_every_n_steps: int = 15+ trigger_char_count: int | None = None # Min char floor; set via trigger_token_count if preferred+ trigger_token_count: int | None = None # Alternative to trigger_char_count (~4 chars/token)+ chars_per_token: float = 4.0keep_last_items: int = 6summary_max_chars: int = 6000- cooldown_steps: int = 3include_read_state: bool = Falsecompaction_llm: BaseChatModel | None = None@model_validator(mode='after')def _resolve_trigger_threshold(self) -> MessageCompactionSettings:- """Resolve trigger_char_count from trigger_token_count if needed."""if self.trigger_char_count is not None and self.trigger_token_count is not None:raise ValueError('Set trigger_char_count or trigger_token_count, not both.')if self.trigger_token_count is not None:self.trigger_char_count = int(self.trigger_token_count * self.chars_per_token)elif self.trigger_char_count is None:- # Default: ~62k tokens worth of chars- self.trigger_char_count = 250000+ self.trigger_char_count = 40000 # ~10k tokensreturn self