openhands-sdk 1.49.2__tar.gz → 1.49.4__tar.gz

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/PKG-INFO

@@ -1,20 +1,20 @@
 Metadata-Version: 2.4
 Name: openhands-sdk
-Version: 1.49.2
+Version: 1.49.4
 Summary: OpenHands SDK - Core functionality for building AI agents
 Project-URL: Source, https://github.com/OpenHands/software-agent-sdk
 Project-URL: Homepage, https://github.com/OpenHands/software-agent-sdk
 Project-URL: Documentation, https://docs.openhands.dev/sdk
 Project-URL: Bug Tracker, https://github.com/OpenHands/software-agent-sdk/issues
 Requires-Python: >=3.12
-Requires-Dist: agent-client-protocol<0.11.0,>=0.10.1
+Requires-Dist: agent-client-protocol<0.13.0,>=0.12.1
 Requires-Dist: deprecation>=2.1.0
 Requires-Dist: fakeredis[lua]>=2.32.1
 Requires-Dist: fastmcp<4,>=3.2.0
 Requires-Dist: filelock>=3.20.1
 Requires-Dist: httpx[socks]>=0.27.0
 Requires-Dist: jsonschema>=4.23.0
-Requires-Dist: joserfc>=1.6.8
+Requires-Dist: joserfc>=1.7.5
 Requires-Dist: litellm>=1.93.0
 Requires-Dist: pillow>=12.3.0
 Requires-Dist: pydantic>=2.12.5

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/openhands/sdk/agent/acp_agent.py

