agentex-sdk 0.8.1__py3-none-any.whl → 0.9.0__py3-none-any.whl

agentex/lib/sdk/config/validation.py

@@ -4,6 +4,7 @@ Validation framework for agent configuration files.
 This module provides validation functions for agent configurations,
 with clear error messages and best practices enforcement.
 """
+
 from __future__ import annotations
 
 from typing import Any, Dict, List, Optional
@@ -17,7 +18,7 @@ logger = make_logger(__name__)
 
 class ConfigValidationError(Exception):
     """Exception raised when configuration validation fails."""
-    
+
     def __init__(self, message: str, file_path: Optional[str] = None):
         self.file_path = file_path
         super().__init__(message)
@@ -25,88 +26,95 @@ class ConfigValidationError(Exception):
 
 class EnvironmentsValidationError(ConfigValidationError):
     """Exception raised when environments.yaml validation fails."""
+
     pass
 
 
 def validate_environments_config(
-    environments_config: AgentEnvironmentsConfig, 
-    required_environments: Optional[List[str]] = None
+    environments_config: AgentEnvironmentsConfig, required_environments: Optional[List[str]] = None
 ) -> None:
     """
     Validate environments configuration with comprehensive checks.
-    
+
     Args:
         environments_config: The loaded environments configuration
         required_environments: List of environment names that must be present
-        
+
     Raises:
         EnvironmentsValidationError: If validation fails
     """
     # Check for required environments
     if required_environments:
+        # this must exist as a top-level key or via the environment indicator
         missing_envs: List[str] = []
+        environment_mappings = [env.environment for env in environments_config.environments.values() if env.environment]
+        top_level_envs = [env for env in environments_config.environments]
+        all_envs = set(environment_mappings + top_level_envs)
         for env_name in required_environments:
-            if env_name not in environments_config.environments:
+            if env_name not in all_envs:
                 missing_envs.append(env_name)
-        
+
         if missing_envs:
-            available_envs = list(environments_config.environments.keys())
             raise EnvironmentsValidationError(
                 f"Missing required environments: {', '.join(missing_envs)}. "
-                f"Available environments: {', '.join(available_envs)}"
+                f"Available environments: {', '.join(all_envs)}"
             )
-    
+
+    # if environment mappings are set, you cannot have a top-level env_name that maps to an `environment: value`
+    # and another environment that has the mapping i.e.
+    # enviorments:
+    #   dev:
+    #       ....
+    #   dev1:
+    #       environment: dev
+    # this is invalid because its unclear if "dev" refers to just that top-level environment or the mapping
+    #
     # Validate each environment configuration
     for env_name, env_config in environments_config.environments.items():
         try:
             _validate_single_environment_config(env_name, env_config)
         except Exception as e:
-            raise EnvironmentsValidationError(
-                f"Environment '{env_name}' configuration error: {str(e)}"
-            ) from e
+            raise EnvironmentsValidationError(f"Environment '{env_name}' configuration error: {str(e)}") from e
 
 
 def _validate_single_environment_config(env_name: str, env_config: AgentEnvironmentConfig) -> None:
     """
     Validate a single environment configuration.
-    
+
     Args:
         env_name: Name of the environment
         env_config: AgentEnvironmentConfig instance
