fix(api): build errors

- update openapi spec
- comment out models that don't exist
- add back methods for backwards compatibility for now

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 34
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp%2Fagentex-sdk-021b55c88964b7a5bfc9d692d32a52c6b0150445656d2407c4cb8e9dd1e5f100.yml
-openapi_spec_hash: ed92c0d5d6bed9cb5617f8a776ac42c9
-config_hash: 7661726e3cccf9f6349179841153601d
+openapi_spec_hash: 3f634d45f6241dea4fbdac496b70f5a3
+config_hash: 7c45df33d1cc4df7ea9dac3b0968b0f0

README.md

@@ -28,17 +28,16 @@ pip install git+ssh://[email protected]/scaleapi/agentex-python.git
 The full API of this library can be found in [api.md](api.md).
 
 ```python
+import os
 from agentex import Agentex
 
 client = Agentex(
+    api_key=os.environ.get("AGENTEX_SDK_API_KEY"),  # This is the default and can be omitted
     # defaults to "production".
     environment="development",
 )
 
-agent = client.agents.retrieve(
-    "agent_id",
-)
-print(agent.id)
+tasks = client.tasks.list()
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -51,20 +50,19 @@ so that your API Key is not stored in source control.
 Simply import `AsyncAgentex` instead of `Agentex` and use `await` with each API call:
 
 ```python
+import os
 import asyncio
 from agentex import AsyncAgentex
 
 client = AsyncAgentex(
+    api_key=os.environ.get("AGENTEX_SDK_API_KEY"),  # This is the default and can be omitted
     # defaults to "production".
     environment="development",
 )
 
 
 async def main() -> None:
-    agent = await client.agents.retrieve(
-        "agent_id",
-    )
-    print(agent.id)
+    tasks = await client.tasks.list()
 
 
 asyncio.run(main())
@@ -93,12 +91,10 @@ from agentex import AsyncAgentex
 
 async def main() -> None:
     async with AsyncAgentex(
+        api_key="My API Key",
         http_client=DefaultAioHttpClient(),
     ) as client:
-        agent = await client.agents.retrieve(
-            "agent_id",
-        )
-        print(agent.id)
+        tasks = await client.tasks.list()
 
 
 asyncio.run(main())
@@ -129,9 +125,7 @@ from agentex import Agentex
 client = Agentex()
 
 try:
-    client.agents.retrieve(
-        "agent_id",
-    )
+    client.tasks.list()
 except agentex.APIConnectionError as e:
     print("The server could not be reached")
     print(e.__cause__)  # an underlying Exception, likely raised within httpx.
@@ -174,9 +168,7 @@ client = Agentex(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).agents.retrieve(
-    "agent_id",
-)
+client.with_options(max_retries=5).tasks.list()
 ```
 
 ### Timeouts
@@ -199,9 +191,7 @@ client = Agentex(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).agents.retrieve(
-    "agent_id",
-)
+client.with_options(timeout=5.0).tasks.list()
 ```
 
 On timeout, an `APITimeoutError` is thrown.
@@ -242,13 +232,11 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from agentex import Agentex
 
 client = Agentex()
-response = client.agents.with_raw_response.retrieve(
-    "agent_id",
-)
+response = client.tasks.with_raw_response.list()
 print(response.headers.get('X-My-Header'))
 
-agent = response.parse()  # get the object that `agents.retrieve()` would have returned
-print(agent.id)
+task = response.parse()  # get the object that `tasks.list()` would have returned
+print(task)
 ```
 
 These methods return an [`APIResponse`](https://github.com/scaleapi/agentex-python/tree/main/src/agentex/_response.py) object.
@@ -262,9 +250,7 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.agents.with_streaming_response.retrieve(
-    "agent_id",
-) as response:
+with client.tasks.with_streaming_response.list() as response:
     print(response.headers.get("X-My-Header"))
 
     for line in response.iter_lines():

api.md

@@ -8,13 +8,22 @@ from agentex.types import AcpType, Agent, AgentRpcRequest, AgentListResponse
 
 Methods:
 
-- <code title="get /agents/{agent_id}">client.agents.<a href="./src/agentex/resources/agents.py">retrieve</a>(agent_id) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
-- <code title="get /agents">client.agents.<a href="./src/agentex/resources/agents.py">list</a>(\*\*<a href="src/agentex/types/agent_list_params.py">params</a>) -> <a href="./src/agentex/types/agent_list_response.py">AgentListResponse</a></code>
-- <code title="delete /agents/{agent_id}">client.agents.<a href="./src/agentex/resources/agents.py">delete</a>(agent_id) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
-- <code title="delete /agents/name/{agent_name}">client.agents.<a href="./src/agentex/resources/agents.py">delete_by_name</a>(agent_name) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
-- <code title="get /agents/name/{agent_name}">client.agents.<a href="./src/agentex/resources/agents.py">retrieve_by_name</a>(agent_name) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
-- <code title="post /agents/{agent_id}/rpc">client.agents.<a href="./src/agentex/resources/agents.py">rpc</a>(agent_id, \*\*<a href="src/agentex/types/agent_rpc_params.py">params</a>) -> object</code>
-- <code title="post /agents/name/{agent_name}/rpc">client.agents.<a href="./src/agentex/resources/agents.py">rpc_by_name</a>(agent_name, \*\*<a href="src/agentex/types/agent_rpc_by_name_params.py">params</a>) -> object</code>
+- <code title="get /agents/{agent_id}">client.agents.<a href="./src/agentex/resources/agents/agents.py">retrieve</a>(agent_id) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
+- <code title="get /agents">client.agents.<a href="./src/agentex/resources/agents/agents.py">list</a>(\*\*<a href="src/agentex/types/agent_list_params.py">params</a>) -> <a href="./src/agentex/types/agent_list_response.py">AgentListResponse</a></code>
+- <code title="delete /agents/{agent_id}">client.agents.<a href="./src/agentex/resources/agents/agents.py">delete</a>(agent_id) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
+- <code title="delete /agents/name/{agent_name}">client.agents.<a href="./src/agentex/resources/agents/agents.py">delete_by_name</a>(agent_name) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
+- <code title="get /agents/name/{agent_name}">client.agents.<a href="./src/agentex/resources/agents/agents.py">retrieve_by_name</a>(agent_name) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
+- <code title="post /agents/{agent_id}/rpc">client.agents.<a href="./src/agentex/resources/agents/agents.py">rpc</a>(agent_id, \*\*<a href="src/agentex/types/agent_rpc_params.py">params</a>) -> object</code>
+- <code title="post /agents/name/{agent_name}/rpc">client.agents.<a href="./src/agentex/resources/agents/agents.py">rpc_by_name</a>(agent_name, \*\*<a href="src/agentex/types/agent_rpc_by_name_params.py">params</a>) -> object</code>
+
+## Name
+
+Methods:
+
+- <code title="get /agents/name/{agent_name}">client.agents.name.<a href="./src/agentex/resources/agents/name.py">retrieve</a>(agent_name) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
+- <code title="delete /agents/name/{agent_name}">client.agents.name.<a href="./src/agentex/resources/agents/name.py">delete</a>(agent_name) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
+- <code title="post /agents/name/{agent_name}/rpc">client.agents.name.<a href="./src/agentex/resources/agents/name.py">handle_rpc</a>(agent_name, \*\*<a href="src/agentex/types/agents/name_handle_rpc_params.py">params</a>) -> object</code>
+- <code title="post /agents/name/{agent_name}/rpc">client.agents.name.<a href="./src/agentex/resources/agents/name.py">rpc</a>(agent_name, \*\*<a href="src/agentex/types/agents/name_rpc_params.py">params</a>) -> object</code>
 
 # Tasks
 
@@ -26,13 +35,21 @@ from agentex.types import Task, TaskListResponse
 
 Methods:
 
-- <code title="get /tasks/{task_id}">client.tasks.<a href="./src/agentex/resources/tasks.py">retrieve</a>(task_id) -> <a href="./src/agentex/types/task.py">Task</a></code>
-- <code title="get /tasks">client.tasks.<a href="./src/agentex/resources/tasks.py">list</a>() -> <a href="./src/agentex/types/task_list_response.py">TaskListResponse</a></code>
-- <code title="delete /tasks/{task_id}">client.tasks.<a href="./src/agentex/resources/tasks.py">delete</a>(task_id) -> <a href="./src/agentex/types/task.py">Task</a></code>
-- <code title="delete /tasks/name/{task_name}">client.tasks.<a href="./src/agentex/resources/tasks.py">delete_by_name</a>(task_name) -> <a href="./src/agentex/types/task.py">Task</a></code>
-- <code title="get /tasks/name/{task_name}">client.tasks.<a href="./src/agentex/resources/tasks.py">retrieve_by_name</a>(task_name) -> <a href="./src/agentex/types/task.py">Task</a></code>
-- <code title="get /tasks/{task_id}/stream">client.tasks.<a href="./src/agentex/resources/tasks.py">stream_events</a>(task_id) -> object</code>
-- <code title="get /tasks/name/{task_name}/stream">client.tasks.<a href="./src/agentex/resources/tasks.py">stream_events_by_name</a>(task_name) -> object</code>
+- <code title="get /tasks/{task_id}">client.tasks.<a href="./src/agentex/resources/tasks/tasks.py">retrieve</a>(task_id) -> <a href="./src/agentex/types/task.py">Task</a></code>
+- <code title="get /tasks">client.tasks.<a href="./src/agentex/resources/tasks/tasks.py">list</a>() -> <a href="./src/agentex/types/task_list_response.py">TaskListResponse</a></code>
+- <code title="delete /tasks/{task_id}">client.tasks.<a href="./src/agentex/resources/tasks/tasks.py">delete</a>(task_id) -> <a href="./src/agentex/types/task.py">Task</a></code>
+- <code title="delete /tasks/name/{task_name}">client.tasks.<a href="./src/agentex/resources/tasks/tasks.py">delete_by_name</a>(task_name) -> <a href="./src/agentex/types/task.py">Task</a></code>
+- <code title="get /tasks/name/{task_name}">client.tasks.<a href="./src/agentex/resources/tasks/tasks.py">retrieve_by_name</a>(task_name) -> <a href="./src/agentex/types/task.py">Task</a></code>
+- <code title="get /tasks/{task_id}/stream">client.tasks.<a href="./src/agentex/resources/tasks/tasks.py">stream_events</a>(task_id) -> object</code>
+- <code title="get /tasks/name/{task_name}/stream">client.tasks.<a href="./src/agentex/resources/tasks/tasks.py">stream_events_by_name</a>(task_name) -> object</code>
+
+## Name
+
+Methods:
+
+- <code title="get /tasks/name/{task_name}">client.tasks.name.<a href="./src/agentex/resources/tasks/name.py">retrieve</a>(task_name) -> <a href="./src/agentex/types/task.py">Task</a></code>
+- <code title="delete /tasks/name/{task_name}">client.tasks.name.<a href="./src/agentex/resources/tasks/name.py">delete</a>(task_name) -> <a href="./src/agentex/types/task.py">Task</a></code>
+- <code title="get /tasks/name/{task_name}/stream">client.tasks.name.<a href="./src/agentex/resources/tasks/name.py">stream_events</a>(task_name) -> object</code>
 
 # Messages
 

src/agentex/_client.py

@@ -21,14 +21,16 @@
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import spans, tasks, agents, events, states, tracker
+from .resources import spans, events, states, tracker
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import APIStatusError
 from ._base_client import (
     DEFAULT_MAX_RETRIES,
     SyncAPIClient,
     AsyncAPIClient,
 )
+from .resources.tasks import tasks
+from .resources.agents import agents
 from .resources.messages import messages
 
 __all__ = [

src/agentex/resources/agents/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .name import (
+    NameResource,
+    AsyncNameResource,
+    NameResourceWithRawResponse,
+    AsyncNameResourceWithRawResponse,
+    NameResourceWithStreamingResponse,
+    AsyncNameResourceWithStreamingResponse,
+)
+from .agents import (
+    AgentsResource,
+    AsyncAgentsResource,
+    AgentsResourceWithRawResponse,
+    AsyncAgentsResourceWithRawResponse,
+    AgentsResourceWithStreamingResponse,
+    AsyncAgentsResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "NameResource",
+    "AsyncNameResource",
+    "NameResourceWithRawResponse",
+    "AsyncNameResourceWithRawResponse",
+    "NameResourceWithStreamingResponse",
+    "AsyncNameResourceWithStreamingResponse",
+    "AgentsResource",
+    "AsyncAgentsResource",
+    "AgentsResourceWithRawResponse",
+    "AsyncAgentsResourceWithRawResponse",
+    "AgentsResourceWithStreamingResponse",
+    "AsyncAgentsResourceWithStreamingResponse",
+]

src/agentex/resources/agents.py renamed to src/agentex/resources/agents/agents.py

@@ -7,25 +7,37 @@
 
 import httpx
 
-from ..types import agent_rpc_params, agent_list_params, agent_rpc_by_name_params
-from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
-from .._utils import maybe_transform, async_maybe_transform
-from .._compat import cached_property
-from .._resource import SyncAPIResource, AsyncAPIResource
-from .._response import (
+from .name import (
+    NameResource,
+    AsyncNameResource,
+    NameResourceWithRawResponse,
+    AsyncNameResourceWithRawResponse,
+    NameResourceWithStreamingResponse,
+    AsyncNameResourceWithStreamingResponse,
+)
+from ...types import agent_rpc_params, agent_list_params, agent_rpc_by_name_params
+from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ..._utils import maybe_transform, async_maybe_transform
+from ..._compat import cached_property
+from ..._resource import SyncAPIResource, AsyncAPIResource
+from ..._response import (
     to_raw_response_wrapper,
     to_streamed_response_wrapper,
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from ..types.agent import Agent
-from .._base_client import make_request_options
-from ..types.agent_list_response import AgentListResponse
+from ...types.agent import Agent
+from ..._base_client import make_request_options
+from ...types.agent_list_response import AgentListResponse
 
 __all__ = ["AgentsResource", "AsyncAgentsResource"]
 
 
 class AgentsResource(SyncAPIResource):
+    @cached_property
+    def name(self) -> NameResource:
+        return NameResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> AgentsResourceWithRawResponse:
         """
@@ -308,6 +320,10 @@ def rpc_by_name(
 
 
 class AsyncAgentsResource(AsyncAPIResource):
+    @cached_property
+    def name(self) -> AsyncNameResource:
+        return AsyncNameResource(self._client)
+
     @cached_property
     def with_raw_response(self) -> AsyncAgentsResourceWithRawResponse:
         """
@@ -615,6 +631,10 @@ def __init__(self, agents: AgentsResource) -> None:
             agents.rpc_by_name,
         )
 
+    @cached_property
+    def name(self) -> NameResourceWithRawResponse:
+        return NameResourceWithRawResponse(self._agents.name)
+
 
 class AsyncAgentsResourceWithRawResponse:
     def __init__(self, agents: AsyncAgentsResource) -> None:
@@ -642,6 +662,10 @@ def __init__(self, agents: AsyncAgentsResource) -> None:
             agents.rpc_by_name,
         )
 
+    @cached_property
+    def name(self) -> AsyncNameResourceWithRawResponse:
+        return AsyncNameResourceWithRawResponse(self._agents.name)
+
 
 class AgentsResourceWithStreamingResponse:
     def __init__(self, agents: AgentsResource) -> None:
@@ -669,6 +693,10 @@ def __init__(self, agents: AgentsResource) -> None:
             agents.rpc_by_name,
         )
 
+    @cached_property
+    def name(self) -> NameResourceWithStreamingResponse:
+        return NameResourceWithStreamingResponse(self._agents.name)
+
 
 class AsyncAgentsResourceWithStreamingResponse:
     def __init__(self, agents: AsyncAgentsResource) -> None:
@@ -695,3 +723,7 @@ def __init__(self, agents: AsyncAgentsResource) -> None:
         self.rpc_by_name = async_to_streamed_response_wrapper(
             agents.rpc_by_name,
         )
+
+    @cached_property
+    def name(self) -> AsyncNameResourceWithStreamingResponse:
+        return AsyncNameResourceWithStreamingResponse(self._agents.name)