scaleapi · danielmillerp · Feb 24, 2026 · Feb 24, 2026 · Feb 24, 2026
diff --git a/.cursor/rules/30_cli_and_commands.mdc b/.cursor/rules/30_cli_and_commands.mdc
@@ -15,4 +15,4 @@ The `agentex` CLI exposes:
 Development tips:
 
 - For agent development, use `agentex agents run --manifest manifest.yaml`
-- For debugging, append `--debug-worker` and optionally `--debug-port 5679`
+- For debugging, append `--debug-worker` and optionally `--debug-port 9679`
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -38,7 +38,7 @@ The package provides the `agentex` CLI with these main commands:
 ### Agent Development
 - Run agents: `agentex agents run --manifest manifest.yaml`
 - Debug agents: `agentex agents run --manifest manifest.yaml --debug-worker`
-- Debug with custom port: `agentex agents run --manifest manifest.yaml --debug-worker --debug-port 5679`
+- Debug with custom port: `agentex agents run --manifest manifest.yaml --debug-worker --debug-port 9679`
 
 ## Architecture Overview
 

diff --git a/README.md b/README.md
@@ -80,7 +80,7 @@ uv run agentex agents run --manifest manifest.yaml --debug-worker
 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
+uv run agentex agents run --manifest manifest.yaml --debug-worker --debug-port 9679
 ```
 
 For **VS Code**, add this configuration to `.vscode/launch.json`:
@@ -90,14 +90,14 @@ For **VS Code**, add this configuration to `.vscode/launch.json`:
   "name": "Attach to AgentEx Worker",
   "type": "debugpy",
   "request": "attach",
-  "connect": { "host": "localhost", "port": 5678 },
+  "connect": { "host": "localhost", "port": 9678 },
   "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.
+The debug server automatically finds an available port starting from 9678 and prints connection details when starting.
 
 ### With aiohttp
 

diff --git a/examples/demos/procurement_agent/Dockerfile b/examples/demos/procurement_agent/Dockerfile
@@ -42,7 +42,7 @@ RUN uv pip install --system .
 COPY procurement_agent/project /app/procurement_agent/project
 
 # Run the ACP server using uvicorn
-CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8000"]
+CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8718"]
 
 # When we deploy the worker, we will replace the CMD with the following
 # CMD ["python", "-m", "run_worker"] 
diff --git a/examples/demos/procurement_agent/README.md b/examples/demos/procurement_agent/README.md
@@ -85,7 +85,7 @@ uv sync
 export ENVIRONMENT=development && uv run agentex agents run --manifest manifest.yaml
 ```
 
-The agent will start and register with the AgentEx backend on port 8000.
+The agent will start and register with the AgentEx backend on port 8718.
 
 ### Step 4: Create a Task
 
@@ -365,7 +365,7 @@ tools=[
 ## Troubleshooting
 
 **Agent not appearing in UI**
-- Verify agent is running on port 8000: `lsof -i :8000`
+- Verify agent is running on port 8718: `lsof -i :8718`
 - Check `ENVIRONMENT=development` is set
 - Review agent logs for errors
 

diff --git a/examples/demos/procurement_agent/dev.ipynb b/examples/demos/procurement_agent/dev.ipynb
@@ -9,7 +9,7 @@
    "source": [
     "from agentex import Agentex\n",
     "\n",
-    "client = Agentex(base_url=\"http://localhost:5003\")"
+    "client = Agentex(base_url=\"http://localhost:5718\")"
    ]
   },
   {

diff --git a/examples/demos/procurement_agent/evals/conftest.py b/examples/demos/procurement_agent/evals/conftest.py
@@ -21,7 +21,7 @@
 
 # Set environment variables for local development
 os.environ.setdefault("AGENT_NAME", "procurement-agent")
-os.environ.setdefault("ACP_URL", "http://localhost:8000")
+os.environ.setdefault("ACP_URL", "http://localhost:8718")
 os.environ.setdefault("WORKFLOW_NAME", "procurement-agent")
 os.environ.setdefault("WORKFLOW_TASK_QUEUE", "procurement_agent_queue")
 os.environ.setdefault("TEMPORAL_ADDRESS", "localhost:7233")

diff --git a/examples/demos/procurement_agent/manifest.yaml b/examples/demos/procurement_agent/manifest.yaml
@@ -40,7 +40,7 @@ build:
 # Only used when running the agent locally
 local_development:
   agent:
-    port: 8000  # Port where your local ACP server is running
+    port: 8718  # Port where your local ACP server is running
     host_address: host.docker.internal  # Host address for Docker networking (host.docker.internal for Docker, localhost for direct) 
 
   # File paths for local development (relative to this manifest.yaml)
@@ -90,8 +90,8 @@ agent:
         queue_name: procurement_agent_queue
 
     # Optional: Health check port for temporal worker
-    # Defaults to 80 if not specified
-    # health_check_port: 80
+    # Defaults to 8080 if not specified
+    # health_check_port: 8080
 
   # Optional: Credentials mapping
   # Maps Kubernetes secrets to environment variables

diff --git a/examples/demos/procurement_agent/project/acp.py b/examples/demos/procurement_agent/project/acp.py
@@ -16,7 +16,7 @@
         from agentex.lib.utils.logging import make_logger
 
         logger = make_logger(__name__)
-        debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "5679"))
+        debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "9679"))
         debug_type = os.getenv("AGENTEX_DEBUG_TYPE", "acp")
         wait_for_attach = os.getenv("AGENTEX_DEBUG_WAIT_FOR_ATTACH", "false").lower() == "true"
 
