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

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

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

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

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

@@ -47,7 +47,9 @@ from .models import (
     PromptHookHandler,
     ListSessionsOptions,
     McpSdkServerConfig,
+    McpSdkServerConfigWithInstance,
     McpServerConfig,
+    McpSetServersResult,
     Message,
     NotificationHookInput,
     NotificationHookSpecificOutput,
@@ -171,7 +173,9 @@ __all__ = [
     "InvalidRequestError",
     "ListSessionsOptions",
     "McpSdkServerConfig",
+    "McpSdkServerConfigWithInstance",
     "McpServerConfig",
+    "McpSetServersResult",
     "Message",
     "Network",
     "NewSession",

{clawd_code_sdk-0.6.2 → clawd_code_sdk-0.6.3}/src/clawd_code_sdk/client.py

@@ -14,6 +14,7 @@ from clawd_code_sdk.models import (
     AssistantMessage,
     ClaudeAgentOptions,
     ClaudeCodeAgentInfo,  # noqa: TC001
+    McpSetServersResult,
     McpStatusResponse,
     ResultErrorMessage,
     ResultMessage,
@@ -286,7 +287,7 @@ class ClaudeSDKClient:
         result = await query.get_mcp_status()
         return McpStatusResponse.model_validate(result)
 
-    async def set_mcp_servers(self, servers: dict[str, McpServerConfig]) -> dict[str, Any]:
+    async def set_mcp_servers(self, servers: dict[str, McpServerConfig]) -> McpSetServersResult:
         """Add, replace, or remove MCP servers dynamically mid-session.
 
         Allows dynamic registration of MCP servers without restarting the session.
@@ -312,7 +313,8 @@ class ClaudeSDKClient:
             server_dict = dict(config)
             server_dict["name"] = name
             wire_servers[name] = server_dict
-        return await query.set_mcp_servers(wire_servers)
+        result = await query.set_mcp_servers(wire_servers)
+        return McpSetServersResult.model_validate(result)
 
     async def mcp_reconnect(self, server_name: str) -> None:
         """Reconnect to an MCP server."""

{clawd_code_sdk-0.6.2 → clawd_code_sdk-0.6.3}/src/clawd_code_sdk/mcp_utils.py

@@ -7,7 +7,7 @@ from typing import TYPE_CHECKING, Any, assert_never
 
 from pydantic import AnyUrl, TypeAdapter
 
-from clawd_code_sdk.models import McpSdkServerConfig
+from clawd_code_sdk.models import McpSdkServerConfigWithInstance
 
 
 if TYPE_CHECKING:
@@ -86,7 +86,7 @@ def create_sdk_mcp_server(
     name: str,
     version: str = "1.0.0",
     tools: list[SdkMcpTool[Any]] | None = None,
-) -> McpSdkServerConfig:
+) -> McpSdkServerConfigWithInstance:
     """Create an in-process MCP server that runs within your Python application.
 
     Server lifecycle is managed automatically by the SDK
@@ -107,7 +107,7 @@ def create_sdk_mcp_server(
             If None or empty, the server will have no tools (rarely useful).
 
     Returns:
-        McpSdkServerConfig: A configuration object that can be passed to
+        McpSdkServerConfigWithInstance: A configuration object that can be passed to
         ClaudeAgentOptions.mcp_servers. This config contains the server
         instance and metadata needed for the SDK to route tool calls.
 
@@ -231,4 +231,4 @@ def create_sdk_mcp_server(
             return content
 
     # Return SDK server configuration
-    return McpSdkServerConfig(type="sdk", name=name, instance=server)
+    return McpSdkServerConfigWithInstance(type="sdk", name=name, instance=server)

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

@@ -126,10 +126,15 @@ from .mcp import (
     JSONRPCResultResponse,
     McpConnectionStatus,
     McpHttpServerConfig,
+    McpClaudeAIProxyServerConfig,
     McpSdkServerConfig,
+    McpSdkServerConfigWithInstance,
     McpServerConfig,
+    McpServerConfigForProcessTransport,
+    McpServerStatusConfig,
     McpServerStatusEntry,
     McpServerVersionInfo,
+    McpSetServersResult,
     McpSSEServerConfig,
     McpStatusResponse,
     McpStdioServerConfig,
@@ -410,16 +415,21 @@ __all__ = [
     "ListMcpResourcesOutput",
     "ListSessionsOptions",
     "LocalCommandOutputMessage",
+    "McpClaudeAIProxyServerConfig",
     "McpConnectionStatus",
     "McpHttpServerConfig",
     "McpOutput",
     "McpResourceEntry",
     "McpSSEServerConfig",
     "McpSdkServerConfig",
+    "McpSdkServerConfigWithInstance",
     "McpServerConfig",
+    "McpServerConfigForProcessTransport",
     "McpServerStatus",
+    "McpServerStatusConfig",
     "McpServerStatusEntry",
     "McpServerVersionInfo",
+    "McpSetServersResult",
     "McpStatusResponse",
     "McpStdioServerConfig",
     "McpToolStatus",

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

@@ -26,7 +26,7 @@ class AgentInput(TypedDict):
     """A short (3-5 word) description of the task."""
     prompt: str
     """The task for the agent to perform."""
-    subagent_type: str
+    subagent_type: NotRequired[str]
     """The type of specialized agent to use for this task."""
     resume: NotRequired[str]
     """Optional agent ID to resume from in order to continue from the previous exec transcript."""

{clawd_code_sdk-0.6.2 → clawd_code_sdk-0.6.3}/src/clawd_code_sdk/models/mcp.py

@@ -94,19 +94,47 @@ class McpHttpServerConfig(TypedDict):
 
 
 class McpSdkServerConfig(TypedDict):
-    """SDK MCP server configuration."""
+    """SDK MCP server configuration (serializable, no instance)."""
 
     type: Literal["sdk"]
     name: str
+
+
+class McpSdkServerConfigWithInstance(McpSdkServerConfig):
+    """SDK MCP server config with a live McpServer instance. Not serializable."""
+
     instance: McpServer
 
 
 ExternalMcpServerConfig = McpStdioServerConfig | McpSSEServerConfig | McpHttpServerConfig
 
 McpServerConfig = (
+    McpStdioServerConfig | McpSSEServerConfig | McpHttpServerConfig | McpSdkServerConfigWithInstance
+)
+
+
+class McpClaudeAIProxyServerConfig(TypedDict):
+    """MCP Claude AI proxy server configuration."""
+
+    type: Literal["claudeai-proxy"]
+    url: str
+    id: str
+
+
+McpServerConfigForProcessTransport = (
     McpStdioServerConfig | McpSSEServerConfig | McpHttpServerConfig | McpSdkServerConfig
 )
 
+McpServerStatusConfig = McpServerConfigForProcessTransport | McpClaudeAIProxyServerConfig
+
+
+class McpSetServersResult(ClaudeCodeBaseModel):
+    """Result of a setMcpServers operation."""
+
+    added: list[str] = Field(default_factory=list)
+    removed: list[str] = Field(default_factory=list)
+    errors: dict[str, str] = Field(default_factory=dict)
+
 
 class SdkPluginConfig(ClaudeCodeBaseModel):
     """SDK plugin configuration.
@@ -161,7 +189,8 @@ class McpServerStatusEntry(ClaudeCodeBaseModel):
     name: str
     status: McpConnectionStatus
     server_info: McpServerVersionInfo | None = None
-    config: dict[str, Any] = Field(default_factory=dict)
+    error: str | None = None
+    config: McpServerStatusConfig | None = None
     scope: Literal["project", "user", "local", "claudeai", "managed"] | str | None = None  # noqa: PYI051
     tools: list[McpToolStatus] = Field(default_factory=list)
 

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

@@ -145,6 +145,8 @@ class BashOutput(TypedDict):
     """Path to persisted full output (when output is too large for inline)."""
     persistedOutputSize: NotRequired[int]
     """Total size of the output in bytes (when output is too large for inline)."""
+    tokenSaverOutput: NotRequired[str]
+    """Compressed output sent to model when token-saver is active (UI still uses stdout)."""
 
 
 # ---------------------------------------------------------------------------

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

@@ -57,10 +57,7 @@ class UserImageURLPrompt:
         """Return the Anthropic API content block dict."""
         return {
             "type": "image",
-            "source": {
-                "type": "url",
-                "url": self.url,
-            },
+            "source": {"type": "url", "url": self.url},
         }
 
 
@@ -86,12 +83,10 @@ class UserDocumentPrompt:
                 "media_type": self.media_type,
                 "data": self.document_data,
             },
+            "title": self.title,
+            "context": self.context,
         }
-        if self.title is not None:
-            block["title"] = self.title
-        if self.context is not None:
-            block["context"] = self.context
-        return block
+        return {k: v for k, v in block.items() if v is not None}
 
 
 @dataclass
@@ -109,16 +104,11 @@ class UserDocumentURLPrompt:
         """Return the Anthropic API content block dict."""
         block: dict[str, Any] = {
             "type": "document",
-            "source": {
-                "type": "url",
-                "url": self.url,
-            },
+            "source": {"type": "url", "url": self.url},
+            "title": self.title,
+            "context": self.context,
         }
-        if self.title is not None:
-            block["title"] = self.title
-        if self.context is not None:
-            block["context"] = self.context
-        return block
+        return {k: v for k, v in block.items() if v is not None}
 
 
 @dataclass
@@ -143,12 +133,10 @@ class UserPlainTextDocumentPrompt:
                 "media_type": self.media_type,
                 "data": self.data,
             },
+            "title": self.title,
+            "context": self.context,
         }
-        if self.title is not None:
-            block["title"] = self.title
-        if self.context is not None:
-            block["context"] = self.context
-        return block
+        return {k: v for k, v in block.items() if v is not None}
 
 
 @dataclass
@@ -166,16 +154,11 @@ class UserFilePrompt:
         """Return the Anthropic API content block dict."""
         block: dict[str, Any] = {
             "type": "document",
-            "source": {
-                "type": "file",
-                "file_id": self.file_id,
-            },
+            "source": {"type": "file", "file_id": self.file_id},
+            "title": self.title,
+            "context": self.context,
         }
-        if self.title is not None:
-            block["title"] = self.title
-        if self.context is not None:
-            block["context"] = self.context
-        return block
+        return {k: v for k, v in block.items() if v is not None}
 
 
 UserPrompt = (

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

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  claude-code-settings-titled.json
-#   timestamp: 2026-03-05T01:14:35+00:00
+#   timestamp: 2026-03-06T02:05:16+00:00
 
 from __future__ import annotations
 
@@ -391,6 +391,20 @@ class StrictMarketplaceDirectory(ClaudeCodeBaseModel):
     """
 
 
+class StrictMarketplacePathPattern(ClaudeCodeBaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    source: Literal["pathPattern"] = "pathPattern"
+    """
+    Identifies the marketplace source type
+    """
+    path_pattern: str = Field(..., alias="pathPattern")
+    """
+    Regex pattern to match file or directory paths for marketplace sources
+    """
+
+
 class SkippedMarketplace(AdditionalDirectory):
     pass
 
@@ -493,6 +507,12 @@ class Sandbox(ClaudeCodeBaseModel):
     """
     Automatically allow bash commands without prompting when they run in the sandbox. Only applies to commands that will run sandboxed.
     """
+    enable_weaker_network_isolation: bool | None = Field(
+        False, alias="enableWeakerNetworkIsolation"
+    )
+    """
+    macOS only. Allow access to the system TLS trust service (com.apple.trustd.agent) in the sandbox. Required for Go-based tools like gh, gcloud, and terraform to verify TLS certificates when using httpProxyPort with a MITM proxy and custom CA. Reduces security by opening a potential data exfiltration path. Default: false. See https://code.claude.com/docs/en/settings#sandbox-settings
+    """
     enable_weaker_nested_sandbox: bool | None = Field(None, alias="enableWeakerNestedSandbox")
     """
     Enable weaker sandbox mode for unprivileged docker environments where --proc mounting fails. This significantly reduces the strength of the sandbox and should only be used when this risk is acceptable.Default: false (secure).
@@ -536,7 +556,7 @@ class Tip(AdditionalDirectory):
 
 
 class SpinnerTipsOverride(ClaudeCodeBaseModel):
-    """Customize the tips displayed in the spinner while Claude is working. See https://code.claude.com/docs/en/settings."""
+    """Customize the tips displayed in the spinner while Claude is working. See https://code.claude.com/docs/en/settings#available-settings."""
 
     model_config = ConfigDict(
         extra="forbid",
@@ -685,6 +705,20 @@ class BlockedMarketplaceHostPattern(ClaudeCodeBaseModel):
     """
 
 
+class BlockedMarketplacePathPattern(ClaudeCodeBaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    source: Literal["pathPattern"] = "pathPattern"
+    """
+    Block marketplace by file/directory path pattern matching
+    """
+    path_pattern: str = Field(..., alias="pathPattern")
+    """
+    Regex pattern to match file or directory paths for marketplace sources
+    """
+
+
 class PermissionRule(RootModel[str]):
     model_config = ConfigDict(
         regex_engine="python-re",
@@ -705,13 +739,14 @@ class PermissionRule(RootModel[str]):
             "Read(./secrets/**)",
             "Read(//Users/alice/secrets/**)",
             "Read(~/Documents/*.pdf)",
+            "Agent(Explore)",
             "Task(Explore)",
             "WebFetch",
             "WebFetch(domain:example.com)",
             "mcp__puppeteer",
             "mcp__github__search_repositories",
         ],
-        pattern="^((Bash|Edit|ExitPlanMode|Glob|Grep|KillShell|LS|LSP|MultiEdit|NotebookEdit|NotebookRead|Read|Skill|Task|TaskCreate|TaskGet|TaskList|TaskOutput|TaskStop|TaskUpdate|TodoWrite|ToolSearch|WebFetch|WebSearch|Write)(\\((?=.*[^)*?])[^)]+\\))?|mcp__.*)$",
+        pattern="^((Agent|Bash|Edit|ExitPlanMode|Glob|Grep|KillShell|LS|LSP|MultiEdit|NotebookEdit|NotebookRead|Read|Skill|Task|TaskCreate|TaskGet|TaskList|TaskOutput|TaskStop|TaskUpdate|TodoWrite|ToolSearch|WebFetch|WebSearch|Write)(\\((?=.*[^)*?])[^)]+\\))?|mcp__.*)$",
     )
     """
     Tool permission rule.
@@ -885,7 +920,7 @@ class Permissions(ClaudeCodeBaseModel):
     "default": prompts on first use.
     "acceptEdits": auto-accepts file edits.
     "plan": read-only, no modifications.
-    "delegate": coordination-only for agent team leads (agent teams are experimental; enable via CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS).
+    UNDOCUMENTED. "delegate": coordination-only for agent team leads (agent teams are experimental; enable via CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS).
     "dontAsk": auto-denies unless pre-approved via permissions.
     "bypassPermissions": skips all prompts (use only in isolated environments).
     See https://code.claude.com/docs/en/permissions
@@ -962,6 +997,10 @@ class Hooks(ClaudeCodeBaseModel):
     """
     UNDOCUMENTED. Hooks that run during repository initialization (--init, --init-only) or maintenance (--maintenance)
     """
+    instructions_loaded: list[HookMatcher] | None = Field(None, alias="InstructionsLoaded")
+    """
+    Hooks that run when a CLAUDE.md or .claude/rules/*.md file is loaded into context. Fires at session start and when files are lazily loaded (e.g., nested traversal, path glob match). No decision control; used for audit logging and observability. Does not support matchers. See https://code.claude.com/docs/en/hooks#instructionsloaded
+    """
     config_change: list[HookMatcher] | None = Field(None, alias="ConfigChange")
     """
     Hooks that run when settings, managed settings, or skill files change during a session. Supports matchers: user_settings, project_settings, local_settings, policy_settings, skills. Command handlers only. Exit code 2 blocks the change (except policy_settings which is audit-only). See https://code.claude.com/docs/en/hooks#configchange
@@ -1046,6 +1085,10 @@ class ClaudeCodeSettings(ClaudeCodeBaseModel):
     """
     Customize attribution for git commits and pull requests. See https://code.claude.com/docs/en/settings#attribution-settings
     """
+    include_git_instructions: bool | None = Field(True, alias="includeGitInstructions")
+    """
+    Include built-in git commit and PR workflow instructions in Claude's system prompt. Also configurable via CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS environment variable (set to 1 to disable). See https://code.claude.com/docs/en/settings#available-settings
+    """
     include_co_authored_by: bool | None = Field(True, alias="includeCoAuthoredBy")
     """
     DEPRECATED. Use 'attribution' instead. Whether to include the co-authored-by Claude byline in git commits and pull requests (default: true)
@@ -1092,12 +1135,16 @@ class ClaudeCodeSettings(ClaudeCodeBaseModel):
     """
     effort_level: Literal["low", "medium", "high"] | None = Field("high", alias="effortLevel")
     """
-    Control Opus 4.6 adaptive reasoning effort. Lower effort is faster and cheaper for straightforward tasks, higher effort provides deeper reasoning. Also configurable via CLAUDE_CODE_EFFORT_LEVEL environment variable. See https://code.claude.com/docs/en/model-config#adjust-effort-level
+    Control Opus 4.6 adaptive reasoning effort. Lower effort is faster and cheaper for straightforward tasks, higher effort provides deeper reasoning. Opus 4.6 defaults to medium effort for Max and Team subscribers. Also configurable via CLAUDE_CODE_EFFORT_LEVEL environment variable. See https://code.claude.com/docs/en/model-config#adjust-effort-level
     """
     fast_mode: bool | None = Field(False, alias="fastMode")
     """
     Enable fast mode for Opus 4.6 (research preview). Fast mode uses the same model with 2.5x faster output at higher per-token cost. Requires extra usage enabled. Alternatively, toggle with /fast command. See https://code.claude.com/docs/en/fast-mode
     """
+    fast_mode_per_session_opt_in: bool | None = Field(False, alias="fastModePerSessionOptIn")
+    """
+    Require per-session opt-in for fast mode. When true, fast mode does not persist across sessions and users must enable it with /fast each session. Useful for controlling costs. See https://code.claude.com/docs/en/fast-mode
+    """
     enable_all_project_mcp_servers: bool | None = Field(
         None, alias="enableAllProjectMcpServers", examples=[True]
     )
@@ -1166,7 +1213,7 @@ class ClaudeCodeSettings(ClaudeCodeBaseModel):
         None, alias="allowManagedPermissionRulesOnly"
     )
     """
-    (Managed settings only) Prevent user and project settings from defining allow, ask, or deny permission rules. Only rules in managed settings apply. See https://code.claude.com/docs/en/settings
+    (Managed settings only) Prevent user and project settings from defining allow, ask, or deny permission rules. Only rules in managed settings apply. See https://code.claude.com/docs/en/settings#permission-settings
     """
     status_line: StatusLine | None = Field(
         None,
@@ -1203,6 +1250,7 @@ class ClaudeCodeSettings(ClaudeCodeBaseModel):
             | StrictMarketplaceNpm
             | StrictMarketplaceFile
             | StrictMarketplaceDirectory
+            | StrictMarketplacePathPattern
         ]
         | None
     ) = Field(
@@ -1269,7 +1317,7 @@ class ClaudeCodeSettings(ClaudeCodeBaseModel):
     """
     spinner_tips_override: SpinnerTipsOverride | None = Field(None, alias="spinnerTipsOverride")
     """
-    Customize the tips displayed in the spinner while Claude is working. See https://code.claude.com/docs/en/settings
+    Customize the tips displayed in the spinner while Claude is working. See https://code.claude.com/docs/en/settings#available-settings
     """
     terminal_progress_bar_enabled: bool | None = Field(True, alias="terminalProgressBarEnabled")
     """
@@ -1299,6 +1347,10 @@ class ClaudeCodeSettings(ClaudeCodeBaseModel):
     """
     How agent team teammates display: "auto" picks split panes in tmux or iTerm2, in-process otherwise. Agent teams are experimental and disabled by default. Enable them by adding CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS to your settings.json or environment. See https://code.claude.com/docs/en/agent-teams
     """
+    plugin_trust_message: str | None = Field(None, alias="pluginTrustMessage", min_length=1)
+    """
+    (Managed settings only) Custom message appended to the plugin trust warning shown before installation. Use to provide organization-specific context about approved plugins. See https://code.claude.com/docs/en/settings#plugin-settings
+    """
     plugin_configs: dict[str, PluginConfigs] | None = Field(None, alias="pluginConfigs")
     """
     Per-plugin configuration including MCP server user configs, keyed by plugin ID (plugin@marketplace format). See https://code.claude.com/docs/en/plugins
@@ -1316,6 +1368,7 @@ class ClaudeCodeSettings(ClaudeCodeBaseModel):
             | BlockedMarketplaceFile
             | BlockedMarketplaceDirectory
             | BlockedMarketplaceHostPattern
+            | BlockedMarketplacePathPattern
         ]
         | None
     ) = Field(None, alias="blockedMarketplaces")

{clawd_code_sdk-0.6.2 → clawd_code_sdk-0.6.3}/tests/test_transport.py

@@ -656,7 +656,13 @@ class TestSubprocessCLITransport:
         settings_idx = cmd.index("--settings")
         settings_value = cmd[settings_idx + 1]
         parsed = json.loads(settings_value)
-        assert parsed == {"sandbox": {"autoAllowBashIfSandboxed": True, "enabled": True}}
+        assert parsed == {
+            "sandbox": {
+                "autoAllowBashIfSandboxed": True,
+                "enableWeakerNetworkIsolation": False,
+                "enabled": True,
+            }
+        }
 
     def test_sandbox_network_config(self):
         """Test sandbox with full network configuration."""