feat: make agent version optional in API (#8858)

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 116
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-c7ea174934858cd454d7de0230f9a0eef056f9deff2c4bb6b8b4e5f4a223a959.yml
-openapi_spec_hash: 3a398829d65372e00d413089830878ea
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-8d842053abe7f6230240dc5adadee3b881020d07f7505002fa33a0aee67cc74c.yml
+openapi_spec_hash: 09e0ffd9cd5981634a10592edeb8174e
 config_hash: 436c8d4e665915db22b5d98fe58382c1

src/runloop_api_client/resources/agents.py

@@ -50,8 +50,8 @@ def create(
         self,
         *,
         name: str,
-        version: str,
         source: Optional[AgentSource] | Omit = omit,
+        version: Optional[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,
@@ -68,10 +68,12 @@ def create(
         Args:
           name: The name of the Agent.
 
-          version: The version of the Agent. Must be a semver string (e.g., '2.0.65') or a SHA.
-
           source: The source configuration for the Agent.
 
+          version: Optional version identifier for the Agent. For npm/pip sources this is typically
+              a semver string (e.g. '2.0.65'). For git sources it can be a branch or tag.
+              Semantics are user-defined for object sources.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -87,8 +89,8 @@ def create(
             body=maybe_transform(
                 {
                     "name": name,
-                    "version": version,
                     "source": source,
+                    "version": version,
                 },
                 agent_create_params.AgentCreateParams,
             ),
@@ -357,8 +359,8 @@ async def create(
         self,
         *,
         name: str,
-        version: str,
         source: Optional[AgentSource] | Omit = omit,
+        version: Optional[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,
@@ -375,10 +377,12 @@ async def create(
         Args:
           name: The name of the Agent.
 
-          version: The version of the Agent. Must be a semver string (e.g., '2.0.65') or a SHA.
-
           source: The source configuration for the Agent.
 
+          version: Optional version identifier for the Agent. For npm/pip sources this is typically
+              a semver string (e.g. '2.0.65'). For git sources it can be a branch or tag.
+              Semantics are user-defined for object sources.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -394,8 +398,8 @@ async def create(
             body=await async_maybe_transform(
                 {
                     "name": name,
-                    "version": version,
                     "source": source,
+                    "version": version,
                 },
                 agent_create_params.AgentCreateParams,
             ),

src/runloop_api_client/types/agent_create_params.py

@@ -14,8 +14,13 @@ class AgentCreateParams(TypedDict, total=False):
     name: Required[str]
     """The name of the Agent."""
 
-    version: Required[str]
-    """The version of the Agent. Must be a semver string (e.g., '2.0.65') or a SHA."""
-
     source: Optional[AgentSource]
     """The source configuration for the Agent."""
+
+    version: Optional[str]
+    """Optional version identifier for the Agent.
+
+    For npm/pip sources this is typically a semver string (e.g. '2.0.65'). For git
+    sources it can be a branch or tag. Semantics are user-defined for object
+    sources.
+    """

src/runloop_api_client/types/agent_view.py

@@ -23,8 +23,13 @@ class AgentView(BaseModel):
     name: str
     """The name of the Agent."""
 
-    version: str
-    """The version of the Agent. A semver string (e.g., '2.0.65') or a SHA."""
-
     source: Optional[AgentSource] = None
     """The source configuration for the Agent."""
+
+    version: Optional[str] = None
+    """Optional version identifier for the Agent.
+
+    For npm/pip sources this is typically a semver string (e.g. '2.0.65'). For git
+    sources it can be a branch or tag. Omitted for object sources or when not
+    provided.
+    """

tests/api_resources/test_agents.py

@@ -25,15 +25,13 @@ class TestAgents:
     def test_method_create(self, client: Runloop) -> None:
         agent = client.agents.create(
             name="name",
-            version="version",
         )
         assert_matches_type(AgentView, agent, path=["response"])
 
     @parametrize
     def test_method_create_with_all_params(self, client: Runloop) -> None:
         agent = client.agents.create(
             name="name",
-            version="version",
             source={
                 "type": "type",
                 "git": {
@@ -56,14 +54,14 @@ def test_method_create_with_all_params(self, client: Runloop) -> None:
                     "registry_url": "registry_url",
                 },
             },
+            version="version",
         )
         assert_matches_type(AgentView, agent, path=["response"])
 
     @parametrize
     def test_raw_response_create(self, client: Runloop) -> None:
         response = client.agents.with_raw_response.create(
             name="name",
-            version="version",
         )
 
         assert response.is_closed is True
@@ -75,7 +73,6 @@ def test_raw_response_create(self, client: Runloop) -> None:
     def test_streaming_response_create(self, client: Runloop) -> None:
         with client.agents.with_streaming_response.create(
             name="name",
-            version="version",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -271,15 +268,13 @@ class TestAsyncAgents:
     async def test_method_create(self, async_client: AsyncRunloop) -> None:
         agent = await async_client.agents.create(
             name="name",
-            version="version",
         )
         assert_matches_type(AgentView, agent, path=["response"])
 
     @parametrize
     async def test_method_create_with_all_params(self, async_client: AsyncRunloop) -> None:
         agent = await async_client.agents.create(
             name="name",
-            version="version",
             source={
                 "type": "type",
                 "git": {
@@ -302,14 +297,14 @@ async def test_method_create_with_all_params(self, async_client: AsyncRunloop) -
                     "registry_url": "registry_url",
                 },
             },
+            version="version",
         )
         assert_matches_type(AgentView, agent, path=["response"])
 
     @parametrize
     async def test_raw_response_create(self, async_client: AsyncRunloop) -> None:
         response = await async_client.agents.with_raw_response.create(
             name="name",
-            version="version",
         )
 
         assert response.is_closed is True
@@ -321,7 +316,6 @@ async def test_raw_response_create(self, async_client: AsyncRunloop) -> None:
     async def test_streaming_response_create(self, async_client: AsyncRunloop) -> None:
         async with async_client.agents.with_streaming_response.create(
             name="name",
-            version="version",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"