-        
+
     Raises:
         ValueError: If validation fails
     """
     # Validate namespace naming conventions if kubernetes config exists
     if env_config.kubernetes and env_config.kubernetes.namespace:
         namespace = env_config.kubernetes.namespace
-        
+
         # Check for common namespace naming issues
         if namespace != namespace.lower():
             logger.warning(
-                f"Namespace '{namespace}' contains uppercase letters. "
-                "Kubernetes namespaces should be lowercase."
+                f"Namespace '{namespace}' contains uppercase letters. Kubernetes namespaces should be lowercase."
             )
-        
-        if namespace.startswith('-') or namespace.endswith('-'):
-            raise ValueError(
-                f"Namespace '{namespace}' cannot start or end with hyphens"
-            )
-    
+
+        if namespace.startswith("-") or namespace.endswith("-"):
+            raise ValueError(f"Namespace '{namespace}' cannot start or end with hyphens")
+
     # Validate auth principal
     principal = env_config.auth.principal
-    if not principal.get('user_id'):
+    if not principal.get("user_id"):
         raise ValueError("Auth principal must contain non-empty 'user_id'")
-    
+
     # Check for environment-specific user_id patterns
-    user_id = principal['user_id']
+    user_id = principal["user_id"]
     if isinstance(user_id, str):
-        if not any(env_name.lower() in user_id.lower() for env_name in ['dev', 'prod', 'staging', env_name]):
+        if not any(env_name.lower() in user_id.lower() for env_name in ["dev", "prod", "staging", env_name]):
             logger.warning(
                 f"User ID '{user_id}' doesn't contain environment indicator. "
                 f"Consider including '{env_name}' in the user_id for clarity."
             )
-    
+
     # Validate helm overrides if present
     if env_config.helm_overrides:
         _validate_helm_overrides(env_config.helm_overrides)
@@ -115,26 +123,26 @@ def _validate_single_environment_config(env_name: str, env_config: AgentEnvironm
 def _validate_helm_overrides(helm_overrides: Dict[str, Any]) -> None:
     """
     Validate helm override configuration.
-    
+
     Args:
         helm_overrides: Dictionary of helm overrides
-        
+
     Raises:
         ValueError: If validation fails
     """
     # Check for common helm override issues
-    if 'resources' in helm_overrides:
-        resources = helm_overrides['resources']
+    if "resources" in helm_overrides:
+        resources = helm_overrides["resources"]
         if isinstance(resources, dict):
             # Validate resource format
-            if 'requests' in resources or 'limits' in resources:
-                for resource_type in ['requests', 'limits']:
+            if "requests" in resources or "limits" in resources:
+                for resource_type in ["requests", "limits"]:
                     if resource_type in resources:
                         resource_config: Any = resources[resource_type]
                         if isinstance(resource_config, dict):
                             # Check for valid resource specifications
                             for key, value in resource_config.items():
-                                if key in ['cpu', 'memory'] and not isinstance(value, str):
+                                if key in ["cpu", "memory"] and not isinstance(value, str):
                                     logger.warning(
                                         f"Resource {key} should be a string (e.g., '500m', '1Gi'), "
                                         f"got {type(value).__name__}: {value}"
@@ -144,13 +152,13 @@ def _validate_helm_overrides(helm_overrides: Dict[str, Any]) -> None:
 def validate_environments_yaml_file(file_path: str) -> AgentEnvironmentsConfig:
     """
     Load and validate environments.yaml file.
-    
+
     Args:
         file_path: Path to environments.yaml file
-        
+
     Returns:
         Validated AgentEnvironmentsConfig
-        
+
     Raises:
         EnvironmentsValidationError: If file is invalid
     """
@@ -164,66 +172,59 @@ def validate_environments_yaml_file(file_path: str) -> AgentEnvironmentsConfig:
             "📋 Why required:\n"
             "   Environment-specific settings (auth, namespace, resources)\n"
             "   must be separated from global manifest for proper isolation.",
-            file_path=file_path
+            file_path=file_path,
         ) from None
     except Exception as e:
-        raise EnvironmentsValidationError(
-            f"Invalid environments.yaml file: {str(e)}",
-            file_path=file_path
-        ) from e
+        raise EnvironmentsValidationError(f"Invalid environments.yaml file: {str(e)}", file_path=file_path) from e
 
 
 def validate_manifest_and_environments(
-    manifest_path: str, 
-    required_environment: Optional[str] = None
+    manifest_path: str, required_environment: Optional[str] = None
 ) -> tuple[str, AgentEnvironmentsConfig]:
     """
     Validate both manifest.yaml and environments.yaml files together.
-    
+
     Args:
         manifest_path: Path to manifest.yaml file
         required_environment: Specific environment that must be present
-        
+
     Returns:
         Tuple of (manifest_path, environments_config)
