clawd-code-sdk 0.3.1__tar.gz → 0.3.2__tar.gz

{clawd_code_sdk-0.3.1 → clawd_code_sdk-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clawd-code-sdk
-Version: 0.3.1
+Version: 0.3.2
 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-0.3.1 → clawd_code_sdk-0.3.2}/pyproject.toml

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

{clawd_code_sdk-0.3.1 → clawd_code_sdk-0.3.2}/src/clawd_code_sdk/__init__.py

@@ -28,6 +28,7 @@ from .models import (
     BaseHookInput,
     CanUseTool,
     ClaudeAgentOptions,
+    OnUserQuestion,
     ContentBlock,
     HookCallback,
     HookContext,
@@ -141,6 +142,7 @@ __all__ = [
     "ContentBlock",
     # Tool callbacks
     "CanUseTool",
+    "OnUserQuestion",
     "ToolPermissionContext",
     "PermissionResult",
     "PermissionResultAllow",

{clawd_code_sdk-0.3.1 → clawd_code_sdk-0.3.2}/src/clawd_code_sdk/_internal/query.py

@@ -44,9 +44,10 @@ if TYPE_CHECKING:
     from clawd_code_sdk.models import ControlRequestUnion, PermissionMode
     from clawd_code_sdk.models.agents import AgentDefinition
     from clawd_code_sdk.models.hooks import HookEvent, HookMatcher
+    from clawd_code_sdk.models.input_types import AskUserQuestionInput
     from clawd_code_sdk.models.mcp import JSONRPCMessage, JSONRPCResponse, RequestId
     from clawd_code_sdk.models.messages import UserPromptMessage
-    from clawd_code_sdk.models.permissions import CanUseTool, PermissionResult
+    from clawd_code_sdk.models.permissions import CanUseTool, OnUserQuestion, PermissionResult
 
 logger = logging.getLogger(__name__)
 
@@ -93,6 +94,7 @@ class Query:
         self,
         transport: Transport,
         can_use_tool: CanUseTool | None = None,
+        on_user_question: OnUserQuestion | None = None,
         hooks: dict[HookEvent, list[HookMatcher]] | None = None,
         sdk_mcp_servers: dict[str, McpServer] | None = None,
         initialize_timeout: float = 60.0,
@@ -107,6 +109,7 @@ class Query:
         Args:
             transport: Low-level transport for I/O
             can_use_tool: Optional callback for tool permission requests
+            on_user_question: Optional callback for AskUserQuestion elicitation
             hooks: Optional hook configurations
             sdk_mcp_servers: Optional SDK MCP server instances
             initialize_timeout: Timeout in seconds for the initialize request
@@ -119,6 +122,7 @@ class Query:
         self._initialize_timeout = initialize_timeout
         self.transport = transport
         self.can_use_tool = can_use_tool
+        self.on_user_question = on_user_question
         self.hooks = convert_hooks_to_internal_format(hooks) if hooks else {}
         self.sdk_mcp_servers = sdk_mcp_servers or {}
         self._agents = {name: agent_def.to_dict() for name, agent_def in (agents or {}).items()}
@@ -317,16 +321,28 @@ class Query:
     async def _handle_permission_request(
         self, req: SDKControlPermissionRequest
     ) -> PermissionResult:
-        """Handle a tool permission request."""
-        if not self.can_use_tool:
-            raise RuntimeError("canUseTool callback is not provided")
+        """Handle a tool permission request.
 
+        Dispatches AskUserQuestion to on_user_question if set,
+        otherwise falls through to can_use_tool for backwards compatibility.
+        """
         context = ToolPermissionContext(
             tool_use_id=req.tool_use_id,
             suggestions=req.permission_suggestions or [],
             blocked_path=req.blocked_path,
         )
 
+        # Dispatch elicitation requests to dedicated callback if available
+        if req.tool_name == "AskUserQuestion" and self.on_user_question:
+            input_data: AskUserQuestionInput = req.input  # type: ignore[assignment]
+            result = await self.on_user_question(input_data, context)
+            if isinstance(result, PermissionResultAllow) and result.updated_input is None:
+                result.updated_input = req.input
+            return result
+
+        if not self.can_use_tool:
+            raise RuntimeError("canUseTool callback is not provided")
+
         result = await self.can_use_tool(req.tool_name, req.input, context)
         if isinstance(result, PermissionResultAllow) and result.updated_input is None:
             result.updated_input = req.input

{clawd_code_sdk-0.3.1 → clawd_code_sdk-0.3.2}/src/clawd_code_sdk/client.py

@@ -141,6 +141,7 @@ class ClaudeSDKClient:
         self._query = Query(
             transport=self._transport,
             can_use_tool=self.options.can_use_tool,
+            on_user_question=self.options.on_user_question,
             hooks=self.options.hooks,
             sdk_mcp_servers=sdk_mcp_servers,
             initialize_timeout=initialize_timeout,

{clawd_code_sdk-0.3.1 → clawd_code_sdk-0.3.2}/src/clawd_code_sdk/models/__init__.py

@@ -244,6 +244,7 @@ from .options import (
 )
 from .permissions import (
     CanUseTool,
+    OnUserQuestion,
     PermissionResult,
     PermissionResultAllow,
     PermissionResultDeny,
@@ -272,6 +273,7 @@ __all__ = [
     "ToolsPreset",
     # permissions
     "CanUseTool",
+    "OnUserQuestion",
     "PermissionBehavior",
     "PermissionResult",
     "PermissionResultAllow",

{clawd_code_sdk-0.3.1 → clawd_code_sdk-0.3.2}/src/clawd_code_sdk/models/content_blocks.py

@@ -17,24 +17,24 @@ if TYPE_CHECKING:
 
 
 # Content block types
-@dataclass
+@dataclass(kw_only=True)
 class TextBlock:
     """Text content block."""
 
     type: Literal["text"] = field(default="text", repr=False)
-    text: str = ""
+    text: str
 
 
-@dataclass
+@dataclass(kw_only=True)
 class ThinkingBlock:
     """Thinking content block."""
 
     type: Literal["thinking"] = field(default="thinking", repr=False)
-    thinking: str = ""
-    signature: str = ""
+    thinking: str
+    signature: str
 
 
-@dataclass
+@dataclass(kw_only=True)
 class ToolUseBlock:
     """Tool use content block."""
 
@@ -45,7 +45,7 @@ class ToolUseBlock:
     caller: dict[str, str] | None = None
 
 
-@dataclass
+@dataclass(kw_only=True)
 class ToolResultBlock:
     """Tool result content block."""
 

{clawd_code_sdk-0.3.1 → clawd_code_sdk-0.3.2}/src/clawd_code_sdk/models/options.py

@@ -13,6 +13,7 @@ if TYPE_CHECKING:
     from collections.abc import Callable
 
     from clawd_code_sdk.models.base import ModelName
+    from clawd_code_sdk.models.permissions import OnUserQuestion
 
     from .agents import AgentDefinition, SystemPromptPreset, ToolsPreset
     from .base import PermissionMode, ReasoningEffort, SettingSource, ThinkingConfig
@@ -155,6 +156,13 @@ class ClaudeAgentOptions:
     """MCP tool to handle permission prompts."""
     can_use_tool: CanUseTool | None = None
     """Tool permission callback."""
+    on_user_question: OnUserQuestion | None = None
+    """Callback for handling AskUserQuestion elicitation requests.
+
+    Called when Claude asks the user a clarifying question via the
+    AskUserQuestion tool. If not set, these requests fall through
+    to can_use_tool (if set) for backwards compatibility.
+    """
     # Session
     session: str | SessionConfig | None = None
     """Session configuration.

{clawd_code_sdk-0.3.1 → clawd_code_sdk-0.3.2}/src/clawd_code_sdk/models/permissions.py

@@ -6,12 +6,12 @@ from collections.abc import Awaitable, Callable
 from dataclasses import dataclass, field
 from typing import Any, Literal
 
-from clawd_code_sdk.models import ToolInput
 from clawd_code_sdk.models.base import (
     ClaudeCodeBaseModel,
     PermissionBehavior,  # noqa: TC001
     PermissionMode,  # noqa: TC001
 )
+from clawd_code_sdk.models.input_types import AskUserQuestionInput, ToolInput
 
 
 # Permission Update types (matching TypeScript SDK)
@@ -107,3 +107,13 @@ PermissionResult = PermissionResultAllow | PermissionResultDeny
 CanUseTool = Callable[
     [str, ToolInput | dict[str, Any], ToolPermissionContext], Awaitable[PermissionResult]
 ]
+
+OnUserQuestion = Callable[
+    [AskUserQuestionInput, ToolPermissionContext], Awaitable[PermissionResult]
+]
+"""Callback for handling AskUserQuestion elicitation requests.
+
+Called when Claude asks the user a clarifying question.
+The callback should return a PermissionResultAllow with updated_input
+containing the answers, or a PermissionResultDeny to cancel.
+"""

{clawd_code_sdk-0.3.1 → clawd_code_sdk-0.3.2}/tests/test_session.py

@@ -89,7 +89,7 @@ TOOL_USE_MSG = {
                 "type": "tool_use",
                 "id": "tool-123",
                 "name": "Read",
-                "input": {"path": "/tmp/test.py"},
+                "input": {"file_path": "/tmp/test.py"},
             },
         ],
         model="claude-sonnet-4-5-20250514",
@@ -260,7 +260,7 @@ class TestSession:
                 tc = turn.tool_calls[0]
                 assert tc.tool_use_id == "tool-123"
                 assert tc.tool_name == "Read"
-                assert tc.input == {"path": "/tmp/test.py"}
+                assert tc.input == {"file_path": "/tmp/test.py"}
 
         anyio.run(_test)