agentex-sdk 0.2.6__py3-none-any.whl → 0.2.7__py3-none-any.whl

agentex/_version.py

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

agentex/lib/adk/utils/_modules/client.py

@@ -8,17 +8,18 @@ logger = make_logger(__name__)
 
 
 class EnvAuth(httpx.Auth):
-    def __init__(self, header_name="x-agent-identity"):
+    def __init__(self, header_name="x-agent-api-key"):
         self.header_name = header_name
 
     def auth_flow(self, request):
         # This gets called for every request
         env_vars = EnvironmentVariables.refresh()
         if env_vars:
-            agent_id = env_vars.AGENT_ID
-            if agent_id:
-                request.headers[self.header_name] = agent_id
-                logger.info(f"Adding header {self.header_name}:{agent_id}")
+            agent_api_key = env_vars.AGENT_API_KEY  
+            if agent_api_key:
+                request.headers[self.header_name] = agent_api_key
+                masked_key = agent_api_key[-4:] if agent_api_key and len(agent_api_key) > 4 else "****"
+                logger.info(f"Adding header {self.header_name}:{masked_key}")
         yield request
 
 

agentex/lib/cli/commands/agents.py

@@ -11,6 +11,7 @@ from agentex.lib.cli.handlers.agent_handlers import (
     build_agent,
     run_agent,
 )
+from agentex.lib.cli.debug import DebugConfig, DebugMode
 from agentex.lib.cli.handlers.cleanup_handlers import cleanup_agent_workflows
 from agentex.lib.cli.handlers.deploy_handlers import (
     DeploymentError,
@@ -171,7 +172,13 @@ def run(
         False, 
         help="Clean up existing workflows for this agent before starting"
     ),
-):
+    # Debug options
+    debug: bool = typer.Option(False, help="Enable debug mode for both worker and ACP (disables auto-reload)"),
+    debug_worker: bool = typer.Option(False, help="Enable debug mode for temporal worker only"),
+    debug_acp: bool = typer.Option(False, help="Enable debug mode for ACP server only"),
+    debug_port: int = typer.Option(5678, help="Port for remote debugging (worker uses this, ACP uses port+1)"),
+    wait_for_debugger: bool = typer.Option(False, help="Wait for debugger to attach before starting"),
+) -> None:
     """
     Run an agent locally from the given manifest.
     """
@@ -196,8 +203,35 @@ def run(
             console.print(f"[yellow]⚠ Pre-run cleanup failed: {str(e)}[/yellow]")
             logger.warning(f"Pre-run cleanup failed: {e}")
     
+    # Create debug configuration based on CLI flags
+    debug_config = None
+    if debug or debug_worker or debug_acp:
+        # Determine debug mode
+        if debug:
+            mode = DebugMode.BOTH
+        elif debug_worker and debug_acp:
+            mode = DebugMode.BOTH
+        elif debug_worker:
+            mode = DebugMode.WORKER
+        elif debug_acp:
+            mode = DebugMode.ACP
+        else:
+            mode = DebugMode.NONE
+        
+        debug_config = DebugConfig(
+            enabled=True,
+            mode=mode,
+            port=debug_port,
+            wait_for_attach=wait_for_debugger,
+            auto_port=False  # Use fixed port to match VS Code launch.json
+        )
+        
+        console.print(f"[blue]🐛 Debug mode enabled: {mode.value}[/blue]")
+        if wait_for_debugger:
+            console.print("[yellow]⏳ Processes will wait for debugger attachment[/yellow]")
+    
     try:
-        run_agent(manifest_path=manifest)
+        run_agent(manifest_path=manifest, debug_config=debug_config)
     except Exception as e:
         typer.echo(f"Error running agent: {str(e)}", err=True)
         logger.exception("Error running agent")

agentex/lib/cli/debug/__init__.py

@@ -0,0 +1,15 @@
+"""
+Debug functionality for AgentEx CLI
+
+Provides debug support for temporal workers and ACP servers during local development.
+"""
+
+from .debug_config import DebugConfig, DebugMode
+from .debug_handlers import start_acp_server_debug, start_temporal_worker_debug
+
+__all__ = [
+    "DebugConfig",
+    "DebugMode", 
+    "start_acp_server_debug",
+    "start_temporal_worker_debug",
+] 

agentex/lib/cli/debug/debug_config.py

@@ -0,0 +1,116 @@
+"""
+Debug configuration models for AgentEx CLI debugging.
+"""
+
+import socket
+from enum import Enum
+from typing import Optional
+
+from agentex.lib.utils.model_utils import BaseModel
+
+
+class DebugMode(str, Enum):
+    """Debug mode options"""
+    WORKER = "worker"
+    ACP = "acp"
+    BOTH = "both"
+    NONE = "none"
+
+
+class DebugConfig(BaseModel):
+    """Configuration for debug mode"""
+    
+    enabled: bool = False
+    mode: DebugMode = DebugMode.NONE
+    port: int = 5678
+    wait_for_attach: bool = False
+    auto_port: bool = True  # Automatically find available port if specified port is busy
+    
+    @classmethod
+    def create_worker_debug(
+        cls, 
+        port: int = 5678, 
+        wait_for_attach: bool = False,
+        auto_port: bool = True
+    ) -> "DebugConfig":
+        """Create debug config for worker debugging"""
+        return cls(
+            enabled=True,
+            mode=DebugMode.WORKER,
+            port=port,
+            wait_for_attach=wait_for_attach,
+            auto_port=auto_port
+        )
+    
+    @classmethod
+    def create_acp_debug(
+        cls, 
+        port: int = 5679, 
+        wait_for_attach: bool = False,
+        auto_port: bool = True
+    ) -> "DebugConfig":
+        """Create debug config for ACP debugging"""
+        return cls(
+            enabled=True,
+            mode=DebugMode.ACP,
+            port=port,
+            wait_for_attach=wait_for_attach,
+            auto_port=auto_port
+        )
+    
+    @classmethod
+    def create_both_debug(
+        cls, 
+        worker_port: int = 5678,
+        acp_port: int = 5679,
+        wait_for_attach: bool = False,
+        auto_port: bool = True
+    ) -> "DebugConfig":
+        """Create debug config for both worker and ACP debugging"""
+        return cls(
+            enabled=True,
+            mode=DebugMode.BOTH,
+            port=worker_port,  # Primary port for worker
+            wait_for_attach=wait_for_attach,
+            auto_port=auto_port
+        )
+    
+    def should_debug_worker(self) -> bool:
+        """Check if worker should be debugged"""
+        return self.enabled and self.mode in (DebugMode.WORKER, DebugMode.BOTH)
+    
+    def should_debug_acp(self) -> bool:
+        """Check if ACP should be debugged"""
+        return self.enabled and self.mode in (DebugMode.ACP, DebugMode.BOTH)
+    
+    def get_worker_port(self) -> int:
+        """Get port for worker debugging"""
+        return self.port
+    
+    def get_acp_port(self) -> int:
+        """Get port for ACP debugging"""
+        if self.mode == DebugMode.BOTH:
+            return self.port + 1  # Use port + 1 for ACP when debugging both
+        return self.port
+
+
+def find_available_port(start_port: int = 5678, max_attempts: int = 10) -> int:
+    """Find an available port starting from start_port"""
+    for port in range(start_port, start_port + max_attempts):
+        try:
+            with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+                s.bind(('localhost', port))
+                return port
+        except OSError:
+            continue
+    
+    # If we can't find an available port, just return the start port
+    # and let the debug server handle the error
+    return start_port
+
+
+def resolve_debug_port(config: DebugConfig, target_port: int) -> int:
+    """Resolve the actual port to use for debugging"""
+    if config.auto_port:
+        return find_available_port(target_port)
+    return target_port 

agentex/lib/cli/debug/debug_handlers.py

@@ -0,0 +1,174 @@
+"""
+Debug process handlers for AgentEx CLI.
+
+Provides debug-enabled versions of ACP server and temporal worker startup.
+"""
+
+import asyncio
+import sys
+from pathlib import Path
+from typing import Dict, TYPE_CHECKING
+
+from rich.console import Console
+
+if TYPE_CHECKING:
+    import asyncio.subprocess
+
+from .debug_config import DebugConfig, resolve_debug_port
+from agentex.lib.utils.logging import make_logger
+
+logger = make_logger(__name__)
+console = Console()
+
+
+async def start_temporal_worker_debug(
+    worker_path: Path, 
+    env: Dict[str, str], 
+    debug_config: DebugConfig
+):
+    """Start temporal worker with debug support"""
+    
+    if not debug_config.should_debug_worker():
+        raise ValueError("Debug config is not configured for worker debugging")
+    
+    # Resolve the actual debug port
+    debug_port = resolve_debug_port(debug_config, debug_config.get_worker_port())
+    
+    # Add debug environment variables
+    debug_env = env.copy()
+    debug_env.update({
+        "AGENTEX_DEBUG_ENABLED": "true",
+        "AGENTEX_DEBUG_PORT": str(debug_port),
+        "AGENTEX_DEBUG_WAIT_FOR_ATTACH": str(debug_config.wait_for_attach).lower(),
+        "AGENTEX_DEBUG_TYPE": "worker"
+    })
+    
+    # Start the worker process
+    # For debugging, use absolute path to run_worker.py to run from workspace root
+    worker_script = worker_path.parent / "run_worker.py"
+    cmd = [sys.executable, str(worker_script)]
+    
+    console.print(f"[blue]🐛 Starting Temporal worker in debug mode[/blue]")
+    console.print(f"[yellow]📡 Debug server will listen on port {debug_port}[/yellow]")
+    console.print(f"[green]✓ VS Code should connect to: localhost:{debug_port}[/green]")
+    
+    if debug_config.wait_for_attach:
+        console.print(f"[yellow]⏳ Worker will wait for debugger to attach[/yellow]")
+    
+    console.print(f"[dim]💡 In your IDE: Attach to localhost:{debug_port}[/dim]")
+    console.print(f"[dim]🔧 If connection fails, check that VS Code launch.json uses port {debug_port}[/dim]")
+    
+    return await asyncio.create_subprocess_exec(
+        *cmd,
+        cwd=Path.cwd(),  # Run from current working directory (workspace root)
+        env=debug_env,
+        stdout=asyncio.subprocess.PIPE,
+        stderr=asyncio.subprocess.STDOUT,
+    )
+
+
+async def start_acp_server_debug(
+    acp_path: Path, 
+    port: int, 
+    env: Dict[str, str],
+    debug_config: DebugConfig
+):
+    """Start ACP server with debug support"""
+    
+    if not debug_config.should_debug_acp():
+        raise ValueError("Debug config is not configured for ACP debugging")
+    
+    # Resolve the actual debug port
+    debug_port = resolve_debug_port(debug_config, debug_config.get_acp_port())
+    
+    # Add debug environment variables
+    debug_env = env.copy()
+    debug_env.update({
+        "AGENTEX_DEBUG_ENABLED": "true",
+        "AGENTEX_DEBUG_PORT": str(debug_port),
+        "AGENTEX_DEBUG_WAIT_FOR_ATTACH": str(debug_config.wait_for_attach).lower(),
+        "AGENTEX_DEBUG_TYPE": "acp"
+    })
+    
+    # Disable uvicorn auto-reload in debug mode to prevent conflicts
+    cmd = [
+        sys.executable,
+        "-m",
+        "uvicorn",
+        f"{acp_path.parent.name}.acp:acp",
+        "--port",
+        str(port),
+        "--host",
+        "0.0.0.0",
+        # Note: No --reload flag when debugging
+    ]
+
+    console.print(f"[blue]🐛 Starting ACP server in debug mode[/blue]")
+    console.print(f"[yellow]📡 Debug server will listen on port {debug_port}[/yellow]")
+    
+    if debug_config.wait_for_attach:
+        console.print(f"[yellow]⏳ ACP server will wait for debugger to attach[/yellow]")
+        
+    console.print(f"[dim]💡 In your IDE: Attach to localhost:{debug_port}[/dim]")
+
+    return await asyncio.create_subprocess_exec(
+        *cmd,
+        cwd=acp_path.parent.parent,
+        env=debug_env,
+        stdout=asyncio.subprocess.PIPE,
+        stderr=asyncio.subprocess.STDOUT,
+    )
+
+
+def create_debug_startup_script() -> str:
+    """Create a Python script snippet for debug initialization"""
+    return '''
+import os
+import sys
+
+# Debug initialization for AgentEx
+if os.getenv("AGENTEX_DEBUG_ENABLED") == "true":
+    try:
+        import debugpy
+        debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "5678"))
+        debug_type = os.getenv("AGENTEX_DEBUG_TYPE", "unknown")
+        wait_for_attach = os.getenv("AGENTEX_DEBUG_WAIT_FOR_ATTACH", "false").lower() == "true"
+        
+        # Configure debugpy
+        debugpy.configure(subProcess=False)
+        debugpy.listen(debug_port)
+        
+        print(f"🐛 [{debug_type.upper()}] Debug server listening on port {debug_port}")
+        
+        if wait_for_attach:
+            print(f"⏳ [{debug_type.upper()}] Waiting for debugger to attach...")
+            debugpy.wait_for_client()
+            print(f"✅ [{debug_type.upper()}] Debugger attached!")
+        else:
+            print(f"📡 [{debug_type.upper()}] Ready for debugger attachment")
+            
+    except ImportError:
+        print("❌ debugpy not available. Install with: pip install debugpy")
+        sys.exit(1)
+    except Exception as e:
+        print(f"❌ Debug setup failed: {e}")
+        sys.exit(1)
+'''
+
+
+def inject_debug_code_to_worker_template() -> str:
+    """Generate debug code to inject into worker template"""
+    return """
+# === DEBUG SETUP (Auto-generated by AgentEx CLI) ===
+""" + create_debug_startup_script() + """
+# === END DEBUG SETUP ===
+"""
+
+
+def inject_debug_code_to_acp_template() -> str:
+    """Generate debug code to inject into ACP template"""
+    return """
+# === DEBUG SETUP (Auto-generated by AgentEx CLI) ===
+""" + create_debug_startup_script() + """
+# === END DEBUG SETUP ===
+""" 

agentex/lib/cli/handlers/agent_handlers.py

@@ -7,6 +7,7 @@ from rich.console import Console
 
 from agentex.lib.cli.handlers.run_handlers import RunError
 from agentex.lib.cli.handlers.run_handlers import run_agent as _run_agent
+from agentex.lib.cli.debug import DebugConfig
 from agentex.lib.sdk.config.agent_manifest import AgentManifest
 from agentex.lib.utils.logging import make_logger
 
@@ -126,7 +127,7 @@ def build_agent(
     return image_name
 
 
-def run_agent(manifest_path: str):
+def run_agent(manifest_path: str, debug_config: "DebugConfig | None" = None):
     """Run an agent locally from the given manifest"""
     import asyncio
     import signal
@@ -152,7 +153,7 @@ def run_agent(manifest_path: str):
     signal.signal(signal.SIGTERM, signal_handler)
     
     try:
-        asyncio.run(_run_agent(manifest_path))
+        asyncio.run(_run_agent(manifest_path, debug_config))
     except KeyboardInterrupt:
         print("Shutdown completed.")
         sys.exit(0)

agentex/lib/cli/handlers/deploy_handlers.py

@@ -22,7 +22,7 @@ logger = make_logger(__name__)
 console = Console()
 
 TEMPORAL_WORKER_KEY = "temporal-worker"
-AGENTEX_AGENTS_HELM_CHART_VERSION = "0.1.4-v1-beta"
+AGENTEX_AGENTS_HELM_CHART_VERSION = "0.1.6-v1-beta"
 
 
 class InputDeployOverrides(BaseModel):
@@ -204,7 +204,6 @@ def merge_deployment_configs(
             for pull_secret in manifest.deployment.imagePullSecrets
         ]
         helm_values["global"]["imagePullSecrets"] = pull_secrets
-        # TODO: Remove this once i bump the chart version again
         helm_values["imagePullSecrets"] = pull_secrets
 
     # Apply cluster-specific overrides

agentex/lib/cli/handlers/run_handlers.py

@@ -18,6 +18,9 @@ from agentex.lib.cli.utils.path_utils import (
 
 from agentex.lib.environment_variables import EnvVarKeys
 from agentex.lib.sdk.config.agent_manifest import AgentManifest
+
+# Import debug functionality
+from agentex.lib.cli.debug import DebugConfig, start_acp_server_debug, start_temporal_worker_debug
 from agentex.lib.utils.logging import make_logger
 
 logger = make_logger(__name__)
@@ -249,7 +252,7 @@ async def stream_process_output(process: asyncio.subprocess.Process, prefix: str
         logger.debug(f"Output streaming ended for {prefix}: {e}")
 
 
-async def run_agent(manifest_path: str):
+async def run_agent(manifest_path: str, debug_config: "DebugConfig | None" = None):
     """Run an agent locally from the given manifest"""
 
     # Validate manifest exists
@@ -289,11 +292,16 @@ async def run_agent(manifest_path: str):
             )
         )
 
-        # Start ACP server
+        # Start ACP server (with debug support if enabled)
         manifest_dir = Path(manifest_path).parent
-        acp_process = await start_acp_server(
-            file_paths["acp"], manifest.local_development.agent.port, agent_env, manifest_dir
-        )
+        if debug_config and debug_config.should_debug_acp():
+            acp_process = await start_acp_server_debug(
+                file_paths["acp"], manifest.local_development.agent.port, agent_env, debug_config
+            )
+        else:
+            acp_process = await start_acp_server(
+                file_paths["acp"], manifest.local_development.agent.port, agent_env, manifest_dir
+            )
         process_manager.add_process(acp_process)
 
         # Start output streaming for ACP
@@ -301,9 +309,18 @@ async def run_agent(manifest_path: str):
 
         tasks = [acp_output_task]
 
-        # Start temporal worker if needed
+        # Start temporal worker if needed (with debug support if enabled)
         if is_temporal_agent(manifest) and file_paths["worker"]:
-            worker_task = await start_temporal_worker_with_reload(file_paths["worker"], agent_env, process_manager)
+            if debug_config and debug_config.should_debug_worker():
+                # In debug mode, start worker without auto-reload to prevent conflicts
+                worker_process = await start_temporal_worker_debug(
+                    file_paths["worker"], agent_env, debug_config
+                )
+                process_manager.add_process(worker_process)
+                worker_task = asyncio.create_task(stream_process_output(worker_process, "WORKER"))
+            else:
+                # Normal mode with auto-reload
+                worker_task = await start_temporal_worker_with_reload(file_paths["worker"], agent_env, process_manager)
             tasks.append(worker_task)
 
         console.print(

agentex/lib/cli/templates/default/pyproject.toml.j2

@@ -6,7 +6,6 @@ build-backend = "hatchling.build"
 name = "{{ project_name }}"
 version = "0.1.0"
 description = "{{ description }}"
-readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
     "agentex-sdk",

agentex/lib/cli/templates/sync/pyproject.toml.j2

@@ -6,7 +6,6 @@ build-backend = "hatchling.build"
 name = "{{ project_name }}"
 version = "0.1.0"
 description = "{{ description }}"
-readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
     "agentex-sdk",

agentex/lib/cli/templates/temporal/project/acp.py.j2

@@ -1,4 +1,35 @@
 import os
+import sys
+
+# === DEBUG SETUP (AgentEx CLI Debug Support) ===
+if os.getenv("AGENTEX_DEBUG_ENABLED") == "true":
+    try:
+        import debugpy
+        debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "5679"))
+        debug_type = os.getenv("AGENTEX_DEBUG_TYPE", "acp")
+        wait_for_attach = os.getenv("AGENTEX_DEBUG_WAIT_FOR_ATTACH", "false").lower() == "true"
+        
+        # Configure debugpy
+        debugpy.configure(subProcess=False)
+        debugpy.listen(debug_port)
+        
+        print(f"🐛 [{debug_type.upper()}] Debug server listening on port {debug_port}")
+        
+        if wait_for_attach:
+            print(f"⏳ [{debug_type.upper()}] Waiting for debugger to attach...")
+            debugpy.wait_for_client()
+            print(f"✅ [{debug_type.upper()}] Debugger attached!")
+        else:
+            print(f"📡 [{debug_type.upper()}] Ready for debugger attachment")
+            
+    except ImportError:
+        print("❌ debugpy not available. Install with: pip install debugpy")
+        sys.exit(1)
+    except Exception as e:
+        print(f"❌ Debug setup failed: {e}")
+        sys.exit(1)
+# === END DEBUG SETUP ===
+
 from agentex.lib.sdk.fastacp.fastacp import FastACP
 from agentex.lib.types.fastacp import TemporalACPConfig
 

agentex/lib/cli/templates/temporal/project/run_worker.py.j2

@@ -1,9 +1,9 @@
 import asyncio
-import os
 
 from agentex.lib.core.temporal.activities import get_all_activities
 from agentex.lib.core.temporal.workers.worker import AgentexWorker
 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 {{ workflow_class }}
@@ -15,6 +15,9 @@ logger = make_logger(__name__)
 
 
 async def main():
+    # Setup debug mode if enabled
+    setup_debug_if_enabled()
+    
     task_queue_name = environment_variables.WORKFLOW_TASK_QUEUE
     if task_queue_name is None:
         raise ValueError("WORKFLOW_TASK_QUEUE is not set")

agentex/lib/cli/templates/temporal/pyproject.toml.j2

@@ -6,7 +6,6 @@ build-backend = "hatchling.build"
 name = "{{ project_name }}"
 version = "0.1.0"
 description = "{{ description }}"
-readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
     "agentex-sdk",
@@ -20,6 +19,7 @@ dev = [
     "black",
     "isort",
     "flake8",
+    "debugpy>=1.8.15",
 ]
 
 [tool.hatch.build.targets.wheel]

agentex/lib/core/services/adk/acp/acp.py

@@ -64,7 +64,7 @@ class ACPService:
             else:
                 raise ValueError("Either agent_name or agent_id must be provided")
 
-            task_entry = Task.model_validate(json_rpc_response["result"])
+            task_entry = Task.model_validate(json_rpc_response.result)
             if span:
                 span.output = task_entry.model_dump()
             return task_entry
@@ -115,7 +115,7 @@ class ACPService:
             else:
                 raise ValueError("Either agent_name or agent_id must be provided")
 
-            task_message = TaskMessage.model_validate(json_rpc_response["result"])
+            task_message = TaskMessage.model_validate(json_rpc_response.result)
             if span:
                 span.output = task_message.model_dump()
             return task_message
@@ -147,7 +147,7 @@ class ACPService:
                     agent_name=agent_name,
                     method="event/send",
                     params={
-                        "task_name": task_name,
+                        "task_id": task_id,
                         "content": cast(TaskMessageContentParam, content.model_dump()),
                     },
                 )
@@ -163,7 +163,7 @@ class ACPService:
             else:
                 raise ValueError("Either agent_name or agent_id must be provided")
 
-            event_entry = Event.model_validate(json_rpc_response["result"])
+            event_entry = Event.model_validate(json_rpc_response.result)
             if span:
                 span.output = event_entry.model_dump()
             return event_entry
@@ -204,7 +204,7 @@ class ACPService:
             else:
                 raise ValueError("Either task_name or task_id must be provided")
 
-            task_entry = Task.model_validate(json_rpc_response["result"])
+            task_entry = Task.model_validate(json_rpc_response.result)
             if span:
                 span.output = task_entry.model_dump()
             return task_entry

agentex/lib/core/temporal/workers/worker.py

@@ -24,6 +24,8 @@ from temporalio.worker import (
 )
 
 from agentex.lib.utils.logging import make_logger
+from agentex.lib.utils.registration import register_agent
+from agentex.lib.environment_variables import EnvironmentVariables
 
 logger = make_logger(__name__)
 
@@ -103,9 +105,16 @@ class AgentexWorker:
         workflow: type,
     ):
         await self.start_health_check_server()
+        await self._register_agent()
         temporal_client = await get_temporal_client(
             temporal_address=os.environ.get("TEMPORAL_ADDRESS", "localhost:7233"),
         )
+        
+        # Enable debug mode if AgentEx debug is enabled (disables deadlock detection)
+        debug_enabled = os.environ.get("AGENTEX_DEBUG_ENABLED", "false").lower() == "true"
+        if debug_enabled:
+            logger.info("🐛 [WORKER] Temporal debug mode enabled - deadlock detection disabled")
+        
         worker = Worker(
             client=temporal_client,
             task_queue=self.task_queue,
@@ -115,6 +124,7 @@ class AgentexWorker:
             workflow_runner=UnsandboxedWorkflowRunner(),
             max_concurrent_activities=self.max_concurrent_activities,
             build_id=str(uuid.uuid4()),
+            debug_mode=debug_enabled,  # Disable deadlock detection in debug mode
         )
 
         logger.info(f"Starting workers for task queue: {self.task_queue}")
@@ -160,3 +170,17 @@ class AgentexWorker:
                         f"Failed to start health check server on alternative port {alt_port}: {e}"
                     )
                     raise
+
+    """
+    Register the worker with the Agentex server.
+    
+    Even though the Temporal server will also register the agent with the server,
+    doing this on the worker side is required to make sure that both share the API key
+    which is returned on registration and used to authenticate the worker with the Agentex server.
+    """
+    async def _register_agent(self):
+        env_vars = EnvironmentVariables.refresh()
+        if env_vars and env_vars.AGENTEX_BASE_URL:
+            await register_agent(env_vars)
+        else:
+            logger.warning("AGENTEX_BASE_URL not set, skipping worker registration")

agentex/lib/environment_variables.py

@@ -23,6 +23,7 @@ class EnvVarKeys(str, Enum):
     AGENT_NAME = "AGENT_NAME"
     AGENT_DESCRIPTION = "AGENT_DESCRIPTION"
     AGENT_ID = "AGENT_ID"
+    AGENT_API_KEY = "AGENT_API_KEY"
     # ACP Configuration
     ACP_URL = "ACP_URL"
     ACP_PORT = "ACP_PORT"
@@ -52,6 +53,7 @@ class EnvironmentVariables(BaseModel):
     AGENT_NAME: str
     AGENT_DESCRIPTION: str | None = None
     AGENT_ID: str | None = None
+    AGENT_API_KEY: str | None = None
     ACP_TYPE: str | None = "agentic"
     # ACP Configuration
     ACP_URL: str

agentex/lib/sdk/fastacp/base/base_acp_server.py

@@ -1,15 +1,10 @@
 import asyncio
-import base64
 import inspect
-import json
-import os
 from collections.abc import AsyncGenerator, Awaitable, Callable
 from contextlib import asynccontextmanager
 from typing import Any
 
-import httpx
 import uvicorn
-from agentex.lib.adk.utils._modules.client import create_async_agentex_client
 from fastapi import FastAPI, Request
 from fastapi.responses import StreamingResponse
 from pydantic import TypeAdapter, ValidationError
@@ -30,6 +25,7 @@ from agentex.lib.types.task_message_updates import StreamTaskMessageFull, TaskMe
 from agentex.types.task_message_content import TaskMessageContent
 from agentex.lib.utils.logging import make_logger
 from agentex.lib.utils.model_utils import BaseModel
+from agentex.lib.utils.registration import register_agent
 
 logger = make_logger(__name__)
 
@@ -74,7 +70,7 @@ class BaseACPServer(FastAPI):
         async def lifespan_context(app: FastAPI):
             env_vars = EnvironmentVariables.refresh()
             if env_vars.AGENTEX_BASE_URL:
-                await self._register_agent(env_vars)
+                await register_agent(env_vars)
             else:
                 logger.warning("AGENTEX_BASE_URL not set, skipping agent registration")
 
@@ -101,6 +97,16 @@ class BaseACPServer(FastAPI):
             data = await request.json()
             rpc_request = JSONRPCRequest(**data)
 
+            # Check if the request is authenticated
+            if refreshed_environment_variables and getattr(refreshed_environment_variables, "AGENT_API_KEY", None):
+                authorization_header = request.headers.get("x-agent-api-key")
+                if authorization_header != refreshed_environment_variables.AGENT_API_KEY:
+                    return JSONRPCResponse(
+                        id=rpc_request.id,
+                        error=JSONRPCError(code=-32601, message="Unauthorized"),
+                    )
+
+
             # Check if method is valid first
             try:
                 method = RPCMethod(rpc_request.method)
@@ -345,87 +351,4 @@ class BaseACPServer(FastAPI):
         """Start the Uvicorn server for async handlers."""
         uvicorn.run(self, host=host, port=port, **kwargs)
 
-    def _get_auth_principal(self, env_vars: EnvironmentVariables):
-        if not env_vars.AUTH_PRINCIPAL_B64:
-            return None
-
-        try:
-            decoded_str = base64.b64decode(env_vars.AUTH_PRINCIPAL_B64).decode('utf-8')
-            return json.loads(decoded_str)
-        except Exception:
-            return None
-
-    async def _register_agent(self, env_vars: EnvironmentVariables):
-        """Register this agent with the Agentex server"""
-        # Build the agent's own URL
-        full_acp_url = f"{env_vars.ACP_URL.rstrip('/')}:{env_vars.ACP_PORT}"
-
-        description = (
-            env_vars.AGENT_DESCRIPTION
-            or f"Generic description for agent: {env_vars.AGENT_NAME}"
-        )
-
-        # Prepare registration data
-        registration_data = {
-            "name": env_vars.AGENT_NAME,
-            "description": description,
-            "acp_url": full_acp_url,
-            "acp_type": env_vars.ACP_TYPE,
-            "principal_context": self._get_auth_principal(env_vars)
-        }
-
-        if env_vars.AGENT_ID:
-            registration_data["agent_id"] = env_vars.AGENT_ID
-
-        # Make the registration request
-        registration_url = f"{env_vars.AGENTEX_BASE_URL.rstrip('/')}/agents/register"
-        # Retry logic with configurable attempts and delay
-        max_retries = 3
-        base_delay = 5  # seconds
-        last_exception = None
-
-        attempt = 0
-        while attempt < max_retries:
-            try:
-                async with httpx.AsyncClient() as client:
-                    response = await client.post(
-                        registration_url, json=registration_data, timeout=30.0
-                    )
-                    if response.status_code == 200:
-                        agent = response.json()
-                        agent_id, agent_name = agent["id"], agent["name"]
-
-                        os.environ["AGENT_ID"] = agent_id
-                        os.environ["AGENT_NAME"] = agent_name
-                        env_vars.AGENT_ID = agent_id
-                        env_vars.AGENT_NAME = agent_name
-                        global refreshed_environment_variables
-                        refreshed_environment_variables = env_vars
-                        logger.info(
-                            f"Successfully registered agent '{env_vars.AGENT_NAME}' with Agentex server with acp_url: {full_acp_url}. Registration data: {registration_data}"
-                        )
-                        return  # Success, exit the retry loop
-                    else:
-                        error_msg = f"Failed to register agent. Status: {response.status_code}, Response: {response.text}"
-                        logger.error(error_msg)
-                        last_exception = Exception(
-                            f"Failed to startup agent: {response.text}"
-                        )
-
-            except Exception as e:
-                logger.error(
-                    f"Exception during agent registration attempt {attempt + 1}: {e}"
-                )
-                last_exception = e
-            attempt += 1
-            if attempt < max_retries:
-                delay = (attempt) * base_delay  # 5, 10, 15 seconds
-                logger.info(
-                    f"Retrying in {delay} seconds... (attempt {attempt}/{max_retries})"
-                )
-                await asyncio.sleep(delay)
-
-        # If we get here, all retries failed
-        raise last_exception or Exception(
-            f"Failed to register agent after {max_retries} attempts"
-        )
+    

agentex/lib/utils/debug.py

@@ -0,0 +1,63 @@
+"""
+Debug utilities for AgentEx development.
+
+Provides debugging setup functionality that can be used across different components.
+"""
+
+import os
+import debugpy  # type: ignore
+
+
+def setup_debug_if_enabled() -> None:
+    """
+    Setup debugpy if debug mode is enabled via environment variables.
+    
+    This function checks for AgentEx debug environment variables and configures
+    debugpy accordingly. It's designed to be called early in worker startup.
+    
+    Environment Variables:
+        AGENTEX_DEBUG_ENABLED: Set to "true" to enable debug mode
+        AGENTEX_DEBUG_PORT: Port for debug server (default: 5678)
+        AGENTEX_DEBUG_TYPE: Type identifier for logging (default: "worker")
+        AGENTEX_DEBUG_WAIT_FOR_ATTACH: Set to "true" to wait for debugger attachment
+    
+    Raises:
+        Any exception from debugpy setup (will bubble up naturally)
+    """
+    if os.getenv("AGENTEX_DEBUG_ENABLED") == "true":
+        debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "5678"))
+        debug_type = os.getenv("AGENTEX_DEBUG_TYPE", "worker")
+        wait_for_attach = os.getenv("AGENTEX_DEBUG_WAIT_FOR_ATTACH", "false").lower() == "true"
+        
+        # Configure debugpy
+        debugpy.configure(subProcess=False)
+        debugpy.listen(debug_port)
+        
+        print(f"🐛 [{debug_type.upper()}] Debug server listening on port {debug_port}")
+        
+        if wait_for_attach:
+            print(f"⏳ [{debug_type.upper()}] Waiting for debugger to attach...")
+            debugpy.wait_for_client()
+            print(f"✅ [{debug_type.upper()}] Debugger attached!")
+        else:
+            print(f"📡 [{debug_type.upper()}] Ready for debugger attachment")
+
+
+def is_debug_enabled() -> bool:
+    """
+    Check if debug mode is currently enabled.
+    
+    Returns:
+        bool: True if AGENTEX_DEBUG_ENABLED is set to "true"
+    """
+    return os.getenv("AGENTEX_DEBUG_ENABLED", "false").lower() == "true"
+
+
+def get_debug_port() -> int:
+    """
+    Get the debug port from environment variables.
+    
+    Returns:
+        int: Debug port (default: 5678)
+    """
+    return int(os.getenv("AGENTEX_DEBUG_PORT", "5678"))

agentex/lib/utils/registration.py

@@ -0,0 +1,101 @@
+import base64
+import json
+import os
+import httpx
+import asyncio
+
+from agentex.lib.environment_variables import EnvironmentVariables, refreshed_environment_variables
+from agentex.lib.utils.logging import make_logger
+
+logger = make_logger(__name__)
+
+def get_auth_principal(env_vars: EnvironmentVariables):
+    if not env_vars.AUTH_PRINCIPAL_B64:
+        return None
+
+    try:
+        decoded_str = base64.b64decode(env_vars.AUTH_PRINCIPAL_B64).decode('utf-8')
+        return json.loads(decoded_str)
+    except Exception:
+        return None
+
+async def register_agent(env_vars: EnvironmentVariables):
+    """Register this agent with the Agentex server"""
+    if not env_vars.AGENTEX_BASE_URL:
+        logger.warning("AGENTEX_BASE_URL is not set, skipping registration")
+        return
+    # Build the agent's own URL
+    full_acp_url = f"{env_vars.ACP_URL.rstrip('/')}:{env_vars.ACP_PORT}"
+
+    description = (
+        env_vars.AGENT_DESCRIPTION
+        or f"Generic description for agent: {env_vars.AGENT_NAME}"
+    )
+
+    # Prepare registration data
+    registration_data = {
+        "name": env_vars.AGENT_NAME,
+        "description": description,
+        "acp_url": full_acp_url,
+        "acp_type": env_vars.ACP_TYPE,
+        "principal_context": get_auth_principal(env_vars)
+    }
+
+    if env_vars.AGENT_ID:
+        registration_data["agent_id"] = env_vars.AGENT_ID
+
+    # Make the registration request
+    registration_url = f"{env_vars.AGENTEX_BASE_URL.rstrip('/')}/agents/register"
+    # Retry logic with configurable attempts and delay
+    max_retries = 3
+    base_delay = 5  # seconds
+    last_exception = None
+
+    attempt = 0
+    while attempt < max_retries:
+        try:
+            async with httpx.AsyncClient() as client:
+                response = await client.post(
+                    registration_url, json=registration_data, timeout=30.0
+                )
+                if response.status_code == 200:
+                    agent = response.json()
+                    agent_id, agent_name = agent["id"], agent["name"]
+                    agent_api_key = agent["agent_api_key"]
+
+                    os.environ["AGENT_ID"] = agent_id
+                    os.environ["AGENT_NAME"] = agent_name
+                    os.environ["AGENT_API_KEY"] = agent_api_key
+                    env_vars.AGENT_ID = agent_id
+                    env_vars.AGENT_NAME = agent_name
+                    env_vars.AGENT_API_KEY = agent_api_key
+                    global refreshed_environment_variables
+                    refreshed_environment_variables = env_vars
+                    logger.info(
+                        f"Successfully registered agent '{env_vars.AGENT_NAME}' with Agentex server with acp_url: {full_acp_url}. Registration data: {registration_data}"
+                    )
+                    return  # Success, exit the retry loop
+                else:
+                    error_msg = f"Failed to register agent. Status: {response.status_code}, Response: {response.text}"
+                    logger.error(error_msg)
+                    last_exception = Exception(
+                        f"Failed to startup agent: {response.text}"
+                    )
+
+        except Exception as e:
+            logger.error(
+                f"Exception during agent registration attempt {attempt + 1}: {e}"
+            )
+            last_exception = e
+        attempt += 1
+        if attempt < max_retries:
+            delay = (attempt) * base_delay  # 5, 10, 15 seconds
+            logger.info(
+                f"Retrying in {delay} seconds... (attempt {attempt}/{max_retries})"
+            )
+            await asyncio.sleep(delay)
+
+    # If we get here, all retries failed
+    raise last_exception or Exception(
+        f"Failed to register agent after {max_retries} attempts"
+    )

agentex/types/agent.py

@@ -1,6 +1,7 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from typing import Optional
+from datetime import datetime
 from typing_extensions import Literal
 
 from .._models import BaseModel
@@ -16,12 +17,18 @@ class Agent(BaseModel):
     acp_type: AcpType
     """The type of the ACP Server (Either sync or agentic)"""
 
+    created_at: datetime
+    """The timestamp when the agent was created"""
+
     description: str
     """The description of the action."""
 
     name: str
     """The unique name of the agent."""
 
+    updated_at: datetime
+    """The timestamp when the agent was last updated"""
+
     status: Optional[Literal["Pending", "Building", "Ready", "Failed", "Unknown"]] = None
     """The status of the action, indicating if it's building, ready, failed, etc."""
 

{agentex_sdk-0.2.6.dist-info → agentex_sdk-0.2.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: agentex-sdk
-Version: 0.2.6
+Version: 0.2.7
 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
@@ -126,6 +126,37 @@ asyncio.run(main())
 
 Functionality between the synchronous and asynchronous clients is otherwise identical.
 
+## Debugging
+
+AgentEx provides built-in debugging support for **temporal projects** during local development.
+
+```bash
+# Basic debugging
+uv run agentex agents run --manifest manifest.yaml --debug-worker
+
+# Wait for debugger to attach before starting
+uv run agentex agents run --manifest manifest.yaml --debug-worker --wait-for-debugger
+
+# Custom debug port
+uv run agentex agents run --manifest manifest.yaml --debug-worker --debug-port 5679
+```
+
+For **VS Code**, add this configuration to `.vscode/launch.json`:
+
+```json
+{
+  "name": "Attach to AgentEx Worker",
+  "type": "debugpy",
+  "request": "attach",
+  "connect": { "host": "localhost", "port": 5678 },
+  "pathMappings": [{ "localRoot": "${workspaceFolder}", "remoteRoot": "." }],
+  "justMyCode": false,
+  "console": "integratedTerminal"
+}
+```
+
+The debug server automatically finds an available port starting from 5678 and prints connection details when starting.
+
 ### With aiohttp
 
 By default, the async client uses `httpx` for HTTP requests. However, for improved concurrency performance you may also use `aiohttp` as the HTTP backend.

{agentex_sdk-0.2.6.dist-info → agentex_sdk-0.2.7.dist-info}/RECORD

@@ -11,7 +11,7 @@ agentex/_resource.py,sha256=S1t7wmR5WUvoDIhZjo_x-E7uoTJBynJ3d8tPJMQYdjw,1106
 agentex/_response.py,sha256=Tb9zazsnemO2rTxWtBjAD5WBqlhli5ZaXGbiKgdu5DE,28794
 agentex/_streaming.py,sha256=FNGJExRCF-vTRUZHFKUfoAWFhDGOB3XbioVCF37Jr7E,10104
 agentex/_types.py,sha256=KyKYySGIfHPod2hho1fPxssk5NuVn8C4MeMTtA-lg80,6198
-agentex/_version.py,sha256=aolBlxCYy9VLUtx44zgLOoBoWwq2ENVlfc7ry58WRF8,159
+agentex/_version.py,sha256=juL3-lsGG8DrsKnzc0QzewhZCTZuJXw8vQoNFh7Of6g,159
 agentex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agentex/_utils/__init__.py,sha256=PNZ_QJuzZEgyYXqkO1HVhGkj5IU9bglVUcw7H-Knjzw,2062
 agentex/_utils/_logs.py,sha256=LUjFPc3fweSChBUmjhQD8uYmwQAmFMNDuVFKfjYBQfM,777
@@ -25,7 +25,7 @@ agentex/_utils/_typing.py,sha256=D0DbbNu8GnYQTSICnTSHDGsYXj8TcAKyhejb0XcnjtY,460
 agentex/_utils/_utils.py,sha256=ts4CiiuNpFiGB6YMdkQRh2SZvYvsl7mAF-JWHCcLDf4,12312
 agentex/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
 agentex/lib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-agentex/lib/environment_variables.py,sha256=80YcUTKR5edoX2yNgajpLdS9dIe_RpHp68jlcbNR5ow,3175
+agentex/lib/environment_variables.py,sha256=cCL7_cKDNuPyUTmuNLZVTDdFnJPmCsDZ5uN23MtZP-k,3248
 agentex/lib/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agentex/lib/adk/__init__.py,sha256=-PpVfEvYr_HD7TnxUWU8RCW2OnxfwpPxTW97dKTnqvI,1082
 agentex/lib/adk/_modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -45,21 +45,24 @@ agentex/lib/adk/providers/_modules/openai.py,sha256=QyjujK4JHiATB4xI9CiR67agcRhA
 agentex/lib/adk/providers/_modules/sgp.py,sha256=QszUPyeGBODfI5maYvlzErD87PsMsX6vrfC7n65WNjE,3224
 agentex/lib/adk/utils/__init__.py,sha256=7f6ayV0_fqyw5cwzVANNcZWGJZ-vrrYtZ0qi7KKBRFs,130
 agentex/lib/adk/utils/_modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-agentex/lib/adk/utils/_modules/client.py,sha256=1OltPs65W6B_g8SDAOrbLxmiDqxYodmbq5PtUdBmj-U,847
+agentex/lib/adk/utils/_modules/client.py,sha256=zMBYsPr2zXpSynF2W_5SKOpALtXvS0cTNdcJX93ce1I,974
 agentex/lib/adk/utils/_modules/templating.py,sha256=wgjkE4uC1gsArK-exyxOOZwp5Yu7ePqviZuyTDlP9m0,3595
 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=PJVkopMLQEg4lOQf-Dvjb_b0TL6qaWTH2dN6_cxRneo,11417
+agentex/lib/cli/commands/agents.py,sha256=ThpiifTcORxe2kHCfw0Cxm7_i--gHHtO8ZsqCSi2UaY,12957
 agentex/lib/cli/commands/init.py,sha256=JsfusiLTgPu5IAI0MVDR15qA6wx5R2ZowjUJ728GJyQ,8146
 agentex/lib/cli/commands/main.py,sha256=aDn9xJIIQQD33v3caET_NX-8eBxoWC3QfZGMUgjeGN8,1093
 agentex/lib/cli/commands/secrets.py,sha256=cVtsqyGGieBVM4dKkbJROmzR_NJRODFngcEbi1Nc92A,5604
 agentex/lib/cli/commands/tasks.py,sha256=9ARR0VgM2ZZXSFDlMiA_E9RDL2V7Piipp8Fna_OBrKQ,3652
 agentex/lib/cli/commands/uv.py,sha256=n6nk2F2gPUXrvWOljSN06Y5bOEnhaZH4rulproAJktA,3553
+agentex/lib/cli/debug/__init__.py,sha256=dt_NjaWesD2M5BqtTKswWc23PGA_dC0uR2m61JP_xIc,378
+agentex/lib/cli/debug/debug_config.py,sha256=Gl0rI1WUPwhehyDC0EdLo7S8q9hlBy41ZIu3NBUm6QQ,3415
+agentex/lib/cli/debug/debug_handlers.py,sha256=i2Og0v5MPKIxG0uMZIp4NpmCpAro23t7PLCU4d7EKag,5684
 agentex/lib/cli/handlers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-agentex/lib/cli/handlers/agent_handlers.py,sha256=ovhnQOa-lAi5g2J3BVutA0vbprsOFe0lt2qw-qIZah4,5470
+agentex/lib/cli/handlers/agent_handlers.py,sha256=iVZ-4TSQJuq7XpPBYjYIN76M33XwxDjQTuNwTzzynec,5573
 agentex/lib/cli/handlers/cleanup_handlers.py,sha256=V1V0zeErOUGTgCQqjyUl6CWtzGjFW878uzFaLOQJEyQ,7073
-agentex/lib/cli/handlers/deploy_handlers.py,sha256=ULiW5hZr1PJ4wOJ1UnOkUpQiZaSDDk5w3BZxdDPMhos,14896
-agentex/lib/cli/handlers/run_handlers.py,sha256=2DkaGN27nHcL5pZeoOVdlhttnft_jtVdmv_POgnRASE,13923
+agentex/lib/cli/handlers/deploy_handlers.py,sha256=pwdc-m5-auXzlDA-0-TzAPpIGxsYecPKXryrAIpELTM,14832
+agentex/lib/cli/handlers/run_handlers.py,sha256=b02-ng64fMHdd7u2hB_tmwHrm2_0DL-pcA565JDpyPc,14949
 agentex/lib/cli/handlers/secret_handlers.py,sha256=VfAdAQovW9tG36Xgk_gGIGwTyFMxR3P6xc7fmAviNA8,24719
 agentex/lib/cli/templates/default/.dockerignore.j2,sha256=hweGFxw5eDZYsb5EnRHpv27o9M1HF2PEWOxqsfBBcAE,320
 agentex/lib/cli/templates/default/Dockerfile-uv.j2,sha256=tGJo_C4vwHYikV4QhGFtSiG6K7Nt4UDdJ71Gob_uTho,1109
@@ -67,7 +70,7 @@ agentex/lib/cli/templates/default/Dockerfile.j2,sha256=T7ouO3glVBo7U2I1TPQvgARyx
 agentex/lib/cli/templates/default/README.md.j2,sha256=4Sn_cY_TMfN_c5h-I_L3TgTrNKUvhzQvKGDZjS3n2Gw,6361
 agentex/lib/cli/templates/default/dev.ipynb.j2,sha256=8xY82gVfQ0mhzlEZzI4kLqIXCF19YgimLnpEirDMX8I,3395
 agentex/lib/cli/templates/default/manifest.yaml.j2,sha256=n-XK6LqSyBVY6a7KOfIlOQx4LbMNEVzzHIh6yEiqAhs,3752
-agentex/lib/cli/templates/default/pyproject.toml.j2,sha256=9cpTISM7rOoICWejV5GYMEwPn8RUmB6-E7csM1pmSFo,528
+agentex/lib/cli/templates/default/pyproject.toml.j2,sha256=eyN6dYqJTFzb5WztJMxboy9Wc0XPXVnKYaF5JBxJE7o,507
 agentex/lib/cli/templates/default/requirements.txt.j2,sha256=iTmO-z8qFkUa1jTctFCs0WYuq7Sqi6VNQAwATakh2fQ,94
 agentex/lib/cli/templates/default/deploy/example.yaml.j2,sha256=sHIEuhtruyCfGPgeLQ1ilCCnRH0HpsqhDdQT44UWUaU,1554
 agentex/lib/cli/templates/default/project/acp.py.j2,sha256=XZsHNQaQDNvooarFt_NvM8rLQ-rpc_knKkNTPnRxtM4,1136
@@ -79,7 +82,7 @@ agentex/lib/cli/templates/sync/Dockerfile.j2,sha256=T7ouO3glVBo7U2I1TPQvgARyxXGL
 agentex/lib/cli/templates/sync/README.md.j2,sha256=_S7Ngl4qOUQHPFldLXDBvuIWPFU2-WcuxGmr5EXLX6k,8816
 agentex/lib/cli/templates/sync/dev.ipynb.j2,sha256=Z42iRveuI_k5LcJqWX-3H1glPtNTkxg_MKVe1lwuJos,6055
 agentex/lib/cli/templates/sync/manifest.yaml.j2,sha256=V497KXzvA76sHrgIJ5zRJptpIH8sGbSXZaIsEyp5NZ4,3747
-agentex/lib/cli/templates/sync/pyproject.toml.j2,sha256=9cpTISM7rOoICWejV5GYMEwPn8RUmB6-E7csM1pmSFo,528
+agentex/lib/cli/templates/sync/pyproject.toml.j2,sha256=eyN6dYqJTFzb5WztJMxboy9Wc0XPXVnKYaF5JBxJE7o,507
 agentex/lib/cli/templates/sync/requirements.txt.j2,sha256=iTmO-z8qFkUa1jTctFCs0WYuq7Sqi6VNQAwATakh2fQ,94
 agentex/lib/cli/templates/sync/deploy/example.yaml.j2,sha256=sHIEuhtruyCfGPgeLQ1ilCCnRH0HpsqhDdQT44UWUaU,1554
 agentex/lib/cli/templates/sync/project/acp.py.j2,sha256=X5RaE9iR4Dp-kPJL0r1QAe6ohfiOTcYizwtwGW2GzHg,1003
@@ -89,11 +92,11 @@ agentex/lib/cli/templates/temporal/Dockerfile.j2,sha256=pcszlprNTqKMpYEtA4XYlc3v
 agentex/lib/cli/templates/temporal/README.md.j2,sha256=d6BQAZBf7lCKROXnpDu-Ml1Rq0OM8cCFEOpmStoPWfc,10132
 agentex/lib/cli/templates/temporal/dev.ipynb.j2,sha256=8xY82gVfQ0mhzlEZzI4kLqIXCF19YgimLnpEirDMX8I,3395
 agentex/lib/cli/templates/temporal/manifest.yaml.j2,sha256=S-hJlpVCnT62r66otqHa3iROOn1w_yYvehOOxvLQotY,4483
-agentex/lib/cli/templates/temporal/pyproject.toml.j2,sha256=hBZgFBkgdQ4x7lfmmUXuUL10ER11ojaDp_swnrg26Vo,546
+agentex/lib/cli/templates/temporal/pyproject.toml.j2,sha256=MoR1g6KnGOQrXWOXhFKMw561kgpxy0tdom0KLtQe8A8,548
 agentex/lib/cli/templates/temporal/requirements.txt.j2,sha256=iTmO-z8qFkUa1jTctFCs0WYuq7Sqi6VNQAwATakh2fQ,94
 agentex/lib/cli/templates/temporal/deploy/example.yaml.j2,sha256=sHIEuhtruyCfGPgeLQ1ilCCnRH0HpsqhDdQT44UWUaU,1554
-agentex/lib/cli/templates/temporal/project/acp.py.j2,sha256=EXeLdpWmEFCHANNsRtOvT92jV_90IqiSp8lzh7YXyCI,1231
-agentex/lib/cli/templates/temporal/project/run_worker.py.j2,sha256=JA9MLcylkm7zvMiYZRX8-YhS6hrakvIbVq92Fhfh3bI,862
+agentex/lib/cli/templates/temporal/project/acp.py.j2,sha256=Ha5oBaGT1WC93TEBfWMM7OtbmAYOF2t3PjY6uOL6mJE,2386
+agentex/lib/cli/templates/temporal/project/run_worker.py.j2,sha256=kgEbi-NNKDEOcW7lWP1rfQhFHpqjLtUi0Bc7AjO9jQo,979
 agentex/lib/cli/templates/temporal/project/workflow.py.j2,sha256=VPnHnzr09i5y68vCOIJ8wTrc8KVHoDp5WooQew0GiWg,3210
 agentex/lib/cli/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agentex/lib/cli/utils/auth_utils.py,sha256=Y8pCqvQxhYtyQOzbpFZ_PUIp6vo8XGDOPdyoRI1_KG8,489
@@ -127,7 +130,7 @@ agentex/lib/core/services/adk/streaming.py,sha256=zIXxMaoL5iTTC8CvmNoG4lRQO5JHyW
 agentex/lib/core/services/adk/tasks.py,sha256=XEX0u4skq81Fn-gjTzSE_-Iv_mKySZHchpotxAsnJwg,2618
 agentex/lib/core/services/adk/tracing.py,sha256=w4mnIoq5m5iwlkDN_NOUjhi6hUpD958cYn1QR6hFgB8,1156
 agentex/lib/core/services/adk/acp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-agentex/lib/core/services/adk/acp/acp.py,sha256=CDv9_tu44yV7ezeWFwxrX6K3DFCo2A7YFukHOd-8ygY,7575
+agentex/lib/core/services/adk/acp/acp.py,sha256=Ei6r5CcM1RA7DqfTRpAWCmP7Buw97b3ajQuE4DsdSaQ,7559
 agentex/lib/core/services/adk/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agentex/lib/core/services/adk/providers/litellm.py,sha256=7RIVqQ5XaCP2cEL1pr4nl5jfG_0FDMvDTZVKu1iaN3M,9864
 agentex/lib/core/services/adk/providers/openai.py,sha256=Qply4Q7BJqRyukAuNPnFcLXf0eQWACaa5LamGc6xpTY,31559
@@ -159,7 +162,7 @@ agentex/lib/core/temporal/services/temporal_task_service.py,sha256=kXUOwcg1Suc0k
 agentex/lib/core/temporal/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agentex/lib/core/temporal/types/workflow.py,sha256=o8lBUloI44NTYFfbA1BLgzUneyN7aLbt042Eq_9OKo8,89
 agentex/lib/core/temporal/workers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-agentex/lib/core/temporal/workers/worker.py,sha256=WY402Nk6wnsVmCjuOwhO__U8V2OIiRRMC86GDUOP0H4,5488
+agentex/lib/core/temporal/workers/worker.py,sha256=kmdfs67UWjzxU9ZOE7vq_q4S4jj7jB5ZMyJkZYptrAY,6670
 agentex/lib/core/temporal/workflows/workflow.py,sha256=VTS4nqwdJqqjIy6nTyvFLdAoBHnunO8-8rVY0Gx5_zo,723
 agentex/lib/core/tracing/__init__.py,sha256=3dLjXGTwAJxi_xxwdh8Mt04pdLyzN9VxAl8XHmV70Ak,229
 agentex/lib/core/tracing/trace.py,sha256=45Nn0Z97kC_9XNyb9N8IWUFo0OIdb7dDZShhgOTGJB0,8952
@@ -178,7 +181,7 @@ agentex/lib/sdk/config/local_development_config.py,sha256=b1AZsOVo1RoHKbk8Nm5nC8
 agentex/lib/sdk/config/project_config.py,sha256=CGH_r9KbnSFMj2CnBkZnfg41L2o0TeVNz6MwBDKPT_U,3642
 agentex/lib/sdk/fastacp/__init__.py,sha256=UvAdexdnfb4z0F4a2sfXROFyh9EjH89kf3AxHPybzCM,75
 agentex/lib/sdk/fastacp/fastacp.py,sha256=K4D7a9EiJfCgWp2hrE_TbpZBaF4Uc46MfndZK3F9mA0,3061
-agentex/lib/sdk/fastacp/base/base_acp_server.py,sha256=sD2p6xC0vXiD6LTj-bYz4-dvh_HxH8_q-51f-hIV0jI,17670
+agentex/lib/sdk/fastacp/base/base_acp_server.py,sha256=fkEVg5M4Ni2uPt_oiCP7_jfTmRvcC0o2VTg0Oka7mXA,14590
 agentex/lib/sdk/fastacp/impl/agentic_base_acp.py,sha256=LWLAlHrs-2Lc2UICBAEFL8c3JwTA6oxPnzUzW0qQWSA,2694
 agentex/lib/sdk/fastacp/impl/sync_acp.py,sha256=8FEDfBxI31NoVLX9nyckQ8QwA0UV4svC3fhGKgXBIwk,3862
 agentex/lib/sdk/fastacp/impl/temporal_acp.py,sha256=ZLqjzBBVrXJCXD2bFlrcDkFvpsXZp3thC2rTwZ6xNaY,3737
@@ -211,6 +214,7 @@ agentex/lib/types/tracing.py,sha256=0YBdy3aKvxIcpOW0podEAqsFl3yEKW4PswNf-QnMNqo,
 agentex/lib/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 agentex/lib/utils/completions.py,sha256=m9TMwl9-nYK4DOQ8bNyj5YCFrxK3yN3zKvXmdINcIbo,4158
 agentex/lib/utils/console.py,sha256=HVP1NSF4idx40hlGB3ifuofy3rsc83WF_1yNpHYM99M,417
+agentex/lib/utils/debug.py,sha256=1o2NjG8bZXTi63KTGjL3EmU_zMGapco7v5xoDuZRjU8,2148
 agentex/lib/utils/io.py,sha256=17p7dfUZ1YxTAc-n_g7eFOjzInoKi7Uedyad967EKYQ,754
 agentex/lib/utils/iterables.py,sha256=cD49hj98mtY0QPaS0ZA2kguNeGzRU4UfbZfwyASWdzY,319
 agentex/lib/utils/json_schema.py,sha256=nSHbi6LC-oWXHP6sMLCBychA7B0R2DItRIJNCCEzRsY,741
@@ -219,6 +223,7 @@ agentex/lib/utils/mcp.py,sha256=lYQPwKAOH6Gf2I_TeovhEG9YUijUPcN0rENNdT0Vk6c,505
 agentex/lib/utils/model_utils.py,sha256=_zPUIoSl-A7LsIuH-8I6aJBmbgjARbl7puMPh9lx5QU,1562
 agentex/lib/utils/parsing.py,sha256=2T-B4nJSupo2RLf9AkpV6VQHqDnF97ZBgO6zvGCauCo,369
 agentex/lib/utils/regex.py,sha256=Y3VcehCznAqa59D4WTwK_ki722oudHBlFqBk0I930zo,212
+agentex/lib/utils/registration.py,sha256=FAL40KSMRCltHZcDtioGeRNgfB19Twqu6Srp4x7UMSU,3781
 agentex/lib/utils/temporal.py,sha256=sXo8OPMMXiyrF7OSBCJBuN_ufyQOD2bLOXgDbVZoyds,292
 agentex/lib/utils/dev_tools/__init__.py,sha256=oaHxw6ymfhNql-kzXHv3NWVHuqD4fHumasNXJG7kHTU,261
 agentex/lib/utils/dev_tools/async_messages.py,sha256=-alUK1KFltcRb6xtRtIJIRJW9Sf1FwDRgaNPhOn-luw,18105
@@ -234,7 +239,7 @@ agentex/resources/messages/batch.py,sha256=pegCmnjK_J0jek5ChX1pKpq5RmCucTYLbK69H
 agentex/resources/messages/messages.py,sha256=fuFmmGNOjRJVzmYHcfP2trg0yii0n9MPPCpt7F8fDs4,17930
 agentex/types/__init__.py,sha256=v-2hxFsIvOZ_2mZy-5RqILX0VJWG4sN9MRvXAbThqYI,3514
 agentex/types/acp_type.py,sha256=Fj-4SzmM6m95ck_ZXtNbcWggHiD9F49bxBLPbl1fxe4,208
-agentex/types/agent.py,sha256=WZRc8VZtc-JIeNHw5FsVTSMrxlaJ5A0ABvHv3t_zA4s,792
+agentex/types/agent.py,sha256=t6CUsKSaK6Gs_X9g0YxSi5G3Hh21FrGVGnAD6MytVBk,981
 agentex/types/agent_list_params.py,sha256=81IWnRZ2rLfHH7GB6VkXShYjb44DO0guG1znJcV3tuI,316
 agentex/types/agent_list_response.py,sha256=g0b9Cw7j2yk14veyJORpF3me8iW7g7pr2USpXGokoFI,254
 agentex/types/agent_rpc_by_name_params.py,sha256=G6xkjrZKPmJvhwqgc68tAnzmb4wYh9k0zlcm9CsLQR0,2024
@@ -291,8 +296,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.2.6.dist-info/METADATA,sha256=qKBqHbctWyM-HfcIoAqlq01C9hGTktyz5k5XLMFkV7Y,14118
-agentex_sdk-0.2.6.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-agentex_sdk-0.2.6.dist-info/entry_points.txt,sha256=V7vJuMZdF0UlvgX6KiBN7XUvq_cxF5kplcYvc1QlFaQ,62
-agentex_sdk-0.2.6.dist-info/licenses/LICENSE,sha256=Q1AOx2FtRcMlyMgQJ9eVN2WKPq2mQ33lnB4tvWxabLA,11337
-agentex_sdk-0.2.6.dist-info/RECORD,,
+agentex_sdk-0.2.7.dist-info/METADATA,sha256=jDeAOkWMQtFYbgfRbFGwSITJDei-oGZIBYeDksRdq4o,15037
+agentex_sdk-0.2.7.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+agentex_sdk-0.2.7.dist-info/entry_points.txt,sha256=V7vJuMZdF0UlvgX6KiBN7XUvq_cxF5kplcYvc1QlFaQ,62
+agentex_sdk-0.2.7.dist-info/licenses/LICENSE,sha256=Q1AOx2FtRcMlyMgQJ9eVN2WKPq2mQ33lnB4tvWxabLA,11337
+agentex_sdk-0.2.7.dist-info/RECORD,,