agentex-sdk 0.2.4__tar.gz → 0.2.5__tar.gz

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

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

{agentex_sdk-0.2.4 → agentex_sdk-0.2.5}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.2.5 (2025-07-30)
+
+Full Changelog: [v0.2.4...v0.2.5](https://github.com/scaleapi/agentex-python/compare/v0.2.4...v0.2.5)
+
+### Features
+
+* **api:** api update ([f90002c](https://github.com/scaleapi/agentex-python/commit/f90002c247a94cddc17307fb4eded12359cc9ad8))
+* **api:** api update ([aee4ad1](https://github.com/scaleapi/agentex-python/commit/aee4ad10e588386e9af1b4828d16ddba1805dca0))
+* **api:** manual updates ([55efcdd](https://github.com/scaleapi/agentex-python/commit/55efcdd55f2a20d1172da95cd551751d8be0d0df))
+
 ## 0.2.4 (2025-07-29)
 
 Full Changelog: [v0.2.3...v0.2.4](https://github.com/scaleapi/agentex-python/compare/v0.2.3...v0.2.4)

{agentex_sdk-0.2.4 → agentex_sdk-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: agentex-sdk
-Version: 0.2.4
+Version: 0.2.5
 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.0.7
+Requires-Dist: openai-agents!=0.2.3,>=0.0.7
 Requires-Dist: pydantic<3,>=2.0.0
 Requires-Dist: pytest-asyncio>=1.0.0
 Requires-Dist: pytest>=8.4.0

{agentex_sdk-0.2.4 → agentex_sdk-0.2.5}/api.md

@@ -1,3 +1,9 @@
+# Shared Types
+
+```python
+from agentex.types import DeleteResponse
+```
+
 # Agents
 
 Types:
@@ -24,8 +30,8 @@ Methods:
 
 - <code title="get /agents/{agent_id}">client.agents.<a href="./src/agentex/resources/agents.py">retrieve</a>(agent_id) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
 - <code title="get /agents">client.agents.<a href="./src/agentex/resources/agents.py">list</a>(\*\*<a href="src/agentex/types/agent_list_params.py">params</a>) -> <a href="./src/agentex/types/agent_list_response.py">AgentListResponse</a></code>
-- <code title="delete /agents/{agent_id}">client.agents.<a href="./src/agentex/resources/agents.py">delete</a>(agent_id) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
-- <code title="delete /agents/name/{agent_name}">client.agents.<a href="./src/agentex/resources/agents.py">delete_by_name</a>(agent_name) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
+- <code title="delete /agents/{agent_id}">client.agents.<a href="./src/agentex/resources/agents.py">delete</a>(agent_id) -> <a href="./src/agentex/types/shared/delete_response.py">DeleteResponse</a></code>
+- <code title="delete /agents/name/{agent_name}">client.agents.<a href="./src/agentex/resources/agents.py">delete_by_name</a>(agent_name) -> <a href="./src/agentex/types/shared/delete_response.py">DeleteResponse</a></code>
 - <code title="get /agents/name/{agent_name}">client.agents.<a href="./src/agentex/resources/agents.py">retrieve_by_name</a>(agent_name) -> <a href="./src/agentex/types/agent.py">Agent</a></code>
 - <code title="post /agents/{agent_id}/rpc">client.agents.<a href="./src/agentex/resources/agents.py">rpc</a>(agent_id, \*\*<a href="src/agentex/types/agent_rpc_params.py">params</a>) -> <a href="./src/agentex/types/agent_rpc_response.py">AgentRpcResponse</a></code>
 - <code title="post /agents/name/{agent_name}/rpc">client.agents.<a href="./src/agentex/resources/agents.py">rpc_by_name</a>(agent_name, \*\*<a href="src/agentex/types/agent_rpc_by_name_params.py">params</a>) -> <a href="./src/agentex/types/agent_rpc_response.py">AgentRpcResponse</a></code>
@@ -35,15 +41,15 @@ Methods:
 Types:
 
 ```python
-from agentex.types import Task, TaskListResponse, TaskDeleteResponse, TaskDeleteByNameResponse
+from agentex.types import Task, TaskListResponse
 ```
 
 Methods:
 
 - <code title="get /tasks/{task_id}">client.tasks.<a href="./src/agentex/resources/tasks.py">retrieve</a>(task_id) -> <a href="./src/agentex/types/task.py">Task</a></code>
 - <code title="get /tasks">client.tasks.<a href="./src/agentex/resources/tasks.py">list</a>() -> <a href="./src/agentex/types/task_list_response.py">TaskListResponse</a></code>
-- <code title="delete /tasks/{task_id}">client.tasks.<a href="./src/agentex/resources/tasks.py">delete</a>(task_id) -> <a href="./src/agentex/types/task_delete_response.py">TaskDeleteResponse</a></code>
-- <code title="delete /tasks/name/{task_name}">client.tasks.<a href="./src/agentex/resources/tasks.py">delete_by_name</a>(task_name) -> <a href="./src/agentex/types/task_delete_by_name_response.py">TaskDeleteByNameResponse</a></code>
+- <code title="delete /tasks/{task_id}">client.tasks.<a href="./src/agentex/resources/tasks.py">delete</a>(task_id) -> <a href="./src/agentex/types/shared/delete_response.py">DeleteResponse</a></code>
+- <code title="delete /tasks/name/{task_name}">client.tasks.<a href="./src/agentex/resources/tasks.py">delete_by_name</a>(task_name) -> <a href="./src/agentex/types/shared/delete_response.py">DeleteResponse</a></code>
 - <code title="get /tasks/name/{task_name}">client.tasks.<a href="./src/agentex/resources/tasks.py">retrieve_by_name</a>(task_name) -> <a href="./src/agentex/types/task.py">Task</a></code>
 - <code title="get /tasks/{task_id}/stream">client.tasks.<a href="./src/agentex/resources/tasks.py">stream_events</a>(task_id) -> object</code>
 - <code title="get /tasks/name/{task_name}/stream">client.tasks.<a href="./src/agentex/resources/tasks.py">stream_events_by_name</a>(task_name) -> object</code>

{agentex_sdk-0.2.4 → agentex_sdk-0.2.5}/examples/tutorials/10_agentic/00_base/080_batch_events/test_batch_events.py

@@ -10,7 +10,8 @@ import asyncio
 
 # Configuration
 BASE_URL = "http://localhost:5003"
-AGENT_ID = "b4f32d71-ff69-4ac9-84d1-eb2937fea0c7"
+# AGENT_ID = "b4f32d71-ff69-4ac9-84d1-eb2937fea0c7"
+AGENT_ID = "58e78cd0-c898-4009-b5d9-eada8ebcad83"
 RPC_ENDPOINT = f"{BASE_URL}/agents/{AGENT_ID}/rpc"
 
 async def send_rpc_request(method: str, params: dict):
@@ -107,4 +108,4 @@ async def main():
     print(f"📋 Task ID: {task_id}")
 
 if __name__ == "__main__":
-    asyncio.run(main()) 
+    asyncio.run(main()) 

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

@@ -8,6 +8,7 @@ from agentex.lib.environment_variables import EnvironmentVariables
 from workflow import At010AgentChatWorkflow
 
 
+
 environment_variables = EnvironmentVariables.refresh()
 
 logger = make_logger(__name__)

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

@@ -1,5 +1,4 @@
 import asyncio
-import os
 
 from agentex.lib.core.temporal.activities import get_all_activities
 from agentex.lib.core.temporal.workers.worker import AgentexWorker

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

@@ -1,5 +1,4 @@
 import asyncio
-import json
 from typing import override
 
 from temporalio import workflow
@@ -26,6 +25,7 @@ if environment_variables.WORKFLOW_NAME is None:
 if environment_variables.AGENT_NAME is None:
     raise ValueError("Environment variable AGENT_NAME is not set")
 
+
 logger = make_logger(__name__)
 
 @workflow.defn(name=environment_variables.WORKFLOW_NAME)

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

@@ -10,6 +10,7 @@ from state_machines.deep_research import DeepResearchData, DeepResearchState
 
 logger = make_logger(__name__)
 
+
 FOLLOW_UP_QUESTION_TEMPLATE = """
 Given the following research query from the user, ask a follow up question to clarify the research direction.
 <query>

{agentex_sdk-0.2.4 → agentex_sdk-0.2.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentex-sdk"
-version = "0.2.4"
+version = "0.2.5"
 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",
+    "openai-agents>=0.0.7,!=0.2.3", # 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.2.4 → agentex_sdk-0.2.5}/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.2.4"  # x-release-please-version
+__version__ = "0.2.5"  # x-release-please-version

{agentex_sdk-0.2.4 → agentex_sdk-0.2.5}/src/agentex/lib/cli/commands/agents.py

@@ -141,13 +141,13 @@ def build(
         typer.echo("No registry provided, skipping image build")
         return
 
-    platform_list = platforms.split(",") if platforms else []
+    platform_list = platforms.split(",") if platforms else ["linux/amd64"]
 
     try:
         image_url = build_agent(
             manifest_path=manifest,
-            registry_url=registry,  # Now guaranteed to be non-None
-            repository_name=repository_name or "default-repo",  # Provide default
+            registry_url=registry,
+            repository_name=repository_name,
             platforms=platform_list,
             push=push,
             secret=secret or "",  # Provide default empty string

{agentex_sdk-0.2.4 → agentex_sdk-0.2.5}/src/agentex/lib/cli/handlers/agent_handlers.py

@@ -21,7 +21,7 @@ class DockerBuildError(Exception):
 def build_agent(
     manifest_path: str,
     registry_url: str,
-    repository_name: str,
+    repository_name: str | None,
     platforms: list[str],
     push: bool = False,
     secret: str = None,

{agentex_sdk-0.2.4 → agentex_sdk-0.2.5}/src/agentex/lib/cli/handlers/cleanup_handlers.py

@@ -168,19 +168,13 @@ def cleanup_single_task(client: Agentex, agent_name: str, task_id: str) -> None:
     """
     try:
         # Use the agent RPC method to cancel the task
-        try:
-            client.agents.rpc_by_name(
-                agent_name=agent_name,
-                method="task/cancel",
-                params={"task_id": task_id}
-            )
-            logger.debug(f"Successfully cancelled task {task_id} via agent '{agent_name}'")
-        except Exception as e:
-            # If RPC cancel fails, try direct task deletion as fallback
-            logger.warning(f"RPC task/cancel failed for task {task_id}, trying direct deletion: {e}")
-            client.tasks.delete(task_id=task_id)
-            logger.debug(f"Successfully deleted task {task_id} directly")
-        
+        client.agents.rpc_by_name(
+            agent_name=agent_name,
+            method="task/cancel",
+            params={"task_id": task_id}
+        )
+        logger.debug(f"Successfully cancelled task {task_id} via agent '{agent_name}'")
+    
     except Exception as e:
-        logger.warning(f"Failed to cleanup task {task_id}: {e}")
-        raise 
+        logger.warning(f"RPC task/cancel failed for task {task_id}: {e}")
+        raise

{agentex_sdk-0.2.4 → agentex_sdk-0.2.5}/src/agentex/lib/cli/handlers/deploy_handlers.py

@@ -11,6 +11,7 @@ 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.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
@@ -100,10 +101,24 @@ def convert_env_vars_dict_to_list(env_vars: dict[str, str]) -> list[dict[str, st
     return [{"name": key, "value": value} for key, value in env_vars.items()]
 
 
+def add_acp_command_to_helm_values(helm_values: dict[str, Any], manifest: AgentManifest, manifest_path: str) -> None:
+    """Add dynamic ACP command to helm values based on manifest configuration"""
+    try:
+        docker_acp_module = calculate_docker_acp_module(manifest, manifest_path)
+        # Create the uvicorn command with the correct module path
+        helm_values["command"] = ["uvicorn", f"{docker_acp_module}:acp", "--host", "0.0.0.0", "--port", "8000"]
+        logger.info(f"Using dynamic ACP command: uvicorn {docker_acp_module}:acp")
+    except (PathResolutionError, Exception) as e:
+        # Fallback to default command structure
+        logger.warning(f"Could not calculate dynamic ACP module ({e}), using default: project.acp")
+        helm_values["command"] = ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8000"]
+
+
 def merge_deployment_configs(
     manifest: AgentManifest,
     cluster_config: ClusterConfig | None,
     deploy_overrides: InputDeployOverrides,
+    manifest_path: str,
 ) -> dict[str, Any]:
     agent_config: AgentConfig = manifest.agent
 
@@ -176,9 +191,12 @@ def merge_deployment_configs(
         if TEMPORAL_WORKER_KEY in helm_values:
             helm_values[TEMPORAL_WORKER_KEY]["env"] = agent_config.env
 
-        encoded_principal = _encode_principal_context(manifest)
-        if encoded_principal:
-            helm_values["env"][EnvVarKeys.AUTH_PRINCIPAL_B64] = encoded_principal
+    # Add auth principal env var if manifest principal is set
+    encoded_principal = _encode_principal_context(manifest)
+    if encoded_principal:
+        if "env" not in helm_values:
+            helm_values["env"] = {}
+        helm_values["env"][EnvVarKeys.AUTH_PRINCIPAL_B64.value] = encoded_principal
 
     if manifest.deployment and manifest.deployment.imagePullSecrets:
         pull_secrets = [
@@ -228,10 +246,16 @@ def merge_deployment_configs(
     # Convert the env vars to a list of dictionaries
     if "env" in helm_values:
         helm_values["env"] = convert_env_vars_dict_to_list(helm_values["env"])
+
+    # Convert the temporal worker env vars to a list of dictionaries
     if TEMPORAL_WORKER_KEY in helm_values and "env" in helm_values[TEMPORAL_WORKER_KEY]:
         helm_values[TEMPORAL_WORKER_KEY]["env"] = convert_env_vars_dict_to_list(
             helm_values[TEMPORAL_WORKER_KEY]["env"]
         )
+    
+    # Add dynamic ACP command based on manifest configuration
+    add_acp_command_to_helm_values(helm_values, manifest, manifest_path)
+    
     print("Deploying with the following helm values: ", helm_values)
     return helm_values
 
@@ -287,7 +311,7 @@ def deploy_agent(
     add_helm_repo()
 
     # Merge configurations
-    helm_values = merge_deployment_configs(manifest, override_config, deploy_overrides)
+    helm_values = merge_deployment_configs(manifest, override_config, deploy_overrides, manifest_path)
 
     # Create values file
     values_file = create_helm_values_file(helm_values)

{agentex_sdk-0.2.4 → agentex_sdk-0.2.5}/src/agentex/lib/cli/handlers/run_handlers.py

@@ -11,6 +11,11 @@ from agentex.lib.cli.handlers.cleanup_handlers import (
     cleanup_agent_workflows,
     should_cleanup_on_restart
 )
+from agentex.lib.cli.utils.path_utils import (
+    get_file_paths,
+    calculate_uvicorn_target_for_local,
+)
+
 from agentex.lib.environment_variables import EnvVarKeys
 from agentex.lib.sdk.config.agent_manifest import AgentManifest
 from agentex.lib.utils.logging import make_logger
@@ -104,7 +109,10 @@ async def start_temporal_worker_with_reload(
             # PRE-RESTART CLEANUP - NEW!
             if current_process is not None:
                 # Extract agent name from worker path for cleanup
-                agent_name = worker_path.parent.parent.name
+
+                agent_name = env.get("AGENT_NAME")
+                if agent_name is None:
+                    agent_name = worker_path.parent.parent.name
                 
                 # Perform cleanup if configured
                 if should_cleanup_on_restart():
@@ -180,15 +188,17 @@ async def start_temporal_worker_with_reload(
 
 
 async def start_acp_server(
-    acp_path: Path, port: int, env: dict[str, str]
+    acp_path: Path, port: int, env: dict[str, str], manifest_dir: Path
 ) -> asyncio.subprocess.Process:
     """Start the ACP server process"""
-    # Use the actual file path instead of module path for better reload detection
+    # Use file path relative to manifest directory if possible
+    uvicorn_target = calculate_uvicorn_target_for_local(acp_path, manifest_dir)
+    
     cmd = [
         sys.executable,
         "-m",
         "uvicorn",
-        f"{acp_path.parent.name}.acp:acp",
+        f"{uvicorn_target}:acp",
         "--reload",
         "--reload-dir",
         str(acp_path.parent),  # Watch the project directory specifically
@@ -201,7 +211,7 @@ async def start_acp_server(
     console.print(f"[blue]Starting ACP server from {acp_path} on port {port}...[/blue]")
     return await asyncio.create_subprocess_exec(
         *cmd,
-        cwd=acp_path.parent.parent,
+        cwd=manifest_dir,  # Always use manifest directory as CWD for consistency
         env=env,
         stdout=asyncio.subprocess.PIPE,
         stderr=asyncio.subprocess.STDOUT,
@@ -218,7 +228,7 @@ async def start_temporal_worker(
 
     return await asyncio.create_subprocess_exec(
         *cmd,
-        cwd=worker_path.parent,
+        cwd=worker_path.parent,  # Use worker directory as CWD for imports to work
         env=env,
         stdout=asyncio.subprocess.PIPE,
         stderr=asyncio.subprocess.STDOUT,
@@ -280,8 +290,9 @@ async def run_agent(manifest_path: str):
         )
 
         # Start ACP server
+        manifest_dir = Path(manifest_path).parent
         acp_process = await start_acp_server(
-            file_paths["acp"], manifest.local_development.agent.port, agent_env
+            file_paths["acp"], manifest.local_development.agent.port, agent_env, manifest_dir
         )
         process_manager.add_process(acp_process)
 
@@ -291,7 +302,7 @@ async def run_agent(manifest_path: str):
         tasks = [acp_output_task]
 
         # Start temporal worker if needed
-        if is_temporal_agent(manifest):
+        if is_temporal_agent(manifest) and file_paths["worker"]:
             worker_task = await start_temporal_worker_with_reload(file_paths["worker"], agent_env, process_manager)
             tasks.append(worker_task)
 
@@ -323,92 +334,7 @@ async def run_agent(manifest_path: str):
         await process_manager.cleanup_processes()
 
 
-def resolve_and_validate_path(base_path: Path, configured_path: str, file_type: str) -> Path:
-    """Resolve and validate a configured path"""
-    path_obj = Path(configured_path)
-
-    if path_obj.is_absolute():
-        # Absolute path - use as-is
-        resolved_path = path_obj
-    else:
-        # Relative path - resolve relative to manifest directory
-        resolved_path = (base_path / configured_path).resolve()
-
-    # Validate the file exists
-    if not resolved_path.exists():
-        raise RunError(
-            f"{file_type} file not found: {resolved_path}\n"
-            f"  Configured path: {configured_path}\n"
-            f"  Resolved from manifest: {base_path}"
-        )
-
-    # Validate it's actually a file
-    if not resolved_path.is_file():
-        raise RunError(f"{file_type} path is not a file: {resolved_path}")
-
-    return resolved_path
-
-
-def validate_path_security(resolved_path: Path, manifest_dir: Path) -> None:
-    """Basic security validation for resolved paths"""
-    try:
-        # Ensure the resolved path is accessible
-        resolved_path.resolve()
-
-        # Optional: Add warnings for paths that go too far up
-        try:
-            # Check if path goes more than 3 levels up from manifest
-            relative_to_manifest = resolved_path.relative_to(manifest_dir.parent.parent.parent)
-            if str(relative_to_manifest).startswith(".."):
-                logger.warning(
-                    f"Path goes significantly outside project structure: {resolved_path}"
-                )
-        except ValueError:
-            # Path is outside the tree - that's okay, just log it
-            logger.info(f"Using path outside manifest directory tree: {resolved_path}")
-
-    except Exception as e:
-        raise RunError(f"Path resolution failed: {resolved_path} - {str(e)}") from e
-
 
-def get_file_paths(manifest: AgentManifest, manifest_path: str) -> dict[str, Path]:
-    """Get resolved file paths from manifest configuration"""
-    manifest_dir = Path(manifest_path).parent.resolve()
-
-    # Use configured paths or fall back to defaults for backward compatibility
-    if manifest.local_development and manifest.local_development.paths:
-        paths_config = manifest.local_development.paths
-
-        # Resolve ACP path
-        acp_path = resolve_and_validate_path(manifest_dir, paths_config.acp, "ACP server")
-        validate_path_security(acp_path, manifest_dir)
-
-        # Resolve worker path if specified
-        worker_path = None
-        if paths_config.worker:
-            worker_path = resolve_and_validate_path(
-                manifest_dir, paths_config.worker, "Temporal worker"
-            )
-            validate_path_security(worker_path, manifest_dir)
-    else:
-        # Backward compatibility: use old hardcoded structure
-        project_dir = manifest_dir / "project"
-        acp_path = project_dir / "acp.py"
-        worker_path = project_dir / "run_worker.py" if is_temporal_agent(manifest) else None
-
-        # Validate backward compatibility paths
-        if not acp_path.exists():
-            raise RunError(f"ACP file not found: {acp_path}")
-
-        if worker_path and not worker_path.exists():
-            raise RunError(f"Worker file not found: {worker_path}")
-
-    return {
-        "acp": acp_path,
-        "worker": worker_path,
-        "acp_dir": acp_path.parent,
-        "worker_dir": worker_path.parent if worker_path else None,
-    }
 
 
 def create_agent_environment(manifest: AgentManifest) -> dict[str, str]:

agentex_sdk-0.2.5/src/agentex/lib/cli/templates/sync/project/acp.py.j2

@@ -0,0 +1,26 @@
+from typing import AsyncGenerator, Union
+from agentex.lib.sdk.fastacp.fastacp import FastACP
+from agentex.lib.types.acp import SendMessageParams
+
+from agentex.lib.types.task_message_updates import TaskMessageUpdate
+from agentex.types.task_message_content import TaskMessageContent
+from agentex.types.text_content import TextContent
+from agentex.lib.utils.logging import make_logger
+
+logger = make_logger(__name__)
+
+
+# Create an ACP server
+acp = FastACP.create(
+    acp_type="sync",
+)
+
+@acp.on_message_send
+async def handle_message_send(
+    params: SendMessageParams
+) -> TaskMessageContent | list[TaskMessageContent] | AsyncGenerator[TaskMessageUpdate, None]:
+    """Default message handler with streaming support"""
+    return TextContent(
+        author="agent",
+        content=f"Hello! I've received your message. Here's a generic response, but in future tutorials we'll see how you can get me to intelligently respond to your message. This is what I heard you say: {params.content.content}",
+    )

agentex_sdk-0.2.5/src/agentex/lib/cli/utils/path_utils.py

@@ -0,0 +1,143 @@
+from pathlib import Path
+from typing import Dict
+
+from agentex.lib.sdk.config.agent_manifest import AgentManifest
+from agentex.lib.utils.logging import make_logger
+
+logger = make_logger(__name__)
+
+
+class PathResolutionError(Exception):
+    """An error occurred during path resolution"""
+
+
+def resolve_and_validate_path(base_path: Path, configured_path: str, file_type: str) -> Path:
+    """Resolve and validate a configured path"""
+    path_obj = Path(configured_path)
+
+    if path_obj.is_absolute():
+        # Absolute path - resolve to canonical form
+        resolved_path = path_obj.resolve()
+    else:
+        # Relative path - resolve relative to manifest directory
+        resolved_path = (base_path / configured_path).resolve()
+
+    # Validate the file exists
+    if not resolved_path.exists():
+        raise PathResolutionError(
+            f"{file_type} file not found: {resolved_path}\n"
+            f"  Configured path: {configured_path}\n"
+            f"  Resolved from manifest: {base_path}"
+        )
+
+    # Validate it's actually a file
+    if not resolved_path.is_file():
+        raise PathResolutionError(f"{file_type} path is not a file: {resolved_path}")
+
+    return resolved_path
+
+
+def validate_path_security(resolved_path: Path, manifest_dir: Path) -> None:
+    """Basic security validation for resolved paths"""
+    try:
+        # Ensure the resolved path is accessible
+        resolved_path.resolve()
+
+        # Optional: Add warnings for paths that go too far up
+        try:
+            # Check if path goes more than 3 levels up from manifest
+            relative_to_manifest = resolved_path.relative_to(manifest_dir.parent.parent.parent)
+            if str(relative_to_manifest).startswith(".."):
+                logger.warning(
+                    f"Path goes significantly outside project structure: {resolved_path}"
+                )
+        except ValueError:
+            # Path is outside the tree - that's okay, just log it
+            logger.info(f"Using path outside manifest directory tree: {resolved_path}")
+
+    except Exception as e:
+        raise PathResolutionError(f"Path resolution failed: {resolved_path} - {str(e)}") from e
+
+
+def get_file_paths(manifest: AgentManifest, manifest_path: str) -> Dict[str, Path | None]:
+    """Get resolved file paths from manifest configuration"""
+    manifest_dir = Path(manifest_path).parent.resolve()
+
+    # Use configured paths or fall back to defaults for backward compatibility
+    if manifest.local_development and manifest.local_development.paths:
+        paths_config = manifest.local_development.paths
+
+        # Resolve ACP path
+        acp_path = resolve_and_validate_path(manifest_dir, paths_config.acp, "ACP server")
+        validate_path_security(acp_path, manifest_dir)
+
+        # Resolve worker path if specified
+        worker_path = None
+        if paths_config.worker:
+            worker_path = resolve_and_validate_path(
+                manifest_dir, paths_config.worker, "Temporal worker"
+            )
+            validate_path_security(worker_path, manifest_dir)
+    else:
+        # Backward compatibility: use old hardcoded structure
+        project_dir = manifest_dir / "project"
+        acp_path = (project_dir / "acp.py").resolve()
+        worker_path = (project_dir / "run_worker.py").resolve() if manifest.agent.is_temporal_agent() else None
+
+        # Validate backward compatibility paths
+        if not acp_path.exists():
+            raise PathResolutionError(f"ACP file not found: {acp_path}")
+
+        if worker_path and not worker_path.exists():
+            raise PathResolutionError(f"Worker file not found: {worker_path}")
+
+    return {
+        "acp": acp_path,
+        "worker": worker_path,
+        "acp_dir": acp_path.parent,
+        "worker_dir": worker_path.parent if worker_path else None,
+    }
+
+
+def calculate_uvicorn_target_for_local(acp_path: Path, manifest_dir: Path) -> str:
+    """Calculate the uvicorn target path for local development"""
+    # Ensure both paths are resolved to canonical form for accurate comparison
+    acp_resolved = acp_path.resolve()
+    manifest_resolved = manifest_dir.resolve()
+    
+    try:
+        # Try to use path relative to manifest directory
+        acp_relative = acp_resolved.relative_to(manifest_resolved)
+        # Convert to module notation: project/acp.py -> project.acp
+        module_path = str(acp_relative.with_suffix(''))  # Remove .py extension
+        module_path = module_path.replace('/', '.')  # Convert slashes to dots
+        module_path = module_path.replace('\\', '.')  # Handle Windows paths
+        return module_path
+    except ValueError:
+        # Path cannot be made relative - use absolute file path
+        logger.warning(f"ACP file {acp_resolved} cannot be made relative to manifest directory {manifest_resolved}, using absolute file path")
+        return str(acp_resolved)
+
+
+def calculate_docker_acp_module(manifest: AgentManifest, manifest_path: str) -> str:
+    """Calculate the Python module path for the ACP file in the Docker container
+    
+    This should return the same module notation as local development for consistency.
+    """
+    # Use the same logic as local development
+    manifest_dir = Path(manifest_path).parent
+    
+    # Get the configured ACP path (could be relative or absolute)
+    if manifest.local_development and manifest.local_development.paths:
+        acp_config_path = manifest.local_development.paths.acp
+    else:
+        acp_config_path = "project/acp.py"  # Default
+    
+    # Resolve to actual file path
+    acp_path = resolve_and_validate_path(manifest_dir, acp_config_path, "ACP")
+    
+    # Use the same module calculation as local development
+    return calculate_uvicorn_target_for_local(acp_path, manifest_dir)
+
+
+