fix(sdk): revert agent-client-protocol to optional [acp] extra

examples/01_standalone_sdk/40_acp_agent_example.py

@@ -8,6 +8,7 @@
 Prerequisites:
     - Node.js / npx available
     - Claude Code CLI authenticated (or CLAUDE_API_KEY set)
+    - pip install 'openhands-sdk[acp]'
 
 Usage:
     uv run python examples/01_standalone_sdk/40_acp_agent_example.py

openhands-sdk/openhands/sdk/agent/__init__.py

@@ -15,7 +15,14 @@
 # that previously defaulted.
 def __getattr__(name: str):
     if name == "ACPAgent":
-        from openhands.sdk.agent.acp_agent import ACPAgent
+        try:
+            from openhands.sdk.agent.acp_agent import ACPAgent
+        except ImportError:
+            raise ImportError(
+                "The 'agent-client-protocol' package is required for ACPAgent. "
+                "Install it with: pip install 'openhands-sdk[acp]' or "
+                "pip install agent-client-protocol"
+            ) from None
 
         return ACPAgent
     raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

openhands-sdk/pyproject.toml

@@ -5,7 +5,6 @@ description = "OpenHands SDK - Core functionality for building AI agents"
 
 requires-python = ">=3.12"
 dependencies = [
-    "agent-client-protocol>=0.8.1",
     "deprecation>=2.1.0",
     "fakeredis[lua]>=2.32.1",  # Explicit dependency for docket/fastmcp background tasks
     "fastmcp>=3.0.0",
@@ -27,6 +26,7 @@ Documentation = "https://docs.openhands.dev/sdk"
 "Bug Tracker" = "https://github.com/OpenHands/software-agent-sdk/issues"
 
 [project.optional-dependencies]
+acp = ["agent-client-protocol>=0.8.1"]
 boto3 = ["boto3>=1.35.0"]
 
 [build-system]

pyproject.toml

@@ -22,6 +22,7 @@ openhands-agent-server = { workspace = true }
 
 [dependency-groups]
 dev = [
+    "agent-client-protocol>=0.8.1",  # Optional SDK extra; included for ACP tests
     "pre-commit>=4.3.0",
     "packaging>=24.2",
     "psutil>=7.0.0",

tests/sdk/agent/test_acp_agent.py

@@ -9,15 +9,22 @@
 
 import pytest
 
-from openhands.sdk.agent.acp_agent import ACPAgent, _OpenHandsACPBridge
-from openhands.sdk.agent.base import AgentBase
-from openhands.sdk.conversation.state import (
+
+pytest.importorskip("acp", reason="agent-client-protocol not installed")
+
+from openhands.sdk.agent.acp_agent import ACPAgent, _OpenHandsACPBridge  # noqa: E402
+from openhands.sdk.agent.base import AgentBase  # noqa: E402
+from openhands.sdk.conversation.state import (  # noqa: E402
     ConversationExecutionStatus,
     ConversationState,
 )
-from openhands.sdk.event import ACPToolCallEvent, MessageEvent, SystemPromptEvent
-from openhands.sdk.llm import Message, TextContent
-from openhands.sdk.workspace.local import LocalWorkspace
+from openhands.sdk.event import (  # noqa: E402
+    ACPToolCallEvent,
+    MessageEvent,
+    SystemPromptEvent,
+)
+from openhands.sdk.llm import Message, TextContent  # noqa: E402
+from openhands.sdk.workspace.local import LocalWorkspace  # noqa: E402
 
 
 # ---------------------------------------------------------------------------