feat(api): add schedule, checkpoints, and deployment endpoints

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 45
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp/agentex-sdk-9ab4b375245291b8e37dd1cbc054fa65f17b7e7db28729126ea9f1289dc99214.yml
+configured_endpoints: 63
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/sgp/agentex-sdk-5400cbfee7eab6b5ace17d760b4997fd68f8d169470ab5040cf268a185250a0b.yml
 openapi_spec_hash: d31d828c46635cbc20165177c7187a70
-config_hash: fb079ef7936611b032568661b8165f19
+config_hash: 81470e0e689fe06fa3e013ec01a7f84f

api.md

@@ -30,13 +30,60 @@ from agentex.types import (
 
 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/shared/delete_response.py">DeleteResponse</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/shared/delete_response.py">DeleteResponse</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>) -> <a href="./src/agentex/types/agent_rpc_response.py">AgentRpcResponse</a></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>) -> <a href="./src/agentex/types/agent_rpc_response.py">AgentRpcResponse</a></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/shared/delete_response.py">DeleteResponse</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/shared/delete_response.py">DeleteResponse</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>) -> <a href="./src/agentex/types/agent_rpc_response.py">AgentRpcResponse</a></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>) -> <a href="./src/agentex/types/agent_rpc_response.py">AgentRpcResponse</a></code>
+
+## Deployments
+
+Types:
+
+```python
+from agentex.types.agents import (
+    DeploymentCreateResponse,
+    DeploymentRetrieveResponse,
+    DeploymentListResponse,
+    DeploymentPromoteResponse,
+)
+```
+
+Methods:
+
+- <code title="post /agents/{agent_id}/deployments">client.agents.deployments.<a href="./src/agentex/resources/agents/deployments.py">create</a>(agent_id, \*\*<a href="src/agentex/types/agents/deployment_create_params.py">params</a>) -> <a href="./src/agentex/types/agents/deployment_create_response.py">DeploymentCreateResponse</a></code>
+- <code title="get /agents/{agent_id}/deployments/{deployment_id}">client.agents.deployments.<a href="./src/agentex/resources/agents/deployments.py">retrieve</a>(deployment_id, \*, agent_id) -> <a href="./src/agentex/types/agents/deployment_retrieve_response.py">DeploymentRetrieveResponse</a></code>
+- <code title="get /agents/{agent_id}/deployments">client.agents.deployments.<a href="./src/agentex/resources/agents/deployments.py">list</a>(agent_id, \*\*<a href="src/agentex/types/agents/deployment_list_params.py">params</a>) -> <a href="./src/agentex/types/agents/deployment_list_response.py">DeploymentListResponse</a></code>
+- <code title="delete /agents/{agent_id}/deployments/{deployment_id}">client.agents.deployments.<a href="./src/agentex/resources/agents/deployments.py">delete</a>(deployment_id, \*, agent_id) -> <a href="./src/agentex/types/shared/delete_response.py">DeleteResponse</a></code>
+- <code title="post /agents/{agent_id}/deployments/{deployment_id}/rpc">client.agents.deployments.<a href="./src/agentex/resources/agents/deployments.py">preview_rpc</a>(deployment_id, \*, agent_id, \*\*<a href="src/agentex/types/agents/deployment_preview_rpc_params.py">params</a>) -> <a href="./src/agentex/types/agent_rpc_response.py">AgentRpcResponse</a></code>
+- <code title="post /agents/{agent_id}/deployments/{deployment_id}/promote">client.agents.deployments.<a href="./src/agentex/resources/agents/deployments.py">promote</a>(deployment_id, \*, agent_id) -> <a href="./src/agentex/types/agents/deployment_promote_response.py">DeploymentPromoteResponse</a></code>
+
+## Schedules
+
+Types:
+
+```python
+from agentex.types.agents import (
+    ScheduleCreateResponse,
+    ScheduleRetrieveResponse,
+    ScheduleListResponse,
+    SchedulePauseResponse,
+    ScheduleTriggerResponse,
+    ScheduleUnpauseResponse,
+)
+```
+
+Methods:
+
+- <code title="post /agents/{agent_id}/schedules">client.agents.schedules.<a href="./src/agentex/resources/agents/schedules.py">create</a>(agent_id, \*\*<a href="src/agentex/types/agents/schedule_create_params.py">params</a>) -> <a href="./src/agentex/types/agents/schedule_create_response.py">ScheduleCreateResponse</a></code>
+- <code title="get /agents/{agent_id}/schedules/{schedule_name}">client.agents.schedules.<a href="./src/agentex/resources/agents/schedules.py">retrieve</a>(schedule_name, \*, agent_id) -> <a href="./src/agentex/types/agents/schedule_retrieve_response.py">ScheduleRetrieveResponse</a></code>
+- <code title="get /agents/{agent_id}/schedules">client.agents.schedules.<a href="./src/agentex/resources/agents/schedules.py">list</a>(agent_id, \*\*<a href="src/agentex/types/agents/schedule_list_params.py">params</a>) -> <a href="./src/agentex/types/agents/schedule_list_response.py">ScheduleListResponse</a></code>
+- <code title="delete /agents/{agent_id}/schedules/{schedule_name}">client.agents.schedules.<a href="./src/agentex/resources/agents/schedules.py">delete</a>(schedule_name, \*, agent_id) -> <a href="./src/agentex/types/shared/delete_response.py">DeleteResponse</a></code>
+- <code title="post /agents/{agent_id}/schedules/{schedule_name}/pause">client.agents.schedules.<a href="./src/agentex/resources/agents/schedules.py">pause</a>(schedule_name, \*, agent_id, \*\*<a href="src/agentex/types/agents/schedule_pause_params.py">params</a>) -> <a href="./src/agentex/types/agents/schedule_pause_response.py">SchedulePauseResponse</a></code>
+- <code title="post /agents/{agent_id}/schedules/{schedule_name}/trigger">client.agents.schedules.<a href="./src/agentex/resources/agents/schedules.py">trigger</a>(schedule_name, \*, agent_id) -> <a href="./src/agentex/types/agents/schedule_trigger_response.py">ScheduleTriggerResponse</a></code>
+- <code title="post /agents/{agent_id}/schedules/{schedule_name}/unpause">client.agents.schedules.<a href="./src/agentex/resources/agents/schedules.py">unpause</a>(schedule_name, \*, agent_id, \*\*<a href="src/agentex/types/agents/schedule_unpause_params.py">params</a>) -> <a href="./src/agentex/types/agents/schedule_unpause_response.py">ScheduleUnpauseResponse</a></code>
 
 # Tasks
 
