feat(api): skills and hosted shell

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 137
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-bff810f46da56eff8d5e189b0d1f56ac07a8289723666138549d4239cad7c2ea.yml
-openapi_spec_hash: 7532ce5a6f490c8f5d1e079c76c70535
-config_hash: a1454ffd9612dee11f9d5a98e55eac9e
+configured_endpoints: 148
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-7debfce2217c66ea87bfddaa244b57de4062dd7fd766fa9a28e869614205c040.yml
+openapi_spec_hash: e910fc478b8449134e2af1dc15fd33f7
+config_hash: 8dca0f2dc2706c07cf2f8d0ed4dc062e

api.md

@@ -736,11 +736,20 @@ from openai.types.responses import (
     ApplyPatchTool,
     CompactedResponse,
     ComputerTool,
+    ContainerAuto,
+    ContainerNetworkPolicyAllowlist,
+    ContainerNetworkPolicyDisabled,
+    ContainerNetworkPolicyDomainSecret,
+    ContainerReference,
     CustomTool,
     EasyInputMessage,
     FileSearchTool,
     FunctionShellTool,
     FunctionTool,
+    InlineSkill,
+    InlineSkillSource,
+    LocalEnvironment,
+    LocalSkill,
     Response,
     ResponseApplyPatchToolCall,
     ResponseApplyPatchToolCallOutput,
@@ -760,6 +769,7 @@ from openai.types.responses import (
     ResponseComputerToolCall,
     ResponseComputerToolCallOutputItem,
     ResponseComputerToolCallOutputScreenshot,
+    ResponseContainerReference,
     ResponseContent,
     ResponseContentPartAddedEvent,
     ResponseContentPartDoneEvent,
@@ -809,6 +819,7 @@ from openai.types.responses import (
     ResponseInputText,
     ResponseInputTextContent,
     ResponseItem,
+    ResponseLocalEnvironment,
     ResponseMcpCallArgumentsDeltaEvent,
     ResponseMcpCallArgumentsDoneEvent,
     ResponseMcpCallCompletedEvent,
@@ -845,6 +856,7 @@ from openai.types.responses import (
     ResponseWebSearchCallCompletedEvent,
     ResponseWebSearchCallInProgressEvent,
     ResponseWebSearchCallSearchingEvent,
+    SkillReference,
     Tool,
     ToolChoiceAllowed,
     ToolChoiceApplyPatch,
@@ -1170,6 +1182,49 @@ Methods:
 
 - <code title="get /containers/{container_id}/files/{file_id}/content">client.containers.files.content.<a href="./src/openai/resources/containers/files/content.py">retrieve</a>(file_id, \*, container_id) -> HttpxBinaryResponseContent</code>
 
+# Skills
+
+Types:
+
+```python
+from openai.types import DeletedSkill, Skill, SkillList
+```
+
+Methods:
+
+- <code title="post /skills">client.skills.<a href="./src/openai/resources/skills/skills.py">create</a>(\*\*<a href="src/openai/types/skill_create_params.py">params</a>) -> <a href="./src/openai/types/skill.py">Skill</a></code>
+- <code title="get /skills/{skill_id}">client.skills.<a href="./src/openai/resources/skills/skills.py">retrieve</a>(skill_id) -> <a href="./src/openai/types/skill.py">Skill</a></code>
+- <code title="post /skills/{skill_id}">client.skills.<a href="./src/openai/resources/skills/skills.py">update</a>(skill_id, \*\*<a href="src/openai/types/skill_update_params.py">params</a>) -> <a href="./src/openai/types/skill.py">Skill</a></code>
+- <code title="get /skills">client.skills.<a href="./src/openai/resources/skills/skills.py">list</a>(\*\*<a href="src/openai/types/skill_list_params.py">params</a>) -> <a href="./src/openai/types/skill.py">SyncCursorPage[Skill]</a></code>
+- <code title="delete /skills/{skill_id}">client.skills.<a href="./src/openai/resources/skills/skills.py">delete</a>(skill_id) -> <a href="./src/openai/types/deleted_skill.py">DeletedSkill</a></code>
+
+## Content
+
+Methods:
+
+- <code title="get /skills/{skill_id}/content">client.skills.content.<a href="./src/openai/resources/skills/content.py">retrieve</a>(skill_id) -> HttpxBinaryResponseContent</code>
+
+## Versions
+
+Types:
+
+```python
+from openai.types.skills import DeletedSkillVersion, SkillVersion, SkillVersionList
+```
+
+Methods:
+
+- <code title="post /skills/{skill_id}/versions">client.skills.versions.<a href="./src/openai/resources/skills/versions/versions.py">create</a>(skill_id, \*\*<a href="src/openai/types/skills/version_create_params.py">params</a>) -> <a href="./src/openai/types/skills/skill_version.py">SkillVersion</a></code>
+- <code title="get /skills/{skill_id}/versions/{version}">client.skills.versions.<a href="./src/openai/resources/skills/versions/versions.py">retrieve</a>(version, \*, skill_id) -> <a href="./src/openai/types/skills/skill_version.py">SkillVersion</a></code>
+- <code title="get /skills/{skill_id}/versions">client.skills.versions.<a href="./src/openai/resources/skills/versions/versions.py">list</a>(skill_id, \*\*<a href="src/openai/types/skills/version_list_params.py">params</a>) -> <a href="./src/openai/types/skills/skill_version.py">SyncCursorPage[SkillVersion]</a></code>
+- <code title="delete /skills/{skill_id}/versions/{version}">client.skills.versions.<a href="./src/openai/resources/skills/versions/versions.py">delete</a>(version, \*, skill_id) -> <a href="./src/openai/types/skills/deleted_skill_version.py">DeletedSkillVersion</a></code>
+
+### Content
+
+Methods:
+
+- <code title="get /skills/{skill_id}/versions/{version}/content">client.skills.versions.content.<a href="./src/openai/resources/skills/versions/content.py">retrieve</a>(version, \*, skill_id) -> HttpxBinaryResponseContent</code>
+
 # Videos
 
 Types:

src/openai/__init__.py

@@ -379,6 +379,7 @@ def _reset_client() -> None:  # type: ignore[reportUnusedFunction]
     files as files,
     images as images,
     models as models,
+    skills as skills,
     videos as videos,
     batches as batches,
     uploads as uploads,

src/openai/_client.py

@@ -44,6 +44,7 @@
         files,
         images,
         models,
+        skills,
         videos,
         batches,
         uploads,
@@ -70,6 +71,7 @@
     from .resources.completions import Completions, AsyncCompletions
     from .resources.evals.evals import Evals, AsyncEvals
     from .resources.moderations import Moderations, AsyncModerations
+    from .resources.skills.skills import Skills, AsyncSkills
     from .resources.uploads.uploads import Uploads, AsyncUploads
     from .resources.realtime.realtime import Realtime, AsyncRealtime
     from .resources.responses.responses import Responses, AsyncResponses
@@ -290,6 +292,12 @@ def containers(self) -> Containers:
 
         return Containers(self)
 
+    @cached_property
+    def skills(self) -> Skills:
+        from .resources.skills import Skills
+
+        return Skills(self)
+
     @cached_property
     def videos(self) -> Videos:
         from .resources.videos import Videos
@@ -641,6 +649,12 @@ def containers(self) -> AsyncContainers:
 
         return AsyncContainers(self)
 
+    @cached_property
+    def skills(self) -> AsyncSkills:
+        from .resources.skills import AsyncSkills
+
+        return AsyncSkills(self)
+
     @cached_property
     def videos(self) -> AsyncVideos:
         from .resources.videos import AsyncVideos
@@ -897,6 +911,12 @@ def containers(self) -> containers.ContainersWithRawResponse:
 
         return ContainersWithRawResponse(self._client.containers)
 
+    @cached_property
+    def skills(self) -> skills.SkillsWithRawResponse:
+        from .resources.skills import SkillsWithRawResponse
+
+        return SkillsWithRawResponse(self._client.skills)
+
     @cached_property
     def videos(self) -> videos.VideosWithRawResponse:
         from .resources.videos import VideosWithRawResponse
@@ -1018,6 +1038,12 @@ def containers(self) -> containers.AsyncContainersWithRawResponse:
 
         return AsyncContainersWithRawResponse(self._client.containers)
 
+    @cached_property
+    def skills(self) -> skills.AsyncSkillsWithRawResponse:
+        from .resources.skills import AsyncSkillsWithRawResponse
+
+        return AsyncSkillsWithRawResponse(self._client.skills)
+
     @cached_property
     def videos(self) -> videos.AsyncVideosWithRawResponse:
         from .resources.videos import AsyncVideosWithRawResponse
@@ -1139,6 +1165,12 @@ def containers(self) -> containers.ContainersWithStreamingResponse:
 
         return ContainersWithStreamingResponse(self._client.containers)
 
+    @cached_property
+    def skills(self) -> skills.SkillsWithStreamingResponse:
+        from .resources.skills import SkillsWithStreamingResponse
+
+        return SkillsWithStreamingResponse(self._client.skills)
+
     @cached_property
     def videos(self) -> videos.VideosWithStreamingResponse:
         from .resources.videos import VideosWithStreamingResponse
@@ -1260,6 +1292,12 @@ def containers(self) -> containers.AsyncContainersWithStreamingResponse:
 
         return AsyncContainersWithStreamingResponse(self._client.containers)
 
+    @cached_property
+    def skills(self) -> skills.AsyncSkillsWithStreamingResponse:
+        from .resources.skills import AsyncSkillsWithStreamingResponse
+
+        return AsyncSkillsWithStreamingResponse(self._client.skills)
+
     @cached_property
     def videos(self) -> videos.AsyncVideosWithStreamingResponse:
         from .resources.videos import AsyncVideosWithStreamingResponse

src/openai/_module_client.py

@@ -19,6 +19,7 @@
     from .resources.completions import Completions
     from .resources.evals.evals import Evals
     from .resources.moderations import Moderations
+    from .resources.skills.skills import Skills
     from .resources.uploads.uploads import Uploads
     from .resources.realtime.realtime import Realtime
     from .resources.responses.responses import Responses
@@ -73,6 +74,12 @@ def __load__(self) -> Models:
         return _load_client().models
 
 
+class SkillsProxy(LazyProxy["Skills"]):
+    @override
+    def __load__(self) -> Skills:
+        return _load_client().skills
+
+
 class VideosProxy(LazyProxy["Videos"]):
     @override
     def __load__(self) -> Videos:
@@ -158,6 +165,7 @@ def __load__(self) -> Conversations:
 evals: Evals = EvalsProxy().__as_proxied__()
 images: Images = ImagesProxy().__as_proxied__()
 models: Models = ModelsProxy().__as_proxied__()
+skills: Skills = SkillsProxy().__as_proxied__()
 videos: Videos = VideosProxy().__as_proxied__()
 batches: Batches = BatchesProxy().__as_proxied__()
 uploads: Uploads = UploadsProxy().__as_proxied__()

src/openai/resources/__init__.py

@@ -56,6 +56,14 @@
     ModelsWithStreamingResponse,
     AsyncModelsWithStreamingResponse,
 )
+from .skills import (
+    Skills,
+    AsyncSkills,
+    SkillsWithRawResponse,
+    AsyncSkillsWithRawResponse,
+    SkillsWithStreamingResponse,
+    AsyncSkillsWithStreamingResponse,
+)
 from .videos import (
     Videos,
     AsyncVideos,
@@ -220,6 +228,12 @@
     "AsyncContainersWithRawResponse",
     "ContainersWithStreamingResponse",
     "AsyncContainersWithStreamingResponse",
+    "Skills",
+    "AsyncSkills",
+    "SkillsWithRawResponse",
+    "AsyncSkillsWithRawResponse",
+    "SkillsWithStreamingResponse",
+    "AsyncSkillsWithStreamingResponse",
     "Videos",
     "AsyncVideos",
     "VideosWithRawResponse",