clawd-code-sdk 0.3.4__tar.gz → 0.3.6__tar.gz

{clawd_code_sdk-0.3.4 → clawd_code_sdk-0.3.6}/PKG-INFO

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

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

{clawd_code_sdk-0.3.4 → clawd_code_sdk-0.3.6}/src/clawd_code_sdk/client.py

@@ -118,13 +118,14 @@ class ClaudeSDKClient:
         # Extract system prompt for initialize request
         system_prompt: str | None = None
         append_system_prompt: str | None = None
-        match self.options.system_prompt:
-            case None:
-                system_prompt = ""  # Explicitly clear default system prompt
-            case str() as prompt_str:
-                system_prompt = prompt_str
-            case {"type": "preset", "append": str() as append}:
-                append_system_prompt = append
+        if self.options.system_prompt is None:
+            if not self.options.include_builtin_system_prompt:
+                system_prompt = ""  # Clear the builtin prompt
+            # else: send nothing, CLI uses its default builtin prompt
+        elif self.options.include_builtin_system_prompt:
+            append_system_prompt = self.options.system_prompt
+        else:
+            system_prompt = self.options.system_prompt
 
         # JSON schema for structured output
         json_schema: dict[str, Any] | None

{clawd_code_sdk-0.3.4 → clawd_code_sdk-0.3.6}/src/clawd_code_sdk/models/messages.py

@@ -198,9 +198,9 @@ class HookStartedSystemMessage(BaseSystemMessage):
     """System message emitted when a hook starts."""
 
     subtype: Literal["hook_started"] = "hook_started"
-    hook_id: str | None = None
-    hook_name: str | None = None
-    hook_event: str | None = None
+    hook_id: str
+    hook_name: str
+    hook_event: str
 
 
 @dataclass(kw_only=True)
@@ -209,6 +209,7 @@ class StatusSystemMessage(BaseSystemMessage):
 
     subtype: Literal["status"] = "status"
     status: Literal["compacting"] | None
+    permissionMode: PermissionMode | None = None  # noqa: N815
 
 
 class TriggerMetadata(TypedDict):
@@ -247,9 +248,9 @@ class TaskStartedSystemMessage(BaseSystemMessage):
     """System message emitted when a subagent task starts."""
 
     subtype: Literal["task_started"] = "task_started"
-    task_id: str = ""
+    task_id: str
     tool_use_id: str | None = None
-    description: str = ""
+    description: str
     task_type: str | None = None
 
 
@@ -258,10 +259,10 @@ class TaskNotificationSystemMessage(BaseSystemMessage):
     """System message emitted when a subagent task completes, fails, or stops."""
 
     subtype: Literal["task_notification"] = "task_notification"
-    task_id: str = ""
-    status: TaskStatus = "completed"
-    output_file: str = ""
-    summary: str = ""
+    task_id: str
+    status: TaskStatus
+    output_file: str
+    summary: str
     tool_use_id: str | None = None
 
 
@@ -278,10 +279,10 @@ class TaskProgressSystemMessage(BaseSystemMessage):
     """System message emitted periodically with task progress updates."""
 
     subtype: Literal["task_progress"] = "task_progress"
-    task_id: str = ""
+    task_id: str
     tool_use_id: str | None = None
-    description: str = ""
-    usage: TaskProgressUsage | None = None
+    description: str
+    usage: TaskProgressUsage
     last_tool_name: ToolName | str | None = None
 
 

{clawd_code_sdk-0.3.4 → clawd_code_sdk-0.3.6}/src/clawd_code_sdk/models/options.py

@@ -10,12 +10,12 @@ from typing import TYPE_CHECKING, Any, Literal, TypedDict
 
 
 if TYPE_CHECKING:
-    from collections.abc import Callable
+    from collections.abc import Callable, Sequence
 
     from clawd_code_sdk.models.base import ModelName
     from clawd_code_sdk.models.permissions import OnUserQuestion
 
-    from .agents import AgentDefinition, SystemPromptPreset, ToolsPreset
+    from .agents import AgentDefinition, ToolsPreset
     from .base import PermissionMode, ReasoningEffort, SettingSource, ThinkingConfig
     from .hooks import HookEvent, HookMatcher
     from .mcp import McpServerConfig, SdkPluginConfig
@@ -192,7 +192,7 @@ class ClaudeAgentOptions:
     """CLI path override (auto-detects by default)."""
     extra_args: dict[str, str | None] = field(default_factory=dict)
     """Arbitrary extra CLI flags."""
-    max_buffer_size: int | None = None
+    max_buffer_size: int = 10 * 1024 * 1024
     """Max bytes when buffering CLI stdout."""
     stderr: Callable[[str], None] | None = None
     """Callback for stderr output from CLI."""
@@ -201,7 +201,7 @@ class ClaudeAgentOptions:
     user: str | None = None
     """User for the AnyIO process."""
     # CWD
-    add_dirs: list[str | Path] = field(default_factory=list)
+    add_dirs: Sequence[str | Path] = field(default_factory=list)
     """Add additional working directories."""
     cwd: str | Path | None = None
     """The working directory for the agent."""
@@ -219,8 +219,14 @@ class ClaudeAgentOptions:
     debug_file: str | None = None
     """Write debug logs to a specific file path. Implicitly enables debug mode."""
     # Agent config
-    system_prompt: str | SystemPromptPreset | None = None
+    system_prompt: str | None = None
     """System prompt for the agent."""
+    include_builtin_system_prompt: bool = True
+    """Whether to include Claude Code's builtin system prompt.
+
+    When True (default) and system_prompt is set, it is appended to the
+    builtin system prompt. When False, the system_prompt replaces it entirely.
+    """
     hooks: dict[HookEvent, list[HookMatcher]] | None = None
     """Hook configurations."""
     agents: dict[str, AgentDefinition] | None = None