clawd-code-sdk 1.0.6__tar.gz → 1.0.7__tar.gz

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clawd-code-sdk
-Version: 1.0.6
+Version: 1.0.7
 Summary: Python SDK for Claude Code
 Project-URL: Documentation, https://github.com/phil65/claude-agent-sdk-python
 Project-URL: Homepage, https://github.com/phil65/claude-agent-sdk-python

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "clawd-code-sdk"
-version = "1.0.6"
+version = "1.0.7"
 description = "Python SDK for Claude Code"
 readme = "README.md"
 requires-python = ">=3.13"

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/src/clawd_code_sdk/__init__.py

@@ -51,8 +51,13 @@ from .models import (
     McpSdkServerConfig,
     McpSdkServerConfigWithInstance,
     McpServerConfig,
+    AppliedSettings,
+    GetSettingsResponse,
+    McpAuthenticateResponse,
     McpSetServersResult,
+    SettingsSource,
     Message,
+    RemoteControlResponse,
     NotificationHookInput,
     NotificationHookSpecificOutput,
     PermissionMode,
@@ -138,6 +143,7 @@ __all__ = [
     # Hook support
     "AgentHookHandler",
     "AgentHooksConfig",
+    "AppliedSettings",
     "AssistantMessage",
     "AuthenticationError",
     "BaseHookInput",
@@ -163,6 +169,7 @@ __all__ = [
     "DocumentMediaType",
     "Filesystem",
     "FromPR",
+    "GetSettingsResponse",
     "HookCallback",
     "HookContext",
     "HookHandler",
@@ -177,6 +184,7 @@ __all__ = [
     "InitSystemMessage",
     "InvalidRequestError",
     "ListSessionsOptions",
+    "McpAuthenticateResponse",
     "McpSdkServerConfig",
     "McpSdkServerConfigWithInstance",
     "McpServerConfig",
@@ -206,6 +214,7 @@ __all__ = [
     "ProcessError",
     "PromptHookHandler",
     "RateLimitError",
+    "RemoteControlResponse",
     "ResultErrorMessage",
     "ResultMessage",
     "ResultSuccessMessage",
@@ -225,6 +234,7 @@ __all__ = [
     "SessionSnapshot",
     "SessionState",
     "SettingSource",
+    "SettingsSource",
     "StopHookInput",
     "SubagentStartHookInput",
     "SubagentStartHookSpecificOutput",

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/src/clawd_code_sdk/_internal/query.py

@@ -522,6 +522,45 @@ class Query:
         """End the current session."""
         return await self._send_control_request({"subtype": "end_session"})
 
+    async def remote_control(self, *, enabled: bool) -> dict[str, Any]:
+        """Toggle the remote control REPL bridge for external session access.
+
+        When enabled, starts a bridge that allows remote clients to send prompts,
+        permission responses, interrupts, and model changes into the session.
+        The response includes ``session_url``, ``connect_url``, and
+        ``environment_id`` when enabling.
+        """
+        req = {"subtype": "remote_control", "enabled": enabled}
+        return await self._send_control_request(req)
+
+    async def apply_flag_settings(self, settings: dict[str, Any]) -> dict[str, Any]:
+        """Apply runtime flag settings."""
+        req = {"subtype": "apply_flag_settings", "settings": settings}
+        return await self._send_control_request(req)
+
+    async def get_settings(self) -> dict[str, Any]:
+        """Get the effective merged settings and raw per-source settings."""
+        return await self._send_control_request({"subtype": "get_settings"})
+
+    async def mcp_authenticate(self, server_name: str) -> dict[str, Any]:
+        """Trigger OAuth authentication for an MCP server."""
+        req = {"subtype": "mcp_authenticate", "serverName": server_name}
+        return await self._send_control_request(req)
+
+    async def mcp_clear_auth(self, server_name: str) -> dict[str, Any]:
+        """Clear OAuth credentials for an MCP server."""
+        req = {"subtype": "mcp_clear_auth", "serverName": server_name}
+        return await self._send_control_request(req)
+
+    async def mcp_oauth_callback_url(self, server_name: str, callback_url: str) -> dict[str, Any]:
+        """Provide an OAuth redirect callback URL to complete an MCP server OAuth flow."""
+        req = {
+            "subtype": "mcp_oauth_callback_url",
+            "serverName": server_name,
+            "callbackUrl": callback_url,
+        }
+        return await self._send_control_request(req)
+
     async def rewind_files(self, user_message_id: str) -> dict[str, Any]:
         """Rewind tracked files to their state at a specific user message.
 

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/src/clawd_code_sdk/anthropic_types.py

@@ -7,6 +7,7 @@ used to provide proper typing for ToolResultBlock.content.
 
 from __future__ import annotations
 
+import functools
 from typing import Annotated
 
 from anthropic.types.beta import (
@@ -73,35 +74,32 @@ ToolResultContentBlock = Annotated[
     | BetaTextEditorCodeExecutionToolResultError,
     Field(discriminator="type"),
 ]
-_tool_result_content_adapter: TypeAdapter[list[ToolResultContentBlock]] | None = None
 
 
+@functools.cache
 def _get_adapter() -> TypeAdapter[list[ToolResultContentBlock]]:
-    global _tool_result_content_adapter  # noqa: PLW0603
-    if _tool_result_content_adapter is None:
-        # Force schema build for Anthropic models (deferred by default)
-        for model in [
-            BetaTextBlock,
-            BetaWebSearchResultBlock,
-            BetaWebSearchToolResultError,
-            BetaBashCodeExecutionResultBlock,
-            BetaBashCodeExecutionToolResultError,
-            BetaCodeExecutionResultBlock,
-            BetaCodeExecutionToolResultError,
-            BetaTextEditorCodeExecutionCreateResultBlock,
-            BetaTextEditorCodeExecutionStrReplaceResultBlock,
-            BetaTextEditorCodeExecutionToolResultError,
-            BetaTextEditorCodeExecutionViewResultBlock,
-            BetaToolReferenceBlock,
-            BetaToolSearchToolResultError,
-            BetaToolSearchToolSearchResultBlock,
-            BetaWebFetchBlock,
-            BetaWebFetchToolResultErrorBlock,
-        ]:
-            if isinstance(model, type) and issubclass(model, BaseModel):
-                model.model_rebuild()
-        _tool_result_content_adapter = TypeAdapter(list[ToolResultContentBlock])
-    return _tool_result_content_adapter
+    # Force schema build for Anthropic models (deferred by default)
+    for model in [
+        BetaTextBlock,
+        BetaWebSearchResultBlock,
+        BetaWebSearchToolResultError,
+        BetaBashCodeExecutionResultBlock,
+        BetaBashCodeExecutionToolResultError,
+        BetaCodeExecutionResultBlock,
+        BetaCodeExecutionToolResultError,
+        BetaTextEditorCodeExecutionCreateResultBlock,
+        BetaTextEditorCodeExecutionStrReplaceResultBlock,
+        BetaTextEditorCodeExecutionToolResultError,
+        BetaTextEditorCodeExecutionViewResultBlock,
+        BetaToolReferenceBlock,
+        BetaToolSearchToolResultError,
+        BetaToolSearchToolSearchResultBlock,
+        BetaWebFetchBlock,
+        BetaWebFetchToolResultErrorBlock,
+    ]:
+        if isinstance(model, type) and issubclass(model, BaseModel):
+            model.model_rebuild()
+    return TypeAdapter(list[ToolResultContentBlock])
 
 
 def validate_tool_result_content(content: list[dict[str, object]]) -> list[ToolResultContentBlock]:

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/src/clawd_code_sdk/client.py

@@ -14,9 +14,12 @@ from clawd_code_sdk.models import (
     AssistantMessage,
     ClaudeAgentOptions,
     ClaudeCodeAgentInfo,  # noqa: TC001
+    GetSettingsResponse,
+    McpAuthenticateResponse,
     McpSdkServerConfigWithInstance,
     McpSetServersResult,
     McpStatusResponse,
+    RemoteControlResponse,
     ResultErrorMessage,
     ResultMessage,
     ResultSuccessMessage,
@@ -33,6 +36,7 @@ if TYPE_CHECKING:
     from clawd_code_sdk._internal.query import Query
     from clawd_code_sdk.models import (
         ClaudeCodeServerInfo,
+        ClaudeCodeSettings,
         McpServerConfig,
         Message,
         PermissionMode,
@@ -338,6 +342,65 @@ class ClaudeSDKClient:
         query = self._ensure_connected()
         await query.end_session()
 
+    async def remote_control(self, *, enabled: bool) -> RemoteControlResponse | None:
+        """Toggle the remote control REPL bridge for external session access.
+
+        When enabled, starts a bridge that allows remote clients to send prompts,
+        permission responses, interrupts, and model changes into the session.
+
+        Returns:
+            A ``RemoteControlResponse`` with session URLs and environment ID
+            when enabling, or ``None`` when disabling.
+        """
+        query = self._ensure_connected()
+        result = await query.remote_control(enabled=enabled)
+        if not result:
+            return None
+        return RemoteControlResponse.model_validate(result)
+
+    async def apply_flag_settings(self, settings: ClaudeCodeSettings) -> None:
+        """Apply runtime settings overrides without restarting the session.
+
+        Flag settings are an in-memory settings source that gets merged with
+        other sources (user, project, etc.) to produce the effective settings.
+
+        Args:
+            settings: Settings to apply. Only non-None fields will be sent.
+        """
+        query = self._ensure_connected()
+        serialized = settings.model_dump(by_alias=True, exclude_none=True)
+        await query.apply_flag_settings(serialized)
+
+    async def get_settings(self) -> GetSettingsResponse:
+        """Get the effective merged settings and raw per-source settings."""
+        query = self._ensure_connected()
+        result = await query.get_settings()
+        return GetSettingsResponse.model_validate(result)
+
+    async def mcp_authenticate(self, server_name: str) -> McpAuthenticateResponse:
+        """Trigger OAuth authentication for an MCP server.
+
+        Returns:
+            Response indicating whether user action is required and the auth URL if so.
+        """
+        query = self._ensure_connected()
+        result = await query.mcp_authenticate(server_name)
+        return McpAuthenticateResponse.model_validate(result)
+
+    async def mcp_clear_auth(self, server_name: str) -> None:
+        """Clear OAuth credentials for an MCP server."""
+        query = self._ensure_connected()
+        await query.mcp_clear_auth(server_name)
+
+    async def mcp_oauth_callback_url(self, server_name: str, callback_url: str) -> None:
+        """Provide an OAuth redirect callback URL to complete an MCP server OAuth flow.
+
+        After the user completes browser-based OAuth, call this with the full
+        redirect URL (containing the authorization code) to finish the flow.
+        """
+        query = self._ensure_connected()
+        await query.mcp_oauth_callback_url(server_name, callback_url)
+
     async def set_max_thinking_tokens(self, max_thinking_tokens: int) -> None:
         """Set the maximum number of thinking tokens for extended thinking."""
         query = self._ensure_connected()

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/src/clawd_code_sdk/models/__init__.py

@@ -34,7 +34,12 @@ from .control import (
     SDKControlMcpMessageRequest,
     SDKControlMcpOAuthCallbackUrlRequest,
     SDKControlPermissionRequest,
+    AppliedSettings,
+    GetSettingsResponse,
+    McpAuthenticateResponse,
+    RemoteControlResponse,
     SDKControlRemoteControlRequest,
+    SettingsSource,
     SDKControlRequest,
     SDKControlResponse,
     SDKControlRewindFilesRequest,
@@ -214,7 +219,6 @@ from .content_blocks import (
     ThinkingBlock,
     ToolResultBlock,
     ToolUseBlock,
-    content_block_adapter,
 )
 from .session import SDKSessionInfo, ListSessionsOptions
 from .messages import (
@@ -367,6 +371,7 @@ __all__ = [
     "AgentOutputUsage",
     "AgentServerToolUse",
     "ApiKeySource",
+    "AppliedSettings",
     "AskUserQuestion",
     "AskUserQuestionInput",
     "AskUserQuestionItem",
@@ -424,6 +429,7 @@ __all__ = [
     "FilesPersistedSystemMessage",
     "Filesystem",
     "FromPR",
+    "GetSettingsResponse",
     "GitDiff",
     "GlobInput",
     "GlobOutput",
@@ -460,6 +466,7 @@ __all__ = [
     "ListMcpResourcesOutput",
     "ListSessionsOptions",
     "LocalCommandOutputMessage",
+    "McpAuthenticateResponse",
     "McpClaudeAIProxyServerConfig",
     "McpConnectionStatus",
     "McpHttpServerConfig",
@@ -532,6 +539,7 @@ __all__ = [
     "ReadPdfOutput",
     "ReadTextOutput",
     "ReasoningEffort",
+    "RemoteControlResponse",
     "RequestId",
     "ResultErrorMessage",
     "ResultMessage",
@@ -564,6 +572,7 @@ __all__ = [
     "SessionStartHookInput",
     "SessionStartHookSpecificOutput",
     "SettingSource",
+    "SettingsSource",
     "SetupHookInput",
     "SkillInput",
     "SkillOutput",
@@ -631,7 +640,6 @@ __all__ = [
     "WorktreeCreateHookInput",
     "WorktreeRemoveHookInput",
     "WriteOutput",
-    "content_block_adapter",
     "control_request_adapter",
     "message_adapter",
     "system_message_adapter",

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/src/clawd_code_sdk/models/base.py

@@ -26,6 +26,8 @@ CompactionTrigger = Literal["auto", "manual"]
 ElicitationMode = Literal["form", "url"]
 ElicitationAction = Literal["accept", "decline", "cancel"]
 FastModeState = Literal["off", "cooldown", "on"]
+EffortLevel = Literal["low", "medium", "high", "max"]
+
 
 StopReason = Literal[
     "end_turn",

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/src/clawd_code_sdk/models/content_blocks.py

@@ -11,7 +11,7 @@ from collections.abc import Sequence
 from typing import TYPE_CHECKING, Annotated, Any, Literal
 
 from anthropic.types.beta.beta_tool_use_block import Caller
-from pydantic import BaseModel, ConfigDict, Discriminator, TypeAdapter
+from pydantic import BaseModel, ConfigDict, Discriminator
 
 from clawd_code_sdk.models import ToolInput
 from clawd_code_sdk.models.base import ClaudeCodeBaseModel, StopReason, ToolName
@@ -110,8 +110,6 @@ ContentBlock = Annotated[
     Discriminator("type"),
 ]
 
-content_block_adapter = TypeAdapter[ContentBlock](ContentBlock)
-
 
 # =============================================================================
 # Message-level models

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/src/clawd_code_sdk/models/control.py

@@ -5,12 +5,19 @@ from __future__ import annotations
 from dataclasses import dataclass
 from typing import Annotated, Any, Literal, TypedDict
 
-from pydantic import Discriminator, TypeAdapter
+from pydantic import BaseModel, Discriminator, TypeAdapter
 
 from clawd_code_sdk.models.agents import AgentDefinition  # noqa: TC001
-from clawd_code_sdk.models.base import ElicitationMode, PermissionMode  # noqa: TC001
+from clawd_code_sdk.models.base import (  # noqa: TC001
+    ClaudeCodeBaseModel,
+    EffortLevel,
+    ElicitationMode,
+    ModelName,
+    PermissionMode,
+)
 from clawd_code_sdk.models.hooks import HookEvent, HookInput  # noqa: TC001
 from clawd_code_sdk.models.mcp import ExternalMcpServerConfig, JSONRPCMessage  # noqa: TC001
+from clawd_code_sdk.models.permissions import PermissionUpdate  # noqa: TC001
 
 
 # SDK Control Protocol
@@ -29,7 +36,7 @@ class SDKControlPermissionRequest:
     tool_name: str
     input: dict[str, Any]
     tool_use_id: str
-    permission_suggestions: list[Any] | None = None
+    permission_suggestions: list[PermissionUpdate] | None = None
     blocked_path: str | None = None
     decision_reason: str | None = None
     agent_id: str | None = None
@@ -209,6 +216,66 @@ class SDKControlRemoteControlRequest:
     enabled: bool = False
 
 
+class RemoteControlResponse(BaseModel):
+    """Response from enabling remote control.
+
+    Contains the URLs and identifiers needed for remote clients to connect
+    to the session.
+    """
+
+    session_url: str
+    """URL for the remote control session."""
+
+    connect_url: str
+    """URL for remote clients to connect to the session."""
+
+    environment_id: str
+    """Identifier for the environment hosting the session."""
+
+
+class McpAuthenticateResponse(ClaudeCodeBaseModel):
+    """Response from authenticating with an MCP server."""
+
+    auth_url: str | None = None
+    """OAuth authorization URL for the user to visit, if user action is required."""
+
+    requires_user_action: bool
+    """Whether the user needs to complete an OAuth flow in the browser."""
+
+
+class AppliedSettings(BaseModel):
+    """The currently applied model and effort settings."""
+
+    model: ModelName | str
+    """The active model identifier."""
+
+    effort: EffortLevel | None = None
+    """The active effort level, or None if not set."""
+
+
+class SettingsSource(BaseModel):
+    """A single settings source with its raw settings."""
+
+    source: str
+    """The source name (e.g. 'user', 'project', 'flagSettings')."""
+
+    settings: dict[str, Any]
+    """The raw settings from this source."""
+
+
+class GetSettingsResponse(BaseModel):
+    """Response from get_settings() containing effective and per-source settings."""
+
+    effective: dict[str, Any]
+    """The merged effective settings (ClaudeCodeSettings shape, camelCase keys)."""
+
+    sources: list[SettingsSource]
+    """Raw settings from each source."""
+
+    applied: AppliedSettings
+    """The currently applied model and effort."""
+
+
 @dataclass(frozen=True, slots=True, kw_only=True)
 class SDKControlElicitationRequest:
     """Requests the SDK consumer to handle an MCP elicitation (user input request)."""

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/src/clawd_code_sdk/models/hooks.py

@@ -11,6 +11,7 @@ from clawd_code_sdk.models.base import (  # noqa: TC001
     ElicitationAction,
     ElicitationMode,
 )
+from clawd_code_sdk.models.permissions import PermissionUpdate  # noqa: TC001
 
 
 if TYPE_CHECKING:
@@ -237,7 +238,7 @@ class PermissionRequestHookInput(BaseHookInput):
     hook_event_name: Literal["PermissionRequest"]
     tool_name: str
     tool_input: dict[str, Any]
-    permission_suggestions: NotRequired[list[Any]]
+    permission_suggestions: NotRequired[list[PermissionUpdate]]
     agent_id: NotRequired[str]
     agent_type: NotRequired[str]
 

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/src/clawd_code_sdk/models/permissions.py

@@ -6,7 +6,6 @@ from collections.abc import Awaitable, Callable
 from dataclasses import dataclass, field
 from typing import Any, Literal
 
-from clawd_code_sdk.models import AskUserQuestionInput, ToolInput
 from clawd_code_sdk.models.base import (
     ClaudeCodeBaseModel,
     ElicitationAction,  # noqa: TC001
@@ -14,6 +13,7 @@ from clawd_code_sdk.models.base import (
     PermissionBehavior,
     PermissionMode,
 )
+from clawd_code_sdk.models.input_types import AskUserQuestionInput, ToolInput
 
 
 # Permission Update types (matching TypeScript SDK)

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/src/clawd_code_sdk/models/server_info.py

@@ -2,15 +2,10 @@
 
 from __future__ import annotations
 
-from typing import Literal
-
 from anthropic.types import Model
 from pydantic import Field
 
-from clawd_code_sdk.models.base import ClaudeCodeBaseModel, FastModeState
-
-
-EffortLevel = Literal["low", "medium", "high", "max"]
+from clawd_code_sdk.models.base import ClaudeCodeBaseModel, EffortLevel, FastModeState
 
 
 class ClaudeCodeModelInfo(ClaudeCodeBaseModel):

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.7}/tests/test_tool_callbacks.py

@@ -114,7 +114,7 @@ class TestToolPermissionCallbacks:
                 "tool_name": "DangerousTool",
                 "input": {"command": "rm -rf /"},
                 "tool_use_id": "tu-2",
-                "permission_suggestions": ["deny"],
+                "permission_suggestions": [],
                 "blocked_path": None,
             }
         )