clawd-code-sdk 0.4.0__tar.gz → 0.4.1__tar.gz

{clawd_code_sdk-0.4.0 → clawd_code_sdk-0.4.1}/PKG-INFO

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

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

{clawd_code_sdk-0.4.0 → clawd_code_sdk-0.4.1}/src/clawd_code_sdk/__init__.py

@@ -90,11 +90,17 @@ from .models import (
     ToolResultBlock,
     ToolUseBlock,
     UserMessage,
-    UserPromptSubmitHookInput,
-    UserTextPrompt,
+    DocumentMediaType,
+    ImageMediaType,
+    PlainTextMediaType,
+    UserDocumentPrompt,
+    UserDocumentURLPrompt,
     UserImagePrompt,
+    UserImageURLPrompt,
+    UserPlainTextDocumentPrompt,
     UserPrompt,
-    ImageMediaType,
+    UserPromptSubmitHookInput,
+    UserTextPrompt,
     FromPR,
     NewSession,
     ResumeSession,
@@ -146,6 +152,7 @@ __all__ = [
     # Session config
     "ContinueLatest",
     "ConversationTurn",
+    "DocumentMediaType",
     "FromPR",
     "HookCallback",
     "HookContext",
@@ -173,6 +180,7 @@ __all__ = [
     "PermissionResultAllow",
     "PermissionResultDeny",
     "PermissionUpdate",
+    "PlainTextMediaType",
     "PostToolUseFailureHookInput",
     "PostToolUseFailureHookSpecificOutput",
     "PostToolUseHookInput",
@@ -221,8 +229,12 @@ __all__ = [
     "ToolUseBlock",
     # Transport
     "Transport",
+    "UserDocumentPrompt",
+    "UserDocumentURLPrompt",
     "UserImagePrompt",
+    "UserImageURLPrompt",
     "UserMessage",
+    "UserPlainTextDocumentPrompt",
     "UserPrompt",
     "UserPromptSubmitHookInput",
     "UserTextPrompt",

{clawd_code_sdk-0.4.0 → clawd_code_sdk-0.4.1}/src/clawd_code_sdk/client.py

@@ -31,9 +31,7 @@ if TYPE_CHECKING:
     from clawd_code_sdk._internal.query import Query
     from clawd_code_sdk.models import Message, PermissionMode
     from clawd_code_sdk.models.mcp import McpServerConfig
-    from clawd_code_sdk.models.messages import (
-        UserImagePrompt,
-    )
+    from clawd_code_sdk.models.messages import UserPrompt
     from clawd_code_sdk.models.server_info import ClaudeCodeServerInfo
 
 
@@ -164,7 +162,7 @@ class ClaudeSDKClient:
 
     async def query(
         self,
-        *prompts: str | UserTextPrompt | UserImagePrompt,
+        *prompts: str | UserPrompt,
         session_id: str = "default",
         parent_tool_use_id: str | None = None,
     ) -> None:

{clawd_code_sdk-0.4.0 → clawd_code_sdk-0.4.1}/src/clawd_code_sdk/models/__init__.py

@@ -241,10 +241,16 @@ from .messages import (
     TriggerMetadata,
     Usage,
     UserMessage,
+    DocumentMediaType,
+    ImageMediaType,
+    PlainTextMediaType,
+    UserDocumentPrompt,
+    UserDocumentURLPrompt,
     UserImagePrompt,
-    UserTextPrompt,
+    UserImageURLPrompt,
+    UserPlainTextDocumentPrompt,
     UserPrompt,
-    ImageMediaType,
+    UserTextPrompt,
     system_message_adapter,
 )
 from .options import ClaudeAgentOptions
@@ -318,6 +324,7 @@ __all__ = [
     "ControlErrorResponse",
     "ControlRequestUnion",
     "ControlResponse",
+    "DocumentMediaType",
     "EditOutput",
     "EditToolUseResult",
     "EnterPlanModeInput",
@@ -392,6 +399,7 @@ __all__ = [
     "PermissionRuleValue",
     "PermissionUpdate",
     "PermissionUpdateDestination",
+    "PlainTextMediaType",
     "PostToolUseFailureHookInput",
     "PostToolUseFailureHookSpecificOutput",
     "PostToolUseHookInput",
@@ -491,8 +499,12 @@ __all__ = [
     "UnsubscribeMcpResourceOutput",
     "UnsubscribePollingOutput",
     "Usage",
+    "UserDocumentPrompt",
+    "UserDocumentURLPrompt",
     "UserImagePrompt",
+    "UserImageURLPrompt",
     "UserMessage",
+    "UserPlainTextDocumentPrompt",
     "UserPrompt",
     "UserPromptSubmitHookInput",
     "UserPromptSubmitHookSpecificOutput",

{clawd_code_sdk-0.4.0 → clawd_code_sdk-0.4.1}/src/clawd_code_sdk/models/messages.py

@@ -59,6 +59,8 @@ Outcome = Literal["success", "error", "cancelled"]
 
 
 ImageMediaType = Literal["image/png", "image/jpeg", "image/gif", "image/webp"]
+DocumentMediaType = Literal["application/pdf"]
+PlainTextMediaType = Literal["text/plain"]
 
 
 @dataclass
@@ -93,7 +95,119 @@ class UserImagePrompt:
         }
 
 
-UserPrompt = UserTextPrompt | UserImagePrompt
+@dataclass
+class UserImageURLPrompt:
+    """A user prompt containing an image referenced by URL."""
+
+    url: str
+    """Public URL of the image."""
+
+    def to_content_block(self) -> dict[str, Any]:
+        """Return the Anthropic API content block dict."""
+        return {
+            "type": "image",
+            "source": {
+                "type": "url",
+                "url": self.url,
+            },
+        }
+
+
+@dataclass
+class UserDocumentPrompt:
+    """A user prompt containing a base64-encoded PDF document."""
+
+    document_data: str
+    """Base64-encoded PDF data."""
+    media_type: DocumentMediaType = "application/pdf"
+    """MIME type of the document."""
+    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": "base64",
+                "media_type": self.media_type,
+                "data": self.document_data,
+            },
+        }
+        if self.title is not None:
+            block["title"] = self.title
+        if self.context is not None:
+            block["context"] = self.context
+        return block
+
+
+@dataclass
+class UserDocumentURLPrompt:
+    """A user prompt containing a PDF document referenced by URL."""
+
+    url: str
+    """Public URL of the PDF document."""
+    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": "url",
+                "url": self.url,
+            },
+        }
+        if self.title is not None:
+            block["title"] = self.title
+        if self.context is not None:
+            block["context"] = self.context
+        return block
+
+
+@dataclass
+class UserPlainTextDocumentPrompt:
+    """A user prompt containing a plain text document."""
+
+    data: str
+    """The plain text content."""
+    media_type: PlainTextMediaType = "text/plain"
+    """MIME type (always text/plain)."""
+    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": "text",
+                "media_type": self.media_type,
+                "data": self.data,
+            },
+        }
+        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
+    | UserImageURLPrompt
+    | UserDocumentPrompt
+    | UserDocumentURLPrompt
+    | UserPlainTextDocumentPrompt
+)
 """Union type for all user prompt dataclasses."""
 
 

{clawd_code_sdk-0.4.0 → clawd_code_sdk-0.4.1}/src/clawd_code_sdk/query.py

@@ -13,11 +13,11 @@ if TYPE_CHECKING:
 
     from clawd_code_sdk._internal.transport import Transport
     from clawd_code_sdk.models import Message
-    from clawd_code_sdk.models.messages import UserImagePrompt, UserTextPrompt
+    from clawd_code_sdk.models.messages import UserPrompt
 
 
 async def query(
-    *prompts: str | UserTextPrompt | UserImagePrompt,
+    *prompts: str | UserPrompt,
     options: ClaudeAgentOptions | None = None,
     transport: Transport | None = None,
 ) -> AsyncIterator[Message]: