feat: Memory data model scaffolding.

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 22
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-f5a88aa4f1991447272228b7024ebfbec99d31706b8806058917a3f90dd39d00.yml
-openapi_spec_hash: 1952fae99172f1adaf35d800b0d63936
-config_hash: 44a1e8f98607a5cf03815a63bae63453
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-1ef9ad3f2ad814382839a23ea6731e16dda71ce83f460b91489b1464a0e2104a.yml
+openapi_spec_hash: a69bd63605861951ed480d5bcbb8fd38
+config_hash: c15534df6c8d861059e44d9dd5483b3f

src/oz_agent_sdk/resources/agent/agent_.py

@@ -2,9 +2,11 @@
 
 from __future__ import annotations
 
+from typing import Iterable, Optional
+
 import httpx
 
-from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, omit, not_given
+from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import path_template, maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
@@ -48,6 +50,9 @@ def create(
         self,
         *,
         name: str,
+        description: Optional[str] | Omit = omit,
+        secrets: Iterable[agent_create_params.Secret] | Omit = omit,
+        skills: SequenceNotStr[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -63,6 +68,18 @@ def create(
         Args:
           name: A name for the agent
 
+          description: Optional description of the agent
+
+          secrets: Optional list of secrets associated with the agent. Duplicate names within a
+              single request are rejected.
+
+          skills:
+              Optional list of skill specs to associate with the agent. Format:
+              "{owner}/{repo}:{skill_path}" (e.g.,
+              "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md"). Each spec is validated
+              and normalized at attach time using the team's GitHub credentials; inaccessible
+              or malformed specs are rejected.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -73,7 +90,15 @@ def create(
         """
         return self._post(
             "/agent/identities",
-            body=maybe_transform({"name": name}, agent_create_params.AgentCreateParams),
+            body=maybe_transform(
+                {
+                    "name": name,
+                    "description": description,
+                    "secrets": secrets,
+                    "skills": skills,
+                },
+                agent_create_params.AgentCreateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -84,20 +109,33 @@ def update(
         self,
         uid: str,
         *,
+        description: Optional[str] | Omit = omit,
         name: str | Omit = omit,
+        secrets: Optional[Iterable[agent_update_params.Secret]] | Omit = omit,
+        skills: Optional[SequenceNotStr[str]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AgentResponse:
-        """
-        Update an existing agent.
+        """Update an existing agent.
 
         Args:
+          description: Replacement description.
+
+        Omit or pass `null` to leave unchanged, or use an empty
+              value to clear.
+
           name: The new name for the agent
 
+          secrets: Replacement list of secrets. Omit to leave unchanged, pass an empty array to
+              clear, or pass a non-empty array to replace. Duplicate names are rejected.
+
+          skills: Replacement list of skill specs. Omit to leave unchanged, pass an empty array to
+              clear, or pass a non-empty array to replace.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -110,7 +148,15 @@ def update(
             raise ValueError(f"Expected a non-empty value for `uid` but received {uid!r}")
         return self._put(
             path_template("/agent/identities/{uid}", uid=uid),
-            body=maybe_transform({"name": name}, agent_update_params.AgentUpdateParams),
+            body=maybe_transform(
+                {
+                    "description": description,
+                    "name": name,
+                    "secrets": secrets,
+                    "skills": skills,
+                },
+                agent_update_params.AgentUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -202,6 +248,9 @@ async def create(
         self,
         *,
         name: str,
+        description: Optional[str] | Omit = omit,
+        secrets: Iterable[agent_create_params.Secret] | Omit = omit,
+        skills: SequenceNotStr[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -217,6 +266,18 @@ async def create(
         Args:
           name: A name for the agent
 
+          description: Optional description of the agent
+
+          secrets: Optional list of secrets associated with the agent. Duplicate names within a
+              single request are rejected.
+
+          skills:
+              Optional list of skill specs to associate with the agent. Format:
+              "{owner}/{repo}:{skill_path}" (e.g.,
+              "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md"). Each spec is validated
+              and normalized at attach time using the team's GitHub credentials; inaccessible
+              or malformed specs are rejected.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -227,7 +288,15 @@ async def create(
         """
         return await self._post(
             "/agent/identities",
-            body=await async_maybe_transform({"name": name}, agent_create_params.AgentCreateParams),
+            body=await async_maybe_transform(
+                {
+                    "name": name,
+                    "description": description,
+                    "secrets": secrets,
+                    "skills": skills,
+                },
+                agent_create_params.AgentCreateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -238,20 +307,33 @@ async def update(
         self,
         uid: str,
         *,
+        description: Optional[str] | Omit = omit,
         name: str | Omit = omit,
+        secrets: Optional[Iterable[agent_update_params.Secret]] | Omit = omit,
+        skills: Optional[SequenceNotStr[str]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AgentResponse:
-        """
-        Update an existing agent.
+        """Update an existing agent.
 
         Args:
+          description: Replacement description.
+
+        Omit or pass `null` to leave unchanged, or use an empty
+              value to clear.
+
           name: The new name for the agent
 
+          secrets: Replacement list of secrets. Omit to leave unchanged, pass an empty array to
+              clear, or pass a non-empty array to replace. Duplicate names are rejected.
+
+          skills: Replacement list of skill specs. Omit to leave unchanged, pass an empty array to
+              clear, or pass a non-empty array to replace.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -264,7 +346,15 @@ async def update(
             raise ValueError(f"Expected a non-empty value for `uid` but received {uid!r}")
         return await self._put(
             path_template("/agent/identities/{uid}", uid=uid),
-            body=await async_maybe_transform({"name": name}, agent_update_params.AgentUpdateParams),
+            body=await async_maybe_transform(
+                {
+                    "description": description,
+                    "name": name,
+                    "secrets": secrets,
+                    "skills": skills,
+                },
+                agent_update_params.AgentUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

src/oz_agent_sdk/resources/agent/runs.py

@@ -96,6 +96,7 @@ def list(
         cursor: str | Omit = omit,
         environment_id: str | Omit = omit,
         execution_location: Literal["LOCAL", "REMOTE"] | Omit = omit,
+        executor: str | Omit = omit,
         limit: int | Omit = omit,
         model_id: str | Omit = omit,
         name: str | Omit = omit,
@@ -138,6 +139,9 @@ def list(
 
           execution_location: Filter by where the run executed
 
+          executor: Filter by the user or agent that executed the run. This will often be the same
+              as the creator, but not always: users may delegate tasks to agents.
+
           limit: Maximum number of runs to return
 
           model_id: Filter by model ID
@@ -195,6 +199,7 @@ def list(
                         "cursor": cursor,
                         "environment_id": environment_id,
                         "execution_location": execution_location,
+                        "executor": executor,
                         "limit": limit,
                         "model_id": model_id,
                         "name": name,
@@ -401,6 +406,7 @@ def list(
         cursor: str | Omit = omit,
         environment_id: str | Omit = omit,
         execution_location: Literal["LOCAL", "REMOTE"] | Omit = omit,
+        executor: str | Omit = omit,
         limit: int | Omit = omit,
         model_id: str | Omit = omit,
         name: str | Omit = omit,
@@ -443,6 +449,9 @@ def list(
 
           execution_location: Filter by where the run executed
 
+          executor: Filter by the user or agent that executed the run. This will often be the same
+              as the creator, but not always: users may delegate tasks to agents.
+
           limit: Maximum number of runs to return
 
           model_id: Filter by model ID
@@ -500,6 +509,7 @@ def list(
                         "cursor": cursor,
                         "environment_id": environment_id,
                         "execution_location": execution_location,
+                        "executor": executor,
                         "limit": limit,
                         "model_id": model_id,
                         "name": name,

src/oz_agent_sdk/types/agent/agent_create_params.py

@@ -2,11 +2,39 @@
 
 from __future__ import annotations
 
+from typing import Iterable, Optional
 from typing_extensions import Required, TypedDict
 
-__all__ = ["AgentCreateParams"]
+from ..._types import SequenceNotStr
+
+__all__ = ["AgentCreateParams", "Secret"]
 
 
 class AgentCreateParams(TypedDict, total=False):
     name: Required[str]
     """A name for the agent"""
+
+    description: Optional[str]
+    """Optional description of the agent"""
+
+    secrets: Iterable[Secret]
+    """
+    Optional list of secrets associated with the agent. Duplicate names within a
+    single request are rejected.
+    """
+
+    skills: SequenceNotStr[str]
+    """
+    Optional list of skill specs to associate with the agent. Format:
+    "{owner}/{repo}:{skill_path}" (e.g.,
+    "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md"). Each spec is validated
+    and normalized at attach time using the team's GitHub credentials; inaccessible
+    or malformed specs are rejected.
+    """
+
+
+class Secret(TypedDict, total=False):
+    """Reference to a managed secret by name."""
+
+    name: Required[str]
+    """Name of the managed secret."""

src/oz_agent_sdk/types/agent/agent_response.py

@@ -1,10 +1,18 @@
 # 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
 
-__all__ = ["AgentResponse"]
+__all__ = ["AgentResponse", "Secret"]
+
+
+class Secret(BaseModel):
+    """Reference to a managed secret by name."""
+
+    name: str
+    """Name of the managed secret."""
 
 
 class AgentResponse(BaseModel):
@@ -17,5 +25,17 @@ class AgentResponse(BaseModel):
     name: str
     """Name of the agent"""
 
+    secrets: List[Secret]
+    """Secrets that this agent may access by default."""
+
+    skills: List[str]
+    """
+    Ordered list of normalized skill specs associated with this agent. Always
+    present; empty when no skills are attached.
+    """
+
     uid: str
     """Unique identifier for the agent"""
+
+    description: Optional[str] = None
+    """Optional description of the agent"""

src/oz_agent_sdk/types/agent/agent_update_params.py

@@ -2,11 +2,41 @@
 
 from __future__ import annotations
 
-from typing_extensions import TypedDict
+from typing import Iterable, Optional
+from typing_extensions import Required, TypedDict
 
-__all__ = ["AgentUpdateParams"]
+from ..._types import SequenceNotStr
+
+__all__ = ["AgentUpdateParams", "Secret"]
 
 
 class AgentUpdateParams(TypedDict, total=False):
+    description: Optional[str]
+    """Replacement description.
+
+    Omit or pass `null` to leave unchanged, or use an empty value to clear.
+    """
+
     name: str
     """The new name for the agent"""
+
+    secrets: Optional[Iterable[Secret]]
+    """Replacement list of secrets.
+
+    Omit to leave unchanged, pass an empty array to clear, or pass a non-empty array
+    to replace. Duplicate names are rejected.
+    """
+
+    skills: Optional[SequenceNotStr[str]]
+    """Replacement list of skill specs.
+
+    Omit to leave unchanged, pass an empty array to clear, or pass a non-empty array
+    to replace.
+    """
+
+
+class Secret(TypedDict, total=False):
+    """Reference to a managed secret by name."""
+
+    name: Required[str]
+    """Name of the managed secret."""