-        
+
     Raises:
         ConfigValidationError: If validation fails
     """
     manifest_file = Path(manifest_path)
     if not manifest_file.exists():
         raise ConfigValidationError(f"Manifest file not found: {manifest_path}")
-    
+
     # Look for environments.yaml in same directory
     environments_file = manifest_file.parent / "environments.yaml"
     environments_config = validate_environments_yaml_file(str(environments_file))
-    
+
     # Validate specific environment if requested
     if required_environment:
-        validate_environments_config(
-            environments_config, 
-            required_environments=[required_environment]
-        )
-    
+        validate_environments_config(environments_config, required_environments=[required_environment])
+
     return manifest_path, environments_config
 
 
 def generate_helpful_error_message(error: Exception, context: str = "") -> str:
     """
     Generate helpful error message with troubleshooting tips.
-    
+
     Args:
         error: The original exception
         context: Additional context about where the error occurred
-        
+
     Returns:
         Formatted error message with troubleshooting tips
     """
     base_msg = str(error)
-    
+
     if context:
         base_msg = f"{context}: {base_msg}"
-    
+
     # Add troubleshooting tips based on error type
     if isinstance(error, FileNotFoundError):
         if "environments.yaml" in base_msg:
@@ -246,5 +247,5 @@ def generate_helpful_error_message(error: Exception, context: str = "") -> str:
             "- Include team and environment (e.g., 'team-dev-agent')\n"
             "- Keep under 63 characters"
         )
-    
+
     return base_msg

{agentex_sdk-0.8.1.dist-info → agentex_sdk-0.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: agentex-sdk
-Version: 0.8.1
+Version: 0.9.0
 Summary: The official Python library for the agentex API
 Project-URL: Homepage, https://github.com/scaleapi/scale-agentex-python
 Project-URL: Repository, https://github.com/scaleapi/scale-agentex-python

{agentex_sdk-0.8.1.dist-info → agentex_sdk-0.9.0.dist-info}/RECORD

@@ -1,17 +1,17 @@
 agentex/__init__.py,sha256=TvS8DtvGAnubcoUjYIsuCpBzpsdpxBaJCS76s-l-PRo,2712
-agentex/_base_client.py,sha256=bYjTh_wPlo7zWeUO4hnrh30DrWsCAAVdohUlt-zsqUg,67248
+agentex/_base_client.py,sha256=gb-HyiWzYErOgODj-HypzcOTPQnxZxCuW2wZD2wixrY,73410
 agentex/_client.py,sha256=39ydvoIqEPVYkM891ZMhCMKrbXR59QUxuKTtrTJGgMM,28482
 agentex/_compat.py,sha256=DQBVORjFb33zch24jzkhM14msvnzY7mmSmgDLaVFUM8,6562
 agentex/_constants.py,sha256=oGldMuFz7eZtwD8_6rJUippKhZB5fGSA7ffbCDGourA,466
 agentex/_exceptions.py,sha256=B09aFjWFRSShb9BFJd-MNDblsGDyGk3w-vItYmjg_AI,3222
 agentex/_files.py,sha256=KnEzGi_O756MvKyJ4fOCW_u3JhOeWPQ4RsmDvqihDQU,3545
-agentex/_models.py,sha256=3D65psj_C02Mw0K2zpBWrn1khmrvtEXgTTQ6P4r3tUY,31837
+agentex/_models.py,sha256=R3MpO2z4XhTAnD3ObEks32suRXleF1g7BEgQTOLIxTs,32112
 agentex/_qs.py,sha256=craIKyvPktJ94cvf9zn8j8ekG9dWJzhWv0ob34lIOv4,4828
 agentex/_resource.py,sha256=S1t7wmR5WUvoDIhZjo_x-E7uoTJBynJ3d8tPJMQYdjw,1106
 agentex/_response.py,sha256=Tb9zazsnemO2rTxWtBjAD5WBqlhli5ZaXGbiKgdu5DE,28794
 agentex/_streaming.py,sha256=aOvLOte7kaclPGm-D0iNdM3uRcWrZ-T2B8t9BDNmpuA,10225
-agentex/_types.py,sha256=00q2kgDxUPJC16dU-YIUeOFsN5MzNW0zjzVXMlBYGV0,7296
-agentex/_version.py,sha256=SprjymQjfV2BjyuFEaxil784EZtHqtGJvTME7Wtpx2s,159
+agentex/_types.py,sha256=fa7vkH4XTd2n7GdGxf8-i_2kMDtXgwO3X_usN1GyknI,7595
+agentex/_version.py,sha256=QknnjghXHjI-VZe2lpTxhOcs4xErxRJqPkosahapkpw,159
 agentex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agentex/_utils/__init__.py,sha256=7fch0GT9zpNnErbciSpUNa-SjTxxjY6kxHxKMOM4AGs,2305
 agentex/_utils/_compat.py,sha256=D8gtAvjJQrDWt9upS0XaG9Rr5l1QhiAx_I_1utT_tt0,1195
@@ -52,8 +52,8 @@ agentex/lib/adk/utils/_modules/client.py,sha256=UYSTThuZoX3nqF8iuRmRI8uPO00NrYgC
 agentex/lib/adk/utils/_modules/templating.py,sha256=tSiJGoDrF-XkMEi4MB_wVH6nyKyhSQwVZ8krN5R-86Q,3598
 agentex/lib/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agentex/lib/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-agentex/lib/cli/commands/agents.py,sha256=E6O7p3B3P4yX-oYWRtzfbEyI5Pws-yzFi-htYJ7B_kY,14079
-agentex/lib/cli/commands/init.py,sha256=CrKksw5l1w9hXSdDN6wPNgQlyE1k_kqHlA6QrOenqHM,15537
+agentex/lib/cli/commands/agents.py,sha256=QbqRdZEJNlbfSpQ5HrN0xfQBL6bCKD0l1PijTYSb1ak,17014
+agentex/lib/cli/commands/init.py,sha256=pf8FHuJKO1NtTNEKkpB34EcJ-V8D7TcPP_EUrgbkaZs,16041
 agentex/lib/cli/commands/main.py,sha256=QWychw-Xq3nQ00BMypgOEF4w1WauNrgQ06PDardNP_8,1042
 agentex/lib/cli/commands/secrets.py,sha256=t4zvoyjOHmw-8qp6nsxdZCvqy43QXOl0MWXA3ooBO6Q,5640
 agentex/lib/cli/commands/tasks.py,sha256=fvZJjYI8Dh-6nbTVpRa2-VdF6A8D4w3Dmd4tMslSTPI,3741
@@ -62,7 +62,7 @@ agentex/lib/cli/debug/__init__.py,sha256=-ZF2Hg8tyREDjPTefhJG_KesX4DA1gZue89pzf4
 agentex/lib/cli/debug/debug_config.py,sha256=XlMyq7jP9NPAncO9Saob1Ga7dn-6DhmJ86iKAlQC9WY,3388
 agentex/lib/cli/debug/debug_handlers.py,sha256=CZ8i5Xf50IQOeMvNfNgE5AgphkxnPo4jf2VbMt2jDEE,5690
 agentex/lib/cli/handlers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-agentex/lib/cli/handlers/agent_handlers.py,sha256=xy2kXo7poV270yFLyqXNbZ79d_sq_vl5JAs93okYMHY,5604
+agentex/lib/cli/handlers/agent_handlers.py,sha256=KwfWIwjJX1gYaddU19X-U_fIUZegAqoLDPM2FmfAIhg,9985
 agentex/lib/cli/handlers/cleanup_handlers.py,sha256=-MISeCxZ9zOcSL8gBzEHrSMwhW3cJtoXrQkGAzGeknE,7179
 agentex/lib/cli/handlers/deploy_handlers.py,sha256=DcTIi0QUaZRiJG0LcPhKfN2Jkd1aOcRhEZYk8kUQt1w,16243
 agentex/lib/cli/handlers/run_handlers.py,sha256=UFUm-vOUq2aIGUYiuAre7c73U3hd6AHrDXPA1fPmAEw,15963
@@ -89,6 +89,17 @@ agentex/lib/cli/templates/sync/pyproject.toml.j2,sha256=eyN6dYqJTFzb5WztJMxboy9W
 agentex/lib/cli/templates/sync/requirements.txt.j2,sha256=iTmO-z8qFkUa1jTctFCs0WYuq7Sqi6VNQAwATakh2fQ,94
 agentex/lib/cli/templates/sync/test_agent.py.j2,sha256=zMJMCqWcEvKUUxfXSC0GRtLveqvGTknZjZWy2-HbtNU,2049
 agentex/lib/cli/templates/sync/project/acp.py.j2,sha256=PUVXnN7IikBWYnfqLMgual-iXdl_benAjEfNcRADHBk,998
+agentex/lib/cli/templates/sync-openai-agents/.dockerignore.j2,sha256=hweGFxw5eDZYsb5EnRHpv27o9M1HF2PEWOxqsfBBcAE,320
+agentex/lib/cli/templates/sync-openai-agents/Dockerfile-uv.j2,sha256=9-xbz3mh5yGuSxtQ6FRltzY45OyUzvi1ZmlfwOioK-M,1085
+agentex/lib/cli/templates/sync-openai-agents/Dockerfile.j2,sha256=-P2CwE84h4mwO1Gnl779c4MdoOcVX8_ndpesq9M4fQQ,1093
+agentex/lib/cli/templates/sync-openai-agents/README.md.j2,sha256=_S7Ngl4qOUQHPFldLXDBvuIWPFU2-WcuxGmr5EXLX6k,8816
+agentex/lib/cli/templates/sync-openai-agents/dev.ipynb.j2,sha256=Z42iRveuI_k5LcJqWX-3H1glPtNTkxg_MKVe1lwuJos,6055
+agentex/lib/cli/templates/sync-openai-agents/environments.yaml.j2,sha256=BGprRPca_Y2sPA7kOiSK8COYp4_USoikB4cQ3wbAg94,1769
+agentex/lib/cli/templates/sync-openai-agents/manifest.yaml.j2,sha256=pvH3AmdSsp4NvOtQkGTHE9ZM5wou0j99RF5ITWK5wH8,3848
+agentex/lib/cli/templates/sync-openai-agents/pyproject.toml.j2,sha256=eyN6dYqJTFzb5WztJMxboy9Wc0XPXVnKYaF5JBxJE7o,507
+agentex/lib/cli/templates/sync-openai-agents/requirements.txt.j2,sha256=iTmO-z8qFkUa1jTctFCs0WYuq7Sqi6VNQAwATakh2fQ,94
+agentex/lib/cli/templates/sync-openai-agents/test_agent.py.j2,sha256=zMJMCqWcEvKUUxfXSC0GRtLveqvGTknZjZWy2-HbtNU,2049
+agentex/lib/cli/templates/sync-openai-agents/project/acp.py.j2,sha256=a4DFVzRnKksz3Nz0z9FvHJp1dA3kno5NSuYyKrRPQVw,4354
 agentex/lib/cli/templates/temporal/.dockerignore.j2,sha256=hweGFxw5eDZYsb5EnRHpv27o9M1HF2PEWOxqsfBBcAE,320
 agentex/lib/cli/templates/temporal/Dockerfile-uv.j2,sha256=g8zECsR9_byvlc8bPdbY4Lw97w9nlWb8edx5FPiJav0,1426
 agentex/lib/cli/templates/temporal/Dockerfile.j2,sha256=N1Z73jb8pnxsjP9zbs-tSyNHO6usVzyOdtWorbR5gVY,1434
@@ -215,10 +226,10 @@ agentex/lib/sdk/config/agent_config.py,sha256=4q1qMdE9_gBTsLB_NplY4exzUYLd8wQIyw
 agentex/lib/sdk/config/agent_manifest.py,sha256=28e2o6yDe_hQMfegMUh07w-B5Kh9WZHv0z77kJvcJFk,8626
 agentex/lib/sdk/config/build_config.py,sha256=pTgtvecHQejp4SlCvS6f6TfGnWqXFG-Ac0L8zthvyGk,1085
 agentex/lib/sdk/config/deployment_config.py,sha256=QZ8zsYt4Uchw1hCs2y9mHJ8EPVBbbOfmBktv1SC_4K4,4028
-agentex/lib/sdk/config/environment_config.py,sha256=RrQPMHNAKOuqGpXPDKoQNi50lXssLOncIYLy4iwbrxs,6790
+agentex/lib/sdk/config/environment_config.py,sha256=zI-U060RsZZf8G6AAh1Y9F0Ls2AQIy0-Jn98NQT2yP8,8904
 agentex/lib/sdk/config/local_development_config.py,sha256=Sx7Cf3bP4oVjavdqy5rx4pvLZocyS19uJcrEj_mA5Nc,1733
 agentex/lib/sdk/config/project_config.py,sha256=uMrg9BqEQFcnqdlqqSLYsaQkP1mMedhEZZMzPBSyCK0,3698
-agentex/lib/sdk/config/validation.py,sha256=ox8g2vwjYsmfNcz4G-sbPw0ccWjylJRG5bufTEPQMCk,9024
+agentex/lib/sdk/config/validation.py,sha256=yzt9n7KTwHotA-vExa_LK_D_mgq4FCDGIjHuKSgs0Ks,9319
 agentex/lib/sdk/fastacp/__init__.py,sha256=UvAdexdnfb4z0F4a2sfXROFyh9EjH89kf3AxHPybzCM,75
 agentex/lib/sdk/fastacp/fastacp.py,sha256=3aT74pFwF76VoTbQnGZsF6As42aLa2o_JrO6EP_XHQM,4591
 agentex/lib/sdk/fastacp/base/base_acp_server.py,sha256=W2rMZUC-5GLvLJsLFKZHtmyG9Uhrsgffqo9qcomThsQ,17163
@@ -351,8 +362,8 @@ agentex/types/messages/batch_update_params.py,sha256=Ug5CThbD49a8j4qucg04OdmVrp_
 agentex/types/messages/batch_update_response.py,sha256=TbSBe6SuPzjXXWSj-nRjT1JHGBooTshHQQDa1AixQA8,278
 agentex/types/shared/__init__.py,sha256=IKs-Qn5Yja0kFh1G1kDqYZo43qrOu1hSoxlPdN-85dI,149
 agentex/types/shared/delete_response.py,sha256=8qH3zvQXaOHYQSHyXi7UQxdR4miTzR7V9K4zXVsiUyk,215
-agentex_sdk-0.8.1.dist-info/METADATA,sha256=Hp1HQXnaGaB3pROJpb4izGi--8pv7doi7TBTzJddQYI,15553
-agentex_sdk-0.8.1.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-agentex_sdk-0.8.1.dist-info/entry_points.txt,sha256=V7vJuMZdF0UlvgX6KiBN7XUvq_cxF5kplcYvc1QlFaQ,62
-agentex_sdk-0.8.1.dist-info/licenses/LICENSE,sha256=Q1AOx2FtRcMlyMgQJ9eVN2WKPq2mQ33lnB4tvWxabLA,11337
-agentex_sdk-0.8.1.dist-info/RECORD,,
+agentex_sdk-0.9.0.dist-info/METADATA,sha256=fyyMd_afMH7xhLdmQ7mLlYCvFU6SiqmMrIn4dVFe9eg,15553
+agentex_sdk-0.9.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+agentex_sdk-0.9.0.dist-info/entry_points.txt,sha256=V7vJuMZdF0UlvgX6KiBN7XUvq_cxF5kplcYvc1QlFaQ,62
+agentex_sdk-0.9.0.dist-info/licenses/LICENSE,sha256=Eejl902yry8m7Bl6gRYRUObLifIrC61CmV369C6-dqQ,11337
+agentex_sdk-0.9.0.dist-info/RECORD,,

{agentex_sdk-0.8.1.dist-info → agentex_sdk-0.9.0.dist-info}/licenses/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Agentex
+   Copyright 2026 Agentex
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.