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

{clawd_code_sdk-0.6.0 → clawd_code_sdk-0.6.2}/.gitignore

@@ -1,4 +1,7 @@
 # Python
+# E2E test artifacts
+tests/e2e/artifacts/
+
 __pycache__/
 *.py[cod]
 *$py.class

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

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

@@ -1,6 +1,6 @@
 [project]
 name = "clawd-code-sdk"
-version = "0.6.0"
+version = "0.6.2"
 description = "Python SDK for Claude Code"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -239,7 +239,7 @@ max-complexity = 15
 "__init__.py" = ["E402", "I001"]
 "scripts/*" = ["INP001", "PLR2004"]
 "*tests/*" = ["D100", "PLR2004"]
-"reference/settings_file.py" = ["ALL"]
+"src/clawd_code_sdk/models/settings.py" = ["ALL"]
 "docs/examples/**/*.py" = [
   "TC001",
 ]  # Examples don't need TYPE_CHECKING imports

{clawd_code_sdk-0.6.0 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/__init__.py

@@ -67,9 +67,12 @@ from .models import (
     ResultErrorMessage,
     ResultMessage,
     ResultSuccessMessage,
-    SandboxIgnoreViolations,
-    SandboxNetworkConfig,
-    SandboxSettings,
+    ClaudeCodeSettings,
+    Filesystem,
+    Hooks,
+    Network,
+    Permissions,
+    Sandbox,
     SdkBeta,
     SdkPluginConfig,
     SettingSource,
@@ -142,6 +145,8 @@ __all__ = [
     # Tool callbacks
     "CanUseTool",
     "ClaudeAgentOptions",
+    # Settings / sandbox
+    "ClaudeCodeSettings",
     "ClaudeSDKClient",
     # Errors
     "ClaudeSDKError",
@@ -151,6 +156,7 @@ __all__ = [
     "ContinueLatest",
     "ConversationTurn",
     "DocumentMediaType",
+    "Filesystem",
     "FromPR",
     "HookCallback",
     "HookContext",
@@ -159,6 +165,7 @@ __all__ = [
     "HookJSONOutput",
     "HookMatcher",
     "HookMatcherConfig",
+    "Hooks",
     "ImageMediaType",
     "InitSystemMessage",
     "InvalidRequestError",
@@ -166,6 +173,7 @@ __all__ = [
     "McpSdkServerConfig",
     "McpServerConfig",
     "Message",
+    "Network",
     "NewSession",
     "NotificationHookInput",
     "NotificationHookSpecificOutput",
@@ -178,6 +186,7 @@ __all__ = [
     "PermissionResultAllow",
     "PermissionResultDeny",
     "PermissionUpdate",
+    "Permissions",
     "PlainTextMediaType",
     "PostToolUseFailureHookInput",
     "PostToolUseFailureHookSpecificOutput",
@@ -192,10 +201,7 @@ __all__ = [
     "ResultSuccessMessage",
     "ResumeSession",
     "SDKSessionInfo",
-    "SandboxIgnoreViolations",
-    "SandboxNetworkConfig",
-    # Sandbox support
-    "SandboxSettings",
+    "Sandbox",
     # Beta support
     "SdkBeta",
     "SdkMcpTool",

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

@@ -1,17 +1,4 @@
-"""Type definitions for Claude SDK.
-
-This package re-exports all types for backwards compatibility.
-Types are organized into submodules:
-- base: Type aliases, literals, and thinking configuration
-- agents: Agent definitions and presets
-- permissions: Permission system types
-- hooks: Hook system types (inputs, outputs, matchers, callbacks)
-- mcp: MCP server and plugin configuration
-- sandbox: Sandbox configuration
-- messages: Content blocks, message types, and stream events
-- options: ClaudeAgentOptions
-- control: SDK control protocol types
-"""
+"""Type definitions for Claude SDK."""
 
 from __future__ import annotations
 
@@ -49,6 +36,8 @@ from .control import (
     SDKControlResponse,
     SDKControlRewindFilesRequest,
     SDKControlSetPermissionModeRequest,
+    SDKControlSetProactiveRequest,
+    SDKControlGetSettingsRequest,
     SDKControlStopTaskRequest,
     SDKHookCallbackRequest,
     control_request_adapter,
@@ -99,6 +88,7 @@ from .hooks import (
     UserPromptSubmitHookSpecificOutput,
     WorktreeCreateHookInput,
     WorktreeRemoveHookInput,
+    InstructionsLoadedHookInput,
 )
 from .input_types import (
     TOOL_INPUT_TYPES,
@@ -127,7 +117,6 @@ from .input_types import (
     WebSearchInput,
 )
 from .mcp import (
-    JSONRPC_VERSION,
     JSONRPCError,
     JSONRPCErrorResponse,
     JSONRPCMessage,
@@ -158,7 +147,6 @@ from .output_types import (
     AgentOutputTextContent,
     AgentOutputUsage,
     AgentServerToolUse,
-    AgentSubAgentEnteredOutput,
     AskUserQuestionItem,
     AskUserQuestionOutput,
     BashOutput,
@@ -249,6 +237,7 @@ from .prompts import (
     UserDocumentPrompt,
     PlainTextMediaType,
     UserDocumentURLPrompt,
+    UserFilePrompt,
     UserImagePrompt,
     UserImageURLPrompt,
     UserPlainTextDocumentPrompt,
@@ -265,6 +254,7 @@ from .options import (
     NewSession,
     ResumeSession,
     SessionConfig,
+    ToolConfig,
     resolve_session_config,
 )
 from .permissions import (
@@ -281,7 +271,14 @@ from .permissions import (
     PermissionUpdateDestination,
     ToolPermissionContext,
 )
-from .sandbox import SandboxIgnoreViolations, SandboxNetworkConfig, SandboxSettings
+from .settings import (
+    ClaudeCodeSettings,
+    Filesystem,
+    Hooks,
+    Network,
+    Permissions,
+    Sandbox,
+)
 from .server_info import ClaudeCodeAgentInfo, ClaudeCodeServerInfo, ClaudeCodeCommandInfo
 from .system_messages import (
     system_message_adapter,
@@ -307,7 +304,6 @@ from .system_messages import (
 Message = MiscMessages | SystemMessageUnion
 
 __all__ = [
-    "JSONRPC_VERSION",
     "TOOL_INPUT_TYPES",
     "TOOL_USE_RESULT_TYPES",
     "AgentAsyncLaunchedOutput",
@@ -322,7 +318,6 @@ __all__ = [
     "AgentOutputTextContent",
     "AgentOutputUsage",
     "AgentServerToolUse",
-    "AgentSubAgentEnteredOutput",
     "ApiKeySource",
     "AskUserQuestion",
     "AskUserQuestionInput",
@@ -347,6 +342,7 @@ __all__ = [
     "ClaudeCodeAgentInfo",
     "ClaudeCodeCommandInfo",
     "ClaudeCodeServerInfo",
+    "ClaudeCodeSettings",
     "CommandHookHandler",
     "CompactBoundarySystemMessage",
     "ConfigOutput",
@@ -378,6 +374,7 @@ __all__ = [
     "FileReadInput",
     "FileWriteInput",
     "FilesPersistedSystemMessage",
+    "Filesystem",
     "FromPR",
     "GitDiff",
     "GlobInput",
@@ -396,8 +393,10 @@ __all__ = [
     "HookResponseSystemMessage",
     "HookSpecificOutput",
     "HookStartedSystemMessage",
+    "Hooks",
     "ImageMediaType",
     "InitSystemMessage",
+    "InstructionsLoadedHookInput",
     "JSONRPCError",
     "JSONRPCErrorResponse",
     "JSONRPCMessage",
@@ -427,6 +426,7 @@ __all__ = [
     "Message",
     "MiscMessages",
     "ModelUsage",
+    "Network",
     "NewSession",
     "NotebookEditInput",
     "NotebookEditOutput",
@@ -444,6 +444,7 @@ __all__ = [
     "PermissionRuleValue",
     "PermissionUpdate",
     "PermissionUpdateDestination",
+    "Permissions",
     "PlainTextMediaType",
     "PostToolUseFailureHookInput",
     "PostToolUseFailureHookSpecificOutput",
@@ -482,6 +483,7 @@ __all__ = [
     "ResultSuccessMessage",
     "ResumeSession",
     "SDKControlElicitationRequest",
+    "SDKControlGetSettingsRequest",
     "SDKControlInitializeRequest",
     "SDKControlInterruptRequest",
     "SDKControlMcpMessageRequest",
@@ -492,13 +494,12 @@ __all__ = [
     "SDKControlResponse",
     "SDKControlRewindFilesRequest",
     "SDKControlSetPermissionModeRequest",
+    "SDKControlSetProactiveRequest",
     "SDKControlStopTaskRequest",
     "SDKHookCallbackRequest",
     "SDKPermissionDenial",
     "SDKSessionInfo",
-    "SandboxIgnoreViolations",
-    "SandboxNetworkConfig",
-    "SandboxSettings",
+    "Sandbox",
     "SdkBeta",
     "SdkPluginConfig",
     "SessionConfig",
@@ -541,6 +542,7 @@ __all__ = [
     "TodoWriteInput",
     "TodoWriteOutput",
     "TodoWriteToolUseResult",
+    "ToolConfig",
     "ToolInput",
     "ToolPermissionContext",
     "ToolProgressMessage",
@@ -555,6 +557,7 @@ __all__ = [
     "Usage",
     "UserDocumentPrompt",
     "UserDocumentURLPrompt",
+    "UserFilePrompt",
     "UserImagePrompt",
     "UserImageURLPrompt",
     "UserMessage",

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

@@ -7,10 +7,10 @@ from typing import Annotated, Any, Literal, TypedDict
 
 from pydantic import Discriminator, TypeAdapter
 
-from .agents import AgentDefinition  # noqa: TC001
-from .base import ElicitationMode, PermissionMode  # noqa: TC001
-from .hooks import HookEvent, HookInput  # noqa: TC001
-from .mcp import ExternalMcpServerConfig, JSONRPCMessage  # noqa: TC001
+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.hooks import HookEvent, HookInput  # noqa: TC001
+from clawd_code_sdk.models.mcp import ExternalMcpServerConfig, JSONRPCMessage  # noqa: TC001
 
 
 # SDK Control Protocol
@@ -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.0 → 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.0 → 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.0 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/mcp.py

@@ -14,7 +14,6 @@ if TYPE_CHECKING:
 
 
 RequestId = str | int
-JSONRPC_VERSION = "2.0"
 
 McpConnectionStatus = Literal["connected", "pending", "failed", "needs-auth", "disabled"]
 

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

@@ -18,13 +18,11 @@ from clawd_code_sdk._errors import (
     RateLimitError,
     ServerError,
 )
-from clawd_code_sdk.models.base import FastModeState
+from clawd_code_sdk.models.base import FastModeState, StopReason, ToolName  # noqa: TC001
 from clawd_code_sdk.models.content_blocks import ContentBlock, TextBlock
+from clawd_code_sdk.models.input_types import ToolInput  # noqa: TC001
 from clawd_code_sdk.models.output_types import ToolUseResult
 
-from .base import StopReason, ToolName  # noqa: TC001
-from .input_types import ToolInput  # noqa: TC001
-
 
 # Message types
 AssistantMessageError = Literal[
@@ -183,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.0 → clawd_code_sdk-0.6.2}/src/clawd_code_sdk/models/options.py

@@ -13,19 +13,32 @@ if TYPE_CHECKING:
     from collections.abc import Callable, Sequence
 
     from clawd_code_sdk.models import OnElicitation, OnUserQuestion
-    from clawd_code_sdk.models.base import ModelName
-
-    from .agents import AgentDefinition, ToolsPreset
-    from .base import PermissionMode, ReasoningEffort, SettingSource
-    from .hooks import HookEvent, HookMatcher
-    from .mcp import McpServerConfig, SdkPluginConfig
-    from .permissions import CanUseTool
-    from .sandbox import SandboxSettings
-    from .thinking import ThinkingConfig
+    from clawd_code_sdk.models.agents import AgentDefinition, ToolsPreset
+    from clawd_code_sdk.models.base import ModelName, PermissionMode, ReasoningEffort, SettingSource
+    from clawd_code_sdk.models.hooks import HookEvent, HookMatcher
+    from clawd_code_sdk.models.mcp import McpServerConfig, SdkPluginConfig
+    from clawd_code_sdk.models.permissions import CanUseTool
+    from clawd_code_sdk.models.settings import ClaudeCodeSettings, Sandbox
+    from clawd_code_sdk.models.thinking import ThinkingConfig
 
 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
 # ============================================================================
@@ -222,11 +235,17 @@ class ClaudeAgentOptions:
     cwd: str | Path | None = None
     """The working directory for the agent."""
     # Settings
-    settings: str | None = None
-    """Path to a settings JSON file or a JSON string."""
+    settings: str | Path | ClaudeCodeSettings | None = None
+    """Settings configuration.
+
+    Accepts:
+    - A ``str`` or ``Path``: interpreted as a path to a settings JSON file.
+    - A ``ClaudeCodeSettings`` instance: serialized to JSON automatically.
+    - ``None``: no explicit settings.
+    """
     setting_sources: list[SettingSource] | None = None
     """List of sources to load settings from."""
-    sandbox: SandboxSettings | None = None
+    sandbox: Sandbox | None = None
     """Sandbox configuration for bash command isolation.
 
     Filesystem and network restrictions are derived from permission rules (Read/Edit/WebFetch),
@@ -271,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
@@ -283,41 +307,44 @@ class ClaudeAgentOptions:
     """Enable the experimental agent teams feature."""
 
     def build_settings_value(self) -> str | None:
-        """Build settings value, merging sandbox settings if provided.
+        """Build the CLI ``--settings`` value, merging sandbox if provided.
 
-        Returns the settings value as either:
-        - A JSON string (if sandbox is provided or settings is JSON)
-        - A file path (if only settings path is provided without sandbox)
-        - None if neither settings nor sandbox is provided
+        Returns:
+            A JSON string, a file path, or None.
         """
         import anyenv
 
+        from clawd_code_sdk.models.settings import ClaudeCodeSettings as _Settings
+
         has_settings = self.settings is not None
         has_sandbox = self.sandbox is not None
 
         if not has_settings and not has_sandbox:
             return None
 
-        # If only settings path and no sandbox, pass through as-is
-        if has_settings and not has_sandbox:
-            return self.settings
-
-        # If we have sandbox settings, we need to merge into a JSON object
-        settings_obj: dict[str, Any] = {}
-
-        if has_settings:
-            assert self.settings is not None
-            settings_str = self.settings.strip()
-            # Check if settings is a JSON string or a file path
-            if settings_str.startswith("{") and settings_str.endswith("}"):
-                settings_obj = anyenv.load_json(settings_str)
-            else:
-                settings_path = Path(settings_str)
-                if settings_path.exists():
-                    with settings_path.open(encoding="utf-8") as f:
-                        settings_obj = json.load(f)
+        # Resolve settings to a dict (or pass through as file path)
+        settings_obj: dict[str, Any] | None = None
+
+        match self.settings:
+            case _Settings() as model:
+                settings_obj = model.model_dump(by_alias=True, exclude_none=True)
+            case str() | Path() as path:
+                if has_sandbox:
+                    # Need to load file to merge sandbox into it
+                    settings_path = Path(path)
+                    if settings_path.exists():
+                        with settings_path.open(encoding="utf-8") as f:
+                            settings_obj = json.load(f)
+                    else:
+                        logger.warning("Settings file not found: %s", settings_path)
+                        settings_obj = {}
                 else:
-                    logger.warning("Settings file not found: %s", settings_path)
+                    # No sandbox to merge, pass file path directly to CLI
+                    return str(path)
+            case None:
+                settings_obj = {}
+
+        assert settings_obj is not None
 
         # Merge sandbox settings
         if has_sandbox:

{clawd_code_sdk-0.6.0 → 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.0 → 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.0 → 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."""