feat(blueprints): prevent deletion of blueprints with dependent snapshots

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 94
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-4f5fe47eea7a16fba1ba473532c7cb9687a113cf97e7b92bac014bca728f9505.yml
-openapi_spec_hash: ae55e0436d54e239a548e245fd19a863
-config_hash: 95facb8cef59b5a1b05763b871bf6a4b
+configured_endpoints: 97
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-4a14147d9603516ef2245584e4e44af8324cb1cbf130c3718bea39ad15b8084d.yml
+openapi_spec_hash: bfeae3e75e496683934b941a19396c4b
+config_hash: 2363f563f42501d2b1587a4f64bdccaf

api.md

@@ -4,6 +4,7 @@
 from runloop_api_client.types import (
     AfterIdle,
     AgentMountParameters,
+    AgentSource,
     CodeMountParameters,
     LaunchParameters,
     Mount,
@@ -47,6 +48,20 @@ Methods:
 - <code title="post /v1/benchmarks/runs/{id}/complete">client.benchmarks.runs.<a href="./src/runloop_api_client/resources/benchmarks/runs.py">complete</a>(id) -> <a href="./src/runloop_api_client/types/benchmark_run_view.py">BenchmarkRunView</a></code>
 - <code title="get /v1/benchmarks/runs/{id}/scenario_runs">client.benchmarks.runs.<a href="./src/runloop_api_client/resources/benchmarks/runs.py">list_scenario_runs</a>(id, \*\*<a href="src/runloop_api_client/types/benchmarks/run_list_scenario_runs_params.py">params</a>) -> <a href="./src/runloop_api_client/types/scenario_run_view.py">SyncBenchmarkRunsCursorIDPage[ScenarioRunView]</a></code>
 
+# Agents
+
+Types:
+
+```python
+from runloop_api_client.types import AgentCreateParameters, AgentListView, AgentView
+```
+
+Methods:
+
+- <code title="post /v1/agents">client.agents.<a href="./src/runloop_api_client/resources/agents.py">create</a>(\*\*<a href="src/runloop_api_client/types/agent_create_params.py">params</a>) -> <a href="./src/runloop_api_client/types/agent_view.py">AgentView</a></code>
+- <code title="get /v1/agents/{id}">client.agents.<a href="./src/runloop_api_client/resources/agents.py">retrieve</a>(id) -> <a href="./src/runloop_api_client/types/agent_view.py">AgentView</a></code>
+- <code title="get /v1/agents">client.agents.<a href="./src/runloop_api_client/resources/agents.py">list</a>(\*\*<a href="src/runloop_api_client/types/agent_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/agent_view.py">SyncAgentsCursorIDPage[AgentView]</a></code>
+
 # Blueprints
 
 Types:

src/runloop_api_client/_client.py

@@ -31,7 +31,8 @@
 )
 
 if TYPE_CHECKING:
-    from .resources import objects, secrets, devboxes, scenarios, benchmarks, blueprints, repositories
+    from .resources import agents, objects, secrets, devboxes, scenarios, benchmarks, blueprints, repositories
+    from .resources.agents import AgentsResource, AsyncAgentsResource
     from .resources.objects import ObjectsResource, AsyncObjectsResource
     from .resources.secrets import SecretsResource, AsyncSecretsResource
     from .resources.blueprints import BlueprintsResource, AsyncBlueprintsResource
@@ -106,6 +107,12 @@ def benchmarks(self) -> BenchmarksResource:
 
         return BenchmarksResource(self)
 
+    @cached_property
+    def agents(self) -> AgentsResource:
+        from .resources.agents import AgentsResource
+
+        return AgentsResource(self)
+
     @cached_property
     def blueprints(self) -> BlueprintsResource:
         from .resources.blueprints import BlueprintsResource
@@ -318,6 +325,12 @@ def benchmarks(self) -> AsyncBenchmarksResource:
 
         return AsyncBenchmarksResource(self)
 
+    @cached_property
+    def agents(self) -> AsyncAgentsResource:
+        from .resources.agents import AsyncAgentsResource
+
+        return AsyncAgentsResource(self)
+
     @cached_property
     def blueprints(self) -> AsyncBlueprintsResource:
         from .resources.blueprints import AsyncBlueprintsResource
@@ -479,6 +492,12 @@ def benchmarks(self) -> benchmarks.BenchmarksResourceWithRawResponse:
 
         return BenchmarksResourceWithRawResponse(self._client.benchmarks)
 
+    @cached_property
+    def agents(self) -> agents.AgentsResourceWithRawResponse:
+        from .resources.agents import AgentsResourceWithRawResponse
+
+        return AgentsResourceWithRawResponse(self._client.agents)
+
     @cached_property
     def blueprints(self) -> blueprints.BlueprintsResourceWithRawResponse:
         from .resources.blueprints import BlueprintsResourceWithRawResponse
@@ -528,6 +547,12 @@ def benchmarks(self) -> benchmarks.AsyncBenchmarksResourceWithRawResponse:
 
         return AsyncBenchmarksResourceWithRawResponse(self._client.benchmarks)
 
+    @cached_property
+    def agents(self) -> agents.AsyncAgentsResourceWithRawResponse:
+        from .resources.agents import AsyncAgentsResourceWithRawResponse
+
+        return AsyncAgentsResourceWithRawResponse(self._client.agents)
+
     @cached_property
     def blueprints(self) -> blueprints.AsyncBlueprintsResourceWithRawResponse:
         from .resources.blueprints import AsyncBlueprintsResourceWithRawResponse
@@ -577,6 +602,12 @@ def benchmarks(self) -> benchmarks.BenchmarksResourceWithStreamingResponse:
 
         return BenchmarksResourceWithStreamingResponse(self._client.benchmarks)
 
+    @cached_property
+    def agents(self) -> agents.AgentsResourceWithStreamingResponse:
+        from .resources.agents import AgentsResourceWithStreamingResponse
+
+        return AgentsResourceWithStreamingResponse(self._client.agents)
+
     @cached_property
     def blueprints(self) -> blueprints.BlueprintsResourceWithStreamingResponse:
         from .resources.blueprints import BlueprintsResourceWithStreamingResponse
@@ -626,6 +657,12 @@ def benchmarks(self) -> benchmarks.AsyncBenchmarksResourceWithStreamingResponse:
 
         return AsyncBenchmarksResourceWithStreamingResponse(self._client.benchmarks)
 
+    @cached_property
+    def agents(self) -> agents.AsyncAgentsResourceWithStreamingResponse:
+        from .resources.agents import AsyncAgentsResourceWithStreamingResponse
+
+        return AsyncAgentsResourceWithStreamingResponse(self._client.agents)
+
     @cached_property
     def blueprints(self) -> blueprints.AsyncBlueprintsResourceWithStreamingResponse:
         from .resources.blueprints import AsyncBlueprintsResourceWithStreamingResponse

src/runloop_api_client/pagination.py

@@ -16,6 +16,8 @@
     "AsyncDiskSnapshotsCursorIDPage",
     "SyncBenchmarksCursorIDPage",
     "AsyncBenchmarksCursorIDPage",
+    "SyncAgentsCursorIDPage",
+    "AsyncAgentsCursorIDPage",
     "SyncBenchmarkRunsCursorIDPage",
     "AsyncBenchmarkRunsCursorIDPage",
     "SyncScenariosCursorIDPage",
@@ -56,6 +58,11 @@ class BenchmarksCursorIDPageItem(Protocol):
     id: str
 
 
+@runtime_checkable
+class AgentsCursorIDPageItem(Protocol):
+    id: str
+
+
 @runtime_checkable
 class BenchmarkRunsCursorIDPageItem(Protocol):
     id: str
@@ -421,6 +428,74 @@ def next_page_info(self) -> Optional[PageInfo]:
         return PageInfo(params={"starting_after": item.id})
 
 
+class SyncAgentsCursorIDPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
+    agents: List[_T]
+    has_more: Optional[bool] = None
+    total_count: Optional[int] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        agents = self.agents
+        if not agents:
+            return []
+        return agents
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        agents = self.agents
+        if not agents:
+            return None
+
+        item = cast(Any, agents[-1])
+        if not isinstance(item, AgentsCursorIDPageItem) or item.id is None:  # pyright: ignore[reportUnnecessaryComparison]
+            # TODO emit warning log
+            return None
+
+        return PageInfo(params={"starting_after": item.id})
+
+
+class AsyncAgentsCursorIDPage(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
+    agents: List[_T]
+    has_more: Optional[bool] = None
+    total_count: Optional[int] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        agents = self.agents
+        if not agents:
+            return []
+        return agents
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        agents = self.agents
+        if not agents:
+            return None
+
+        item = cast(Any, agents[-1])
+        if not isinstance(item, AgentsCursorIDPageItem) or item.id is None:  # pyright: ignore[reportUnnecessaryComparison]
+            # TODO emit warning log
+            return None
+
+        return PageInfo(params={"starting_after": item.id})
+
+
 class SyncBenchmarkRunsCursorIDPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
     runs: List[_T]
     has_more: Optional[bool] = None

src/runloop_api_client/resources/__init__.py

@@ -1,5 +1,13 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from .agents import (
+    AgentsResource,
+    AsyncAgentsResource,
+    AgentsResourceWithRawResponse,
+    AsyncAgentsResourceWithRawResponse,
+    AgentsResourceWithStreamingResponse,
+    AsyncAgentsResourceWithStreamingResponse,
+)
 from .objects import (
     ObjectsResource,
     AsyncObjectsResource,
@@ -64,6 +72,12 @@
     "AsyncBenchmarksResourceWithRawResponse",
     "BenchmarksResourceWithStreamingResponse",
     "AsyncBenchmarksResourceWithStreamingResponse",
+    "AgentsResource",
+    "AsyncAgentsResource",
+    "AgentsResourceWithRawResponse",
+    "AsyncAgentsResourceWithRawResponse",
+    "AgentsResourceWithStreamingResponse",
+    "AsyncAgentsResourceWithStreamingResponse",
     "BlueprintsResource",
     "AsyncBlueprintsResource",
     "BlueprintsResourceWithRawResponse",