anthropic 0.69.0__py3-none-any.whl → 0.71.0__py3-none-any.whl

anthropic/types/beta/beta_container.py

@@ -1,8 +1,10 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from typing import List, Optional
 from datetime import datetime
 
 from ..._models import BaseModel
+from .beta_skill import BetaSkill
 
 __all__ = ["BetaContainer"]
 
@@ -13,3 +15,6 @@ class BetaContainer(BaseModel):
 
     expires_at: datetime
     """The time at which the container will expire."""
+
+    skills: Optional[List[BetaSkill]] = None
+    """Skills loaded in the container"""

anthropic/types/beta/beta_container_params.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable, Optional
+from typing_extensions import TypedDict
+
+from .beta_skill_params import BetaSkillParams
+
+__all__ = ["BetaContainerParams"]
+
+
+class BetaContainerParams(TypedDict, total=False):
+    id: Optional[str]
+    """Container id"""
+
+    skills: Optional[Iterable[BetaSkillParams]]
+    """List of skills to load in the container"""

anthropic/types/beta/beta_message.py

@@ -63,7 +63,10 @@ class BetaMessage(BaseModel):
     """
 
     context_management: Optional[BetaContextManagementResponse] = None
-    """Information about context management operations applied during the request."""
+    """Context management response.
+
+    Information about context management strategies applied during the request.
+    """
 
     model: Model
     """

anthropic/types/beta/beta_raw_message_delta_event.py

@@ -26,7 +26,7 @@ class Delta(BaseModel):
 
 class BetaRawMessageDeltaEvent(BaseModel):
     context_management: Optional[BetaContextManagementResponse] = None
-    """Information about context management operations applied during the request."""
+    """Information about context management strategies applied during the request"""
 
     delta: Delta
 

anthropic/types/beta/beta_skill.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["BetaSkill"]
+
+
+class BetaSkill(BaseModel):
+    skill_id: str
+    """Skill ID"""
+
+    type: Literal["anthropic", "custom"]
+    """Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)"""
+
+    version: str
+    """Skill version or 'latest' for most recent version"""

anthropic/types/beta/beta_skill_params.py

@@ -0,0 +1,18 @@
+# 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__ = ["BetaSkillParams"]
+
+
+class BetaSkillParams(TypedDict, total=False):
+    skill_id: Required[str]
+    """Skill ID"""
+
+    type: Required[Literal["anthropic", "custom"]]
+    """Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)"""
+
+    version: str
+    """Skill version or 'latest' for most recent version"""

anthropic/types/beta/beta_thinking_config_enabled_param.py

@@ -17,7 +17,7 @@ class BetaThinkingConfigEnabledParam(TypedDict, total=False):
     Must be ≥1024 and less than `max_tokens`.
 
     See
