Skip to content

Commit c2acf5c

Browse files
SWE Destroyerclaude
SWE Destroyer
and
claude
committed
Migrate debug ports to non-standard values and fix review feedback
- Migrate debug worker port from 5678 to 9678 across all files - Migrate debug ACP port from 5679 to 9679 in templates and examples - Fix health check port comment in temporal manifest templates (8080 → 5720) - Update README, CLAUDE.md, and cursor rules with new debug ports - Fix multi-agent Dockerfile CMD to use exec form for proper signal handling Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 450128b commit c2acf5c

19 files changed

Lines changed: 110 additions & 103 deletions

File tree

‎.cursor/rules/30_cli_and_commands.mdc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,4 +15,4 @@ The `agentex` CLI exposes:
1515
Development tips:
1616

1717
- For agent development, use `agentex agents run --manifest manifest.yaml`
18-
- For debugging, append `--debug-worker` and optionally `--debug-port 5679`
18+
- For debugging, append `--debug-worker` and optionally `--debug-port 9679`

‎CLAUDE.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ The package provides the `agentex` CLI with these main commands:
3838
### Agent Development
3939
- Run agents: `agentex agents run --manifest manifest.yaml`
4040
- Debug agents: `agentex agents run --manifest manifest.yaml --debug-worker`
41-
- Debug with custom port: `agentex agents run --manifest manifest.yaml --debug-worker --debug-port 5679`
41+
- Debug with custom port: `agentex agents run --manifest manifest.yaml --debug-worker --debug-port 9679`
4242

4343
## Architecture Overview
4444

‎README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ uv run agentex agents run --manifest manifest.yaml --debug-worker
8080
uv run agentex agents run --manifest manifest.yaml --debug-worker --wait-for-debugger
8181

8282
# Custom debug port
83-
uv run agentex agents run --manifest manifest.yaml --debug-worker --debug-port 5679
83+
uv run agentex agents run --manifest manifest.yaml --debug-worker --debug-port 9679
8484
```
8585

8686
For **VS Code**, add this configuration to `.vscode/launch.json`:
@@ -90,14 +90,14 @@ For **VS Code**, add this configuration to `.vscode/launch.json`:
9090
"name": "Attach to AgentEx Worker",
9191
"type": "debugpy",
9292
"request": "attach",
93-
"connect": { "host": "localhost", "port": 5678 },
93+
"connect": { "host": "localhost", "port": 9678 },
9494
"pathMappings": [{ "localRoot": "${workspaceFolder}", "remoteRoot": "." }],
9595
"justMyCode": false,
9696
"console": "integratedTerminal"
9797
}
9898
```
9999

100-
The debug server automatically finds an available port starting from 5678 and prints connection details when starting.
100+
The debug server automatically finds an available port starting from 9678 and prints connection details when starting.
101101

102102
### With aiohttp
103103

‎examples/demos/procurement_agent/project/acp.py‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616
from agentex.lib.utils.logging import make_logger
1717

1818
logger = make_logger(__name__)
19-
debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "5679"))
19+
debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "9679"))
2020
debug_type = os.getenv("AGENTEX_DEBUG_TYPE", "acp")
2121
wait_for_attach = os.getenv("AGENTEX_DEBUG_WAIT_FOR_ATTACH", "false").lower() == "true"
2222

@@ -54,6 +54,6 @@
5454
type="temporal",
5555
temporal_address=os.getenv("TEMPORAL_ADDRESS", "localhost:7233"),
5656
plugins=[OpenAIAgentsPlugin(model_provider=streaming_model_provider)],
57-
interceptors=[context_interceptor]
58-
)
59-
)
57+
interceptors=[context_interceptor],
58+
),
59+
)

‎examples/tutorials/10_async/00_base/090_multi_agent_non_temporal/Dockerfile‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,4 +54,4 @@ ENV AGENT_NAME=ab090-multi-agent-non-temporal
5454
# (ab090-creator-agent, ab090-critic-agent, ab090-formatter-agent, or ab090-orchestrator-agent)
5555

