Skip to content

Secure, Fast, and Extensible Sandbox runtime for AI agents.

2.0 KB
Raw Blame
# Copyright 2026 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.

from __future__ import annotations

from typing import Any, Dict

POOL_CAPACITY_EXHAUSTED_REASON = "POOL_CAPACITY_EXHAUSTED"


def _normalize_create_status(status_info: Dict[str, Any]) -> Dict[str, Any]:
    if status_info.get("state") != "Allocated":
        return status_info
    return {
        **status_info,
        "state": "Running",
        "message": "Pod has IP assigned and sandbox is ready for requests",
    }


def _is_unschedulable_status(status_info: Dict[str, Any]) -> bool:
    reason = str(status_info.get("reason") or "")
    return reason == "POD_PLATFORM_UNSCHEDULABLE"


def _is_pool_capacity_exhausted_status(status_info: Dict[str, Any]) -> bool:
    reason = str(status_info.get("reason") or "")
    return reason == POOL_CAPACITY_EXHAUSTED_REASON


QUOTA_EXCEEDED_MESSAGE_MARKER = "exceeded quota"


def _is_quota_exhausted_status(status_info: Dict[str, Any]) -> bool:
    """True when the workload condition reports a quota admission rejection.

    The agent-sandbox controller surfaces K8s admission failures on the CR as
    ``Ready=False, Reason=ReconcilerError`` with the API server's message.
    Only the quota marker is matched — other ReconcilerError messages may be
    transient and must keep polling.
    """
    reason = str(status_info.get("reason") or "")
    message = str(status_info.get("message") or "")
    return (
        reason == "ReconcilerError"
        and QUOTA_EXCEEDED_MESSAGE_MARKER in message.lower()
    )