Secure, Fast, and Extensible Sandbox runtime for AI agents.
#
# Copyright 2025 The OpenSandbox Authors
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
"""
Synchronous health service adapter implementation.
"""
import logging
import httpx
from opensandbox._httpx import build_redirect_client_options
from opensandbox.adapters.converter.response_handler import handle_api_error
from opensandbox.config.connection_sync import ConnectionConfigSync
from opensandbox.internal.readiness import (
constrain_readiness_request,
is_readiness_auth_error,
)
from opensandbox.models.sandboxes import SandboxEndpoint
from opensandbox.sync.services.health import HealthSync
logger = logging.getLogger(__name__)
class HealthAdapterSync(HealthSync):
def __init__(
self, connection_config: ConnectionConfigSync, execd_endpoint: SandboxEndpoint
) -> None:
self.connection_config = connection_config
self.execd_endpoint = execd_endpoint
from opensandbox.api.execd import Client
base_url = f"{self.connection_config.protocol}://{self.execd_endpoint.endpoint}"
timeout = httpx.Timeout(self.connection_config.request_timeout.total_seconds())
headers = self.execd_endpoint.build_request_headers(self.connection_config)
self._client = Client(
base_url=base_url,
timeout=timeout,
follow_redirects=self.connection_config.follow_redirects,
)
self._httpx_client = httpx.Client(
base_url=base_url,
headers=headers,
timeout=timeout,
transport=self.connection_config.transport,
**build_redirect_client_options(
self.connection_config,
base_url,
additional_request_hooks=(constrain_readiness_request,),
),
)
self._client.set_httpx_client(self._httpx_client)
def ping(self, sandbox_id: str) -> bool:
try:
from opensandbox.api.execd.api.health import ping
response_obj = ping.sync_detailed(client=self._client)
handle_api_error(response_obj, "Ping")
return True
except Exception as e:
if is_readiness_auth_error(e):
raise
logger.debug(f"Health check failed for sandbox {sandbox_id}: {e}")
return False