5656
# Run the agent using uvicorn
57-
CMD uvicorn project.${AGENT_FILE%.*}:acp --host 0.0.0.0 --port ${PORT:-8718}
57+
CMD ["sh", "-c", "exec uvicorn project.${AGENT_FILE%.*}:acp --host 0.0.0.0 --port ${PORT:-8718}"]

‎examples/tutorials/10_async/00_base/090_multi_agent_non_temporal/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -164,7 +164,7 @@ uv run agentex agents deploy --cluster your-cluster --manifest creator.yaml
164164
### Shared Dockerfile
165165
The Dockerfile uses build arguments to run different agents:
166166
```dockerfile
167-
CMD uvicorn project.${AGENT_FILE%.*}:acp --host 0.0.0.0 --port ${PORT:-8718}
167+
CMD ["sh", "-c", "exec uvicorn project.${AGENT_FILE%.*}:acp --host 0.0.0.0 --port ${PORT:-8718}"]
168168
```
169169

170170
Manifest files specify which agent to run:

‎examples/tutorials/10_async/10_temporal/030_custom_activities/project/acp.py‎

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,23 +5,24 @@
55
if os.getenv("AGENTEX_DEBUG_ENABLED") == "true":
66
try:
77
import debugpy
8-
debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "5679"))
8+
9+
debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "9679"))
910
debug_type = os.getenv("AGENTEX_DEBUG_TYPE", "acp")
1011
wait_for_attach = os.getenv("AGENTEX_DEBUG_WAIT_FOR_ATTACH", "false").lower() == "true"
11-
12+
1213
# Configure debugpy
1314
debugpy.configure(subProcess=False)
1415
debugpy.listen(debug_port)
15-
16+
1617
print(f"🐛 [{debug_type.upper()}] Debug server listening on port {debug_port}")
17-
18+
1819
if wait_for_attach:
1920
print(f"⏳ [{debug_type.upper()}] Waiting for debugger to attach...")
2021
debugpy.wait_for_client()
2122
print(f"✅ [{debug_type.upper()}] Debugger attached!")
2223
else:
2324
print(f"📡 [{debug_type.upper()}] Ready for debugger attachment")
24-
25+
2526
except ImportError:
2627
print("❌ debugpy not available. Install with: pip install debugpy")
2728
sys.exit(1)
@@ -40,8 +41,8 @@
4041
# When deployed to the cluster, the Temporal address will automatically be set to the cluster address
4142
# For local development, we set the address manually to talk to the local Temporal service set up via docker compose
4243
type="temporal",
43-
temporal_address=os.getenv("TEMPORAL_ADDRESS", "localhost:7233")
44-
)
44+
temporal_address=os.getenv("TEMPORAL_ADDRESS", "localhost:7233"),
45+
),
4546
)
4647

4748

@@ -57,4 +58,4 @@
5758

5859
# @acp.on_task_cancel
5960
# This does not need to be handled by your workflow.
60-
# It is automatically handled by the temporal client which cancels the workflow directly
61+
# It is automatically handled by the temporal client which cancels the workflow directly

‎examples/tutorials/10_async/10_temporal/060_open_ai_agents_sdk_hello_world/project/acp.py‎

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,23 +7,24 @@
77
if os.getenv("AGENTEX_DEBUG_ENABLED") == "true":
88
try:
99
import debugpy
10-
debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "5679"))
10+
11+
debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "9679"))
1112
debug_type = os.getenv("AGENTEX_DEBUG_TYPE", "acp")
1213
wait_for_attach = os.getenv("AGENTEX_DEBUG_WAIT_FOR_ATTACH", "false").lower() == "true"
13-
14+
1415
# Configure debugpy
1516
debugpy.configure(subProcess=False)
1617
debugpy.listen(debug_port)
17-
18+
1819
print(f"🐛 [{debug_type.upper()}] Debug server listening on port {debug_port}")
19-
20+
2021
if wait_for_attach:
2122
print(f"⏳ [{debug_type.upper()}] Waiting for debugger to attach...")
2223
debugpy.wait_for_client()
2324
print(f"✅ [{debug_type.upper()}] Debugger attached!")
2425
else:
2526
print(f"📡 [{debug_type.upper()}] Ready for debugger attachment")
26-
27+
2728
except ImportError:
2829
print("❌ debugpy not available. Install with: pip install debugpy")
2930
sys.exit(1)
@@ -52,8 +53,8 @@
5253
type="temporal",
5354
temporal_address=os.getenv("TEMPORAL_ADDRESS", "localhost:7233"),
5455
plugins=[OpenAIAgentsPlugin(model_provider=temporal_streaming_model_provider)],
55-
interceptors=[context_interceptor]
56-
)
56+
interceptors=[context_interceptor],
57+
),
5758
)
5859