@@ -181,3 +228,19 @@ Methods:
 
 - <code title="get /deployment-history/{deployment_id}">client.deployment_history.<a href="./src/agentex/resources/deployment_history.py">retrieve</a>(deployment_id) -> <a href="./src/agentex/types/deployment_history.py">DeploymentHistory</a></code>
 - <code title="get /deployment-history">client.deployment_history.<a href="./src/agentex/resources/deployment_history.py">list</a>(\*\*<a href="src/agentex/types/deployment_history_list_params.py">params</a>) -> <a href="./src/agentex/types/deployment_history_list_response.py">DeploymentHistoryListResponse</a></code>
+
+# Checkpoints
+
+Types:
+
+```python
+from agentex.types import CheckpointListResponse, CheckpointGetTupleResponse, CheckpointPutResponse
+```
+
+Methods:
+
+- <code title="post /checkpoints/list">client.checkpoints.<a href="./src/agentex/resources/checkpoints.py">list</a>(\*\*<a href="src/agentex/types/checkpoint_list_params.py">params</a>) -> <a href="./src/agentex/types/checkpoint_list_response.py">CheckpointListResponse</a></code>
+- <code title="post /checkpoints/delete-thread">client.checkpoints.<a href="./src/agentex/resources/checkpoints.py">delete_thread</a>(\*\*<a href="src/agentex/types/checkpoint_delete_thread_params.py">params</a>) -> None</code>
+- <code title="post /checkpoints/get-tuple">client.checkpoints.<a href="./src/agentex/resources/checkpoints.py">get_tuple</a>(\*\*<a href="src/agentex/types/checkpoint_get_tuple_params.py">params</a>) -> <a href="./src/agentex/types/checkpoint_get_tuple_response.py">Optional[CheckpointGetTupleResponse]</a></code>
+- <code title="post /checkpoints/put">client.checkpoints.<a href="./src/agentex/resources/checkpoints.py">put</a>(\*\*<a href="src/agentex/types/checkpoint_put_params.py">params</a>) -> <a href="./src/agentex/types/checkpoint_put_response.py">CheckpointPutResponse</a></code>
+- <code title="post /checkpoints/put-writes">client.checkpoints.<a href="./src/agentex/resources/checkpoints.py">put_writes</a>(\*\*<a href="src/agentex/types/checkpoint_put_writes_params.py">params</a>) -> None</code>

src/agentex/_client.py

@@ -35,13 +35,14 @@
 )
 
 if TYPE_CHECKING:
-    from .resources import spans, tasks, agents, events, states, tracker, messages, deployment_history
+    from .resources import spans, tasks, agents, events, states, tracker, messages, checkpoints, deployment_history
     from .resources.spans import SpansResource, AsyncSpansResource
     from .resources.tasks import TasksResource, AsyncTasksResource
-    from .resources.agents import AgentsResource, AsyncAgentsResource
     from .resources.events import EventsResource, AsyncEventsResource
     from .resources.states import StatesResource, AsyncStatesResource
     from .resources.tracker import TrackerResource, AsyncTrackerResource
+    from .resources.checkpoints import CheckpointsResource, AsyncCheckpointsResource
+    from .resources.agents.agents import AgentsResource, AsyncAgentsResource
     from .resources.messages.messages import MessagesResource, AsyncMessagesResource
     from .resources.deployment_history import DeploymentHistoryResource, AsyncDeploymentHistoryResource
 
@@ -195,6 +196,12 @@ def deployment_history(self) -> DeploymentHistoryResource:
 
         return DeploymentHistoryResource(self)
 
+    @cached_property
+    def checkpoints(self) -> CheckpointsResource:
+        from .resources.checkpoints import CheckpointsResource
+
+        return CheckpointsResource(self)
+
     @cached_property
     def with_raw_response(self) -> AgentexWithRawResponse:
         return AgentexWithRawResponse(self)
@@ -444,6 +451,12 @@ def deployment_history(self) -> AsyncDeploymentHistoryResource:
 
         return AsyncDeploymentHistoryResource(self)
 
+    @cached_property
+    def checkpoints(self) -> AsyncCheckpointsResource:
+        from .resources.checkpoints import AsyncCheckpointsResource
+
+        return AsyncCheckpointsResource(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncAgentexWithRawResponse:
         return AsyncAgentexWithRawResponse(self)
@@ -615,6 +628,12 @@ def deployment_history(self) -> deployment_history.DeploymentHistoryResourceWith
 
         return DeploymentHistoryResourceWithRawResponse(self._client.deployment_history)
 
+    @cached_property
+    def checkpoints(self) -> checkpoints.CheckpointsResourceWithRawResponse:
+        from .resources.checkpoints import CheckpointsResourceWithRawResponse
+
+        return CheckpointsResourceWithRawResponse(self._client.checkpoints)
+
 
 class AsyncAgentexWithRawResponse:
     _client: AsyncAgentex
@@ -670,6 +689,12 @@ def deployment_history(self) -> deployment_history.AsyncDeploymentHistoryResourc
 
         return AsyncDeploymentHistoryResourceWithRawResponse(self._client.deployment_history)
 
+    @cached_property
+    def checkpoints(self) -> checkpoints.AsyncCheckpointsResourceWithRawResponse:
+        from .resources.checkpoints import AsyncCheckpointsResourceWithRawResponse
+
+        return AsyncCheckpointsResourceWithRawResponse(self._client.checkpoints)
+
 
 class AgentexWithStreamedResponse:
     _client: Agentex
@@ -725,6 +750,12 @@ def deployment_history(self) -> deployment_history.DeploymentHistoryResourceWith
 
         return DeploymentHistoryResourceWithStreamingResponse(self._client.deployment_history)
 
+    @cached_property
+    def checkpoints(self) -> checkpoints.CheckpointsResourceWithStreamingResponse:
+        from .resources.checkpoints import CheckpointsResourceWithStreamingResponse
+
+        return CheckpointsResourceWithStreamingResponse(self._client.checkpoints)
+
 
 class AsyncAgentexWithStreamedResponse:
     _client: AsyncAgentex
@@ -780,6 +811,12 @@ def deployment_history(self) -> deployment_history.AsyncDeploymentHistoryResourc
 
         return AsyncDeploymentHistoryResourceWithStreamingResponse(self._client.deployment_history)
 
+    @cached_property
+    def checkpoints(self) -> checkpoints.AsyncCheckpointsResourceWithStreamingResponse:
+        from .resources.checkpoints import AsyncCheckpointsResourceWithStreamingResponse
+
+        return AsyncCheckpointsResourceWithStreamingResponse(self._client.checkpoints)
+
 
 Client = Agentex
 

src/agentex/resources/__init__.py

@@ -56,6 +56,14 @@
     MessagesResourceWithStreamingResponse,
     AsyncMessagesResourceWithStreamingResponse,
 )