@@ -54,6 +54,6 @@
         type="temporal",
         temporal_address=os.getenv("TEMPORAL_ADDRESS", "localhost:7233"),
         plugins=[OpenAIAgentsPlugin(model_provider=streaming_model_provider)],
-        interceptors=[context_interceptor]
-    )
-)
+        interceptors=[context_interceptor],
+    ),
+)
diff --git a/examples/demos/procurement_agent/project/scripts/happy_path.py b/examples/demos/procurement_agent/project/scripts/happy_path.py
@@ -23,7 +23,7 @@
 
 # Set defaults for local development
 os.environ.setdefault("AGENT_NAME", "procurement-agent")
-os.environ.setdefault("ACP_URL", "http://localhost:8000")
+os.environ.setdefault("ACP_URL", "http://localhost:8718")
 os.environ.setdefault("WORKFLOW_NAME", "procurement-agent")
 os.environ.setdefault("WORKFLOW_TASK_QUEUE", "procurement_agent_queue")
 os.environ.setdefault("TEMPORAL_ADDRESS", "localhost:7233")

diff --git a/examples/demos/procurement_agent/project/scripts/human_in_the_loop.py b/examples/demos/procurement_agent/project/scripts/human_in_the_loop.py
@@ -23,7 +23,7 @@
 
 # Set defaults for local development
 os.environ.setdefault("AGENT_NAME", "procurement-agent")
-os.environ.setdefault("ACP_URL", "http://localhost:8000")
+os.environ.setdefault("ACP_URL", "http://localhost:8718")
 os.environ.setdefault("WORKFLOW_NAME", "procurement-agent")
 os.environ.setdefault("WORKFLOW_TASK_QUEUE", "procurement_agent_queue")
 os.environ.setdefault("TEMPORAL_ADDRESS", "localhost:7233")

diff --git a/examples/demos/procurement_agent/project/scripts/out_of_order.py b/examples/demos/procurement_agent/project/scripts/out_of_order.py
@@ -24,7 +24,7 @@
 
 # Set defaults for local development
 os.environ.setdefault("AGENT_NAME", "procurement-agent")
-os.environ.setdefault("ACP_URL", "http://localhost:8000")
+os.environ.setdefault("ACP_URL", "http://localhost:8718")
 os.environ.setdefault("WORKFLOW_NAME", "procurement-agent")
 os.environ.setdefault("WORKFLOW_TASK_QUEUE", "procurement_agent_queue")
 os.environ.setdefault("TEMPORAL_ADDRESS", "localhost:7233")

diff --git a/examples/demos/procurement_agent/project/scripts/send_test_events.py b/examples/demos/procurement_agent/project/scripts/send_test_events.py
@@ -24,7 +24,7 @@
 
 # Set defaults for local development
 os.environ.setdefault("AGENT_NAME", "procurement-agent")
-os.environ.setdefault("ACP_URL", "http://localhost:8000")
+os.environ.setdefault("ACP_URL", "http://localhost:8718")
 os.environ.setdefault("WORKFLOW_NAME", "procurement-agent")
 os.environ.setdefault("WORKFLOW_TASK_QUEUE", "procurement_agent_queue")
 os.environ.setdefault("TEMPORAL_ADDRESS", "localhost:7233")