5960

@@ -69,4 +70,4 @@
6970

7071
# @acp.on_task_cancel
7172
# This does not need to be handled by your workflow.
72-
# It is automatically handled by the temporal client which cancels the workflow directly
73+
# It is automatically handled by the temporal client which cancels the workflow directly

‎examples/tutorials/10_async/10_temporal/070_open_ai_agents_sdk_tools/project/acp.py‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,8 @@
77
if os.getenv("AGENTEX_DEBUG_ENABLED") == "true":
88
try:
99
import debugpy
10-
debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "5679"))
10+
11+
debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "9679"))
1112
debug_type = os.getenv("AGENTEX_DEBUG_TYPE", "acp")
1213
wait_for_attach = os.getenv("AGENTEX_DEBUG_WAIT_FOR_ATTACH", "false").lower() == "true"
1314

@@ -52,8 +53,8 @@
5253
type="temporal",
5354
temporal_address=os.getenv("TEMPORAL_ADDRESS", "localhost:7233"),
5455
plugins=[OpenAIAgentsPlugin(model_provider=temporal_streaming_model_provider)],
55-
interceptors=[context_interceptor]
56-
)
56+
interceptors=[context_interceptor],
57+
),
5758
)
5859

5960

@@ -69,4 +70,4 @@
6970

7071
# @acp.on_task_cancel
7172
# This does not need to be handled by your workflow.
72-
# It is automatically handled by the temporal client which cancels the workflow directly
73+
# It is automatically handled by the temporal client which cancels the workflow directly

‎examples/tutorials/10_async/10_temporal/080_open_ai_agents_sdk_human_in_the_loop/project/acp.py‎

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,23 +7,24 @@
77
if os.getenv("AGENTEX_DEBUG_ENABLED") == "true":
88
try:
99
import debugpy
10-
debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "5679"))
10+
11+
debug_port = int(os.getenv("AGENTEX_DEBUG_PORT", "9679"))
1112
debug_type = os.getenv("AGENTEX_DEBUG_TYPE", "acp")
1213
wait_for_attach = os.getenv("AGENTEX_DEBUG_WAIT_FOR_ATTACH", "false").lower() == "true"
13-
14+
1415
# Configure debugpy
1516
debugpy.configure(subProcess=False)
1617
debugpy.listen(debug_port)
17-
18+
1819
print(f"🐛 [{debug_type.upper()}] Debug server listening on port {debug_port}")
19-
20+
2021
if wait_for_attach:
2122
print(f"⏳ [{debug_type.upper()}] Waiting for debugger to attach...")
2223
debugpy.wait_for_client()
2324
print(f"✅ [{debug_type.upper()}] Debugger attached!")
2425
else:
2526
print(f"📡 [{debug_type.upper()}] Ready for debugger attachment")
26-
27+
2728
except ImportError:
2829
print("❌ debugpy not available. Install with: pip install debugpy")
2930
sys.exit(1)
@@ -76,7 +77,7 @@
7677
temporal_address=os.getenv("TEMPORAL_ADDRESS", "localhost:7233"),
7778
plugins=[OpenAIAgentsPlugin(model_provider=temporal_streaming_model_provider)],
7879
interceptors=[context_interceptor],
79-
)
80+
),
8081
)
8182

8283

@@ -92,4 +93,4 @@
9293

9394
# @acp.on_task_cancel
9495
# This does not need to be handled by your workflow.
95-
# It is automatically handled by the temporal client which cancels the workflow directly
96+
# It is automatically handled by the temporal client which cancels the workflow directly

0 commit comments

Comments
 (0)