feat(api): add URL source blocks for images and PDFs (#884)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 21
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic-e1328d31b4446324096fb948bd5074b5ac00d7c7e3ce89b6974a1c5aebf5a64d.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic-129d8719c17bc9ea6e310a63400f60e7ad3ef828e54265eb8a8035684187210b.yml

api.md

@@ -22,6 +22,7 @@ Types:
 
 ```python
 from anthropic.types import (
+    Base64ImageSource,
     Base64PDFSource,
     CacheControlEphemeral,
     CitationCharLocation,
@@ -86,6 +87,8 @@ from anthropic.types import (
     ToolUnion,
     ToolUseBlock,
     ToolUseBlockParam,
+    URLImageSource,
+    URLPDFSource,
     Usage,
 )
 ```
@@ -176,6 +179,7 @@ Types:
 
 ```python
 from anthropic.types.beta import (
+    BetaBase64ImageSource,
     BetaBase64PDFBlock,
     BetaBase64PDFSource,
     BetaCacheControlEphemeral,
@@ -235,6 +239,8 @@ from anthropic.types.beta import (
     BetaToolUnion,
     BetaToolUseBlock,
     BetaToolUseBlockParam,
+    BetaURLImageSource,
+    BetaURLPDFSource,
     BetaUsage,
 )
 ```

src/anthropic/types/__init__.py

@@ -56,6 +56,7 @@
 from .message_tokens_count import MessageTokensCount as MessageTokensCount
 from .thinking_block_param import ThinkingBlockParam as ThinkingBlockParam
 from .tool_use_block_param import ToolUseBlockParam as ToolUseBlockParam
+from .url_pdf_source_param import URLPDFSourceParam as URLPDFSourceParam
 from .beta_overloaded_error import BetaOverloadedError as BetaOverloadedError
 from .beta_permission_error import BetaPermissionError as BetaPermissionError
 from .beta_rate_limit_error import BetaRateLimitError as BetaRateLimitError
@@ -68,6 +69,7 @@
 from .raw_message_stop_event import RawMessageStopEvent as RawMessageStopEvent
 from .tool_choice_auto_param import ToolChoiceAutoParam as ToolChoiceAutoParam
 from .tool_choice_tool_param import ToolChoiceToolParam as ToolChoiceToolParam
+from .url_image_source_param import URLImageSourceParam as URLImageSourceParam
 from .base64_pdf_source_param import Base64PDFSourceParam as Base64PDFSourceParam
 from .plain_text_source_param import PlainTextSourceParam as PlainTextSourceParam
 from .raw_message_delta_event import RawMessageDeltaEvent as RawMessageDeltaEvent
@@ -78,6 +80,7 @@
 from .content_block_stop_event import ContentBlockStopEvent as ContentBlockStopEvent
 from .raw_message_stream_event import RawMessageStreamEvent as RawMessageStreamEvent
 from .tool_bash_20250124_param import ToolBash20250124Param as ToolBash20250124Param
+from .base64_image_source_param import Base64ImageSourceParam as Base64ImageSourceParam
 from .beta_authentication_error import BetaAuthenticationError as BetaAuthenticationError
 from .content_block_delta_event import ContentBlockDeltaEvent as ContentBlockDeltaEvent
 from .content_block_start_event import ContentBlockStartEvent as ContentBlockStartEvent

src/anthropic/types/base64_image_source_param.py

@@ -0,0 +1,23 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from typing_extensions import Literal, Required, Annotated, TypedDict
+
+from .._types import Base64FileInput
+from .._utils import PropertyInfo
+from .._models import set_pydantic_config
+
+__all__ = ["Base64ImageSourceParam"]
+
+
+class Base64ImageSourceParam(TypedDict, total=False):
+    data: Required[Annotated[Union[str, Base64FileInput], PropertyInfo(format="base64")]]
+
+    media_type: Required[Literal["image/jpeg", "image/png", "image/gif", "image/webp"]]
+
+    type: Required[Literal["base64"]]
+
+
+set_pydantic_config(Base64ImageSourceParam, {"arbitrary_types_allowed": True})

src/anthropic/types/beta/__init__.py

@@ -30,6 +30,7 @@
 from .beta_message_tokens_count import BetaMessageTokensCount as BetaMessageTokensCount
 from .beta_thinking_block_param import BetaThinkingBlockParam as BetaThinkingBlockParam
 from .beta_tool_use_block_param import BetaToolUseBlockParam as BetaToolUseBlockParam
+from .beta_url_pdf_source_param import BetaURLPDFSourceParam as BetaURLPDFSourceParam
 from .beta_thinking_config_param import BetaThinkingConfigParam as BetaThinkingConfigParam
 from .beta_tool_choice_any_param import BetaToolChoiceAnyParam as BetaToolChoiceAnyParam
 from .beta_base64_pdf_block_param import BetaBase64PDFBlockParam as BetaBase64PDFBlockParam
@@ -39,6 +40,7 @@
 from .beta_raw_message_stop_event import BetaRawMessageStopEvent as BetaRawMessageStopEvent
 from .beta_tool_choice_auto_param import BetaToolChoiceAutoParam as BetaToolChoiceAutoParam
 from .beta_tool_choice_tool_param import BetaToolChoiceToolParam as BetaToolChoiceToolParam
+from .beta_url_image_source_param import BetaURLImageSourceParam as BetaURLImageSourceParam
 from .message_count_tokens_params import MessageCountTokensParams as MessageCountTokensParams
 from .beta_base64_pdf_source_param import BetaBase64PDFSourceParam as BetaBase64PDFSourceParam
 from .beta_plain_text_source_param import BetaPlainTextSourceParam as BetaPlainTextSourceParam
@@ -49,6 +51,7 @@
 from .beta_raw_message_stream_event import BetaRawMessageStreamEvent as BetaRawMessageStreamEvent
 from .beta_tool_bash_20241022_param import BetaToolBash20241022Param as BetaToolBash20241022Param
 from .beta_tool_bash_20250124_param import BetaToolBash20250124Param as BetaToolBash20250124Param
+from .beta_base64_image_source_param import BetaBase64ImageSourceParam as BetaBase64ImageSourceParam
 from .beta_content_block_source_param import BetaContentBlockSourceParam as BetaContentBlockSourceParam
 from .beta_citation_char_location_param import BetaCitationCharLocationParam as BetaCitationCharLocationParam
 from .beta_citation_page_location_param import BetaCitationPageLocationParam as BetaCitationPageLocationParam

src/anthropic/types/beta/beta_base64_image_source_param.py

@@ -0,0 +1,23 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from typing_extensions import Literal, Required, Annotated, TypedDict
+
+from ..._types import Base64FileInput
+from ..._utils import PropertyInfo
+from ..._models import set_pydantic_config
+
+__all__ = ["BetaBase64ImageSourceParam"]
+
+
+class BetaBase64ImageSourceParam(TypedDict, total=False):
+    data: Required[Annotated[Union[str, Base64FileInput], PropertyInfo(format="base64")]]
+
+    media_type: Required[Literal["image/jpeg", "image/png", "image/gif", "image/webp"]]
+
+    type: Required[Literal["base64"]]
+
+
+set_pydantic_config(BetaBase64ImageSourceParam, {"arbitrary_types_allowed": True})

src/anthropic/types/beta/beta_base64_pdf_block_param.py

@@ -5,6 +5,7 @@
 from typing import Union, Optional
 from typing_extensions import Literal, Required, TypeAlias, TypedDict
 
+from .beta_url_pdf_source_param import BetaURLPDFSourceParam
 from .beta_citations_config_param import BetaCitationsConfigParam
 from .beta_base64_pdf_source_param import BetaBase64PDFSourceParam
 from .beta_plain_text_source_param import BetaPlainTextSourceParam
@@ -13,7 +14,9 @@
 
 __all__ = ["BetaBase64PDFBlockParam", "Source"]
 
-Source: TypeAlias = Union[BetaBase64PDFSourceParam, BetaPlainTextSourceParam, BetaContentBlockSourceParam]
+Source: TypeAlias = Union[
+    BetaBase64PDFSourceParam, BetaPlainTextSourceParam, BetaContentBlockSourceParam, BetaURLPDFSourceParam
+]
 
 
 class BetaBase64PDFBlockParam(TypedDict, total=False):

src/anthropic/types/beta/beta_image_block_param.py

@@ -3,25 +3,15 @@
 from __future__ import annotations
 
 from typing import Union, Optional
-from typing_extensions import Literal, Required, Annotated, TypedDict
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
 
-from ..._types import Base64FileInput
-from ..._utils import PropertyInfo
-from ..._models import set_pydantic_config
+from .beta_url_image_source_param import BetaURLImageSourceParam
+from .beta_base64_image_source_param import BetaBase64ImageSourceParam
 from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
 
 __all__ = ["BetaImageBlockParam", "Source"]
 
-
-class Source(TypedDict, total=False):
-    data: Required[Annotated[Union[str, Base64FileInput], PropertyInfo(format="base64")]]
-
-    media_type: Required[Literal["image/jpeg", "image/png", "image/gif", "image/webp"]]
-
-    type: Required[Literal["base64"]]
-
-
-set_pydantic_config(Source, {"arbitrary_types_allowed": True})
+Source: TypeAlias = Union[BetaBase64ImageSourceParam, BetaURLImageSourceParam]
 
 
 class BetaImageBlockParam(TypedDict, total=False):

src/anthropic/types/beta/beta_tool_union_param.py

@@ -16,11 +16,11 @@
 __all__ = ["BetaToolUnionParam"]
 
 BetaToolUnionParam: TypeAlias = Union[
+    BetaToolParam,
     BetaToolComputerUse20241022Param,
     BetaToolBash20241022Param,
     BetaToolTextEditor20241022Param,
     BetaToolComputerUse20250124Param,
     BetaToolBash20250124Param,
     BetaToolTextEditor20250124Param,
-    BetaToolParam,
 ]

src/anthropic/types/beta/beta_url_image_source_param.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["BetaURLImageSourceParam"]
+
+
+class BetaURLImageSourceParam(TypedDict, total=False):
+    type: Required[Literal["url"]]
+
+    url: Required[str]