diff --git a/examples/demos/procurement_agent/project/scripts/send_test_events_lite.py b/examples/demos/procurement_agent/project/scripts/send_test_events_lite.py
@@ -24,7 +24,7 @@
 
 # Set defaults for local development
 os.environ.setdefault("AGENT_NAME", "procurement-agent")
-os.environ.setdefault("ACP_URL", "http://localhost:8000")
+os.environ.setdefault("ACP_URL", "http://localhost:8718")
 os.environ.setdefault("WORKFLOW_NAME", "procurement-agent")
 os.environ.setdefault("WORKFLOW_TASK_QUEUE", "procurement_agent_queue")
 os.environ.setdefault("TEMPORAL_ADDRESS", "localhost:7233")

diff --git a/examples/launch-tutorials.sh b/examples/launch-tutorials.sh
@@ -220,8 +220,8 @@ manual_cleanup() {
     fi
 
     # Check for occupied ports
-    print_colored $YELLOW "🔍 Checking common tutorial ports (8000-8003)..."
-    local port_check=$(lsof -i :8000 -i :8001 -i :8002 -i :8003 2>/dev/null || true)
+    print_colored $YELLOW "🔍 Checking common tutorial ports (8718-8721)..."
+    local port_check=$(lsof -i :8718 -i :8719 -i :8720 -i :8721 2>/dev/null || true)
     if [[ -n "$port_check" ]]; then
         found_processes=true
         echo "$port_check"

diff --git a/examples/tutorials/00_sync/000_hello_acp/Dockerfile b/examples/tutorials/00_sync/000_hello_acp/Dockerfile
@@ -48,4 +48,4 @@ ENV PYTHONPATH=/app
 ENV AGENT_NAME=000-hello-acp
 
 # Run the agent using uvicorn
-CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8000"] 
+CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8718"] 
diff --git a/examples/tutorials/00_sync/000_hello_acp/dev.ipynb b/examples/tutorials/00_sync/000_hello_acp/dev.ipynb
@@ -9,7 +9,7 @@
    "source": [
     "from agentex import Agentex\n",
     "\n",
-    "client = Agentex(base_url=\"http://localhost:5003\")"
+    "client = Agentex(base_url=\"http://localhost:5718\")"
    ]
   },
   {

diff --git a/examples/tutorials/00_sync/000_hello_acp/manifest.yaml b/examples/tutorials/00_sync/000_hello_acp/manifest.yaml
@@ -40,7 +40,7 @@ build:
 # Only used when running the agent locally
 local_development:
   agent:
-    port: 8000 # Port where your local ACP server is running
+    port: 8718 # Port where your local ACP server is running
     host_address: host.docker.internal # Host address for Docker networking (host.docker.internal for Docker, localhost for direct)
 
   # File paths for local development (relative to this manifest.yaml)

diff --git a/examples/tutorials/00_sync/000_hello_acp/tests/test_agent.py b/examples/tutorials/00_sync/000_hello_acp/tests/test_agent.py
@@ -12,7 +12,7 @@
 3. Run: pytest test_agent.py -v
 
 Configuration:
-- AGENTEX_API_BASE_URL: Base URL for the AgentEx server (default: http://localhost:5003)
+- AGENTEX_API_BASE_URL: Base URL for the AgentEx server (default: http://localhost:5718)
 - AGENT_NAME: Name of the agent to test (default: hello-acp)
 """
 
@@ -26,7 +26,7 @@
 from agentex.types.task_message_update import StreamTaskMessageFull, StreamTaskMessageDelta
 
 # Configuration from environment variables
-AGENTEX_API_BASE_URL = os.environ.get("AGENTEX_API_BASE_URL", "http://localhost:5003")
+AGENTEX_API_BASE_URL = os.environ.get("AGENTEX_API_BASE_URL", "http://localhost:5718")
 AGENT_NAME = os.environ.get("AGENT_NAME", "s000-hello-acp")
 
 

diff --git a/examples/tutorials/00_sync/010_multiturn/Dockerfile b/examples/tutorials/00_sync/010_multiturn/Dockerfile
@@ -48,4 +48,4 @@ ENV PYTHONPATH=/app
 ENV AGENT_NAME=010-multiturn
 
 # Run the agent using uvicorn
-CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8000"] 
+CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8718"] 
diff --git a/examples/tutorials/00_sync/010_multiturn/dev.ipynb b/examples/tutorials/00_sync/010_multiturn/dev.ipynb
@@ -9,7 +9,7 @@
    "source": [
     "from agentex import Agentex\n",
     "\n",
-    "client = Agentex(base_url=\"http://localhost:5003\")"
+    "client = Agentex(base_url=\"http://localhost:5718\")"
    ]
   },
   {

diff --git a/examples/tutorials/00_sync/010_multiturn/manifest.yaml b/examples/tutorials/00_sync/010_multiturn/manifest.yaml
@@ -41,7 +41,7 @@ build:
 # Only used when running the agent locally
 local_development:
   agent:
-    port: 8000  # Port where your local ACP server is running
+    port: 8718  # Port where your local ACP server is running
     host_address: host.docker.internal  # Host address for Docker networking (host.docker.internal for Docker, localhost for direct) 
 
   # File paths for local development (relative to this manifest.yaml)

diff --git a/examples/tutorials/00_sync/010_multiturn/tests/test_agent.py b/examples/tutorials/00_sync/010_multiturn/tests/test_agent.py
@@ -12,7 +12,7 @@
 3. Run: pytest test_agent.py -v
 
 Configuration:
-- AGENTEX_API_BASE_URL: Base URL for the AgentEx server (default: http://localhost:5003)
+- AGENTEX_API_BASE_URL: Base URL for the AgentEx server (default: http://localhost:5718)
 - AGENT_NAME: Name of the agent to test (default: s010-multiturn)
 """
 
@@ -27,7 +27,7 @@
 from agentex.lib.sdk.fastacp.base.base_acp_server import uuid
 
 # Configuration from environment variables
-AGENTEX_API_BASE_URL = os.environ.get("AGENTEX_API_BASE_URL", "http://localhost:5003")
+AGENTEX_API_BASE_URL = os.environ.get("AGENTEX_API_BASE_URL", "http://localhost:5718")
 AGENT_NAME = os.environ.get("AGENT_NAME", "s010-multiturn")
 
 

diff --git a/examples/tutorials/00_sync/020_streaming/Dockerfile b/examples/tutorials/00_sync/020_streaming/Dockerfile
@@ -47,4 +47,4 @@ ENV PYTHONPATH=/app
 ENV AGENT_NAME=020-streaming
 
 # Run the agent using uvicorn
-CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8000"]
+CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8718"]
diff --git a/examples/tutorials/00_sync/020_streaming/dev.ipynb b/examples/tutorials/00_sync/020_streaming/dev.ipynb
@@ -9,7 +9,7 @@
    "source": [
     "from agentex import Agentex\n",
     "\n",
-    "client = Agentex(base_url=\"http://localhost:5003\")"
+    "client = Agentex(base_url=\"http://localhost:5718\")"
    ]
   },
   {

diff --git a/examples/tutorials/00_sync/020_streaming/manifest.yaml b/examples/tutorials/00_sync/020_streaming/manifest.yaml
@@ -42,7 +42,7 @@ build:
 # Only used when running the agent locally
 local_development:
   agent:
-    port: 8000  # Port where your local ACP server is running
+    port: 8718  # Port where your local ACP server is running
     host_address: host.docker.internal  # Host address for Docker networking (host.docker.internal for Docker, localhost for direct) 
 
   # File paths for local development (relative to this manifest.yaml)

diff --git a/examples/tutorials/00_sync/020_streaming/tests/test_agent.py b/examples/tutorials/00_sync/020_streaming/tests/test_agent.py
@@ -12,7 +12,7 @@
 3. Run: pytest test_agent.py -v
 
 Configuration:
-- AGENTEX_API_BASE_URL: Base URL for the AgentEx server (default: http://localhost:5003)
+- AGENTEX_API_BASE_URL: Base URL for the AgentEx server (default: http://localhost:5718)
 - AGENT_NAME: Name of the agent to test (default: s020-streaming)
 """
 
@@ -27,7 +27,7 @@
 from agentex.lib.sdk.fastacp.base.base_acp_server import uuid
 
 # Configuration from environment variables
-AGENTEX_API_BASE_URL = os.environ.get("AGENTEX_API_BASE_URL", "http://localhost:5003")
+AGENTEX_API_BASE_URL = os.environ.get("AGENTEX_API_BASE_URL", "http://localhost:5718")
 AGENT_NAME = os.environ.get("AGENT_NAME", "s020-streaming")
 
 

diff --git a/examples/tutorials/00_sync/030_langgraph/Dockerfile b/examples/tutorials/00_sync/030_langgraph/Dockerfile
@@ -47,4 +47,4 @@ ENV PYTHONPATH=/app
 ENV AGENT_NAME=s030-langgraph
 
 # Run the agent using uvicorn
-CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8000"]
+CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8718"]
diff --git a/examples/tutorials/00_sync/030_langgraph/manifest.yaml b/examples/tutorials/00_sync/030_langgraph/manifest.yaml
@@ -9,7 +9,7 @@ build:
 
 local_development:
   agent:
-    port: 8000
+    port: 8718
     host_address: host.docker.internal
   paths:
     acp: project/acp.py

diff --git a/examples/tutorials/00_sync/030_langgraph/tests/test_agent.py b/examples/tutorials/00_sync/030_langgraph/tests/test_agent.py
@@ -11,7 +11,7 @@
 3. Run: pytest test_agent.py -v
 
 Configuration:
-- AGENTEX_API_BASE_URL: Base URL for the AgentEx server (default: http://localhost:5003)
+- AGENTEX_API_BASE_URL: Base URL for the AgentEx server (default: http://localhost:5718)
 - AGENT_NAME: Name of the agent to test (default: s030-langgraph)
 """
 
@@ -26,7 +26,7 @@
 from agentex.lib.sdk.fastacp.base.base_acp_server import uuid
 
 # Configuration from environment variables
-AGENTEX_API_BASE_URL = os.environ.get("AGENTEX_API_BASE_URL", "http://localhost:5003")
+AGENTEX_API_BASE_URL = os.environ.get("AGENTEX_API_BASE_URL", "http://localhost:5718")
 AGENT_NAME = os.environ.get("AGENT_NAME", "s030-langgraph")
 
 

diff --git a/examples/tutorials/10_async/00_base/000_hello_acp/Dockerfile b/examples/tutorials/10_async/00_base/000_hello_acp/Dockerfile
@@ -48,4 +48,4 @@ ENV PYTHONPATH=/app
 ENV AGENT_NAME=ab000-hello-acp
 
 # Run the agent using uvicorn
-CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8000"] 
+CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8718"] 
diff --git a/examples/tutorials/10_async/00_base/000_hello_acp/dev.ipynb b/examples/tutorials/10_async/00_base/000_hello_acp/dev.ipynb
@@ -9,7 +9,7 @@
    "source": [
     "from agentex import Agentex\n",
     "\n",
-    "client = Agentex(base_url=\"http://localhost:5003\")"
+    "client = Agentex(base_url=\"http://localhost:5718\")"
    ]
   },
   {

diff --git a/examples/tutorials/10_async/00_base/000_hello_acp/manifest.yaml b/examples/tutorials/10_async/00_base/000_hello_acp/manifest.yaml
@@ -41,7 +41,7 @@ build:
 # Only used when running the agent locally
 local_development:
   agent:
-    port: 8000  # Port where your local ACP server is running
+    port: 8718  # Port where your local ACP server is running
     host_address: host.docker.internal  # Host address for Docker networking (host.docker.internal for Docker, localhost for direct) 
 
   # File paths for local development (relative to this manifest.yaml)

diff --git a/examples/tutorials/10_async/00_base/000_hello_acp/tests/test_agent.py b/examples/tutorials/10_async/00_base/000_hello_acp/tests/test_agent.py
@@ -11,7 +11,7 @@
 3. Run: pytest test_agent.py -v
 
 Configuration:
-- AGENTEX_API_BASE_URL: Base URL for the AgentEx server (default: http://localhost:5003)
+- AGENTEX_API_BASE_URL: Base URL for the AgentEx server (default: http://localhost:5718)
 - AGENT_NAME: Name of the agent to test (default: ab000-hello-acp)
 """
 
@@ -33,7 +33,7 @@
 from agentex.types.text_content_param import TextContentParam
 
 # Configuration from environment variables
-AGENTEX_API_BASE_URL = os.environ.get("AGENTEX_API_BASE_URL", "http://localhost:5003")
+AGENTEX_API_BASE_URL = os.environ.get("AGENTEX_API_BASE_URL", "http://localhost:5718")
 AGENT_NAME = os.environ.get("AGENT_NAME", "ab000-hello-acp")
 
 

diff --git a/examples/tutorials/10_async/00_base/010_multiturn/Dockerfile b/examples/tutorials/10_async/00_base/010_multiturn/Dockerfile
@@ -48,4 +48,4 @@ ENV PYTHONPATH=/app
 ENV AGENT_NAME=ab010-multiturn
 
 # Run the agent using uvicorn
-CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8000"] 
+CMD ["uvicorn", "project.acp:acp", "--host", "0.0.0.0", "--port", "8718"]