openhands-sdk 1.3.0__py3-none-any.whl → 1.4.1__py3-none-any.whl

openhands/sdk/llm/utils/model_features.py

@@ -24,6 +24,7 @@ class ModelFeatures:
     supports_responses_api: bool
     force_string_serializer: bool
     send_reasoning_content: bool
+    supports_prompt_cache_retention: bool
 
 
 # Pattern tables capturing current behavior. Keep patterns lowercase.
@@ -68,6 +69,14 @@ PROMPT_CACHE_PATTERNS: list[str] = [
     "claude-opus-4-5",
 ]
 
+# Models that support a top-level prompt_cache_retention parameter
+PROMPT_CACHE_RETENTION_PATTERNS: list[str] = [
+    # OpenAI GPT-5+ family
+    "gpt-5",
+    # GPT-4.1 too
+    "gpt-4.1",
+]
+
 SUPPORTS_STOP_WORDS_FALSE_PATTERNS: list[str] = [
     # o-series families don't support stop words
     "o1",
@@ -118,6 +127,9 @@ def get_features(model: str) -> ModelFeatures:
         supports_responses_api=model_matches(model, RESPONSES_API_PATTERNS),
         force_string_serializer=model_matches(model, FORCE_STRING_SERIALIZER_PATTERNS),
         send_reasoning_content=model_matches(model, SEND_REASONING_CONTENT_PATTERNS),
+        supports_prompt_cache_retention=model_matches(
+            model, PROMPT_CACHE_RETENTION_PATTERNS
+        ),
     )
 
 

openhands/sdk/logger/logger.py

@@ -105,7 +105,14 @@ def setup_logging(
     keep = ENV_BACKUP_COUNT if backup_count is None else backup_count
 
     root = logging.getLogger()
+    old_level = root.level
     root.setLevel(lvl)
+
+    # Set the level for any existing logger with the same intial level
+    for logger in logging.root.manager.loggerDict.values():
+        if isinstance(logger, logging.Logger) and logger.level == old_level:
+            logger.setLevel(lvl)
+
     # Do NOT clear existing handlers; Uvicorn installs these before importing the app.
     # Only add ours if there isn't already a comparable stream handler.
     has_stream = any(isinstance(h, logging.StreamHandler) for h in root.handlers)

openhands/sdk/tool/tool.py

@@ -440,7 +440,24 @@ class ToolDefinition[ActionT, ObservationT](DiscriminatedUnionMixin, ABC):
         for subclass in get_known_concrete_subclasses(cls):
             if subclass.__name__ == kind:
                 return subclass
-        raise ValueError(f"Unknown kind '{kind}' for {cls}")
+
+        # Get all possible kinds for the error message
+        possible_kinds = [
+            subclass.__name__ for subclass in get_known_concrete_subclasses(cls)
+        ]
+        possible_kinds_str = (
+            ", ".join(sorted(possible_kinds)) if possible_kinds else "none"
+        )
+
+        error_msg = (
+            f"Unexpected kind '{kind}' for {cls.__name__}. "
+            f"Expected one of: {possible_kinds_str}. "
+            f"If you receive this error when trying to wrap a DiscriminatedUnion "
+            f"instance inside another pydantic model, you may need to use "
+            f"OpenHandsModel instead of BaseModel to make sure that an invalid "
+            f"schema has not been cached."
+        )
+        raise ValueError(error_msg)
 
 
 def _create_action_type_with_risk(action_type: type[Schema]) -> type[Schema]:

openhands/sdk/utils/models.py

@@ -3,7 +3,7 @@ import json
 import logging
 import os
 from abc import ABC
-from typing import Annotated, Any, ClassVar, Literal, Self, Union
+from typing import Annotated, Any, ClassVar, Literal, NoReturn, Self, Union
 
 from pydantic import (
     BaseModel,
@@ -11,7 +11,9 @@ from pydantic import (
     Field,
     Tag,
     TypeAdapter,
+    ValidationError,
 )
+from pydantic_core import ErrorDetails
 
 
 logger = logging.getLogger(__name__)
@@ -56,6 +58,48 @@ def kind_of(obj) -> str:
     return obj.__name__
 
 
+def _create_enhanced_discriminated_union_error_message(
+    invalid_kind: str, cls_name: str, valid_kinds: list[str]
+) -> str:
+    """Create an enhanced error message for discriminated union validation failures."""
+    possible_kinds_str = ", ".join(sorted(valid_kinds)) if valid_kinds else "none"
+    return (
+        f"Unexpected kind '{invalid_kind}' for {cls_name}. "
+        f"Expected one of: {possible_kinds_str}. "
+        f"If you receive this error when trying to wrap a "
+        f"DiscriminatedUnion instance inside another pydantic model, "
+        f"you may need to use OpenHandsModel instead of BaseModel "
+        f"to make sure that an invalid schema has not been cached."
+    )
+
+
+def _extract_invalid_kind_from_validation_error(error: ErrorDetails) -> str:
+    """Extract the invalid kind from a Pydantic validation error."""
+    input_value = error.get("input")
+    if input_value is not None and hasattr(input_value, "kind"):
+        return input_value.kind
+    elif isinstance(input_value, dict) and "kind" in input_value:
+        return input_value["kind"]
+    else:
+        return kind_of(input_value)
+
+
+def _handle_discriminated_union_validation_error(
+    validation_error: ValidationError, cls_name: str, valid_kinds: list[str]
+) -> NoReturn:
+    """Handle discriminated union validation errors with enhanced messages."""
+    for error in validation_error.errors():
+        if error.get("type") == "union_tag_invalid":
+            invalid_kind = _extract_invalid_kind_from_validation_error(error)
+            error_msg = _create_enhanced_discriminated_union_error_message(
+                invalid_kind, cls_name, valid_kinds
+            )
+            raise ValueError(error_msg) from validation_error
+
+    # If it's not a discriminated union error, re-raise the original error
+    raise validation_error
+
+
 def get_known_concrete_subclasses(cls) -> list[type]:
     """Recursively returns all concrete subclasses in a stable order,
     without deduping classes that share the same (module, name)."""
@@ -137,7 +181,15 @@ class DiscriminatedUnionMixin(OpenHandsModel, ABC):
         for subclass in get_known_concrete_subclasses(cls):
             if subclass.__name__ == kind:
                 return subclass
-        raise ValueError(f"Unknown kind '{kind}' for {cls}")
+
+        # Generate enhanced error message for unknown kind
+        valid_kinds = [
+            subclass.__name__ for subclass in get_known_concrete_subclasses(cls)
+        ]
+        error_msg = _create_enhanced_discriminated_union_error_message(
+            kind, cls.__name__, valid_kinds
+        )
+        raise ValueError(error_msg)
 
     @classmethod
     def __get_pydantic_core_schema__(cls, source_type, handler):
@@ -150,7 +202,30 @@ class DiscriminatedUnionMixin(OpenHandsModel, ABC):
             serializable_type = source_type.get_serializable_type()
             # If there are subclasses, generate schema for the discriminated union
             if serializable_type is not source_type:
-                return handler.generate_schema(serializable_type)
+                from pydantic_core import core_schema
+
+                # Generate the base schema
+                base_schema = handler.generate_schema(serializable_type)
+
+                # Wrap it with a custom validation function that provides
+                # enhanced error messages
+                def validate_with_enhanced_error(value, handler_func, info):  # noqa: ARG001
+                    try:
+                        return handler_func(value)
+                    except ValidationError as e:
+                        valid_kinds = [
+                            subclass.__name__
+                            for subclass in get_known_concrete_subclasses(source_type)
+                        ]
+                        _handle_discriminated_union_validation_error(
+                            e, source_type.__name__, valid_kinds
+                        )
+
+                # Create a with_info_wrap_validator_function schema
+                return core_schema.with_info_wrap_validator_function(
+                    validate_with_enhanced_error,
+                    base_schema,
+                )
 
         return handler(source_type)
 
@@ -241,12 +316,18 @@ class DiscriminatedUnionMixin(OpenHandsModel, ABC):
 
     @classmethod
     def model_validate(cls, obj: Any, **kwargs) -> Self:
-        if _is_abstract(cls):
-            resolved = cls.resolve_kind(kind_of(obj))
-        else:
-            resolved = super()
-        result = resolved.model_validate(obj, **kwargs)
-        return result  # type: ignore
+        try:
+            if _is_abstract(cls):
+                resolved = cls.resolve_kind(kind_of(obj))
+            else:
+                resolved = super()
+            result = resolved.model_validate(obj, **kwargs)
+            return result  # type: ignore
+        except ValidationError as e:
+            valid_kinds = [
+                subclass.__name__ for subclass in get_known_concrete_subclasses(cls)
+            ]
+            _handle_discriminated_union_validation_error(e, cls.__name__, valid_kinds)
 
     @classmethod
     def model_validate_json(

openhands/sdk/utils/truncate.py

@@ -1,5 +1,13 @@
 """Utility functions for truncating text content."""
 
+import hashlib
+from pathlib import Path
+
+from openhands.sdk.logger import get_logger
+
+
+logger = get_logger(__name__)
+
 # Default truncation limits
 DEFAULT_TEXT_CONTENT_LIMIT = 50_000
 
@@ -7,38 +15,103 @@ DEFAULT_TEXT_CONTENT_LIMIT = 50_000
 DEFAULT_TRUNCATE_NOTICE = (
     "<response clipped><NOTE>Due to the max output limit, only part of the full "
     "response has been shown to you.</NOTE>"
+)  # 113 chars
+
+DEFAULT_TRUNCATE_NOTICE_WITH_PERSIST = (
+    "<response clipped><NOTE>Due to the max output limit, only part of the full "
+    "response has been shown to you. The complete output has been saved to "
+    "{file_path} - you can use other tools to view the full content (truncated "
+    "part starts around line {line_num}).</NOTE>"
 )
 
 
+def _save_full_content(content: str, save_dir: str, tool_prefix: str) -> str | None:
+    """Save full content to the specified directory and return the file path."""
+
+    save_dir_path = Path(save_dir)
+    save_dir_path.mkdir(exist_ok=True)
+
+    # Generate hash-based filename for deduplication
+    content_hash = hashlib.sha256(content.encode("utf-8")).hexdigest()[:8]
+    filename = f"{tool_prefix}_output_{content_hash}.txt"
+    file_path = save_dir_path / filename
+
+    # Only write if file doesn't exist (deduplication)
+    if not file_path.exists():
+        try:
+            file_path.write_text(content, encoding="utf-8")
+        except Exception as e:
+            logger.debug(f"Failed to save full content to {file_path}: {e}")
+            return None
+
+    return str(file_path)
+
+
 def maybe_truncate(
     content: str,
     truncate_after: int | None = None,
     truncate_notice: str = DEFAULT_TRUNCATE_NOTICE,
+    save_dir: str | None = None,
+    tool_prefix: str = "output",
 ) -> str:
     """
     Truncate the middle of content if it exceeds the specified length.
 
     Keeps the head and tail of the content to preserve context at both ends.
+    Optionally saves the full content to a file for later investigation.
 
     Args:
         content: The text content to potentially truncate
         truncate_after: Maximum length before truncation. If None, no truncation occurs
         truncate_notice: Notice to insert in the middle when content is truncated
+        save_dir: Working directory to save full content file in
+        tool_prefix: Prefix for the saved file (e.g., "bash", "browser", "editor")
 
     Returns:
         Original content if under limit, or truncated content with head and tail
-        preserved
+        preserved and reference to saved file if applicable
     """
+    # 1) Early exits: no truncation requested, or content already within limit
     if not truncate_after or len(content) <= truncate_after or truncate_after < 0:
         return content
 
-    # Calculate how much space we have for actual content
+    # 2) If even the base notice doesn't fit, return a slice of it
+    if len(truncate_notice) >= truncate_after:
+        return truncate_notice[:truncate_after]
+
+    # 3) Calculate proposed head size based on base notice
+    # (for consistent line number calc)
     available_chars = truncate_after - len(truncate_notice)
-    half = available_chars // 2
+    # Prefer giving the "extra" char to head (ceil split)
+    proposed_head = available_chars // 2 + (available_chars % 2)
+
+    # 4) Optionally save full content, then construct the final notice
+    final_notice = truncate_notice
+    if save_dir:
+        saved_file_path = _save_full_content(content, save_dir, tool_prefix)
+        if saved_file_path:
+            # Calculate line number where truncation happens (using head_chars)
+            head_content_lines = len(content[:proposed_head].splitlines())
+
+            final_notice = DEFAULT_TRUNCATE_NOTICE_WITH_PERSIST.format(
+                file_path=saved_file_path,
+                line_num=head_content_lines + 1,  # +1 to indicate next line
+            )
+
+    # 5) If the final notice (with persist info) alone fills the
+    # budget, return a slice of it
+    if len(final_notice) >= truncate_after:
+        return final_notice[:truncate_after]
 
-    # Give extra character to head if odd number
-    head_chars = half + (available_chars % 2)
-    tail_chars = half
+    # 6) Allocate remaining budget to head/tail
+    remaining = truncate_after - len(final_notice)
+    head_chars = min(
+        proposed_head, remaining
+    )  # Ensure head_chars doesn't exceed remaining
+    tail_chars = remaining - head_chars  # non-negative due to previous checks
 
-    # Keep head and tail, insert notice in the middle
-    return content[:head_chars] + truncate_notice + content[-tail_chars:]
+    return (
+        content[:head_chars]
+        + final_notice
+        + (content[-tail_chars:] if tail_chars > 0 else "")
+    )

openhands/sdk/workspace/__init__.py

@@ -1,6 +1,6 @@
 from .base import BaseWorkspace
 from .local import LocalWorkspace
-from .models import CommandResult, FileOperationResult
+from .models import CommandResult, FileOperationResult, PlatformType, TargetType
 from .remote import RemoteWorkspace
 from .workspace import Workspace
 
@@ -10,6 +10,8 @@ __all__ = [
     "CommandResult",
     "FileOperationResult",
     "LocalWorkspace",
+    "PlatformType",
     "RemoteWorkspace",
+    "TargetType",
     "Workspace",
 ]

openhands/sdk/workspace/models.py

@@ -1,8 +1,14 @@
-"""Pydantic models for workspace operation results."""
+"""Pydantic models for workspace operation results and build types."""
+
+from typing import Literal
 
 from pydantic import BaseModel, Field
 
 
+TargetType = Literal["binary", "binary-minimal", "source", "source-minimal"]
+PlatformType = Literal["linux/amd64", "linux/arm64"]
+
+
 class CommandResult(BaseModel):
     """Result of executing a command in the workspace."""
 

openhands/sdk/workspace/remote/async_remote_workspace.py

@@ -15,11 +15,32 @@ class AsyncRemoteWorkspace(RemoteWorkspaceMixin):
 
     _client: httpx.AsyncClient | None = PrivateAttr(default=None)
 
+    async def reset_client(self) -> None:
+        """Reset the HTTP client to force re-initialization.
+
+        This is useful when connection parameters (host, api_key) have changed
+        and the client needs to be recreated with new values.
+        """
+        if self._client is not None:
+            try:
+                await self._client.aclose()
+            except Exception:
+                pass
+        self._client = None
+
     @property
     def client(self) -> httpx.AsyncClient:
         client = self._client
         if client is None:
-            client = httpx.AsyncClient(base_url=self.host)
+            # Configure reasonable timeouts for HTTP requests
+            # - connect: 10 seconds to establish connection
+            # - read: 60 seconds to read response (for LLM operations)
+            # - write: 10 seconds to send request
+            # - pool: 10 seconds to get connection from pool
+            timeout = httpx.Timeout(connect=10.0, read=60.0, write=10.0, pool=10.0)
+            client = httpx.AsyncClient(
+                base_url=self.host, timeout=timeout, headers=self._headers
+            )
             self._client = client
         return client
 

openhands/sdk/workspace/remote/base.py

@@ -30,6 +30,19 @@ class RemoteWorkspace(RemoteWorkspaceMixin, BaseWorkspace):
 
     _client: httpx.Client | None = PrivateAttr(default=None)
 
+    def reset_client(self) -> None:
+        """Reset the HTTP client to force re-initialization.
+
+        This is useful when connection parameters (host, api_key) have changed
+        and the client needs to be recreated with new values.
+        """
+        if self._client is not None:
+            try:
+                self._client.close()
+            except Exception:
+                pass
+        self._client = None
+
     @property
     def client(self) -> httpx.Client:
         client = self._client

{openhands_sdk-1.3.0.dist-info → openhands_sdk-1.4.1.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: openhands-sdk
-Version: 1.3.0
+Version: 1.4.1
 Summary: OpenHands SDK - Core functionality for building AI agents
 Requires-Python: >=3.12
 Requires-Dist: deprecation>=2.1.0
 Requires-Dist: fastmcp>=2.11.3
 Requires-Dist: httpx>=0.27.0
-Requires-Dist: litellm>=1.77.7.dev9
+Requires-Dist: litellm>=1.80.7
 Requires-Dist: pydantic>=2.11.7
 Requires-Dist: python-frontmatter>=1.1.0
 Requires-Dist: python-json-logger>=3.3.0

{openhands_sdk-1.3.0.dist-info → openhands_sdk-1.4.1.dist-info}/RECORD

@@ -1,20 +1,20 @@
-openhands/sdk/__init__.py,sha256=fs0eN6b9WXrjyP0g1N4Ms_ThlYnYrS4i861lZhmTvU8,2284
+openhands/sdk/__init__.py,sha256=SsB5acHhWvF6e3FlbR72PzZHH9ByJiXc7vnwxBPqmhw,2374
 openhands/sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 openhands/sdk/agent/__init__.py,sha256=yOn1ZCgTTq2VJlTzKDSzmWVPli1siBzqV89vlEHCwOg,137
-openhands/sdk/agent/agent.py,sha256=UX1FK5DhL0vwPYKqWKAN4Noz59cX_MTC3EtFpNbJTkU,18217
-openhands/sdk/agent/base.py,sha256=dG0dzZKioQIVVw0g6ARwZzP76eI4MW0tgP4bHw_-bPI,15517
-openhands/sdk/agent/utils.py,sha256=U3C1GnX3xEuCT3hp1zbm25vFas3QhQ6zhb1HbPjEIS8,7158
+openhands/sdk/agent/agent.py,sha256=y8jfExyzgP898_Vr_Fz75Ovg2XTnkNQTgekdOi2S58I,19516
+openhands/sdk/agent/base.py,sha256=HmZ_wNXdbsStqxjgkylGFm9B0pkp-0MCjmFTyh_XenM,15780
+openhands/sdk/agent/utils.py,sha256=alYsAQ611XQ_94ogJacYD22BLbgSJjzd3Xex_b9KuC4,7418
 openhands/sdk/agent/prompts/in_context_learning_example.j2,sha256=MGB0dPUlh6pwLoR_dBK-M3e5dtETX6C6WNjPcPixZmU,5512
 openhands/sdk/agent/prompts/in_context_learning_example_suffix.j2,sha256=k3Zwnd7Iq7kL4lo307RDuu1mxWXn6pSLsEdvKEXN3BU,164
 openhands/sdk/agent/prompts/security_policy.j2,sha256=K56d2aaZ88DI-y2DsMSDaiZRTTnkkzuBLjbzXfKHGA8,993
 openhands/sdk/agent/prompts/security_risk_assessment.j2,sha256=7o1tk6MIQpVD7sAES-sBhw4ckYLGQydzYnjjNitP5iY,1196
-openhands/sdk/agent/prompts/system_prompt.j2,sha256=JTFd07yBCZa0dIE3iQ5ZIgWNNySBoiTaNqk5fukHivo,8546
+openhands/sdk/agent/prompts/system_prompt.j2,sha256=Cdi9eDy5el1mp5IXlJqr3aqsgRYt3p6yC0Wgw1E8NFQ,7979
 openhands/sdk/agent/prompts/system_prompt_interactive.j2,sha256=AW3rGuqu82BqbS1XMXVO4Fp-Apa8DPYZV3_nQYkzVtM,1388
 openhands/sdk/agent/prompts/system_prompt_long_horizon.j2,sha256=_oOHRIer_FSuRrBOSOPpe5Ueo9KgSTba5SPoHHpghCI,2995
 openhands/sdk/agent/prompts/system_prompt_planning.j2,sha256=wh01KX7yzeUSn5PtG3Ij0keRM6vmQuZZM6I0Fod4DK4,2934
 openhands/sdk/agent/prompts/system_prompt_tech_philosophy.j2,sha256=Yq9H7hHen2-tNsfBq9RlAWpyWsVRpjHhzmziZv8JHs8,5005
 openhands/sdk/context/__init__.py,sha256=dsOiCbO-eizN7HiGn_ZSSgH-EE841ygwalMzWz9GbVY,557
-openhands/sdk/context/agent_context.py,sha256=JSVrWCX7ETugHgj8W77Qkw7df94TvCGMyzl6WstpulY,7112
+openhands/sdk/context/agent_context.py,sha256=lEJySpZz2aq9RonsCwsf2eF4bivrCikOqpmnogsiNhk,8370
 openhands/sdk/context/view.py,sha256=j8R4r1PSKFUJR_G4qDyI8ToqyHbWtU0YRKDBm8LJm4I,9260
 openhands/sdk/context/condenser/__init__.py,sha256=o3O5wEOUak7mzJ3EzY4s6pjUwA_Q5EzLvgNSFM46d50,490
 openhands/sdk/context/condenser/base.py,sha256=fp1WxZGslE1luwmzFmablZ9Q3h_F7ErBJfCAh6HKpRI,3659
@@ -27,30 +27,30 @@ openhands/sdk/context/prompts/prompt.py,sha256=a2eCR4QSYzgdDxcGkGVktKerAOk-SCb8o
 openhands/sdk/context/prompts/templates/ask_agent_template.j2,sha256=VRKWdF2VTJ_Tyway_Wexp8_KlNgAkME94eZelbbsEZI,212
 openhands/sdk/context/prompts/templates/skill_knowledge_info.j2,sha256=3yNxEEbScAU1w60ix7Ph91wr6p8mjwT-3EGkkZkWT9Q,261
 openhands/sdk/context/prompts/templates/system_message_suffix.j2,sha256=JTNvdtH_qbFBTzZVV8NzHtn48BJXNY2dLFgMWj_iwM8,401
-openhands/sdk/context/skills/__init__.py,sha256=cQuHXin2tGg1qH9Y_nV6Oud-cWztrLaUyPCTYRpCWM4,543
+openhands/sdk/context/skills/__init__.py,sha256=5YmyufIWoLvoUYtcZE_xI4sOtcCs70-CHrblnzavWWY,593
 openhands/sdk/context/skills/exceptions.py,sha256=tVBSbXTXG32nb1TebVAuzbNNHvn8GScpSM1bHCnQzvY,305
-openhands/sdk/context/skills/skill.py,sha256=Qz5bazmLaR2cvRLvJpJUUoGy6sl_XACT1eJ-WhlReFs,13237
+openhands/sdk/context/skills/skill.py,sha256=iJpJWiXLHhxd7tmdPo1HcIDqa4emAYkQHgN7KvkQcl0,20407
 openhands/sdk/context/skills/trigger.py,sha256=ZGaDmMpJghnAEuTTYX6UepsA5nX1CSz83zK1Ox46vMk,756
 openhands/sdk/context/skills/types.py,sha256=qdakWgfs_88I_cnmVhO5bl3C3s11GvCydq7Q-V53kCI,1662
-openhands/sdk/conversation/__init__.py,sha256=_8jMjId0iyn-TLH59EjV3JiWOPUVbCU9b4ayXsuf6c4,1321
-openhands/sdk/conversation/base.py,sha256=SVlFQPwJt8hOgWAovt5ZHaMxtCmwoo3KTv4j2FqtRW8,8151
-openhands/sdk/conversation/conversation.py,sha256=5H-hV7sgXQRwncd9-lyf6TytmUyiEzJOZLGHd4cKj-Q,4905
-openhands/sdk/conversation/conversation_stats.py,sha256=_-iKBOnT5PYhbDkm7kB3Jsw1RrOhViA0HdnfmCDwRn0,1643
+openhands/sdk/conversation/__init__.py,sha256=1-xh49S2KJhtAjkHDaDHU28UWhfQLl3CeFlo179gr00,1402
+openhands/sdk/conversation/base.py,sha256=3qUc4_PjrT1IztBX7EJKuypvRVWRIbMmIQ3Fc2lvspI,8308
+openhands/sdk/conversation/conversation.py,sha256=GsPK9MWTAWG47J6jQ1vcSD9ER31wbFkRF9zdFmCqz9I,5275
+openhands/sdk/conversation/conversation_stats.py,sha256=ZlQ99kgG5YVCrZ4rqJlq63JaiInxX8jqv-q5lS7RN68,3038
 openhands/sdk/conversation/event_store.py,sha256=he-bwP823s5zAIdua_0ZgkkHQCJoAqbtV2SN0hibX30,5207
 openhands/sdk/conversation/events_list_base.py,sha256=n_YvgbhBPOPDbw4Kp68J0EKFM39vg95ng09GMfTz29s,505
 openhands/sdk/conversation/exceptions.py,sha256=C3pN3MJJIYdhcMHMqtOmVkR1BhVe3pfxBhxzQ6FVBjc,804
-openhands/sdk/conversation/fifo_lock.py,sha256=HG10uaTI9NMJ9P4njf6ne_EC6tMpBxYwfexafpt6kt8,4012
+openhands/sdk/conversation/fifo_lock.py,sha256=nY5RsobNvVXBbAzwjqIxyQwPUh0AzffbTZw4PewhTTI,4240
 openhands/sdk/conversation/persistence_const.py,sha256=om3pOQa5sGK8t_NUYb3Tz-7sKeu531gaS1e7iCaqWmo,218
 openhands/sdk/conversation/response_utils.py,sha256=rPlC3cDSmoQte6NZ0kK6h6-9ho5cbF8jEw-DiyEhgIM,1548
 openhands/sdk/conversation/secret_registry.py,sha256=37kk-aaeQ_XKZDXHpNJ2oTOWsElL4Q9jI_6qd3A774I,4500
-openhands/sdk/conversation/secret_source.py,sha256=aKs3hFhbdwZVBEYHZf76jPfqWaNd1XPJBfY2Gg94364,2554
+openhands/sdk/conversation/secret_source.py,sha256=1itHqTgwu1yZKGZ46HR0X08MLU2Y_rWa2ahzbqxH4k0,2568
 openhands/sdk/conversation/serialization_diff.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-openhands/sdk/conversation/state.py,sha256=RzCS-uMkklaTPBRkLxlrutc1qY24pmkwTya_Dx4EP9Y,12746
+openhands/sdk/conversation/state.py,sha256=EpP_0MAWv14gEIBvIlpdIxtxLCzN1n2mgzSzQNRpCY8,13046
 openhands/sdk/conversation/stuck_detector.py,sha256=PZF0HWC6G0SUud_U3hiv5r4AqfJJMw5-ookEWVOY5sY,10866
 openhands/sdk/conversation/title_utils.py,sha256=j40-dP-Oes-mhU2xUC7fCC8cB0wkMdbbDJU7WLHiVIo,7063
-openhands/sdk/conversation/types.py,sha256=O1_7_BrH-abvvTx6C1cXaPNHC3k2A1ZfsN6Q5w0YEi4,213
+openhands/sdk/conversation/types.py,sha256=CMCCJz6fSfWgaAgWXeorEDC8VSXyyplyiMlpcueszT8,423
 openhands/sdk/conversation/impl/__init__.py,sha256=DmDFyNR4RU8eiMocKf2j9eBQomipP-rrJgU1LoVWTDA,220
-openhands/sdk/conversation/impl/local_conversation.py,sha256=lTLXSJGGeAMBQluVe-fKOCXw9Vz1AAZgqnpB6n3jUQg,22094
+openhands/sdk/conversation/impl/local_conversation.py,sha256=R0iTc1oCaOBiBUH3Ei7RNO1JMS_7nEuBlCr3ILUosU0,22594
 openhands/sdk/conversation/impl/remote_conversation.py,sha256=9_yCDHO5KKODYHVzUt0mJnsSVcDE6Tv3TJvGULilcyE,28536
 openhands/sdk/conversation/visualizer/__init__.py,sha256=0LXpKlt2eJcrqP1z6jQP_nLx23V8ErnQkKYSxvUp0_A,275
 openhands/sdk/conversation/visualizer/base.py,sha256=77DdRdHAPSESxRCYyRRSOK7ROBlljscxogkFFr4YgM0,2323
@@ -65,7 +65,7 @@ openhands/sdk/event/__init__.py,sha256=ir-jRVA0QjEbFuDzJOYRq2kXTgUHs8eJ7_skoCRNz
 openhands/sdk/event/base.py,sha256=QpQtYfYiZqaKWA-2xa4GEmk2qkUHKD6x-OIAk7SMnDs,5568
 openhands/sdk/event/condenser.py,sha256=sne9CxhhNq9UvJMKuKcw8tXuMgutuGh85TbbZHwYhPQ,2481
 openhands/sdk/event/conversation_error.py,sha256=gZMyliJx1xbyoJFYH0-AEHqznyiA8LZ7olPSidaNfuc,957
-openhands/sdk/event/conversation_state.py,sha256=nARmfgjj8PJ6luBjKlBjNIgdf1U0YxWrkIVAHCvbguY,3284
+openhands/sdk/event/conversation_state.py,sha256=V-ti5SLL5SL330sEOQgpy-U8tErVwZYG0iC3AqjTUwo,3650
 openhands/sdk/event/llm_completion_log.py,sha256=VCxJiZBsn1F6TRV6fwvsPs6W9DpjghfIFmJJlGKztXg,1232
 openhands/sdk/event/token.py,sha256=QlEbBrfZaHe9tp8-Ot4vTd0T-_Vj7lpUqKfVJcVHOeI,497
 openhands/sdk/event/types.py,sha256=3hyFDBNtYTGEwLV6muodJO7iDMoZTC4D0Dd4vYeF2dE,271
@@ -84,11 +84,12 @@ openhands/sdk/io/__init__.py,sha256=6pXTWP03Wn5S7b6fOT0g3PYn-qSoEGGdrrwBqALYGA4,
 openhands/sdk/io/base.py,sha256=kAcX0chfCswakiieJlKiHWoJgL3zOtaQauRqMPNYfW8,1355
 openhands/sdk/io/local.py,sha256=H1wjnBS0EkBJxEatWqNpteL1bPBHoetcnhrIeou4uEY,2991
 openhands/sdk/io/memory.py,sha256=XIsdXsSyF-PzoYVmvJuO7Vtz-k3D5jMOFoZ5gHw8tbA,1712
-openhands/sdk/llm/__init__.py,sha256=o-wWK3HPXUZIc-rXxHxRV8FdkGP8zy6iVXXt2LaQvnU,1085
-openhands/sdk/llm/llm.py,sha256=ZNkXDkDCcFsrxbrffYnHbkw0PwNkprR9Yhbm9TLyU0g,41476
-openhands/sdk/llm/llm_registry.py,sha256=LJMK7yyoFbHyCmlui5zmwwqpTO4zWtXsvXYjqjoiBQw,3554
+openhands/sdk/llm/__init__.py,sha256=k8UneyfoDUMe0lSP4GSlYzrL2Fe3MkDUKpSg2OIDi_I,1206
+openhands/sdk/llm/llm.py,sha256=7cpdaXvsgafim2ZXI5umjN3P5ND9xk1GjktKRbrWGqo,44308
+openhands/sdk/llm/llm_registry.py,sha256=DL9yqSbAM7OBkzdIChLuxG2qk_oElW2tC2xem6mq0F8,3530
 openhands/sdk/llm/llm_response.py,sha256=DaBVBkij4Sz-RsYhRb3UUcvJCTzCBcOYQ9IhFwN4ukI,1988
 openhands/sdk/llm/message.py,sha256=zVcmHL4z99Bm0_qHz0hhtDh8a9r8Y1GtcfCgL5yBsME,25429
+openhands/sdk/llm/streaming.py,sha256=tFJ7B0AjJ-e8Xv13DTtc2FdrsLRUCG8wxQex8fDlOp4,214
 openhands/sdk/llm/exceptions/__init__.py,sha256=6iMJah2nS6BboU06HqgAM2JT6aykCWY8muoUwaaJpR8,1144
 openhands/sdk/llm/exceptions/classifier.py,sha256=pu5fVNubUrB3eXV1i5W7m4-D4Ik2Z-fGe1ba2t0SSc4,1456
 openhands/sdk/llm/exceptions/mapping.py,sha256=D68duh85HPONw5P0Mv4e8Ji-ubi6qWEb2d9FkOKf8cA,1656
@@ -96,22 +97,22 @@ openhands/sdk/llm/exceptions/types.py,sha256=IfyRtfH5eJrsLOlp6Fz76CiCKjx1ukmXciI
 openhands/sdk/llm/mixins/fn_call_converter.py,sha256=G5u0cNGLBscog7Vt0c7Xjo5uLsvyleBlk12Mq0wTQTM,46310
 openhands/sdk/llm/mixins/non_native_fc.py,sha256=ymPELReJtFsBJCweEpfx2njyd6NCG9mj9AoDPPLFAqc,3250
 openhands/sdk/llm/options/__init__.py,sha256=EntvOWC5kwDoTMXXMkYuoWMQ13hD8YtC9CEMCtnKj7o,54
-openhands/sdk/llm/options/chat_options.py,sha256=x21uNuZcInnpDGajgTsJl4FSBu-2Uf-w9Pr9mHPQPTw,4126
+openhands/sdk/llm/options/chat_options.py,sha256=YrQrMKUj9Sb0ZdzJMoB11PwD7hzdLBDGrOMWfgZQ10s,3452
 openhands/sdk/llm/options/common.py,sha256=qFcPuZF_c4rmH1bgGG8Qp6TJ4YWpv9IFzfLZRRiik9M,580
-openhands/sdk/llm/options/responses_options.py,sha256=vXLOSMebL8nK2ZHQ7_GUOf2dMZgXqgu3DdRbDCbmXXM,1876
+openhands/sdk/llm/options/responses_options.py,sha256=xrBEc62PFjLeM9bGyXtXrQ6GgYDzhJfGha8Nhi5Oci8,2166
 openhands/sdk/llm/router/__init__.py,sha256=N8qldpGdLLCWZzn5Rz2y8AheSoCTQLGkLOBDCFNMJRA,261
-openhands/sdk/llm/router/base.py,sha256=5znrRHgDK6OHRY8UuXDOb_sVf3YfqKvopGD768FkAG8,3999
+openhands/sdk/llm/router/base.py,sha256=9mUUpv-zgT6HVKmJ87Q5e5VncoKi8hHd9aP8j9cJI_g,4139
 openhands/sdk/llm/router/impl/multimodal.py,sha256=uKFVm7b3Jr0xCC1lvP-cVn-fIkTv24-pK3xKlOJahz4,3034
 openhands/sdk/llm/router/impl/random.py,sha256=oBHoFTBMa9OeDyg-rV4siLCkN6rKYL0uDlZMEseB3ro,656
 openhands/sdk/llm/utils/metrics.py,sha256=4zD0Hkc9Oc4qcDcVZUX13RyggyObshUbz4Ik9W1uIw4,11592
-openhands/sdk/llm/utils/model_features.py,sha256=JY5xqwkkKa7uF77Gp6jkBcfJVIeHBrpQnSDyBdqOeLo,4258
+openhands/sdk/llm/utils/model_features.py,sha256=JMGShnYBplGL6O6f19YC2EqI3dIviNN_58TFbflBnlA,4607
 openhands/sdk/llm/utils/model_info.py,sha256=1mFYA7OcEyUB6k1doao8_w1XT7UMM_DAm57HcTpKkLw,2628
 openhands/sdk/llm/utils/retry_mixin.py,sha256=yIkUxgtym4ouOci0o1u1BJnThUt05njblhC0b2Tvmb8,4559
 openhands/sdk/llm/utils/telemetry.py,sha256=BGzikbw1DAj96Bo60D7XIGh034zKIbO1zRx597_3TR4,13966
 openhands/sdk/llm/utils/unverified_models.py,sha256=SmYrX_WxXOJBanTviztqy1xPjOcLY4i3qvwNBEga_Dk,4797
 openhands/sdk/llm/utils/verified_models.py,sha256=add09fF6MHOCBS4Wp2BxLYYfijMtzkq1IFc3GNZgMWU,1357
 openhands/sdk/logger/__init__.py,sha256=vZvFDYfW01Y8Act3tveMs3XxTysJlt4HeT-n6X_ujYk,330
-openhands/sdk/logger/logger.py,sha256=Dqhl8EFVIprQmSQNKVnyIpybF6twZKzTJ21pHK7aW9k,6243
+openhands/sdk/logger/logger.py,sha256=kSpeol92dKesm24ZxVyYbtAxeYccmuFZJw3qNO9X-t4,6513
 openhands/sdk/logger/rolling.py,sha256=E6oy0asgmOhZHoWlSCw0QK1PKnS6kvtxjoWLAsqlGvs,3440
 openhands/sdk/mcp/__init__.py,sha256=-wQbZ405PjVRCBtSfirp4jsiRohd7IJAyAdicZ-M8Ok,588
 openhands/sdk/mcp/client.py,sha256=CLkFImydorlT_RBTE5UxvRNGMlc-uO3wvupoDzB5E20,2420
@@ -131,7 +132,7 @@ openhands/sdk/tool/__init__.py,sha256=Fpcy_I5CYC8lDf2KNLj7LJg9YpoDObbacMFOvM9fI5
 openhands/sdk/tool/registry.py,sha256=x5j8DwOjH3YJijhXe_3nRPsSr1A2sDPpNhxCuvFrHK0,5456
 openhands/sdk/tool/schema.py,sha256=PdQbkzPER-Z9B-eKPMr16M8ap27gghszq1xSHH5DGZQ,9114
 openhands/sdk/tool/spec.py,sha256=EbtWasVhwjLKNJywHubbwfYqfgXnZbU4QE6XUOLhsdk,1221
-openhands/sdk/tool/tool.py,sha256=pJLeqjGQMANPKNBNk16vO8I7trRNZs_fvJWRLDF9bsA,17100
+openhands/sdk/tool/tool.py,sha256=tcAno2EEXF-Ta8icgSbX_0mQDuuBDmQ5CugnEINHqwk,17798
 openhands/sdk/tool/builtins/__init__.py,sha256=30MfENomH9JBPwKs03Xwgny09dDUOt3FSIQ3egRJKhM,729
 openhands/sdk/tool/builtins/finish.py,sha256=pPv_bKDOQE4sUK9lNh1H1lDaxavHozjOwLCIuYrb424,3136
 openhands/sdk/tool/builtins/think.py,sha256=Jp8CBHJZwrtNuVCLrxKlVwb9HeQ1lZB56PCYMxW3wWk,4050
@@ -143,21 +144,21 @@ openhands/sdk/utils/command.py,sha256=iqTdFL9tPQ0gyq5w_HOMXSSHg1nowtrWwJBeDL87lZ
 openhands/sdk/utils/deprecation.py,sha256=7XwepMKTwBLaqS-4rdJupKxNZkepV0Mrru3uTQukS0k,5114
 openhands/sdk/utils/github.py,sha256=l-_LQKw820dA_U8NmDdmaReAPhgMAWqfH1oRMi1q5OA,1638
 openhands/sdk/utils/json.py,sha256=hHAA7i7NCJrQhb5WWSsoT0nvmJUi0koyBdbviFrfdcM,1384
-openhands/sdk/utils/models.py,sha256=viYKdoCXd-ln6mDY0mx2Oqh-HWHwbVM4127bp71cFJU,17170
+openhands/sdk/utils/models.py,sha256=tOTGa4O1vHZgHvOp2mNv5V4hM3fBSM6Sswv-0oYVyJQ,20676
 openhands/sdk/utils/pydantic_diff.py,sha256=vOy4M1XKKDkCzp7RXBvnibvPYWL8fNEDtWNUn_-N1yg,2732
 openhands/sdk/utils/pydantic_secrets.py,sha256=B9njRdijnqO4g-GDCWRsWd-TZc5GTjMncDEPMFP_aUE,2186
-openhands/sdk/utils/truncate.py,sha256=Owl2fYsRAuQCIwJ6ma_xOwOYQ0b7EPF1ektzPHn8RQc,1466
+openhands/sdk/utils/truncate.py,sha256=wrPdD1557teSR0A66z9roYAINp_cWYYwS6Ku29Z7b8M,4376
 openhands/sdk/utils/visualize.py,sha256=ZRZTA0epdiOA7vdk-EdGV6Yb5t8rz6ZzrargH7MUTEQ,845
-openhands/sdk/workspace/__init__.py,sha256=gUAmB0CuzwzYfDRO9e1zaX6SyoCvJ6zXOpmVXxkS3D0,337
+openhands/sdk/workspace/__init__.py,sha256=09huA83IZJZU8XZSVzSgZwfUv-slzYwofnUjLgqt7B8,401
 openhands/sdk/workspace/base.py,sha256=4_oBXbjspa2Oh2wpgbcQMyrshi7prhmOL1LY97NowgQ,4590
 openhands/sdk/workspace/local.py,sha256=N_cW_E5BfctIpgwU-OcRQIqKLn4ibxNwjL4c8iYjU6E,6253
-openhands/sdk/workspace/models.py,sha256=s-2-AtOspEgZqpptGS7a34n8x8-JyoiZm5stPGPABr4,1128
+openhands/sdk/workspace/models.py,sha256=ORFn70kXvD0urjeq59d_XqXBYSHbDYkBMg9KYQKRa5I,1304
 openhands/sdk/workspace/workspace.py,sha256=Of1r2z3W_pXSgV8u10sUQ87ChtaA5khD6HJ_PtJz6aY,1296
 openhands/sdk/workspace/remote/__init__.py,sha256=eKkj6NOESMUBGDVC6_L2Wfuc4K6G-mpnJDNHKBkSeUI,114
-openhands/sdk/workspace/remote/async_remote_workspace.py,sha256=SrenHPqt432aEhAVivnA7IYxbkH_yWGqoaNjpxifHww,4168
-openhands/sdk/workspace/remote/base.py,sha256=petJPmrloN9tHrORagDn6kRAfdtk16On0A8Ado5pWA0,5183
+openhands/sdk/workspace/remote/async_remote_workspace.py,sha256=ftv1Vdx4mmM3AjygJpemMJGvhaQel7ORxdQVk12z4ZE,5061
+openhands/sdk/workspace/remote/base.py,sha256=72C9MZV7ch5n6oHNvFMo6irW7b6Le8n4gk3yFuc0798,5605
 openhands/sdk/workspace/remote/remote_workspace_mixin.py,sha256=CzHfnLUIra5sgPkP9kcggb1vHGOPpYQzLsHvGO2rRt0,10963
-openhands_sdk-1.3.0.dist-info/METADATA,sha256=QF-QF_V8FlMlZRxvgJasvyj8xpAdyjL4Dg-GLBIertI,550
-openhands_sdk-1.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-openhands_sdk-1.3.0.dist-info/top_level.txt,sha256=jHgVu9I0Blam8BXFgedoGKfglPF8XvW1TsJFIjcgP4E,10
-openhands_sdk-1.3.0.dist-info/RECORD,,
+openhands_sdk-1.4.1.dist-info/METADATA,sha256=9K8ieOX7Xf0snpoeuCY9KmXkd5GTHkg_3EpgTT6vGLo,545
+openhands_sdk-1.4.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+openhands_sdk-1.4.1.dist-info/top_level.txt,sha256=jHgVu9I0Blam8BXFgedoGKfglPF8XvW1TsJFIjcgP4E,10
+openhands_sdk-1.4.1.dist-info/RECORD,,