agentkernel-sdk 0.20.0__tar.gz → 0.21.0__tar.gz

{agentkernel_sdk-0.20.0 → agentkernel_sdk-0.21.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agentkernel-sdk
-Version: 0.20.0
+Version: 0.21.0
 Summary: Python SDK for agentkernel — run AI coding agents in secure, isolated microVMs
 Project-URL: Homepage, https://github.com/thrashr888/agentkernel
 Project-URL: Repository, https://github.com/thrashr888/agentkernel/tree/main/sdk/python

{agentkernel_sdk-0.20.0 → agentkernel_sdk-0.21.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentkernel-sdk"
-version = "0.20.0"
+version = "0.21.0"
 description = "Python SDK for agentkernel — run AI coding agents in secure, isolated microVMs"
 readme = "README.md"
 license = "MIT"

{agentkernel_sdk-0.20.0 → agentkernel_sdk-0.21.0}/src/agentkernel/__init__.py

@@ -23,6 +23,9 @@ from .errors import (
 )
 from .types import (
     AriaSnapshot,
+    BackendCapabilities,
+    BackendDescriptor,
+    BackendDiscovery,
     BatchCommand,
     BatchFileWriteResponse,
     BatchResult,
@@ -56,6 +59,9 @@ from .types import (
 
 __all__ = [
     "AgentKernel",
+    "BackendCapabilities",
+    "BackendDescriptor",
+    "BackendDiscovery",
     "AsyncAgentKernel",
     "SandboxSession",
     "AsyncSandboxSession",

{agentkernel_sdk-0.20.0 → agentkernel_sdk-0.21.0}/src/agentkernel/async_client.py

@@ -14,6 +14,7 @@ if TYPE_CHECKING:
 from ._config import resolve_config
 from .errors import AgentKernelError, NetworkError, error_from_status
 from .types import (
+    BackendDiscovery,
     BatchFileWriteResponse,
     BatchRunResponse,
     DetachedCommand,
@@ -34,7 +35,7 @@ from .types import (
     StreamEvent,
 )
 
-SDK_VERSION = "0.3.0"
+SDK_VERSION = "0.21.0"
 
 
 class AsyncSandboxSession:
@@ -181,6 +182,10 @@ class AsyncAgentKernel:
         data = await self._request("GET", "/sandboxes")
         return [SandboxInfo(**s) for s in data]
 
+    async def get_backends(self) -> BackendDiscovery:
+        """Discover server-supported and ready sandbox backends."""
+        return BackendDiscovery(**await self._request("GET", "/backends"))
+
     async def create_sandbox(
         self,
         name: str,
@@ -189,6 +194,7 @@ class AsyncAgentKernel:
         vcpus: int | None = None,
         memory_mb: int | None = None,
         profile: SecurityProfile | None = None,
+        backend: str | None = None,
         source_url: str | None = None,
         source_ref: str | None = None,
         volumes: list[str] | None = None,
@@ -199,6 +205,7 @@ class AsyncAgentKernel:
             "/sandboxes",
             json={
                 "name": name,
+                "backend": backend,
                 "image": image,
                 "vcpus": vcpus,
                 "memory_mb": memory_mb,

{agentkernel_sdk-0.20.0 → agentkernel_sdk-0.21.0}/src/agentkernel/client.py

@@ -13,6 +13,7 @@ if TYPE_CHECKING:
 from ._config import resolve_config
 from .errors import AgentKernelError, NetworkError, error_from_status
 from .types import (
+    BackendDiscovery,
     BatchFileWriteResponse,
     BatchRunResponse,
     DetachedCommand,
@@ -33,7 +34,7 @@ from .types import (
     StreamEvent,
 )
 
-SDK_VERSION = "0.3.0"
+SDK_VERSION = "0.21.0"
 
 
 class SandboxSession:
@@ -167,6 +168,10 @@ class AgentKernel:
         data = self._request("GET", "/sandboxes")
         return [SandboxInfo(**s) for s in data]
 
+    def get_backends(self) -> BackendDiscovery:
+        """Discover server-supported and ready sandbox backends."""
+        return BackendDiscovery(**self._request("GET", "/backends"))
+
     def create_sandbox(
         self,
         name: str,
@@ -175,6 +180,7 @@ class AgentKernel:
         vcpus: int | None = None,
         memory_mb: int | None = None,
         profile: SecurityProfile | None = None,
+        backend: str | None = None,
         source_url: str | None = None,
         source_ref: str | None = None,
         volumes: list[str] | None = None,
@@ -184,6 +190,7 @@ class AgentKernel:
         """Create a new sandbox."""
         body = {
             "name": name,
+            "backend": backend,
             "image": image,
             "vcpus": vcpus,
             "memory_mb": memory_mb,

{agentkernel_sdk-0.20.0 → agentkernel_sdk-0.21.0}/src/agentkernel/types.py

@@ -7,7 +7,7 @@ from typing import Any, Literal
 from pydantic import BaseModel
 
 SecurityProfile = Literal["permissive", "moderate", "restrictive"]
-SandboxStatus = Literal["running", "stopped"]
+SandboxStatus = Literal["running", "paused", "stopped", "dormant", "archived"]
 StreamEventType = Literal["started", "progress", "output", "done", "error"]
 
 
@@ -30,6 +30,34 @@ class SandboxInfo(BaseModel):
     created_at: str | None = None
 
 
+class BackendCapabilities(BaseModel):
+    mount_cwd: bool
+    mount_home: bool
+    attach: bool
+    host_volumes: bool
+    ssh: bool
+    proxy_secret_bindings: bool
+    secret_files: bool
+    snapshots: bool
+    resume: bool
+    full_state_pause_resume: bool
+    full_state_fork: bool
+    endpoints: bool
+
+
+class BackendDescriptor(BaseModel):
+    backend: str
+    configured: bool
+    usable: bool
+    readiness_reason: str
+    capabilities: BackendCapabilities
+
+
+class BackendDiscovery(BaseModel):
+    default_backend: str | None = None
+    backends: list[BackendDescriptor]
+
+
 class RunOptions(BaseModel):
     """Options for the run command."""
 
@@ -41,6 +69,8 @@ class RunOptions(BaseModel):
 class CreateSandboxOptions(BaseModel):
     """Options for creating a sandbox."""
 
+    backend: str | None = None
+
     image: str | None = None
     vcpus: int | None = None
     memory_mb: int | None = None

{agentkernel_sdk-0.20.0 → agentkernel_sdk-0.21.0}/tests/test_client.py

@@ -61,13 +61,15 @@ class TestListSandboxes:
                 "data": [
                     {"name": "sb-1", "status": "running", "backend": "docker"},
                     {"name": "sb-2", "status": "stopped", "backend": "docker"},
+                    {"name": "sb-3", "status": "paused", "backend": "firecracker"},
                 ],
             }
         )
         result = make_client().list_sandboxes()
-        assert len(result) == 2
+        assert len(result) == 3
         assert all(isinstance(s, SandboxInfo) for s in result)
         assert result[0].name == "sb-1"
+        assert result[2].status == "paused"
 
 
 class TestCreateSandbox:

{agentkernel_sdk-0.20.0 → agentkernel_sdk-0.21.0}/uv.lock

@@ -8,7 +8,7 @@ resolution-markers = [
 
 [[package]]
 name = "agentkernel-sdk"
-version = "0.3.0"
+version = "0.21.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },