agentex-sdk 0.4.0__tar.gz → 0.4.2__tar.gz

agentex_sdk-0.4.2/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.4.2"
+}

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.4.2 (2025-08-17)
+
+Full Changelog: [v0.4.1...v0.4.2](https://github.com/scaleapi/agentex-python/compare/v0.4.1...v0.4.2)
+
+## 0.4.1 (2025-08-16)
+
+Full Changelog: [v0.4.0...v0.4.1](https://github.com/scaleapi/agentex-python/compare/v0.4.0...v0.4.1)
+
 ## 0.4.0 (2025-08-15)
 
 Full Changelog: [v0.3.0...v0.4.0](https://github.com/scaleapi/agentex-python/compare/v0.3.0...v0.4.0)

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: agentex-sdk
-Version: 0.4.0
+Version: 0.4.2
 Summary: The official Python library for the agentex API
 Project-URL: Homepage, https://github.com/scaleapi/agentex-python
 Project-URL: Repository, https://github.com/scaleapi/agentex-python
@@ -31,7 +31,7 @@ Requires-Dist: jsonschema<5,>=4.23.0
 Requires-Dist: kubernetes<29.0.0,>=25.0.0
 Requires-Dist: litellm<2,>=1.66.0
 Requires-Dist: mcp[cli]>=1.4.1
-Requires-Dist: openai-agents!=0.2.3,>=0.0.7
+Requires-Dist: openai-agents==0.2.7
 Requires-Dist: openai>=1.99.9
 Requires-Dist: pydantic<3,>=2.0.0
 Requires-Dist: pytest-asyncio>=1.0.0

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/examples/tutorials/10_agentic/10_temporal/000_hello_acp/project/run_worker.py

@@ -6,7 +6,7 @@ from agentex.lib.utils.logging import make_logger
 from agentex.lib.utils.debug import setup_debug_if_enabled
 from agentex.lib.environment_variables import EnvironmentVariables
 
-from workflow import At000HelloAcpWorkflow
+from project.workflow import At000HelloAcpWorkflow
 
 
 

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/examples/tutorials/10_agentic/10_temporal/010_agent_chat/project/run_worker.py

@@ -6,7 +6,7 @@ from agentex.lib.utils.logging import make_logger
 from agentex.lib.utils.debug import setup_debug_if_enabled
 from agentex.lib.environment_variables import EnvironmentVariables
 
-from workflow import At010AgentChatWorkflow
+from project.workflow import At010AgentChatWorkflow
 
 
 

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/examples/tutorials/10_agentic/10_temporal/020_state_machine/project/run_worker.py

@@ -6,7 +6,7 @@ from agentex.lib.utils.logging import make_logger
 from agentex.lib.utils.debug import setup_debug_if_enabled
 from agentex.lib.environment_variables import EnvironmentVariables
 
-from workflow import At020StateMachineWorkflow
+from project.workflow import At020StateMachineWorkflow
 
 
 environment_variables = EnvironmentVariables.refresh()

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/examples/tutorials/10_agentic/10_temporal/020_state_machine/project/workflow.py

@@ -12,10 +12,10 @@ from agentex.types.text_content import TextContent
 from agentex.lib.environment_variables import EnvironmentVariables
 from agentex.lib.sdk.state_machine.state import State
 
-from state_machines.deep_research import DeepResearchStateMachine, DeepResearchState, DeepResearchData
-from workflows.deep_research.clarify_user_query import ClarifyUserQueryWorkflow
-from workflows.deep_research.waiting_for_user_input import WaitingForUserInputWorkflow
-from workflows.deep_research.performing_deep_research import PerformingDeepResearchWorkflow
+from project.state_machines.deep_research import DeepResearchStateMachine, DeepResearchState, DeepResearchData
+from project.workflows.deep_research.clarify_user_query import ClarifyUserQueryWorkflow
+from project.workflows.deep_research.waiting_for_user_input import WaitingForUserInputWorkflow
+from project.workflows.deep_research.performing_deep_research import PerformingDeepResearchWorkflow
 
 environment_variables = EnvironmentVariables.refresh()
 

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/examples/tutorials/10_agentic/10_temporal/020_state_machine/project/workflows/deep_research/clarify_user_query.py

@@ -6,7 +6,7 @@ from agentex.lib.sdk.state_machine.state_workflow import StateWorkflow
 from agentex.lib.types.llm_messages import LLMConfig, SystemMessage, UserMessage
 from agentex.lib.utils.logging import make_logger
 
-from state_machines.deep_research import DeepResearchData, DeepResearchState
+from project.state_machines.deep_research import DeepResearchData, DeepResearchState
 
 logger = make_logger(__name__)
 

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/examples/tutorials/10_agentic/10_temporal/020_state_machine/project/workflows/deep_research/performing_deep_research.py

@@ -10,7 +10,7 @@ from agentex.lib.sdk.state_machine.state_workflow import StateWorkflow
 from agentex.types.text_content import TextContent
 from agentex.lib.utils.logging import make_logger
 
-from state_machines.deep_research import DeepResearchData, DeepResearchState
+from project.state_machines.deep_research import DeepResearchData, DeepResearchState
 
 logger = make_logger(__name__)
 

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/examples/tutorials/10_agentic/10_temporal/020_state_machine/project/workflows/deep_research/waiting_for_user_input.py

@@ -2,7 +2,7 @@ from typing import override
 from agentex.lib.sdk.state_machine import StateWorkflow, StateMachine
 from agentex.lib.utils.logging import make_logger
 from temporalio import workflow
-from state_machines.deep_research import DeepResearchData, DeepResearchState
+from project.state_machines.deep_research import DeepResearchData, DeepResearchState
 
 logger = make_logger(__name__)
 

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentex-sdk"
-version = "0.4.0"
+version = "0.4.2"
 description = "The official Python library for the agentex API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -32,7 +32,7 @@ dependencies = [
     "jinja2>=3.1.3,<4",
     "mcp[cli]>=1.4.1",
     "scale-gp>=0.1.0a59",
-    "openai-agents>=0.0.7,!=0.2.3", # 0.2.3 bug - https://github.com/openai/openai-agents-python/issues/1276
+    "openai-agents==0.2.7", # 0.2.3 bug - https://github.com/openai/openai-agents-python/issues/1276
     "tzlocal>=5.3.1",
     "tzdata>=2025.2",
     "pytest>=8.4.0",

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/src/agentex/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "agentex"
-__version__ = "0.4.0"  # x-release-please-version
+__version__ = "0.4.2"  # x-release-please-version

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/src/agentex/lib/cli/commands/agents.py

@@ -19,6 +19,11 @@ from agentex.lib.cli.handlers.deploy_handlers import (
     InputDeployOverrides,
     deploy_agent,
 )
+from agentex.lib.sdk.config.validation import (
+    validate_manifest_and_environments, 
+    EnvironmentsValidationError,
+    generate_helpful_error_message
+)
 from agentex.lib.cli.utils.cli_utils import handle_questionary_cancellation
 from agentex.lib.cli.utils.kubectl_utils import (
     check_and_switch_cluster_context,
@@ -246,15 +251,15 @@ def deploy(
     manifest: str = typer.Option("manifest.yaml", help="Path to the manifest file"),
     namespace: str | None = typer.Option(
         None,
-        help="Kubernetes namespace to deploy to (required in non-interactive mode)",
+        help="Override Kubernetes namespace (defaults to namespace from environments.yaml)",
     ),
+    environment: str | None = typer.Option(
+        None, help="Environment name (dev, prod, etc.) - must be defined in environments.yaml. If not provided, the namespace must be set explicitly."
+    ),    
     tag: str | None = typer.Option(None, help="Override the image tag for deployment"),
     repository: str | None = typer.Option(
         None, help="Override the repository for deployment"
     ),
-    override_file: str | None = typer.Option(
-        None, help="Path to override configuration file"
-    ),
     interactive: bool = typer.Option(
         True, "--interactive/--no-interactive", help="Enable interactive prompts"
     ),
@@ -272,45 +277,49 @@ def deploy(
             console.print(f"[red]Error:[/red] Manifest file not found: {manifest}")
             raise typer.Exit(1)
 
-        # In non-interactive mode, require namespace
-        if not interactive and not namespace:
-            console.print(
-                "[red]Error:[/red] --namespace is required in non-interactive mode"
-            )
-            raise typer.Exit(1)
-
-        # Get namespace if not provided (only in interactive mode)
-        if not namespace:
-            namespace = questionary.text(
-                "Enter Kubernetes namespace:", default="default"
-            ).ask()
-            namespace = handle_questionary_cancellation(namespace, "namespace input")
-
-            if not namespace:
-                console.print("Deployment cancelled")
-                raise typer.Exit(0)
-
-        # Validate override file exists if provided
-        if override_file:
-            override_path = Path(override_file)
-            if not override_path.exists():
-                console.print(
-                    f"[red]Error:[/red] Override file not found: {override_file}"
+        # Validate manifest and environments configuration
+        try:
+            if environment:
+                _, environments_config = validate_manifest_and_environments(
+                    str(manifest_path), 
+                    required_environment=environment
                 )
-                raise typer.Exit(1)
+                agent_env_config = environments_config.get_config_for_env(environment)
+                console.print(f"[green]✓[/green] Environment config validated: {environment}")
+            else:
+                agent_env_config = None
+                console.print(f"[yellow]⚠[/yellow] No environment provided, skipping environment-specific config")
+            
+        except EnvironmentsValidationError as e:
+            error_msg = generate_helpful_error_message(e, "Environment validation failed")
+            console.print(f"[red]Configuration Error:[/red]\n{error_msg}")
+            raise typer.Exit(1)
+        except Exception as e:
+            console.print(f"[red]Error:[/red] Failed to validate configuration: {e}")
+            raise typer.Exit(1)
 
         # Load manifest for credential validation
         manifest_obj = AgentManifest.from_yaml(str(manifest_path))
 
+        # Use namespace from environment config if not overridden
+        if not namespace and agent_env_config:
+            namespace_from_config = agent_env_config.kubernetes.namespace if agent_env_config.kubernetes else None
+            if namespace_from_config:
+                console.print(f"[blue]ℹ[/blue] Using namespace from environments.yaml: {namespace_from_config}")
+                namespace = namespace_from_config
+            else:
+                raise DeploymentError(f"No namespace found in environments.yaml for environment: {environment}, and not passed in as --namespace")
+        elif not namespace:
+            raise DeploymentError("No namespace provided, and not passed in as --namespace and no environment provided to read from an environments.yaml file")
+
         # Confirm deployment (only in interactive mode)
         console.print("\n[bold]Deployment Summary:[/bold]")
         console.print(f"  Manifest: {manifest}")
+        console.print(f"  Environment: {environment}")
         console.print(f"  Cluster: {cluster}")
         console.print(f"  Namespace: {namespace}")
         if tag:
             console.print(f"  Image Tag: {tag}")
-        if override_file:
-            console.print(f"  Override File: {override_file}")
 
         if interactive:
             proceed = questionary.confirm("Proceed with deployment?").ask()
@@ -339,7 +348,7 @@ def deploy(
             cluster_name=cluster,
             namespace=namespace,
             deploy_overrides=deploy_overrides,
-            override_file_path=override_file,
+            environment_name=environment,
         )
 
         # Use the already loaded manifest object

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/src/agentex/lib/cli/commands/init.py

@@ -65,6 +65,7 @@ def create_project_structure(
         ".dockerignore.j2": ".dockerignore",
         "manifest.yaml.j2": "manifest.yaml",
         "README.md.j2": "README.md",
+        "environments.yaml.j2": "environments.yaml",
     }
 
     # Add package management file based on uv choice

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/src/agentex/lib/cli/handlers/deploy_handlers.py

@@ -8,14 +8,14 @@ import yaml
 from pydantic import BaseModel, Field
 from rich.console import Console
 
-from agentex.lib.cli.utils.auth_utils import _encode_principal_context
 from agentex.lib.cli.utils.exceptions import DeploymentError, HelmError
+from agentex.lib.sdk.config.environment_config import AgentEnvironmentConfig
 from agentex.lib.cli.utils.kubectl_utils import check_and_switch_cluster_context
 from agentex.lib.cli.utils.path_utils import calculate_docker_acp_module, PathResolutionError
 from agentex.lib.environment_variables import EnvVarKeys
 from agentex.lib.sdk.config.agent_config import AgentConfig
 from agentex.lib.sdk.config.agent_manifest import AgentManifest
-from agentex.lib.sdk.config.deployment_config import ClusterConfig
+
 from agentex.lib.utils.logging import make_logger
 
 logger = make_logger(__name__)
@@ -76,25 +76,6 @@ def add_helm_repo() -> None:
         raise HelmError(f"Failed to add helm repository: {e}") from e
 
 
-def load_override_config(override_file_path: str | None = None) -> ClusterConfig | None:
-    """Load override configuration from specified file path"""
-    if not override_file_path:
-        return None
-
-    override_path = Path(override_file_path)
-    if not override_path.exists():
-        raise DeploymentError(f"Override file not found: {override_file_path}")
-
-    try:
-        with open(override_path) as f:
-            config_data = yaml.safe_load(f)
-            return ClusterConfig(**config_data) if config_data else None
-    except Exception as e:
-        raise DeploymentError(
-            f"Failed to load override config from {override_file_path}: {e}"
-        ) from e
-
-
 
 def convert_env_vars_dict_to_list(env_vars: dict[str, str]) -> list[dict[str, str]]:
     """Convert a dictionary of environment variables to a list of dictionaries"""
@@ -116,13 +97,13 @@ def add_acp_command_to_helm_values(helm_values: dict[str, Any], manifest: AgentM
 
 def merge_deployment_configs(
     manifest: AgentManifest,
-    cluster_config: ClusterConfig | None,
+    agent_env_config: AgentEnvironmentConfig | None,
     deploy_overrides: InputDeployOverrides,
     manifest_path: str,
 ) -> dict[str, Any]:
     agent_config: AgentConfig = manifest.agent
 
-    """Merge global deployment config with cluster-specific overrides into helm values"""
+    """Merge global deployment config with environment-specific overrides into helm values"""
     if not manifest.deployment:
         raise DeploymentError("No deployment configuration found in manifest")
 
@@ -185,18 +166,27 @@ def merge_deployment_configs(
                 "taskQueue": temporal_config.queue_name,
             }
 
-    # Collect all environment variables with conflict detection
+    # Collect all environment variables with proper precedence
+    # Priority: manifest -> environments.yaml -> secrets (highest)
     all_env_vars: dict[str, str] = {}
     secret_env_vars: list[dict[str, str]] = []
     
-    # Start with agent_config env vars
+    # Start with agent_config env vars from manifest
     if agent_config.env:
         all_env_vars.update(agent_config.env)
+    
+    # Override with environment config env vars if they exist
+    if agent_env_config and agent_env_config.helm_overrides and "env" in agent_env_config.helm_overrides:
+        env_overrides = agent_env_config.helm_overrides["env"]
+        if isinstance(env_overrides, list):
+            # Convert list format to dict for easier merging
+            env_override_dict: dict[str, str] = {}
+            for env_var in env_overrides:
+                if isinstance(env_var, dict) and "name" in env_var and "value" in env_var:
+                    env_override_dict[str(env_var["name"])] = str(env_var["value"])
+            all_env_vars.update(env_override_dict)
+
 
-    # Add auth principal env var if manifest principal is set
-    encoded_principal = _encode_principal_context(manifest)
-    if encoded_principal:
-        all_env_vars[EnvVarKeys.AUTH_PRINCIPAL_B64.value] = encoded_principal
 
     # Handle credentials and check for conflicts
     if agent_config.credentials:
@@ -228,57 +218,23 @@ def merge_deployment_configs(
                 }
             )
 
-    # Apply cluster-specific overrides
-    if cluster_config:
-        if cluster_config.image:
-            if cluster_config.image.repository:
-                helm_values["global"]["image"]["repository"] = (
-                    cluster_config.image.repository
-                )
-            if cluster_config.image.tag:
-                helm_values["global"]["image"]["tag"] = cluster_config.image.tag
-
-        if cluster_config.replicaCount is not None:
-            helm_values["replicaCount"] = cluster_config.replicaCount
-
-        if cluster_config.resources:
-            if cluster_config.resources.requests:
-                helm_values["resources"]["requests"].update(
-                    {
-                        "cpu": cluster_config.resources.requests.cpu,
-                        "memory": cluster_config.resources.requests.memory,
-                    }
-                )
-            if cluster_config.resources.limits:
-                helm_values["resources"]["limits"].update(
-                    {
-                        "cpu": cluster_config.resources.limits.cpu,
-                        "memory": cluster_config.resources.limits.memory,
-                    }
-                )
-
-        # Handle cluster env vars with conflict detection
-        if cluster_config.env:
-            # Convert cluster env list to dict for easier conflict detection
-            cluster_env_dict = {env_var["name"]: env_var["value"] for env_var in cluster_config.env}
-            
-            # Check for conflicts with secret env vars
-            for secret_env_var in secret_env_vars:
-                if secret_env_var["name"] in cluster_env_dict:
-                    logger.warning(
-                        f"Environment variable '{secret_env_var['name']}' is defined in both "
-                        f"cluster config env and secretEnvVars. The secret value will take precedence."
-                    )
-                    del cluster_env_dict[secret_env_var["name"]]
-            
-            # Update all_env_vars with cluster overrides
-            all_env_vars.update(cluster_env_dict)
-
-        # Apply additional arbitrary overrides
-        if cluster_config.additional_overrides:
-            _deep_merge(helm_values, cluster_config.additional_overrides)
+    # Apply agent environment configuration overrides
+    if agent_env_config:
+        # Add auth principal env var if environment config is set
+        if agent_env_config.auth:
+            from agentex.lib.cli.utils.auth_utils import _encode_principal_context_from_env_config
+            encoded_principal = _encode_principal_context_from_env_config(agent_env_config.auth)
+            logger.info(f"Encoding auth principal from {agent_env_config.auth}")
+            if encoded_principal:
+                all_env_vars[EnvVarKeys.AUTH_PRINCIPAL_B64.value] = encoded_principal
+            else:
+                raise DeploymentError(f"Auth principal unable to be encoded for agent_env_config: {agent_env_config}")
+                
+        if agent_env_config.helm_overrides:
+            _deep_merge(helm_values, agent_env_config.helm_overrides)
 
     # Set final environment variables
+    # Environment variable precedence: manifest -> environments.yaml -> secrets (highest)
     if all_env_vars:
         helm_values["env"] = convert_env_vars_dict_to_list(all_env_vars)
     
@@ -295,7 +251,7 @@ def merge_deployment_configs(
     # Handle image pull secrets
     if manifest.deployment and manifest.deployment.imagePullSecrets:
         pull_secrets = [
-            pull_secret.to_dict()
+            pull_secret.model_dump()
             for pull_secret in manifest.deployment.imagePullSecrets
         ]
         helm_values["global"]["imagePullSecrets"] = pull_secrets
@@ -333,7 +289,7 @@ def deploy_agent(
     cluster_name: str,
     namespace: str,
     deploy_overrides: InputDeployOverrides,
-    override_file_path: str | None = None,
+    environment_name: str | None = None,
 ) -> None:
     """Deploy an agent using helm"""
 
@@ -345,21 +301,23 @@ def deploy_agent(
     check_and_switch_cluster_context(cluster_name)
 
     manifest = AgentManifest.from_yaml(file_path=manifest_path)
-    override_config = load_override_config(override_file_path)
 
-    # Provide feedback about override configuration
-    if override_config:
-        console.print(f"[green]✓[/green] Using override config: {override_file_path}")
-    else:
-        console.print(
-            "[yellow]ℹ[/yellow] No override config specified, using global defaults"
-        )
+    # Load agent environment configuration
+    agent_env_config = None
+    if environment_name:
+        manifest_dir = Path(manifest_path).parent
+        environments_config = manifest.load_environments_config(manifest_dir)
+        if environments_config:
+            agent_env_config = environments_config.get_config_for_env(environment_name)
+            console.print(f"[green]✓[/green] Using environment config: {environment_name}")
+        else:
+            console.print(f"[yellow]⚠[/yellow] No environments.yaml found, skipping environment-specific config")
 
     # Add helm repository/update
     add_helm_repo()
 
     # Merge configurations
-    helm_values = merge_deployment_configs(manifest, override_config, deploy_overrides, manifest_path)
+    helm_values = merge_deployment_configs(manifest, agent_env_config, deploy_overrides, manifest_path)
 
     # Create values file
     values_file = create_helm_values_file(helm_values)

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/src/agentex/lib/cli/handlers/run_handlers.py

@@ -6,7 +6,6 @@ from pathlib import Path
 from rich.console import Console
 from rich.panel import Panel
 
-from agentex.lib.cli.utils.auth_utils import _encode_principal_context
 from agentex.lib.cli.handlers.cleanup_handlers import (
     cleanup_agent_workflows,
     should_cleanup_on_restart
@@ -89,14 +88,13 @@ async def start_temporal_worker_with_reload(
     worker_path: Path, env: dict[str, str], process_manager: ProcessManager, manifest_dir: Path
 ) -> asyncio.Task[None]:
     """Start temporal worker with auto-reload using watchfiles"""
-    
     try:
         from watchfiles import awatch
     except ImportError:
         console.print("[yellow]watchfiles not installed, falling back to basic worker start[/yellow]")
         console.print("[dim]Install with: pip install watchfiles[/dim]")
         # Fallback to regular worker without reload
-        worker_process = await start_temporal_worker(worker_path, env)
+        worker_process = await start_temporal_worker(worker_path, env, manifest_dir)
         process_manager.add_process(worker_process)
         return asyncio.create_task(stream_process_output(worker_process, "WORKER"))
     
@@ -114,6 +112,7 @@ async def start_temporal_worker_with_reload(
                 # Extract agent name from worker path for cleanup
 
                 agent_name = env.get("AGENT_NAME")
+                console.print(f"FOUND AGENT_NAME FROM ENV VARS: {agent_name} {agent_name is None}")
                 if agent_name is None:
                     agent_name = worker_path.parent.parent.name
                 
@@ -150,12 +149,12 @@ async def start_temporal_worker_with_reload(
         
         try:
             # Start initial worker
-            await start_worker()
+            current_process = await start_worker()
             if current_process:
                 output_task = asyncio.create_task(stream_process_output(current_process, "WORKER"))
             
             # Watch for file changes
-            async for changes in awatch(worker_path.parent):
+            async for changes in awatch(manifest_dir, recursive=True):
                 # Filter for Python files
                 py_changes = [(change, path) for change, path in changes if str(path).endswith('.py')]
                 
@@ -225,7 +224,9 @@ async def start_temporal_worker(
     worker_path: Path, env: dict[str, str], manifest_dir: Path
 ) -> asyncio.subprocess.Process:
     """Start the temporal worker process"""
-    cmd = [sys.executable, "-m", "run_worker"]
+    run_worker_target = calculate_uvicorn_target_for_local(worker_path, manifest_dir)
+
+    cmd = [sys.executable, "-m", run_worker_target]
 
     console.print(f"[blue]Starting Temporal worker from {worker_path}...[/blue]")
 
@@ -372,10 +373,13 @@ def create_agent_environment(manifest: AgentManifest) -> dict[str, str]:
         "ACP_PORT": str(manifest.local_development.agent.port),
     }
 
-    # Add authorization principal if set
+    # Add authorization principal if set - for local development, auth is optional
+    from agentex.lib.cli.utils.auth_utils import _encode_principal_context
     encoded_principal = _encode_principal_context(manifest)
     if encoded_principal:
         env_vars[EnvVarKeys.AUTH_PRINCIPAL_B64] = encoded_principal
+    else:
+        logger.info("No auth principal configured - agent will run without authentication context")
 
     # Add description if available
     if manifest.agent.description:

agentex_sdk-0.4.2/src/agentex/lib/cli/templates/default/environments.yaml.j2

@@ -0,0 +1,57 @@
+# Agent Environment Configuration
+# ------------------------------
+# This file defines environment-specific settings for your agent.
+# This DIFFERS from the manifest.yaml file in that it is used to program things that are ONLY per environment.
+
+# ********** EXAMPLE **********
+# schema_version: "v1" # This is used to validate the file structure and is not used by the agentex CLI
+# environments:
+#   dev:
+#     auth:
+#       principal:
+#         user_id: "1234567890"
+#         user_name: "John Doe"
+#         user_email: "john.doe@example.com"
+#         user_role: "admin"
+#       user_permissions: "read, write, delete"
+#     helm_overrides: # This is used to override the global helm values.yaml file in the agentex-agent helm charts
+#       replicas: 3
+#       resources:
+#         requests:
+#           cpu: "1000m"
+#           memory: "2Gi"
+#         limits:
+#           cpu: "2000m"
+#           memory: "4Gi"
+#       env:
+#         - name: LOG_LEVEL
+#           value: "DEBUG"
+#         - name: ENVIRONMENT
+#           value: "staging"
+#
+#     kubernetes: 
+#       # OPTIONAL - Otherwise it will be derived from separately. However, this can be used to override the derived
+#       #   namespace and deploy it with in the same namespace that already exists for a separate agent.
+#       namespace: "team-{{agent_name}}"
+# ********** END EXAMPLE **********
+
+schema_version: "v1" # This is used to validate the file structure and is not used by the agentex CLI
+environments:
+  dev:
+    auth:
+      principal:
+        user_id: # TODO: Fill in
+        account_id: # TODO: Fill in
+    helm_overrides:
+      replicaCount: 2
+      resources:
+        requests:
+          cpu: "500m"
+          memory: "1Gi"
+        limits:
+          cpu: "1000m"
+          memory: "2Gi"
+      temporal:
+        enabled: false
+          
+

{agentex_sdk-0.4.0 → agentex_sdk-0.4.2}/src/agentex/lib/cli/templates/default/manifest.yaml.j2

@@ -75,6 +75,10 @@ agent:
   # Optional: Credentials mapping
   # Maps Kubernetes secrets to environment variables
   # Common credentials include:
+  credentials:
+    - env_var_name: REDIS_URL
+      secret_name: redis-url-secret
+      secret_key: url
   # credentials:
   #   - env_var_name: OPENAI_API_KEY
   #     secret_name: openai-api-key