chore: address pr comments

Signed-off-by: Rushil Patel <rpatel@codegen.com>

Author: rushilpatel0

src/claude_code_sdk/_internal/transport/__init__.py

@@ -4,11 +4,15 @@
 from collections.abc import AsyncIterator
 from typing import Any
 
-from claude_code_sdk.types import ClaudeCodeOptions
-
 
 class Transport(ABC):
-    """Abstract transport for Claude communication."""
+    """Abstract transport for Claude communication.
+
+    WARNING: This internal API is exposed for custom transport implementations
+    (e.g., remote Claude Code connections). The Claude Code team may change or
+    or remove this abstract class in any future release. Custom implementations
+    must be updated to match interface changes.
+    """
 
     @abstractmethod
     def configure(self, prompt: str, options: ClaudeCodeOptions) -> None:
@@ -43,5 +47,4 @@ def is_connected(self) -> bool:
         pass
 
 
-# Import implementations
 __all__ = ["Transport"]

src/claude_code_sdk/types.py

@@ -128,3 +128,4 @@ class ClaudeCodeOptions:
     permission_prompt_tool_name: str | None = None
     cwd: str | Path | None = None
     settings: str | None = None
+    

tests/test_client.py

@@ -111,4 +111,4 @@ async def mock_receive():
                 assert call_kwargs["prompt"] == "test"
                 assert call_kwargs["options"].cwd == "/custom/path"
 
-        anyio.run(_test)
+        anyio.run(_test)

tests/test_integration.py

@@ -199,4 +199,4 @@ async def mock_receive():
                 call_kwargs = mock_transport_class.call_args.kwargs
                 assert call_kwargs["options"].continue_conversation is True
 
-        anyio.run(_test)
+        anyio.run(_test)

tests/test_subprocess_buffering.py

@@ -304,4 +304,4 @@ async def _test() -> None:
             assert messages[2]["type"] == "system"
             assert messages[2]["subtype"] == "end"
 
-        anyio.run(_test)
+        anyio.run(_test)

tests/test_transport.py

@@ -155,4 +155,4 @@ async def _test():
 
             assert "/this/directory/does/not/exist" in str(exc_info.value)
 
-        anyio.run(_test)
+        anyio.run(_test)