clawd-code-sdk 1.0.6__tar.gz → 1.0.8__tar.gz

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/PKG-INFO

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

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

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/__init__.py

@@ -51,8 +51,13 @@ from .models import (
     McpSdkServerConfig,
     McpSdkServerConfigWithInstance,
     McpServerConfig,
+    AppliedSettings,
+    GetSettingsResponse,
+    McpAuthenticateResponse,
     McpSetServersResult,
+    SettingsSource,
     Message,
+    RemoteControlResponse,
     NotificationHookInput,
     NotificationHookSpecificOutput,
     PermissionMode,
@@ -138,6 +143,7 @@ __all__ = [
     # Hook support
     "AgentHookHandler",
     "AgentHooksConfig",
+    "AppliedSettings",
     "AssistantMessage",
     "AuthenticationError",
     "BaseHookInput",
@@ -163,6 +169,7 @@ __all__ = [
     "DocumentMediaType",
     "Filesystem",
     "FromPR",
+    "GetSettingsResponse",
     "HookCallback",
     "HookContext",
     "HookHandler",
@@ -177,6 +184,7 @@ __all__ = [
     "InitSystemMessage",
     "InvalidRequestError",
     "ListSessionsOptions",
+    "McpAuthenticateResponse",
     "McpSdkServerConfig",
     "McpSdkServerConfigWithInstance",
     "McpServerConfig",
@@ -206,6 +214,7 @@ __all__ = [
     "ProcessError",
     "PromptHookHandler",
     "RateLimitError",
+    "RemoteControlResponse",
     "ResultErrorMessage",
     "ResultMessage",
     "ResultSuccessMessage",
@@ -225,6 +234,7 @@ __all__ = [
     "SessionSnapshot",
     "SessionState",
     "SettingSource",
+    "SettingsSource",
     "StopHookInput",
     "SubagentStartHookInput",
     "SubagentStartHookSpecificOutput",

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/_internal/query.py

@@ -522,6 +522,45 @@ class Query:
         """End the current session."""
         return await self._send_control_request({"subtype": "end_session"})
 
+    async def remote_control(self, *, enabled: bool) -> dict[str, Any]:
+        """Toggle the remote control REPL bridge for external session access.
+
+        When enabled, starts a bridge that allows remote clients to send prompts,
+        permission responses, interrupts, and model changes into the session.
+        The response includes ``session_url``, ``connect_url``, and
+        ``environment_id`` when enabling.
+        """
+        req = {"subtype": "remote_control", "enabled": enabled}
+        return await self._send_control_request(req)
+
+    async def apply_flag_settings(self, settings: dict[str, Any]) -> dict[str, Any]:
+        """Apply runtime flag settings."""
+        req = {"subtype": "apply_flag_settings", "settings": settings}
+        return await self._send_control_request(req)
+
+    async def get_settings(self) -> dict[str, Any]:
+        """Get the effective merged settings and raw per-source settings."""
+        return await self._send_control_request({"subtype": "get_settings"})
+
+    async def mcp_authenticate(self, server_name: str) -> dict[str, Any]:
+        """Trigger OAuth authentication for an MCP server."""
+        req = {"subtype": "mcp_authenticate", "serverName": server_name}
+        return await self._send_control_request(req)
+
+    async def mcp_clear_auth(self, server_name: str) -> dict[str, Any]:
+        """Clear OAuth credentials for an MCP server."""
+        req = {"subtype": "mcp_clear_auth", "serverName": server_name}
+        return await self._send_control_request(req)
+
+    async def mcp_oauth_callback_url(self, server_name: str, callback_url: str) -> dict[str, Any]:
+        """Provide an OAuth redirect callback URL to complete an MCP server OAuth flow."""
+        req = {
+            "subtype": "mcp_oauth_callback_url",
+            "serverName": server_name,
+            "callbackUrl": callback_url,
+        }
+        return await self._send_control_request(req)
+
     async def rewind_files(self, user_message_id: str) -> dict[str, Any]:
         """Rewind tracked files to their state at a specific user message.
 

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/anthropic_types.py

@@ -7,6 +7,7 @@ used to provide proper typing for ToolResultBlock.content.
 
 from __future__ import annotations
 
+import functools
 from typing import Annotated
 
 from anthropic.types.beta import (
@@ -73,35 +74,32 @@ ToolResultContentBlock = Annotated[
     | BetaTextEditorCodeExecutionToolResultError,
     Field(discriminator="type"),
 ]
-_tool_result_content_adapter: TypeAdapter[list[ToolResultContentBlock]] | None = None
 
 
+@functools.cache
 def _get_adapter() -> TypeAdapter[list[ToolResultContentBlock]]:
-    global _tool_result_content_adapter  # noqa: PLW0603
-    if _tool_result_content_adapter is None:
-        # Force schema build for Anthropic models (deferred by default)
-        for model in [
-            BetaTextBlock,
-            BetaWebSearchResultBlock,
-            BetaWebSearchToolResultError,
-            BetaBashCodeExecutionResultBlock,
-            BetaBashCodeExecutionToolResultError,
-            BetaCodeExecutionResultBlock,
-            BetaCodeExecutionToolResultError,
-            BetaTextEditorCodeExecutionCreateResultBlock,
-            BetaTextEditorCodeExecutionStrReplaceResultBlock,
-            BetaTextEditorCodeExecutionToolResultError,
-            BetaTextEditorCodeExecutionViewResultBlock,
-            BetaToolReferenceBlock,
-            BetaToolSearchToolResultError,
-            BetaToolSearchToolSearchResultBlock,
-            BetaWebFetchBlock,
-            BetaWebFetchToolResultErrorBlock,
-        ]:
-            if isinstance(model, type) and issubclass(model, BaseModel):
-                model.model_rebuild()
-        _tool_result_content_adapter = TypeAdapter(list[ToolResultContentBlock])
-    return _tool_result_content_adapter
+    # Force schema build for Anthropic models (deferred by default)
+    for model in [
+        BetaTextBlock,
+        BetaWebSearchResultBlock,
+        BetaWebSearchToolResultError,
+        BetaBashCodeExecutionResultBlock,
+        BetaBashCodeExecutionToolResultError,
+        BetaCodeExecutionResultBlock,
+        BetaCodeExecutionToolResultError,
+        BetaTextEditorCodeExecutionCreateResultBlock,
+        BetaTextEditorCodeExecutionStrReplaceResultBlock,
+        BetaTextEditorCodeExecutionToolResultError,
+        BetaTextEditorCodeExecutionViewResultBlock,
+        BetaToolReferenceBlock,
+        BetaToolSearchToolResultError,
+        BetaToolSearchToolSearchResultBlock,
+        BetaWebFetchBlock,
+        BetaWebFetchToolResultErrorBlock,
+    ]:
+        if isinstance(model, type) and issubclass(model, BaseModel):
+            model.model_rebuild()
+    return TypeAdapter(list[ToolResultContentBlock])
 
 
 def validate_tool_result_content(content: list[dict[str, object]]) -> list[ToolResultContentBlock]:

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/client.py

@@ -7,16 +7,18 @@ import os
 from typing import TYPE_CHECKING, Any, Literal, Self, cast
 
 import anyenv
-from pydantic import TypeAdapter
 
 from clawd_code_sdk._errors import CLIConnectionError
 from clawd_code_sdk.models import (
     AssistantMessage,
     ClaudeAgentOptions,
     ClaudeCodeAgentInfo,  # noqa: TC001
+    GetSettingsResponse,
+    McpAuthenticateResponse,
     McpSdkServerConfigWithInstance,
     McpSetServersResult,
     McpStatusResponse,
+    RemoteControlResponse,
     ResultErrorMessage,
     ResultMessage,
     ResultSuccessMessage,
@@ -33,6 +35,7 @@ if TYPE_CHECKING:
     from clawd_code_sdk._internal.query import Query
     from clawd_code_sdk.models import (
         ClaudeCodeServerInfo,
+        ClaudeCodeSettings,
         McpServerConfig,
         Message,
         PermissionMode,
@@ -91,9 +94,6 @@ class ClaudeSDKClient:
         from clawd_code_sdk._internal.query import Query
         from clawd_code_sdk._internal.transport.subprocess_cli import SubprocessCLITransport
 
-        # Validate and configure permission settings (matching TypeScript SDK logic)
-        self.options.validate()
-
         # If on_permission is a callback, extract it for Query and replace with
         # "stdio" so the CLI routes permission requests through the control protocol.
         if callable(self.options.on_permission):
@@ -130,20 +130,10 @@ class ClaudeSDKClient:
         else:
             system_prompt = self.options.system_prompt
 
-        # JSON schema for structured output
-        json_schema: dict[str, Any] | None
-        match self.options.output_schema:
-            case type() as typ:
-                json_schema = TypeAdapter(typ).json_schema()
-            case dict() as schema:
-                json_schema = schema
-            case None:
-                json_schema = None
-
         # Create Query to handle control protocol
         self._query = Query(
             transport=self._transport,
-            can_use_tool=can_use_tool,
+            can_use_tool=can_use_tool,  # ty:ignore[invalid-argument-type]
             on_user_question=self.options.on_user_question,
             on_elicitation=self.options.on_elicitation,
             hooks=self.options.hooks,
@@ -152,7 +142,7 @@ class ClaudeSDKClient:
             agents=self.options.agents,
             system_prompt=system_prompt,
             append_system_prompt=append_system_prompt,
-            json_schema=json_schema,
+            json_schema=self.options.get_json_schema(),
             prompt_suggestions=self.options.prompt_suggestions,
             agent_progress_summaries=self.options.agent_progress_summaries,
         )
@@ -338,6 +328,65 @@ class ClaudeSDKClient:
         query = self._ensure_connected()
         await query.end_session()
 
+    async def remote_control(self, *, enabled: bool) -> RemoteControlResponse | None:
+        """Toggle the remote control REPL bridge for external session access.
+
+        When enabled, starts a bridge that allows remote clients to send prompts,
+        permission responses, interrupts, and model changes into the session.
+
+        Returns:
+            A ``RemoteControlResponse`` with session URLs and environment ID
+            when enabling, or ``None`` when disabling.
+        """
+        query = self._ensure_connected()
+        result = await query.remote_control(enabled=enabled)
+        if not result:
+            return None
+        return RemoteControlResponse.model_validate(result)
+
+    async def apply_flag_settings(self, settings: ClaudeCodeSettings) -> None:
+        """Apply runtime settings overrides without restarting the session.
+
+        Flag settings are an in-memory settings source that gets merged with
+        other sources (user, project, etc.) to produce the effective settings.
+
+        Args:
+            settings: Settings to apply. Only non-None fields will be sent.
+        """
+        query = self._ensure_connected()
+        serialized = settings.model_dump(by_alias=True, exclude_none=True)
+        await query.apply_flag_settings(serialized)
+
+    async def get_settings(self) -> GetSettingsResponse:
+        """Get the effective merged settings and raw per-source settings."""
+        query = self._ensure_connected()
+        result = await query.get_settings()
+        return GetSettingsResponse.model_validate(result)
+
+    async def mcp_authenticate(self, server_name: str) -> McpAuthenticateResponse:
+        """Trigger OAuth authentication for an MCP server.
+
+        Returns:
+            Response indicating whether user action is required and the auth URL if so.
+        """
+        query = self._ensure_connected()
+        result = await query.mcp_authenticate(server_name)
+        return McpAuthenticateResponse.model_validate(result)
+
+    async def mcp_clear_auth(self, server_name: str) -> None:
+        """Clear OAuth credentials for an MCP server."""
+        query = self._ensure_connected()
+        await query.mcp_clear_auth(server_name)
+
+    async def mcp_oauth_callback_url(self, server_name: str, callback_url: str) -> None:
+        """Provide an OAuth redirect callback URL to complete an MCP server OAuth flow.
+
+        After the user completes browser-based OAuth, call this with the full
+        redirect URL (containing the authorization code) to finish the flow.
+        """
+        query = self._ensure_connected()
+        await query.mcp_oauth_callback_url(server_name, callback_url)
+
     async def set_max_thinking_tokens(self, max_thinking_tokens: int) -> None:
         """Set the maximum number of thinking tokens for extended thinking."""
         query = self._ensure_connected()

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/models/__init__.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from .agents import AgentDefinition, AgentInfo, ToolsPreset
 from .base import (
     ApiKeySource,
+    AssistantMessageError,
     ElicitationAction,
     ElicitationMode,
     PermissionMode,
@@ -34,7 +35,12 @@ from .control import (
     SDKControlMcpMessageRequest,
     SDKControlMcpOAuthCallbackUrlRequest,
     SDKControlPermissionRequest,
+    AppliedSettings,
+    GetSettingsResponse,
+    McpAuthenticateResponse,
+    RemoteControlResponse,
     SDKControlRemoteControlRequest,
+    SettingsSource,
     SDKControlRequest,
     SDKControlResponse,
     SDKControlRewindFilesRequest,
@@ -214,12 +220,10 @@ from .content_blocks import (
     ThinkingBlock,
     ToolResultBlock,
     ToolUseBlock,
-    content_block_adapter,
 )
 from .session import SDKSessionInfo, ListSessionsOptions
 from .messages import (
     AssistantMessage,
-    AssistantMessageError,
     ModelUsage,
     BaseResultMessage,
     PromptSuggestionMessage,
@@ -367,6 +371,7 @@ __all__ = [
     "AgentOutputUsage",
     "AgentServerToolUse",
     "ApiKeySource",
+    "AppliedSettings",
     "AskUserQuestion",
     "AskUserQuestionInput",
     "AskUserQuestionItem",
@@ -424,6 +429,7 @@ __all__ = [
     "FilesPersistedSystemMessage",
     "Filesystem",
     "FromPR",
+    "GetSettingsResponse",
     "GitDiff",
     "GlobInput",
     "GlobOutput",
@@ -460,6 +466,7 @@ __all__ = [
     "ListMcpResourcesOutput",
     "ListSessionsOptions",
     "LocalCommandOutputMessage",
+    "McpAuthenticateResponse",
     "McpClaudeAIProxyServerConfig",
     "McpConnectionStatus",
     "McpHttpServerConfig",
@@ -532,6 +539,7 @@ __all__ = [
     "ReadPdfOutput",
     "ReadTextOutput",
     "ReasoningEffort",
+    "RemoteControlResponse",
     "RequestId",
     "ResultErrorMessage",
     "ResultMessage",
@@ -564,6 +572,7 @@ __all__ = [
     "SessionStartHookInput",
     "SessionStartHookSpecificOutput",
     "SettingSource",
+    "SettingsSource",
     "SetupHookInput",
     "SkillInput",
     "SkillOutput",
@@ -631,7 +640,6 @@ __all__ = [
     "WorktreeCreateHookInput",
     "WorktreeRemoveHookInput",
     "WriteOutput",
-    "content_block_adapter",
     "control_request_adapter",
     "message_adapter",
     "system_message_adapter",

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/models/agents.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass, fields
-from typing import Any, Literal, TypedDict
+from typing import TYPE_CHECKING, Any, Literal, TypedDict
 
 from anthropic.types import Model  # noqa: TC002
 
@@ -12,6 +12,10 @@ from clawd_code_sdk.models.hooks import AgentHooksConfig  # noqa: TC001
 from clawd_code_sdk.models.mcp import ExternalMcpServerConfig  # noqa: TC001
 
 
+if TYPE_CHECKING:
+    from collections.abc import Mapping
+
+
 # Agent MCP server spec: either a string name or a {name: config} dict.
 # Matches the TypeScript type: AgentMcpServerSpec =
 # string | Record<string, McpServerConfigForProcessTransport>
@@ -57,7 +61,7 @@ class AgentDefinition:
     tools: list[str] | None = None
     model: ModelName | Literal["inherit"] | str | None = None  # noqa: PYI051
     memory: SettingSource | None = None
-    mcp_servers: list[AgentMcpServerSpec] | dict[str, ExternalMcpServerConfig] | None = None
+    mcp_servers: list[AgentMcpServerSpec] | Mapping[str, ExternalMcpServerConfig] | None = None
     disallowed_tools: list[str] | None = None
     critical_system_reminder_experimental: str | None = None
     skills: list[str] | None = None

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/models/base.py

@@ -26,7 +26,15 @@ CompactionTrigger = Literal["auto", "manual"]
 ElicitationMode = Literal["form", "url"]
 ElicitationAction = Literal["accept", "decline", "cancel"]
 FastModeState = Literal["off", "cooldown", "on"]
-
+EffortLevel = Literal["low", "medium", "high", "max"]
+AssistantMessageError = Literal[
+    "authentication_failed",
+    "billing_error",
+    "rate_limit",
+    "invalid_request",
+    "server_error",
+    "unknown",
+]
 StopReason = Literal[
     "end_turn",
     "max_tokens",

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/models/content_blocks.py

@@ -11,7 +11,7 @@ from collections.abc import Sequence
 from typing import TYPE_CHECKING, Annotated, Any, Literal
 
 from anthropic.types.beta.beta_tool_use_block import Caller
-from pydantic import BaseModel, ConfigDict, Discriminator, TypeAdapter
+from pydantic import BaseModel, ConfigDict, Discriminator
 
 from clawd_code_sdk.models import ToolInput
 from clawd_code_sdk.models.base import ClaudeCodeBaseModel, StopReason, ToolName
@@ -110,8 +110,6 @@ ContentBlock = Annotated[
     Discriminator("type"),
 ]
 
-content_block_adapter = TypeAdapter[ContentBlock](ContentBlock)
-
 
 # =============================================================================
 # Message-level models

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/models/control.py

@@ -5,12 +5,19 @@ from __future__ import annotations
 from dataclasses import dataclass
 from typing import Annotated, Any, Literal, TypedDict
 
-from pydantic import Discriminator, TypeAdapter
+from pydantic import BaseModel, Discriminator, TypeAdapter
 
 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.base import (  # noqa: TC001
+    ClaudeCodeBaseModel,
+    EffortLevel,
+    ElicitationMode,
+    ModelName,
+    PermissionMode,
+)
 from clawd_code_sdk.models.hooks import HookEvent, HookInput  # noqa: TC001
 from clawd_code_sdk.models.mcp import ExternalMcpServerConfig, JSONRPCMessage  # noqa: TC001
+from clawd_code_sdk.models.permissions import PermissionUpdate  # noqa: TC001
 
 
 # SDK Control Protocol
@@ -28,10 +35,12 @@ class SDKControlPermissionRequest:
     subtype: Literal["can_use_tool"] = "can_use_tool"
     tool_name: str
     input: dict[str, Any]
-    tool_use_id: str
-    permission_suggestions: list[Any] | None = None
+    permission_suggestions: list[PermissionUpdate] | None = None
     blocked_path: str | None = None
     decision_reason: str | None = None
+    title: str | None = None
+    display_name: str | None = None
+    tool_use_id: str
     agent_id: str | None = None
     description: str | None = None
 
@@ -209,6 +218,66 @@ class SDKControlRemoteControlRequest:
     enabled: bool = False
 
 
+class RemoteControlResponse(BaseModel):
+    """Response from enabling remote control.
+
+    Contains the URLs and identifiers needed for remote clients to connect
+    to the session.
+    """
+
+    session_url: str
+    """URL for the remote control session."""
+
+    connect_url: str
+    """URL for remote clients to connect to the session."""
+
+    environment_id: str
+    """Identifier for the environment hosting the session."""
+
+
+class McpAuthenticateResponse(ClaudeCodeBaseModel):
+    """Response from authenticating with an MCP server."""
+
+    auth_url: str | None = None
+    """OAuth authorization URL for the user to visit, if user action is required."""
+
+    requires_user_action: bool
+    """Whether the user needs to complete an OAuth flow in the browser."""
+
+
+class AppliedSettings(BaseModel):
+    """The currently applied model and effort settings."""
+
+    model: ModelName | str
+    """The active model identifier."""
+
+    effort: EffortLevel | None = None
+    """The active effort level, or None if not set."""
+
+
+class SettingsSource(BaseModel):
+    """A single settings source with its raw settings."""
+
+    source: str
+    """The source name (e.g. 'user', 'project', 'flagSettings')."""
+
+    settings: dict[str, Any]
+    """The raw settings from this source."""
+
+
+class GetSettingsResponse(BaseModel):
+    """Response from get_settings() containing effective and per-source settings."""
+
+    effective: dict[str, Any]
+    """The merged effective settings (ClaudeCodeSettings shape, camelCase keys)."""
+
+    sources: list[SettingsSource]
+    """Raw settings from each source."""
+
+    applied: AppliedSettings
+    """The currently applied model and effort."""
+
+
 @dataclass(frozen=True, slots=True, kw_only=True)
 class SDKControlElicitationRequest:
     """Requests the SDK consumer to handle an MCP elicitation (user input request)."""

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/models/hooks.py

@@ -11,6 +11,7 @@ from clawd_code_sdk.models.base import (  # noqa: TC001
     ElicitationAction,
     ElicitationMode,
 )
+from clawd_code_sdk.models.permissions import PermissionUpdate  # noqa: TC001
 
 
 if TYPE_CHECKING:
@@ -41,7 +42,7 @@ HookEvent = Literal[
     "WorktreeRemove",
     "InstructionsLoaded",
 ]
-
+LoadReason = Literal["session_start", "nested_traversal", "path_glob_match", "include", "compact"]
 
 # ---------------------------------------------------------------------------
 # Declarative hook handler configs (for agent/skill frontmatter & settings)
@@ -237,7 +238,7 @@ class PermissionRequestHookInput(BaseHookInput):
     hook_event_name: Literal["PermissionRequest"]
     tool_name: str
     tool_input: dict[str, Any]
-    permission_suggestions: NotRequired[list[Any]]
+    permission_suggestions: NotRequired[list[PermissionUpdate]]
     agent_id: NotRequired[str]
     agent_type: NotRequired[str]
 
@@ -337,7 +338,7 @@ class InstructionsLoadedHookInput(BaseHookInput):
     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"]
+    load_reason: LoadReason
     globs: NotRequired[list[str]]
     trigger_file_path: NotRequired[str]
     parent_file_path: NotRequired[str]

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/models/input_types.py

@@ -33,8 +33,8 @@ class AgentInput(TypedDict):
 
     Takes precedence over the agent definition's model frontmatter.
     If omitted, uses the agent definition's model, or inherits from the parent."""
-    resume: NotRequired[str]
-    """Optional agent ID to resume from in order to continue from the previous exec transcript."""
+    # 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."""
     name: NotRequired[str]

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/models/messages.py

@@ -31,7 +31,12 @@ from clawd_code_sdk._errors import (
     RateLimitError,
     ServerError,
 )
-from clawd_code_sdk.models.base import FastModeState, StopReason, ToolName  # noqa: TC001
+from clawd_code_sdk.models.base import (  # noqa: TC001
+    AssistantMessageError,
+    FastModeState,
+    StopReason,
+    ToolName,
+)
 from clawd_code_sdk.models.content_blocks import (
     AssistantMessageContent,
     MessageParam,
@@ -46,15 +51,6 @@ if TYPE_CHECKING:
 
 
 # Message types
-AssistantMessageError = Literal[
-    "authentication_failed",
-    "billing_error",
-    "rate_limit",
-    "invalid_request",
-    "server_error",
-    "unknown",
-]
-
 ErrorSubType = Literal[
     "error_during_execution",
     "error_max_turns",
@@ -173,6 +169,7 @@ class UserMessage(BaseMessage):
     is_synthetic: bool | None = Field(default=None, validation_alias="isSynthetic")
     priority: Literal["now", "next", "later"] | None = None
     message: MessageParam
+    timestamp: str | None = None
 
     @property
     def content(self) -> str | Sequence[ContentBlock]:

{clawd_code_sdk-1.0.6 → clawd_code_sdk-1.0.8}/src/clawd_code_sdk/models/options.py

@@ -334,5 +334,15 @@ class ClaudeAgentOptions:
 
         return anyenv.dump_json(settings_obj) if settings_obj else None
 
-    def validate(self) -> None:
-        """Validate option constraints."""
+    def get_json_schema(self) -> dict[str, Any] | None:
+        from pydantic import TypeAdapter
+
+        match self.output_schema:
+            case type() as typ:
+                return TypeAdapter(typ).json_schema()
+            case dict() as schema:
+                return schema
+            case None:
+                return None
+            case _ as unreachable:
+                assert_never(unreachable)