clawd-code-sdk 0.6.1__tar.gz → 0.6.2__tar.gz

{clawd_code_sdk-0.6.1 → clawd_code_sdk-0.6.2}/PKG-INFO

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

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

{clawd_code_sdk-0.6.1 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/__init__.py

@@ -36,6 +36,8 @@ from .control import (
     SDKControlResponse,
     SDKControlRewindFilesRequest,
     SDKControlSetPermissionModeRequest,
+    SDKControlSetProactiveRequest,
+    SDKControlGetSettingsRequest,
     SDKControlStopTaskRequest,
     SDKHookCallbackRequest,
     control_request_adapter,
@@ -86,6 +88,7 @@ from .hooks import (
     UserPromptSubmitHookSpecificOutput,
     WorktreeCreateHookInput,
     WorktreeRemoveHookInput,
+    InstructionsLoadedHookInput,
 )
 from .input_types import (
     TOOL_INPUT_TYPES,
@@ -144,7 +147,6 @@ from .output_types import (
     AgentOutputTextContent,
     AgentOutputUsage,
     AgentServerToolUse,
-    AgentSubAgentEnteredOutput,
     AskUserQuestionItem,
     AskUserQuestionOutput,
     BashOutput,
@@ -235,6 +237,7 @@ from .prompts import (
     UserDocumentPrompt,
     PlainTextMediaType,
     UserDocumentURLPrompt,
+    UserFilePrompt,
     UserImagePrompt,
     UserImageURLPrompt,
     UserPlainTextDocumentPrompt,
@@ -251,6 +254,7 @@ from .options import (
     NewSession,
     ResumeSession,
     SessionConfig,
+    ToolConfig,
     resolve_session_config,
 )
 from .permissions import (
@@ -314,7 +318,6 @@ __all__ = [
     "AgentOutputTextContent",
     "AgentOutputUsage",
     "AgentServerToolUse",
-    "AgentSubAgentEnteredOutput",
     "ApiKeySource",
     "AskUserQuestion",
     "AskUserQuestionInput",
@@ -393,6 +396,7 @@ __all__ = [
     "Hooks",
     "ImageMediaType",
     "InitSystemMessage",
+    "InstructionsLoadedHookInput",
     "JSONRPCError",
     "JSONRPCErrorResponse",
     "JSONRPCMessage",
@@ -479,6 +483,7 @@ __all__ = [
     "ResultSuccessMessage",
     "ResumeSession",
     "SDKControlElicitationRequest",
+    "SDKControlGetSettingsRequest",
     "SDKControlInitializeRequest",
     "SDKControlInterruptRequest",
     "SDKControlMcpMessageRequest",
@@ -489,6 +494,7 @@ __all__ = [
     "SDKControlResponse",
     "SDKControlRewindFilesRequest",
     "SDKControlSetPermissionModeRequest",
+    "SDKControlSetProactiveRequest",
     "SDKControlStopTaskRequest",
     "SDKHookCallbackRequest",
     "SDKPermissionDenial",
@@ -536,6 +542,7 @@ __all__ = [
     "TodoWriteInput",
     "TodoWriteOutput",
     "TodoWriteToolUseResult",
+    "ToolConfig",
     "ToolInput",
     "ToolPermissionContext",
     "ToolProgressMessage",
@@ -550,6 +557,7 @@ __all__ = [
     "Usage",
     "UserDocumentPrompt",
     "UserDocumentURLPrompt",
+    "UserFilePrompt",
     "UserImagePrompt",
     "UserImageURLPrompt",
     "UserMessage",

{clawd_code_sdk-0.6.1 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/control.py

@@ -206,6 +206,20 @@ class SDKControlElicitationRequest:
     requested_schema: dict[str, Any] | None = None
 
 
+@dataclass(frozen=True, slots=True, kw_only=True)
+class SDKControlGetSettingsRequest:
+    """Returns the effective merged settings and the raw per-source settings."""
+
+    subtype: Literal["get_settings"] = "get_settings"
+
+
+@dataclass(frozen=True, slots=True, kw_only=True)
+class SDKControlSetProactiveRequest:
+    """Sets proactive mode configuration."""
+
+    subtype: Literal["set_proactive"] = "set_proactive"
+
+
 ControlRequestUnion = Annotated[
     SDKControlInterruptRequest
     | SDKControlPermissionRequest
@@ -224,8 +238,10 @@ ControlRequestUnion = Annotated[
     | SDKControlMcpClearAuthRequest
     | SDKControlMcpOAuthCallbackUrlRequest
     | SDKControlRemoteControlRequest
+    | SDKControlSetProactiveRequest
     | SDKControlStopTaskRequest
     | SDKControlApplyFlagSettingsRequest
+    | SDKControlGetSettingsRequest
     | SDKControlElicitationRequest,
     Discriminator("subtype"),
 ]

{clawd_code_sdk-0.6.1 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/hooks.py

@@ -38,6 +38,7 @@ HookEvent = Literal[
     "ConfigChange",
     "WorktreeCreate",
     "WorktreeRemove",
+    "InstructionsLoaded",
 ]
 
 
@@ -143,6 +144,8 @@ class PreToolUseHookInput(BaseHookInput):
     tool_name: str
     tool_input: dict[str, Any]
     tool_use_id: str
+    agent_id: NotRequired[str]
+    agent_type: NotRequired[str]
 
 
 class PostToolUseHookInput(BaseHookInput):
@@ -153,6 +156,8 @@ class PostToolUseHookInput(BaseHookInput):
     tool_input: dict[str, Any]
     tool_response: Any
     tool_use_id: str
+    agent_id: NotRequired[str]
+    agent_type: NotRequired[str]
 
 
 class PostToolUseFailureHookInput(BaseHookInput):
@@ -164,6 +169,8 @@ class PostToolUseFailureHookInput(BaseHookInput):
     tool_use_id: str
     error: str
     is_interrupt: NotRequired[bool]
+    agent_id: NotRequired[str]
+    agent_type: NotRequired[str]
 
 
 class UserPromptSubmitHookInput(BaseHookInput):
@@ -222,6 +229,8 @@ class PermissionRequestHookInput(BaseHookInput):
     tool_name: str
     tool_input: dict[str, Any]
     permission_suggestions: NotRequired[list[Any]]
+    agent_id: NotRequired[str]
+    agent_type: NotRequired[str]
 
 
 class SessionStartHookInput(BaseHookInput):
@@ -313,6 +322,18 @@ class ElicitationResultHookInput(BaseHookInput):
     content: NotRequired[dict[str, Any]]
 
 
+class InstructionsLoadedHookInput(BaseHookInput):
+    """Input data for InstructionsLoaded hook events."""
+
+    hook_event_name: Literal["InstructionsLoaded"]
+    file_path: str
+    memory_type: Literal["User", "Project", "Local", "Managed"]
+    load_reason: Literal["session_start", "nested_traversal", "path_glob_match", "include"]
+    globs: NotRequired[list[str]]
+    trigger_file_path: NotRequired[str]
+    parent_file_path: NotRequired[str]
+
+
 # Union type for all hook inputs
 HookInput = (
     PreToolUseHookInput
@@ -333,6 +354,7 @@ HookInput = (
     | ElicitationHookInput
     | ElicitationResultHookInput
     | ConfigChangeHookInput
+    | InstructionsLoadedHookInput
     | WorktreeCreateHookInput
     | WorktreeRemoveHookInput
 )

{clawd_code_sdk-0.6.1 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/input_types.py

@@ -10,7 +10,7 @@ from typing import Literal, NotRequired, TypedDict
 
 from pydantic import ConfigDict, with_config
 
-from clawd_code_sdk.models.base import ModelName, PermissionMode  # noqa: TC001
+from clawd_code_sdk.models.base import PermissionMode  # noqa: TC001
 
 
 _extra_allow = with_config(ConfigDict(extra="allow"))
@@ -28,16 +28,10 @@ class AgentInput(TypedDict):
     """The task for the agent to perform."""
     subagent_type: str
     """The type of specialized agent to use for this task."""
-    model: NotRequired[ModelName]
-    """Optional model to use for the agent."""
     resume: NotRequired[str]
     """Optional agent ID to resume from in order to continue from the previous exec transcript."""
     run_in_background: NotRequired[bool]
     """Whether to run the agent in the background."""
-    max_turns: NotRequired[int]
-    """Maximum number of agentic turns (API round-trips) before stopping.
-
-    Used internally for warmup."""
     name: NotRequired[str]
     """Name for the spawned agent."""
     team_name: NotRequired[str]
@@ -54,6 +48,8 @@ class AskUserQuestionOption(TypedDict):
     """Display text for this option (1-5 words)."""
     description: str
     """Explanation of what this option means."""
+    preview: NotRequired[str]
+    """Optional preview content rendered when this option is focused."""
 
 
 @_extra_allow

{clawd_code_sdk-0.6.1 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/messages.py

@@ -181,6 +181,7 @@ class UserMessage(BaseMessage):
     ) = None
     isReplay: bool | None = None  # noqa: N815
     isSynthetic: bool | None = None  # noqa: N815
+    priority: Literal["now", "next", "later"] | None = None
 
     def parse_command_output(self) -> str | None:
         """Extract output from legacy XML-tagged command output in user messages."""

{clawd_code_sdk-0.6.1 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/options.py

@@ -24,6 +24,21 @@ if TYPE_CHECKING:
 logger = logging.getLogger(__name__)
 
 
+@dataclass(kw_only=True)
+class AskUserQuestionToolConfig:
+    """Configuration for the AskUserQuestion tool."""
+
+    preview_format: Literal["markdown", "html"] | None = None
+    """Content format for the preview field on question options."""
+
+
+@dataclass(kw_only=True)
+class ToolConfig:
+    """Per-tool configuration for built-in tools."""
+
+    ask_user_question: AskUserQuestionToolConfig | None = None
+
+
 # ============================================================================
 # Session configuration
 # ============================================================================
@@ -275,6 +290,11 @@ class ClaudeAgentOptions:
     When enabled, files can be rewound to their state at any user message
     using `ClaudeSDKClient.rewind_files()`.
     """
+    # TODO: tool_config is defined in upstream sdk.d.ts Options but not yet
+    # present in the CC settings JSON schema. Uncomment once settings.py is
+    # regenerated with the toolConfig field so it flows through --settings.
+    # tool_config: ToolConfig | None = None
+    # """Per-tool configuration for built-in tools."""
     agent: str | None = None
     """Agent name for the main thread. The agent must be defined in `agents` or settings."""
     context_1m: bool = False

{clawd_code_sdk-0.6.1 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/output_types.py

@@ -108,18 +108,7 @@ class AgentAsyncLaunchedOutput(TypedDict):
     """Whether the calling agent has Read/Bash tools to check progress."""
 
 
-class AgentSubAgentEnteredOutput(TypedDict):
-    """Output from the Task tool when entering a sub-agent context."""
-
-    status: Literal["sub_agent_entered"]
-    """Indicates a sub-agent context was entered."""
-    description: str
-    """Description of the sub-agent task."""
-    message: str
-    """Status message."""
-
-
-AgentOutput = AgentCompletedOutput | AgentAsyncLaunchedOutput | AgentSubAgentEnteredOutput
+AgentOutput = AgentCompletedOutput | AgentAsyncLaunchedOutput
 
 
 # ---------------------------------------------------------------------------

{clawd_code_sdk-0.6.1 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/prompts.py

@@ -151,6 +151,33 @@ class UserPlainTextDocumentPrompt:
         return block
 
 
+@dataclass
+class UserFilePrompt:
+    """A user prompt referencing a file uploaded via the Anthropic Files API."""
+
+    file_id: str
+    """Anthropic file identifier (e.g. 'file_abc123')."""
+    title: str | None = None
+    """Optional document title."""
+    context: str | None = None
+    """Optional context about the document."""
+
+    def to_content_block(self) -> dict[str, Any]:
+        """Return the Anthropic API content block dict."""
+        block: dict[str, Any] = {
+            "type": "document",
+            "source": {
+                "type": "file",
+                "file_id": self.file_id,
+            },
+        }
+        if self.title is not None:
+            block["title"] = self.title
+        if self.context is not None:
+            block["context"] = self.context
+        return block
+
+
 UserPrompt = (
     UserTextPrompt
     | UserImagePrompt
@@ -158,5 +185,6 @@ UserPrompt = (
     | UserDocumentPrompt
     | UserDocumentURLPrompt
     | UserPlainTextDocumentPrompt
+    | UserFilePrompt
 )
 """Union type for all user prompt dataclasses."""

{clawd_code_sdk-0.6.1 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/server_info.py

@@ -34,6 +34,9 @@ class ClaudeCodeModelInfo(ClaudeCodeBaseModel):
     supports_adaptive_thinking: bool | None = None
     """Whether the model supports adaptive thinking."""
 
+    supports_fast_mode: bool | None = None
+    """Whether the model supports fast mode."""
+
 
 class ClaudeCodeCommandInfo(ClaudeCodeBaseModel):
     """Information about an available slash command from Claude Code."""

{clawd_code_sdk-0.6.1 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/settings.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  claude-code-settings-titled.json
-#   timestamp: 2026-03-04T18:35:14+00:00
+#   timestamp: 2026-03-05T01:14:35+00:00
 
 from __future__ import annotations