-    [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+    [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
     for details.
     """
 

anthropic/types/beta/message_count_tokens_params.py

@@ -91,12 +91,12 @@ class MessageCountTokensParams(TypedDict, total=False):
     { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
     ```
 
-    See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+    See [input examples](https://docs.claude.com/en/api/messages-examples).
 
     Note that if you want to include a
-    [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-    the top-level `system` parameter — there is no `"system"` role for input
-    messages in the Messages API.
+    [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+    top-level `system` parameter — there is no `"system"` role for input messages in
+    the Messages API.
 
     There is a limit of 100,000 messages in a single request.
     """
@@ -109,7 +109,11 @@ class MessageCountTokensParams(TypedDict, total=False):
     """
 
     context_management: Optional[BetaContextManagementConfigParam]
-    """Configuration for context management operations."""
+    """Context management configuration.
+
+    This allows you to control how Claude manages context across multiple requests,
+    such as whether to clear function results or not.
+    """
 
     mcp_servers: Iterable[BetaRequestMCPServerURLDefinitionParam]
     """MCP servers to be utilized in this request"""
@@ -119,7 +123,7 @@ class MessageCountTokensParams(TypedDict, total=False):
 
     A system prompt is a way of providing context and instructions to Claude, such
     as specifying a particular goal or role. See our
-    [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+    [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
     """
 
     thinking: BetaThinkingConfigParam
@@ -130,7 +134,7 @@ class MessageCountTokensParams(TypedDict, total=False):
     tokens and counts towards your `max_tokens` limit.
 
     See
-    [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+    [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
     for details.
     """
 
@@ -151,9 +155,9 @@ class MessageCountTokensParams(TypedDict, total=False):
 
     There are two types of tools: **client tools** and **server tools**. The
     behavior described below applies to client tools. For
-    [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+    [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
     see their individual documentation as each has its own behavior (e.g., the
-    [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+    [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
 
     Each tool definition includes:
 
@@ -216,7 +220,7 @@ class MessageCountTokensParams(TypedDict, total=False):
     functions, or more generally whenever you want the model to produce a particular
     JSON structure of output.
 
-    See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+    See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
     """
 
     betas: Annotated[List[AnthropicBetaParam], PropertyInfo(alias="anthropic-beta")]

anthropic/types/beta/message_create_params.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import List, Union, Iterable, Optional
-from typing_extensions import Literal, Required, Annotated, TypedDict
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
 from ..._types import SequenceNotStr
 from ..._utils import PropertyInfo
@@ -11,6 +11,7 @@ from ..model_param import ModelParam
 from .beta_message_param import BetaMessageParam
 from .beta_metadata_param import BetaMetadataParam
 from ..anthropic_beta_param import AnthropicBetaParam
+from .beta_container_params import BetaContainerParams
 from .beta_text_block_param import BetaTextBlockParam
 from .beta_tool_union_param import BetaToolUnionParam
 from .beta_tool_choice_param import BetaToolChoiceParam
@@ -18,7 +19,7 @@ from .beta_thinking_config_param import BetaThinkingConfigParam
 from .beta_context_management_config_param import BetaContextManagementConfigParam
 from .beta_request_mcp_server_url_definition_param import BetaRequestMCPServerURLDefinitionParam
 
-__all__ = ["MessageCreateParamsBase", "MessageCreateParamsNonStreaming", "MessageCreateParamsStreaming"]
+__all__ = ["MessageCreateParamsBase", "Container", "MessageCreateParamsNonStreaming", "MessageCreateParamsStreaming"]
 
 
 class MessageCreateParamsBase(TypedDict, total=False):
@@ -29,7 +30,7 @@ class MessageCreateParamsBase(TypedDict, total=False):
     only specifies the absolute maximum number of tokens to generate.
 
     Different models have different maximum values for this parameter. See
-    [models](https://docs.anthropic.com/en/docs/models-overview) for details.
+    [models](https://docs.claude.com/en/docs/models-overview) for details.
     """
 
     messages: Required[Iterable[BetaMessageParam]]
@@ -90,12 +91,12 @@ class MessageCreateParamsBase(TypedDict, total=False):
     { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
     ```
 
-    See [input examples](https://docs.anthropic.com/en/api/messages-examples).
+    See [input examples](https://docs.claude.com/en/api/messages-examples).
 
     Note that if you want to include a
-    [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
-    the top-level `system` parameter — there is no `"system"` role for input
-    messages in the Messages API.
+    [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+    top-level `system` parameter — there is no `"system"` role for input messages in
+    the Messages API.
 
     There is a limit of 100,000 messages in a single request.
     """
@@ -107,11 +108,15 @@ class MessageCreateParamsBase(TypedDict, total=False):
     details and options.
     """
 
-    container: Optional[str]
+    container: Optional[Container]
     """Container identifier for reuse across requests."""
 
     context_management: Optional[BetaContextManagementConfigParam]
-    """Configuration for context management operations."""
+    """Context management configuration.
+
+    This allows you to control how Claude manages context across multiple requests,
+    such as whether to clear function results or not.
+    """
 
     mcp_servers: Iterable[BetaRequestMCPServerURLDefinitionParam]
     """MCP servers to be utilized in this request"""
@@ -125,7 +130,7 @@ class MessageCreateParamsBase(TypedDict, total=False):
     for this request.
 
     Anthropic offers different levels of service for your API requests. See
-    [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
+    [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
     """
 
     stop_sequences: SequenceNotStr[str]
@@ -145,7 +150,7 @@ class MessageCreateParamsBase(TypedDict, total=False):
 
     A system prompt is a way of providing context and instructions to Claude, such
     as specifying a particular goal or role. See our
-    [guide to system prompts](https://docs.anthropic.com/en/docs/system-prompts).
+    [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
     """
 
     temperature: float
@@ -167,7 +172,7 @@ class MessageCreateParamsBase(TypedDict, total=False):
     tokens and counts towards your `max_tokens` limit.
 
     See
-    [extended thinking](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+    [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
     for details.
     """
 
@@ -188,9 +193,9 @@ class MessageCreateParamsBase(TypedDict, total=False):
 
     There are two types of tools: **client tools** and **server tools**. The
     behavior described below applies to client tools. For
-    [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+    [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
     see their individual documentation as each has its own behavior (e.g., the
-    [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+    [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
 
     Each tool definition includes:
 
@@ -253,7 +258,7 @@ class MessageCreateParamsBase(TypedDict, total=False):
     functions, or more generally whenever you want the model to produce a particular
     JSON structure of output.
 
-    See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
+    See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
     """
 
     top_k: int
@@ -282,12 +287,14 @@ class MessageCreateParamsBase(TypedDict, total=False):
     """Optional header to specify the beta version(s) you want to use."""
 
 
+Container: TypeAlias = Union[BetaContainerParams, str]
+
+
 class MessageCreateParamsNonStreaming(MessageCreateParamsBase, total=False):
     stream: Literal[False]
     """Whether to incrementally stream the response using server-sent events.
 
-    See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-    details.
+    See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
     """
 
 
@@ -295,8 +302,7 @@ class MessageCreateParamsStreaming(MessageCreateParamsBase):
     stream: Required[Literal[True]]
     """Whether to incrementally stream the response using server-sent events.
 
-    See [streaming](https://docs.anthropic.com/en/api/messages-streaming) for
-    details.
+    See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
     """
 
 

anthropic/types/beta/messages/batch_create_params.py

@@ -23,6 +23,7 @@ class BatchCreateParams(TypedDict, total=False):
     """Optional header to specify the beta version(s) you want to use."""
 
 
+
 class Request(TypedDict, total=False):
     custom_id: Required[str]
     """Developer-provided ID created for each request in a Message Batch.

anthropic/types/beta/skill_create_params.py

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Optional
+from typing_extensions import Annotated, TypedDict
+
+from ..._types import FileTypes, SequenceNotStr
+from ..._utils import PropertyInfo
+from ..anthropic_beta_param import AnthropicBetaParam
+
+__all__ = ["SkillCreateParams"]
+
+
+class SkillCreateParams(TypedDict, total=False):
+    display_title: Optional[str]
+    """Display title for the skill.
+
+    This is a human-readable label that is not included in the prompt sent to the
+    model.
+    """
+
+    files: Optional[SequenceNotStr[FileTypes]]
+    """Files to upload for the skill.
+
+    All files must be in the same top-level directory and must include a SKILL.md
+    file at the root of that directory.
+    """
+
+    betas: Annotated[List[AnthropicBetaParam], PropertyInfo(alias="anthropic-beta")]
+    """Optional header to specify the beta version(s) you want to use."""

anthropic/types/beta/skill_create_response.py

@@ -0,0 +1,49 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["SkillCreateResponse"]
+
+
+class SkillCreateResponse(BaseModel):
+    id: str
+    """Unique identifier for the skill.
+
+    The format and length of IDs may change over time.
+    """
+
+    created_at: str
+    """ISO 8601 timestamp of when the skill was created."""
+
+    display_title: Optional[str] = None
+    """Display title for the skill.
+
+    This is a human-readable label that is not included in the prompt sent to the
+    model.
+    """
+
+    latest_version: Optional[str] = None
+    """The latest version identifier for the skill.
+
+    This represents the most recent version of the skill that has been created.
+    """
+
+    source: str
+    """Source of the skill.
+
+    This may be one of the following values:
+
+    - `"custom"`: the skill was created by a user
+    - `"anthropic"`: the skill was created by Anthropic
+    """
+
+    type: str
+    """Object type.
+
+    For Skills, this is always `"skill"`.
+    """
+
+    updated_at: str
+    """ISO 8601 timestamp of when the skill was last updated."""

anthropic/types/beta/skill_delete_response.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ..._models import BaseModel
+
+__all__ = ["SkillDeleteResponse"]
+
+
+class SkillDeleteResponse(BaseModel):
+    id: str
+    """Unique identifier for the skill.
+
+    The format and length of IDs may change over time.
+    """
+
+    type: str
+    """Deleted object type.
+
+    For Skills, this is always `"skill_deleted"`.
+    """

anthropic/types/beta/skill_list_params.py

@@ -0,0 +1,38 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Optional
+from typing_extensions import Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+from ..anthropic_beta_param import AnthropicBetaParam
+
+__all__ = ["SkillListParams"]
+
+
+class SkillListParams(TypedDict, total=False):
+    limit: int
+    """Number of results to return per page.
+
+    Maximum value is 100. Defaults to 20.
+    """
+
+    page: Optional[str]
+    """Pagination token for fetching a specific page of results.
+
+    Pass the value from a previous response's `next_page` field to get the next page
+    of results.
+    """
+
+    source: Optional[str]
+    """Filter skills by source.
+
+    If provided, only skills from the specified source will be returned:
+
+    - `"custom"`: only return user-created skills
+    - `"anthropic"`: only return Anthropic-created skills
+    """
+
+    betas: Annotated[List[AnthropicBetaParam], PropertyInfo(alias="anthropic-beta")]
+    """Optional header to specify the beta version(s) you want to use."""

anthropic/types/beta/skill_list_response.py

@@ -0,0 +1,49 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["SkillListResponse"]
+
+
+class SkillListResponse(BaseModel):
+    id: str
+    """Unique identifier for the skill.
+
+    The format and length of IDs may change over time.
+    """
+
+    created_at: str
+    """ISO 8601 timestamp of when the skill was created."""
+
+    display_title: Optional[str] = None
+    """Display title for the skill.
+
+    This is a human-readable label that is not included in the prompt sent to the
+    model.
+    """
+
+    latest_version: Optional[str] = None
+    """The latest version identifier for the skill.
+
+    This represents the most recent version of the skill that has been created.
+    """
+
+    source: str
+    """Source of the skill.
+
+    This may be one of the following values:
+
+    - `"custom"`: the skill was created by a user
+    - `"anthropic"`: the skill was created by Anthropic
+    """
+
+    type: str
+    """Object type.
+
+    For Skills, this is always `"skill"`.
+    """
+
+    updated_at: str
+    """ISO 8601 timestamp of when the skill was last updated."""

anthropic/types/beta/skill_retrieve_response.py

@@ -0,0 +1,49 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["SkillRetrieveResponse"]
+
+
+class SkillRetrieveResponse(BaseModel):
+    id: str
+    """Unique identifier for the skill.
+
+    The format and length of IDs may change over time.
+    """
+
+    created_at: str
+    """ISO 8601 timestamp of when the skill was created."""
+
+    display_title: Optional[str] = None
+    """Display title for the skill.
+
+    This is a human-readable label that is not included in the prompt sent to the
+    model.
+    """
+
+    latest_version: Optional[str] = None
+    """The latest version identifier for the skill.
+
+    This represents the most recent version of the skill that has been created.
+    """
+
+    source: str
+    """Source of the skill.
+
+    This may be one of the following values:
+
+    - `"custom"`: the skill was created by a user
+    - `"anthropic"`: the skill was created by Anthropic
+    """
+
+    type: str
+    """Object type.
+
+    For Skills, this is always `"skill"`.
+    """
+
+    updated_at: str
+    """ISO 8601 timestamp of when the skill was last updated."""

anthropic/types/beta/skills/__init__.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .version_list_params import VersionListParams as VersionListParams
+from .version_create_params import VersionCreateParams as VersionCreateParams
+from .version_list_response import VersionListResponse as VersionListResponse
+from .version_create_response import VersionCreateResponse as VersionCreateResponse
+from .version_delete_response import VersionDeleteResponse as VersionDeleteResponse
+from .version_retrieve_response import VersionRetrieveResponse as VersionRetrieveResponse

anthropic/types/beta/skills/version_create_params.py

@@ -0,0 +1,24 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Optional
+from typing_extensions import Annotated, TypedDict
+
+from ...._types import FileTypes, SequenceNotStr
+from ...._utils import PropertyInfo
+from ...anthropic_beta_param import AnthropicBetaParam
+
+__all__ = ["VersionCreateParams"]
+
+
+class VersionCreateParams(TypedDict, total=False):
+    files: Optional[SequenceNotStr[FileTypes]]
+    """Files to upload for the skill.
+
+    All files must be in the same top-level directory and must include a SKILL.md
+    file at the root of that directory.
+    """
+
+    betas: Annotated[List[AnthropicBetaParam], PropertyInfo(alias="anthropic-beta")]
+    """Optional header to specify the beta version(s) you want to use."""

anthropic/types/beta/skills/version_create_response.py

@@ -0,0 +1,49 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ...._models import BaseModel
+
+__all__ = ["VersionCreateResponse"]
+
+
+class VersionCreateResponse(BaseModel):
+    id: str
+    """Unique identifier for the skill version.
+
+    The format and length of IDs may change over time.
+    """
+
+    created_at: str
+    """ISO 8601 timestamp of when the skill version was created."""
+
+    description: str
+    """Description of the skill version.
+
+    This is extracted from the SKILL.md file in the skill upload.
+    """
+
+    directory: str
+    """Directory name of the skill version.
+
+    This is the top-level directory name that was extracted from the uploaded files.
+    """
+
+    name: str
+    """Human-readable name of the skill version.
+
+    This is extracted from the SKILL.md file in the skill upload.
+    """
+
+    skill_id: str
+    """Identifier for the skill that this version belongs to."""
+
+    type: str
+    """Object type.
+
+    For Skill Versions, this is always `"skill_version"`.
+    """
+
+    version: str
+    """Version identifier for the skill.
+
+    Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
+    """