sandboxy 0.0.1__py3-none-any.whl

sandboxy/cli/type_detector.py

@@ -0,0 +1,48 @@
+"""YAML type detection for unified CLI dispatcher."""
+
+from typing import Any, Literal
+
+YamlType = Literal["scenario", "module"]
+
+VALID_TYPES: set[str] = {"scenario", "module"}
+
+
+def detect_yaml_type(data: dict[str, Any]) -> YamlType:
+    """Detect YAML type from structure.
+
+    Detection priority:
+    1. Explicit `type:` field
+    2. Scenario: has `goals` or `tools_from`
+    3. Module (legacy): has `environment.sandbox_type`
+
+    Args:
+        data: Parsed YAML data
+
+    Returns:
+        Detected type string
+
+    Raises:
+        ValueError: If type cannot be detected
+
+    """
+    # Explicit type field takes priority
+    if "type" in data:
+        explicit_type = data["type"]
+        if explicit_type not in VALID_TYPES:
+            raise ValueError(
+                f"Invalid type '{explicit_type}'. Valid types: {', '.join(sorted(VALID_TYPES))}"
+            )
+        return explicit_type  # type: ignore[return-value]
+
+    # Scenario: has goals or tools_from
+    if "goals" in data or "tools_from" in data:
+        return "scenario"
+
+    # Module (legacy): has environment with sandbox_type
+    if "environment" in data:
+        env = data.get("environment", {})
+        if isinstance(env, dict) and "sandbox_type" in env:
+            return "module"
+
+    # Default to scenario - the unified format handles everything
+    return "scenario"

sandboxy/config.py

@@ -0,0 +1,49 @@
+"""Centralized configuration for Sandboxy.
+
+All configuration is loaded from environment variables with SANDBOXY_ prefix.
+"""
+
+from functools import lru_cache
+from pathlib import Path
+
+from pydantic import Field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Config(BaseSettings):
+    """Application configuration from environment variables."""
+
+    model_config = SettingsConfigDict(
+        env_prefix="SANDBOXY_",
+        env_file=".env",
+        env_file_encoding="utf-8",
+        extra="ignore",
+    )
+
+    # Paths
+    modules_dir: Path = Path("modules")
+    agents_dir: Path = Path("agents")
+    tools_dir: Path = Path("tools")
+
+    # Security
+    cors_origins: list[str] = Field(default_factory=list)
+    allow_dynamic_tools: bool = True
+
+    # HTTP Client
+    http_timeout: float = 120.0
+
+    # Runtime
+    env: str = "development"
+    debug: bool = False
+    host: str = "0.0.0.0"
+    port: int = 8000
+
+
+@lru_cache(maxsize=1)
+def get_config() -> Config:
+    """Get the application configuration singleton."""
+    return Config()
+
+
+# Convenience alias
+config = get_config()

sandboxy/core/__init__.py

@@ -0,0 +1 @@
+"""Core module - MDL parser, runner, and state management."""