+from .checkpoints import (
+    CheckpointsResource,
+    AsyncCheckpointsResource,
+    CheckpointsResourceWithRawResponse,
+    AsyncCheckpointsResourceWithRawResponse,
+    CheckpointsResourceWithStreamingResponse,
+    AsyncCheckpointsResourceWithStreamingResponse,
+)
 from .deployment_history import (
     DeploymentHistoryResource,
     AsyncDeploymentHistoryResource,
@@ -114,4 +122,10 @@
     "AsyncDeploymentHistoryResourceWithRawResponse",
     "DeploymentHistoryResourceWithStreamingResponse",
     "AsyncDeploymentHistoryResourceWithStreamingResponse",
+    "CheckpointsResource",
+    "AsyncCheckpointsResource",
+    "CheckpointsResourceWithRawResponse",
+    "AsyncCheckpointsResourceWithRawResponse",
+    "CheckpointsResourceWithStreamingResponse",
+    "AsyncCheckpointsResourceWithStreamingResponse",
 ]

src/agentex/resources/agents/__init__.py

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .agents import (
+    AgentsResource,
+    AsyncAgentsResource,
+    AgentsResourceWithRawResponse,
+    AsyncAgentsResourceWithRawResponse,
+    AgentsResourceWithStreamingResponse,
+    AsyncAgentsResourceWithStreamingResponse,
+)
+from .schedules import (
+    SchedulesResource,
+    AsyncSchedulesResource,
+    SchedulesResourceWithRawResponse,
+    AsyncSchedulesResourceWithRawResponse,
+    SchedulesResourceWithStreamingResponse,
+    AsyncSchedulesResourceWithStreamingResponse,
+)
+from .deployments import (
+    DeploymentsResource,
+    AsyncDeploymentsResource,
+    DeploymentsResourceWithRawResponse,
+    AsyncDeploymentsResourceWithRawResponse,
+    DeploymentsResourceWithStreamingResponse,
+    AsyncDeploymentsResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "DeploymentsResource",
+    "AsyncDeploymentsResource",
+    "DeploymentsResourceWithRawResponse",
+    "AsyncDeploymentsResourceWithRawResponse",
+    "DeploymentsResourceWithStreamingResponse",
+    "AsyncDeploymentsResourceWithStreamingResponse",
+    "SchedulesResource",
+    "AsyncSchedulesResource",
+    "SchedulesResourceWithRawResponse",
+    "AsyncSchedulesResourceWithRawResponse",
+    "SchedulesResourceWithStreamingResponse",
+    "AsyncSchedulesResourceWithStreamingResponse",
+    "AgentsResource",
+    "AsyncAgentsResource",
+    "AgentsResourceWithRawResponse",
+    "AsyncAgentsResourceWithRawResponse",
+    "AgentsResourceWithStreamingResponse",
+    "AsyncAgentsResourceWithStreamingResponse",
+]