opencode-agent-sdk 0.4.6__tar.gz → 0.4.8__tar.gz

{opencode_agent_sdk-0.4.6 → opencode_agent_sdk-0.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-agent-sdk
-Version: 0.4.6
+Version: 0.4.8
 Summary: Open-source Agent SDK backed by OpenCode ACP (drop-in replacement for claude_agent_sdk)
 Author: OpenCode
 License: MIT
@@ -71,9 +71,13 @@ async def main():
 asyncio.run(main())
 ```
 
-## SDKClient
+## Why OpenCode Agent SDK?
 
-`SDKClient` supports bidirectional conversations with an LLM via OpenCode. It works in two transport modes:
+- **Drop-in Replacement**: Seamlessly switch from `claude_agent_sdk` by just changing your imports.
+- **Open Source & Headless**: Take full control of your agent infrastructure. No more proprietary black boxes.
+- **Multi-Provider Support**: Use any LLM (Anthropic, OpenAI, xAI, Google, Locall) via OpenCode's backend.
+- **Native SSE Streaming**: Real-time response streaming for a better user experience.
+- **Advanced Control**: Fine-grained tool permission hooks and MCP server support builtin.
 
 - **HTTP mode** — communicates with a running `opencode serve` instance over REST
 - **Subprocess mode** — spawns `opencode acp` locally over stdio JSON-RPC

{opencode_agent_sdk-0.4.6 → opencode_agent_sdk-0.4.8}/README.md

@@ -47,9 +47,13 @@ async def main():
 asyncio.run(main())
 ```
 
-## SDKClient
+## Why OpenCode Agent SDK?
 
-`SDKClient` supports bidirectional conversations with an LLM via OpenCode. It works in two transport modes:
+- **Drop-in Replacement**: Seamlessly switch from `claude_agent_sdk` by just changing your imports.
+- **Open Source & Headless**: Take full control of your agent infrastructure. No more proprietary black boxes.
+- **Multi-Provider Support**: Use any LLM (Anthropic, OpenAI, xAI, Google, Locall) via OpenCode's backend.
+- **Native SSE Streaming**: Real-time response streaming for a better user experience.
+- **Advanced Control**: Fine-grained tool permission hooks and MCP server support builtin.
 
 - **HTTP mode** — communicates with a running `opencode serve` instance over REST
 - **Subprocess mode** — spawns `opencode acp` locally over stdio JSON-RPC

{opencode_agent_sdk-0.4.6 → opencode_agent_sdk-0.4.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "opencode-agent-sdk"
-version = "0.4.6"
+version = "0.4.8"
 description = "Open-source Agent SDK backed by OpenCode ACP (drop-in replacement for claude_agent_sdk)"
 readme = "README.md"
 requires-python = ">=3.10"

{opencode_agent_sdk-0.4.6 → opencode_agent_sdk-0.4.8}/src/opencode_agent_sdk/__init__.py

@@ -31,4 +31,4 @@ __all__ = [
     "tool",
 ]
 
-__version__ = "0.2.0"
+__version__ = "0.4.8"

opencode_agent_sdk-0.4.8/src/opencode_agent_sdk/_errors.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+
+class SDKError(Exception):
+    """Base exception for all OpenCode Agent SDK errors."""
+    pass
+
+
+class ProcessError(SDKError):
+    """Raised when the opencode subprocess exits with an error or fails to start."""
+    def __init__(self, message: str, exit_code: int | None = None) -> None:
+        super().__init__(message)
+        self.exit_code = exit_code
+
+
+class TransportError(SDKError):
+    """Raised when there is a communication error with the OpenCode server."""
+    pass
+
+
+class SessionError(SDKError):
+    """Raised when a session-related error occurs (e.g., missing session, expiration)."""
+    pass
+
+
+class ToolError(SDKError):
+    """Raised when a tool execution hook fails or returns an error."""
+    pass
+

{opencode_agent_sdk-0.4.6 → opencode_agent_sdk-0.4.8}/src/opencode_agent_sdk/_internal/acp.py

@@ -341,15 +341,28 @@ class ACPSession:
                 text = content.get("text", "")
                 if text:
                     self._text_buffer += text
+                    # Flush immediately so consumers can stream text incrementally
+                    yield AssistantMessage(
+                        content=[TextBlock(text=self._text_buffer)]
+                    )
+                    self._text_buffer = ""
 
             elif update_type == "tool_call":
                 tool_call_id = session_update.get("toolCallId", "")
+                tool_name = session_update.get("title", "")
                 self._tool_calls[tool_call_id] = {
                     "id": tool_call_id,
-                    "name": session_update.get("title", ""),
+                    "name": tool_name,
                     "input": session_update.get("rawInput", {}),
                     "status": session_update.get("status", "pending"),
                 }
+                # Flush text buffer before tool starts so consumers see
+                # accumulated text immediately rather than after tool completes
+                if self._text_buffer:
+                    yield AssistantMessage(
+                        content=[TextBlock(text=self._text_buffer)]
+                    )
+                    self._text_buffer = ""
 
             elif update_type == "tool_call_update":
                 tool_call_id = session_update.get("toolCallId", "")
@@ -396,10 +409,12 @@ class ACPSession:
                 )
 
             elif update_type == "agent_thought_chunk":
+                # Yield thinking text as AssistantMessage so consumers can
+                # stream it without needing to handle SystemMessage separately.
+                # Kept separate from _text_buffer to avoid mixing with response text.
                 content = session_update.get("content", {})
                 text = content.get("text", "")
                 if text:
-                    yield SystemMessage(
-                        subtype="thought",
-                        data={"text": text},
+                    yield AssistantMessage(
+                        content=[TextBlock(text=text)]
                     )

{opencode_agent_sdk-0.4.6 → opencode_agent_sdk-0.4.8}/src/opencode_agent_sdk/_internal/http_transport.py

@@ -254,7 +254,7 @@ class HTTPTransport:
                     data={
                         "tool_name": tool_name,
                         "tool_id": part.get("callID", part_id),
-                        "error": str(state),
+                        "error": str(state.get("error", state)),
                     },
                 )
 
@@ -263,11 +263,15 @@ class HTTPTransport:
 
         elif part_type == "step-finish":
             tokens = part.get("tokens", {})
+            from ..types import Usage
+            usage = Usage(
+                input_tokens=int(tokens.get("input", 0)),
+                output_tokens=int(tokens.get("output", 0)),
+                cache_creation_input_tokens=tokens.get("cache_creation_input_tokens"),
+                cache_read_input_tokens=tokens.get("cache_read_input_tokens"),
+            )
             return ResultMessage(
-                usage={
-                    "input_tokens": int(tokens.get("input", 0)),
-                    "output_tokens": int(tokens.get("output", 0)),
-                },
+                usage=usage,
                 total_cost_usd=part.get("cost", 0.0),
                 session_id=part.get("sessionID", self._session_id),
                 duration_ms=0.0,

{opencode_agent_sdk-0.4.6 → opencode_agent_sdk-0.4.8}/src/opencode_agent_sdk/types.py

@@ -4,6 +4,15 @@ from dataclasses import dataclass, field
 from typing import Any, Callable
 
 
+@dataclass
+class Usage:
+    """Usage stats for a response."""
+    input_tokens: int = 0
+    output_tokens: int = 0
+    cache_creation_input_tokens: int | None = None
+    cache_read_input_tokens: int | None = None
+
+
 @dataclass
 class TextBlock:
     text: str
@@ -26,7 +35,7 @@ class AssistantMessage:
 
 @dataclass
 class ResultMessage:
-    usage: dict[str, Any] = field(default_factory=dict)
+    usage: Usage = field(default_factory=Usage)
     total_cost_usd: float = 0.0
     session_id: str = ""
     duration_ms: float = 0.0

{opencode_agent_sdk-0.4.6 → opencode_agent_sdk-0.4.8}/src/opencode_agent_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-agent-sdk
-Version: 0.4.6
+Version: 0.4.8
 Summary: Open-source Agent SDK backed by OpenCode ACP (drop-in replacement for claude_agent_sdk)
 Author: OpenCode
 License: MIT
@@ -71,9 +71,13 @@ async def main():
 asyncio.run(main())
 ```
 
-## SDKClient
+## Why OpenCode Agent SDK?
 
-`SDKClient` supports bidirectional conversations with an LLM via OpenCode. It works in two transport modes:
+- **Drop-in Replacement**: Seamlessly switch from `claude_agent_sdk` by just changing your imports.
+- **Open Source & Headless**: Take full control of your agent infrastructure. No more proprietary black boxes.
+- **Multi-Provider Support**: Use any LLM (Anthropic, OpenAI, xAI, Google, Locall) via OpenCode's backend.
+- **Native SSE Streaming**: Real-time response streaming for a better user experience.
+- **Advanced Control**: Fine-grained tool permission hooks and MCP server support builtin.
 
 - **HTTP mode** — communicates with a running `opencode serve` instance over REST
 - **Subprocess mode** — spawns `opencode acp` locally over stdio JSON-RPC

{opencode_agent_sdk-0.4.6 → opencode_agent_sdk-0.4.8}/src/opencode_agent_sdk.egg-info/SOURCES.txt

@@ -19,4 +19,5 @@ src/opencode_agent_sdk/_internal/transport.py
 tests/test_common.py
 tests/test_model_registry.py
 tests/test_opencode_agent.py
-tests/test_runner.py
+tests/test_runner.py
+tests/test_types.py

opencode_agent_sdk-0.4.8/tests/test_types.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+import unittest
+from opencode_agent_sdk.types import ResultMessage, Usage
+
+class TestTypes(unittest.TestCase):
+    def test_result_message_usage_robustness(self):
+        # Testing the new Usage class integration
+        usage = Usage(input_tokens=10, output_tokens=20)
+        msg = ResultMessage(usage=usage, total_cost_usd=0.01)
+        
+        self.assertEqual(msg.usage.input_tokens, 10)
+        self.assertEqual(msg.usage.output_tokens, 20)
+        self.assertEqual(msg.total_cost_usd, 0.01)
+
+    def test_usage_default_values(self):
+        usage = Usage()
+        self.assertEqual(usage.input_tokens, 0)
+        self.assertEqual(usage.output_tokens, 0)
+        self.assertIsNone(usage.cache_read_input_tokens)
+
+if __name__ == "__main__":
+    unittest.main()

opencode_agent_sdk-0.4.6/src/opencode_agent_sdk/_errors.py

@@ -1,9 +0,0 @@
-from __future__ import annotations
-
-
-class ProcessError(Exception):
-    """Raised when the opencode subprocess exits with an error."""
-
-    def __init__(self, message: str, exit_code: int | None = None) -> None:
-        super().__init__(message)
-        self.exit_code = exit_code