feat(api): adding support for agent skills

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 26
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-c91c0b5257f197335770ca7195d6b56e5808bf90d40580ca833095dfe56d2954.yml
-openapi_spec_hash: 592d90505082223899e0638ad56ba162
-config_hash: 24ad78f46908cfe5b81c053facaf4194
+configured_endpoints: 34
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-284ade6201f97a13e95e2a4e38deefa8cb3d53c45fae1022c5a01520e76338be.yml
+openapi_spec_hash: 327b1deb1eba170331a3ac42eabedfbe
+config_hash: 291fe920e1e3b71db2e92ced81e1b859

api.md

@@ -243,6 +243,7 @@ from anthropic.types.beta import (
     BetaCodeExecutionToolResultErrorCode,
     BetaCodeExecutionToolResultErrorParam,
     BetaContainer,
+    BetaContainerParams,
     BetaContainerUploadBlock,
     BetaContainerUploadBlockParam,
     BetaContentBlock,
@@ -295,6 +296,8 @@ from anthropic.types.beta import (
     BetaServerToolUseBlock,
     BetaServerToolUseBlockParam,
     BetaSignatureDelta,
+    BetaSkill,
+    BetaSkillParams,
     BetaStopReason,
     BetaTextBlock,
     BetaTextBlockParam,
@@ -409,3 +412,43 @@ Methods:
 - <code title="get /v1/files/{file_id}/content?beta=true">client.beta.files.<a href="./src/anthropic/resources/beta/files.py">download</a>(file_id) -> BinaryAPIResponse</code>
 - <code title="get /v1/files/{file_id}?beta=true">client.beta.files.<a href="./src/anthropic/resources/beta/files.py">retrieve_metadata</a>(file_id) -> <a href="./src/anthropic/types/beta/file_metadata.py">FileMetadata</a></code>
 - <code title="post /v1/files?beta=true">client.beta.files.<a href="./src/anthropic/resources/beta/files.py">upload</a>(\*\*<a href="src/anthropic/types/beta/file_upload_params.py">params</a>) -> <a href="./src/anthropic/types/beta/file_metadata.py">FileMetadata</a></code>
+
+## Skills
+
+Types:
+
+```python
+from anthropic.types.beta import (
+    SkillCreateResponse,
+    SkillRetrieveResponse,
+    SkillListResponse,
+    SkillDeleteResponse,
+)
+```
+
+Methods:
+
+- <code title="post /v1/skills?beta=true">client.beta.skills.<a href="./src/anthropic/resources/beta/skills/skills.py">create</a>(\*\*<a href="src/anthropic/types/beta/skill_create_params.py">params</a>) -> <a href="./src/anthropic/types/beta/skill_create_response.py">SkillCreateResponse</a></code>
+- <code title="get /v1/skills/{skill_id}?beta=true">client.beta.skills.<a href="./src/anthropic/resources/beta/skills/skills.py">retrieve</a>(skill_id) -> <a href="./src/anthropic/types/beta/skill_retrieve_response.py">SkillRetrieveResponse</a></code>
+- <code title="get /v1/skills?beta=true">client.beta.skills.<a href="./src/anthropic/resources/beta/skills/skills.py">list</a>(\*\*<a href="src/anthropic/types/beta/skill_list_params.py">params</a>) -> <a href="./src/anthropic/types/beta/skill_list_response.py">SyncPageCursor[SkillListResponse]</a></code>
+- <code title="delete /v1/skills/{skill_id}?beta=true">client.beta.skills.<a href="./src/anthropic/resources/beta/skills/skills.py">delete</a>(skill_id) -> <a href="./src/anthropic/types/beta/skill_delete_response.py">SkillDeleteResponse</a></code>
+
+### Versions
+
+Types:
+
+```python
+from anthropic.types.beta.skills import (
+    VersionCreateResponse,
+    VersionRetrieveResponse,
+    VersionListResponse,
+    VersionDeleteResponse,
+)
+```
+
+Methods:
+
+- <code title="post /v1/skills/{skill_id}/versions?beta=true">client.beta.skills.versions.<a href="./src/anthropic/resources/beta/skills/versions.py">create</a>(skill_id, \*\*<a href="src/anthropic/types/beta/skills/version_create_params.py">params</a>) -> <a href="./src/anthropic/types/beta/skills/version_create_response.py">VersionCreateResponse</a></code>
+- <code title="get /v1/skills/{skill_id}/versions/{version}?beta=true">client.beta.skills.versions.<a href="./src/anthropic/resources/beta/skills/versions.py">retrieve</a>(version, \*, skill_id) -> <a href="./src/anthropic/types/beta/skills/version_retrieve_response.py">VersionRetrieveResponse</a></code>
+- <code title="get /v1/skills/{skill_id}/versions?beta=true">client.beta.skills.versions.<a href="./src/anthropic/resources/beta/skills/versions.py">list</a>(skill_id, \*\*<a href="src/anthropic/types/beta/skills/version_list_params.py">params</a>) -> <a href="./src/anthropic/types/beta/skills/version_list_response.py">SyncPageCursor[VersionListResponse]</a></code>
+- <code title="delete /v1/skills/{skill_id}/versions/{version}?beta=true">client.beta.skills.versions.<a href="./src/anthropic/resources/beta/skills/versions.py">delete</a>(version, \*, skill_id) -> <a href="./src/anthropic/types/beta/skills/version_delete_response.py">VersionDeleteResponse</a></code>

src/anthropic/lib/__init__.py

@@ -0,0 +1 @@
+from ._files import files_from_dir as files_from_dir, async_files_from_dir as async_files_from_dir

src/anthropic/lib/_files.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+import anyio
+
+from .._types import FileTypes
+
+
+def files_from_dir(directory: str | os.PathLike[str]) -> list[FileTypes]:
+    path = Path(directory)
+
+    files: list[FileTypes] = []
+    _collect_files(path, path.parent, files)
+    return files
+
+
+def _collect_files(directory: Path, relative_to: Path, files: list[FileTypes]) -> None:
+    for path in directory.iterdir():
+        if path.is_dir():
+            _collect_files(path, relative_to, files)
+            continue
+
+        files.append((str(path.relative_to(relative_to)), path.read_bytes()))
+
+
+async def async_files_from_dir(directory: str | os.PathLike[str]) -> list[FileTypes]:
+    path = anyio.Path(directory)
+
+    files: list[FileTypes] = []
+    await _async_collect_files(path, path.parent, files)
+    return files
+
+
+async def _async_collect_files(directory: anyio.Path, relative_to: anyio.Path, files: list[FileTypes]) -> None:
+    async for path in directory.iterdir():
+        if await path.is_dir():
+            await _async_collect_files(path, relative_to, files)
+            continue
+
+        files.append((str(path.relative_to(relative_to)), await path.read_bytes()))

src/anthropic/pagination.py

@@ -5,7 +5,7 @@
 
 from ._base_client import BasePage, PageInfo, BaseSyncPage, BaseAsyncPage
 
-__all__ = ["SyncPage", "AsyncPage"]
+__all__ = ["SyncPage", "AsyncPage", "SyncTokenPage", "AsyncTokenPage", "SyncPageCursor", "AsyncPageCursor"]
 
 _T = TypeVar("_T")
 
@@ -82,3 +82,119 @@ def next_page_info(self) -> Optional[PageInfo]:
             return None
 
         return PageInfo(params={"after_id": last_id})
+
+
+class SyncTokenPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
+    data: List[_T]
+    has_more: Optional[bool] = None
+    next_page: Optional[str] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        data = self.data
+        if not data:
+            return []
+        return data
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        next_page = self.next_page
+        if not next_page:
+            return None
+
+        return PageInfo(params={"page_token": next_page})
+
+
+class AsyncTokenPage(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
+    data: List[_T]
+    has_more: Optional[bool] = None
+    next_page: Optional[str] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        data = self.data
+        if not data:
+            return []
+        return data
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        next_page = self.next_page
+        if not next_page:
+            return None
+
+        return PageInfo(params={"page_token": next_page})
+
+
+class SyncPageCursor(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
+    data: List[_T]
+    has_more: Optional[bool] = None
+    next_page: Optional[str] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        data = self.data
+        if not data:
+            return []
+        return data
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        next_page = self.next_page
+        if not next_page:
+            return None
+
+        return PageInfo(params={"page": next_page})
+
+
+class AsyncPageCursor(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
+    data: List[_T]
+    has_more: Optional[bool] = None
+    next_page: Optional[str] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        data = self.data
+        if not data:
+            return []
+        return data
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        next_page = self.next_page
+        if not next_page:
+            return None
+
+        return PageInfo(params={"page": next_page})

src/anthropic/resources/beta/__init__.py

@@ -24,6 +24,14 @@
     ModelsWithStreamingResponse,
     AsyncModelsWithStreamingResponse,
 )
+from .skills import (
+    Skills,
+    AsyncSkills,
+    SkillsWithRawResponse,
+    AsyncSkillsWithRawResponse,
+    SkillsWithStreamingResponse,
+    AsyncSkillsWithStreamingResponse,
+)
 from .messages import (
     Messages,
     AsyncMessages,
@@ -52,6 +60,12 @@
     "AsyncFilesWithRawResponse",
     "FilesWithStreamingResponse",
     "AsyncFilesWithStreamingResponse",
+    "Skills",
+    "AsyncSkills",
+    "SkillsWithRawResponse",
+    "AsyncSkillsWithRawResponse",
+    "SkillsWithStreamingResponse",
+    "AsyncSkillsWithStreamingResponse",
     "Beta",
     "AsyncBeta",
     "BetaWithRawResponse",

src/anthropic/resources/beta/beta.py

@@ -20,6 +20,14 @@
 )
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
+from .skills.skills import (
+    Skills,
+    AsyncSkills,
+    SkillsWithRawResponse,
+    AsyncSkillsWithRawResponse,
+    SkillsWithStreamingResponse,
+    AsyncSkillsWithStreamingResponse,
+)
 from .messages.messages import (
     Messages,
     AsyncMessages,
@@ -45,6 +53,10 @@ def messages(self) -> Messages:
     def files(self) -> Files:
         return Files(self._client)
 
+    @cached_property
+    def skills(self) -> Skills:
+        return Skills(self._client)
+
     @cached_property
     def with_raw_response(self) -> BetaWithRawResponse:
         """
@@ -78,6 +90,10 @@ def messages(self) -> AsyncMessages:
     def files(self) -> AsyncFiles:
         return AsyncFiles(self._client)
 
+    @cached_property
+    def skills(self) -> AsyncSkills:
+        return AsyncSkills(self._client)
+
     @cached_property
     def with_raw_response(self) -> AsyncBetaWithRawResponse:
         """
@@ -114,6 +130,10 @@ def messages(self) -> MessagesWithRawResponse:
     def files(self) -> FilesWithRawResponse:
         return FilesWithRawResponse(self._beta.files)
 
+    @cached_property
+    def skills(self) -> SkillsWithRawResponse:
+        return SkillsWithRawResponse(self._beta.skills)
+
 
 class AsyncBetaWithRawResponse:
     def __init__(self, beta: AsyncBeta) -> None:
@@ -131,6 +151,10 @@ def messages(self) -> AsyncMessagesWithRawResponse:
     def files(self) -> AsyncFilesWithRawResponse:
         return AsyncFilesWithRawResponse(self._beta.files)
 
+    @cached_property
+    def skills(self) -> AsyncSkillsWithRawResponse:
+        return AsyncSkillsWithRawResponse(self._beta.skills)
+
 
 class BetaWithStreamingResponse:
     def __init__(self, beta: Beta) -> None:
@@ -148,6 +172,10 @@ def messages(self) -> MessagesWithStreamingResponse:
     def files(self) -> FilesWithStreamingResponse:
         return FilesWithStreamingResponse(self._beta.files)
 
+    @cached_property
+    def skills(self) -> SkillsWithStreamingResponse:
+        return SkillsWithStreamingResponse(self._beta.skills)
+
 
 class AsyncBetaWithStreamingResponse:
     def __init__(self, beta: AsyncBeta) -> None:
@@ -164,3 +192,7 @@ def messages(self) -> AsyncMessagesWithStreamingResponse:
     @cached_property
     def files(self) -> AsyncFilesWithStreamingResponse:
         return AsyncFilesWithStreamingResponse(self._beta.files)
+
+    @cached_property
+    def skills(self) -> AsyncSkillsWithStreamingResponse:
+        return AsyncSkillsWithStreamingResponse(self._beta.skills)