@@ -43,21 +43,34 @@ from acp.client.connection import ClientSideConnection
 from acp.exceptions import RequestError as ACPRequestError
 from acp.helpers import image_block, text_block
 from acp.schema import (
+    AcpMcpServer,
     AgentMessageChunk,
     AgentThoughtChunk,
     AllowedOutcome,
+    CreateElicitationResponse,
+    CreateTerminalResponse,
+    DeclineElicitationResponse,
+    ElicitationMode,
     EnvVariable,
     HttpHeader,
     HttpMcpServer,
     ImageContentBlock,
+    KillTerminalResponse,
     McpServerStdio,
+    PermissionOption,
     PromptResponse,
+    ReadTextFileResponse,
+    ReleaseTerminalResponse,
     RequestPermissionResponse,
     SseMcpServer,
+    TerminalOutputResponse,
     TextContentBlock,
     ToolCallProgress,
     ToolCallStart,
+    ToolCallUpdate,
     UsageUpdate,
+    WaitForTerminalExitResponse,
+    WriteTextFileResponse,
 )
 from acp.transports import default_environment
 from pydantic import (
@@ -617,14 +630,23 @@ async def _apply_acp_model(
     Codex, callers may still pass a combined Canvas id such as ``gpt-5.5/high``;
     codex-acp exposes reasoning effort as a separate config option, so split it
     only on the config-options mechanism.
+
+    agent-client-protocol 0.12.1 dropped the UNSTABLE ``models`` extension from
+    the ACP schema and removed ``ClientSideConnection.set_session_model``. A live
+    0.12 connection therefore has no legacy RPC to call, so the ``else`` branch
+    only invokes it when the connection actually exposes the method (test
+    doubles do; real 0.12 connections do not) and otherwise no-ops rather than
+    raising ``AttributeError``.
     """
     if via_config_option:
         for config_id, value in _model_config_options(agent_name, model):
             await conn.set_config_option(
                 config_id=config_id, value=value, session_id=session_id
             )
-    else:
-        await conn.set_session_model(model_id=model, session_id=session_id)
+    elif hasattr(conn, "set_session_model"):
+        await conn.set_session_model(  # type: ignore[attr-defined]
+            model_id=model, session_id=session_id
+        )
 
 
 def _usable_models(infos: Iterable[ACPModelInfo]) -> list[ACPModelInfo]:
@@ -689,7 +711,7 @@ def _extract_session_models(
 
 
 # The ACP MCP server union accepted by new_session() / load_session().
-_ACPMcpServer = HttpMcpServer | SseMcpServer | McpServerStdio
+_ACPMcpServer = HttpMcpServer | SseMcpServer | McpServerStdio | AcpMcpServer
 
 
 def _remote_mcp_headers(server: MCPServer, name: str) -> list[HttpHeader]:
@@ -1579,11 +1601,11 @@ class _OpenHandsACPBridge:
 
     async def request_permission(
         self,
-        options: list[Any],
         session_id: str,  # noqa: ARG002
-        tool_call: Any,
+        tool_call: ToolCallUpdate,
+        options: list[PermissionOption],
         **kwargs: Any,  # noqa: ARG002
-    ) -> Any:
+    ) -> RequestPermissionResponse:
         """Auto-approve all permission requests from the ACP server."""
         # Pick the first option (usually "allow once")
         option_id = options[0].option_id if options else "allow_once"
@@ -1596,52 +1618,74 @@ class _OpenHandsACPBridge:
             outcome=AllowedOutcome(outcome="selected", option_id=option_id),
         )
 
+    async def create_elicitation(
+        self,
+        message: str,  # noqa: ARG002
+        mode: ElicitationMode,  # noqa: ARG002
+        **kwargs: Any,  # noqa: ARG002
+    ) -> CreateElicitationResponse:
+        """Decline elicitation requests; the headless bridge has no user to ask.
+
+        Added to the ``Client`` protocol in agent-client-protocol 0.12.x. None
+        of the pinned ACP providers elicit during a headless turn, so this is a
+        defensive default rather than an exercised code path.
+        """
+        return DeclineElicitationResponse(action="decline")
+
+    async def complete_elicitation(
+        self,
+        elicitation_id: str,  # noqa: ARG002
+        **kwargs: Any,  # noqa: ARG002
+    ) -> None:
+        """No-op completion for an elicitation the bridge always declines."""
+        return None
+
     # fs/terminal methods — raise NotImplementedError; ACP server handles its own
     async def write_text_file(
-        self, content: str, path: str, session_id: str, **kwargs: Any
-    ) -> None:
+        self, session_id: str, path: str, content: str, **kwargs: Any
+    ) -> WriteTextFileResponse | None:
         raise NotImplementedError("ACP server handles file operations")
 
     async def read_text_file(
         self,
-        path: str,
         session_id: str,
-        limit: int | None = None,
+        path: str,
         line: int | None = None,
+        limit: int | None = None,
         **kwargs: Any,
-    ) -> Any:
+    ) -> ReadTextFileResponse:
         raise NotImplementedError("ACP server handles file operations")
 
     async def create_terminal(
         self,
-        command: str,
         session_id: str,
+        command: str,
         args: list[str] | None = None,
+        env: list[EnvVariable] | None = None,
         cwd: str | None = None,
-        env: Any = None,
         output_byte_limit: int | None = None,
         **kwargs: Any,
-    ) -> Any:
+    ) -> CreateTerminalResponse:
         raise NotImplementedError("ACP server handles terminal operations")
 
     async def terminal_output(
         self, session_id: str, terminal_id: str, **kwargs: Any
-    ) -> Any:
+    ) -> TerminalOutputResponse:
         raise NotImplementedError("ACP server handles terminal operations")
 
     async def release_terminal(
         self, session_id: str, terminal_id: str, **kwargs: Any
-    ) -> None:
+    ) -> ReleaseTerminalResponse | None:
         raise NotImplementedError("ACP server handles terminal operations")
 
     async def wait_for_terminal_exit(
         self, session_id: str, terminal_id: str, **kwargs: Any
-    ) -> Any:
+    ) -> WaitForTerminalExitResponse:
         raise NotImplementedError("ACP server handles terminal operations")
 
     async def kill_terminal(
         self, session_id: str, terminal_id: str, **kwargs: Any
-    ) -> None:
+    ) -> KillTerminalResponse | None:
         raise NotImplementedError("ACP server handles terminal operations")
 
     async def ext_method(

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/openhands/sdk/context/agent_context.py

@@ -260,6 +260,14 @@ class AgentContext(BaseModel):
     @model_validator(mode="after")
     def _load_auto_skills(self):
         """Load user/legacy-public skills if enabled, then apply ``disabled_skills``."""
+        return self.resolve_auto_skills()
+
+    def resolve_auto_skills(self) -> AgentContext:
+        """Resolve ``load_*_skills`` into ``skills`` and apply ``disabled_skills``.
+
+        Exposed because ``model_copy`` skips validators: callers that rebuild a
+        context that way must re-run this or the deny-list silently won't apply.
+        """
         include_public = self.load_public_skills
         if self.load_user_skills or include_public:
             auto_skills = load_available_skills(

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/openhands/sdk/llm/llm.py

@@ -1129,8 +1129,11 @@ class LLM(BaseModel, RetryMixin, NonNativeToolCallingMixin):
         ):
             delta = event.delta
             if delta:
+                # ModelResponseStream mints a fresh id per instance, and a
+                # changed chunk id reads as a retry (StreamContext._emit_delta).
                 delta_chunk = ModelResponseStream(
-                    choices=[StreamingChoices(delta=Delta(content=delta))]
+                    id=event.item_id,
+                    choices=[StreamingChoices(delta=Delta(content=delta))],
                 )
 
         return output_item, delta_chunk

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/openhands/sdk/llm/utils/model_features.py

@@ -221,6 +221,7 @@ SEND_REASONING_CONTENT_MODELS: list[str] = [
     "deepseek/deepseek-reasoner",
     "deepseek/deepseek-v4-pro",  # Dual-mode (Thinking/Non-Thinking)
     "deepseek/deepseek-v4-flash",  # Dual-mode (Thinking/Non-Thinking)
+    "deepseek/deepseek-v4.1-flash",  # Dual-mode (Thinking/Non-Thinking)
 ]
 
 # Match token -> canonical LiteLLM ID for vision metadata overrides.

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/openhands/sdk/llm/utils/verified_models.py

@@ -53,6 +53,7 @@ VERIFIED_DEEPSEEK_MODELS = [
     "deepseek-v4-pro",
     "deepseek-v4-flash",
     "deepseek-v4-flash-vision-exp",
+    "deepseek-v4.1-flash",
     "deepseek-v3.2-reasoner",
 ]
 
@@ -81,6 +82,7 @@ VERIFIED_GLM_MODELS = [
 VERIFIED_NVIDIA_MODELS = [
     "nemotron-3.5-lightning-30b-a3b",
     "nemotron-3-nano",
+    "nemotron-3-nano-omni-30b-a3b-reasoning",
     "nemotron-3-super-120b-a12b",
     "nemotron-3-ultra-550b-a55b",
 ]
@@ -123,6 +125,7 @@ VERIFIED_OPENHANDS_MODELS = [
     "deepseek-v4-pro",
     "deepseek-v4-flash",
     "deepseek-v4-flash-vision-exp",
+    "deepseek-v4.1-flash",
     "deepseek-v3.2-reasoner",
     "kimi-k3",
     "kimi-k2.7-code",

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/openhands/sdk/secret/__init__.py

@@ -4,16 +4,22 @@ This module provides classes and types for managing secrets in OpenHands.
 """
 
 from openhands.sdk.secret.secrets import (
+    LocalSecretResolver,
     LookupSecret,
     SecretSource,
     SecretValue,
     StaticSecret,
+    register_local_secret_resolver,
+    unregister_local_secret_resolver,
 )
 
 
 __all__ = [
+    "LocalSecretResolver",
     "SecretSource",
     "StaticSecret",
     "LookupSecret",
     "SecretValue",
+    "register_local_secret_resolver",
+    "unregister_local_secret_resolver",
 ]

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/openhands/sdk/secret/secrets.py

@@ -2,6 +2,7 @@
 
 import os
 from abc import ABC, abstractmethod
+from collections.abc import Callable
 from urllib.parse import urljoin, urlsplit
 
 import httpx
@@ -32,6 +33,50 @@ def _resolve_lookup_secret_url(url: str) -> str:
     return urljoin(f"{base_url.rstrip('/')}/", url)
 
 
+LocalSecretResolver = Callable[[str], str | None]
+
+_local_secret_resolvers: list[LocalSecretResolver] = []
+
+
+def register_local_secret_resolver(resolver: LocalSecretResolver) -> None:
+    """Register an in-process resolver for ``LookupSecret`` URLs.
+
+    A process that both serves and consumes ``LookupSecret`` URLs — an
+    agent-server running an in-process conversation, say — cannot fetch them
+    over HTTP from its own event loop: the request can only be answered by the
+    loop that is blocked waiting for it, so it stalls until the client times
+    out. Registering a resolver lets such a process answer its own URLs
+    directly and skip the round trip.
+
+    The resolver receives the fully-resolved URL and returns the secret value,
+    or ``None`` when it does not serve that URL, in which case resolution falls
+    through to the next resolver and finally to HTTP.
+    """
+    if resolver not in _local_secret_resolvers:
+        _local_secret_resolvers.append(resolver)
+
+
+def unregister_local_secret_resolver(resolver: LocalSecretResolver) -> None:
+    """Remove a resolver registered with ``register_local_secret_resolver``."""
+    if resolver in _local_secret_resolvers:
+        _local_secret_resolvers.remove(resolver)
+
+
+def _resolve_secret_locally(url: str) -> str | None:
+    """Return a locally-served value for ``url``, or ``None`` if there is none."""
+    for resolver in list(_local_secret_resolvers):
+        try:
+            value = resolver(url)
+        except Exception:
+            logger.warning(
+                "Local secret resolver raised; falling back to HTTP", exc_info=True
+            )
+            continue
+        if value is not None:
+            return value
+    return None
+
+
 class SecretSource(DiscriminatedUnionMixin, ABC):
     """Source for a named secret which may be obtained dynamically"""
 
@@ -77,6 +122,9 @@ class LookupSecret(SecretSource):
         return _resolve_lookup_secret_url(url)
 
     def get_value(self) -> str:
+        local_value = _resolve_secret_locally(self.url)
+        if local_value is not None:
+            return local_value
         response = httpx.get(self.url, headers=self.headers, timeout=30.0)
         response.raise_for_status()
         return response.text

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/openhands/sdk/workspace/remote/base.py

@@ -886,6 +886,7 @@ class RemoteWorkspace(RemoteWorkspaceMixin, BaseWorkspace):
         load_project: bool = True,
         load_org: bool = True,
         timeout: float = 60.0,
+        base_context: "AgentContext | None" = None,
     ) -> tuple[list["Skill"], "AgentContext"]:
         """Load skills via the agent-server's /api/skills endpoint.
 
@@ -906,6 +907,11 @@ class RemoteWorkspace(RemoteWorkspaceMixin, BaseWorkspace):
             load_project: Load project skills from workspace directories.
             load_org: Load organization-level skills.
             timeout: Request timeout in seconds.
+            base_context: Existing AgentContext to preserve. All of its
+                fields survive except `skills` and `load_public_skills`,
+                which this method always sets based on whether skills
+                were found. Defaults to None, which starts from a fresh
+                AgentContext — today's behavior.
 
         Returns:
             Tuple of (list of Skill objects, AgentContext).
@@ -958,11 +964,20 @@ class RemoteWorkspace(RemoteWorkspaceMixin, BaseWorkspace):
         if loaded_skills:
             logger.debug(f"Skills: {[s.name for s in loaded_skills]}")
 
-        # Create AgentContext - fall back to public skills if none loaded
+        # Update `base_context` (or start fresh if none given) with the
+        # newly loaded skills — every other field the caller configured is
+        # preserved. Fall back to public skills if none loaded.
+        base = base_context if base_context is not None else AgentContext()
         if loaded_skills:
-            agent_context = AgentContext(skills=loaded_skills, load_public_skills=False)
+            agent_context = base.model_copy(
+                update={"skills": loaded_skills, "load_public_skills": False}
+            )
         else:
             logger.warning("No skills loaded, falling back to public skills")
-            agent_context = AgentContext(skills=[], load_public_skills=True)
+            agent_context = base.model_copy(
+                update={"skills": [], "load_public_skills": True}
+            )
 
-        return loaded_skills, agent_context
+        # ``model_copy`` skips validators, so re-run the resolution that
+        # applies ``load_*_skills`` and the ``disabled_skills`` deny-list.
+        return loaded_skills, agent_context.resolve_auto_skills()

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/openhands_sdk.egg-info/PKG-INFO

@@ -1,20 +1,20 @@
 Metadata-Version: 2.4
 Name: openhands-sdk
-Version: 1.49.2
+Version: 1.49.4
 Summary: OpenHands SDK - Core functionality for building AI agents
 Project-URL: Source, https://github.com/OpenHands/software-agent-sdk
 Project-URL: Homepage, https://github.com/OpenHands/software-agent-sdk
 Project-URL: Documentation, https://docs.openhands.dev/sdk
 Project-URL: Bug Tracker, https://github.com/OpenHands/software-agent-sdk/issues
 Requires-Python: >=3.12
-Requires-Dist: agent-client-protocol<0.11.0,>=0.10.1
+Requires-Dist: agent-client-protocol<0.13.0,>=0.12.1
 Requires-Dist: deprecation>=2.1.0
 Requires-Dist: fakeredis[lua]>=2.32.1
 Requires-Dist: fastmcp<4,>=3.2.0
 Requires-Dist: filelock>=3.20.1
 Requires-Dist: httpx[socks]>=0.27.0
 Requires-Dist: jsonschema>=4.23.0
-Requires-Dist: joserfc>=1.6.8
+Requires-Dist: joserfc>=1.7.5
 Requires-Dist: litellm>=1.93.0
 Requires-Dist: pillow>=12.3.0
 Requires-Dist: pydantic>=2.12.5

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/openhands_sdk.egg-info/requires.txt

@@ -1,11 +1,11 @@
-agent-client-protocol<0.11.0,>=0.10.1
+agent-client-protocol<0.13.0,>=0.12.1
 deprecation>=2.1.0
 fakeredis[lua]>=2.32.1
 fastmcp<4,>=3.2.0
 filelock>=3.20.1
 httpx[socks]>=0.27.0
 jsonschema>=4.23.0
-joserfc>=1.6.8
+joserfc>=1.7.5
 litellm>=1.93.0
 pillow>=12.3.0
 pydantic>=2.12.5

{openhands_sdk-1.49.2 → openhands_sdk-1.49.4}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "openhands-sdk"
-version = "1.49.2"
+version = "1.49.4"
 description = "OpenHands SDK - Core functionality for building AI agents"
 
 requires-python = ">=3.12"
 dependencies = [
-    "agent-client-protocol>=0.10.1,<0.11.0",  # 0.11.0 reordered prompt() args, broke the client (#4830)
+    "agent-client-protocol>=0.12.1,<0.13.0",  # 0.11.0 reordered prompt() args, broke the client (#4830)
     "deprecation>=2.1.0",
     "fakeredis[lua]>=2.32.1",  # Explicit dependency for docket/fastmcp background tasks
     # 3.2.0 reads back the stored absolute OAuth token expiry; 4.x requires
@@ -14,7 +14,7 @@ dependencies = [
     "filelock>=3.20.1",
     "httpx[socks]>=0.27.0",
     "jsonschema>=4.23.0",
-    "joserfc>=1.6.8",
+    "joserfc>=1.7.5",
     "litellm>=1.93.0",
     "pillow>=12.3.0",
     "pydantic>=2.12.5",