fix(mcp): launch bundled cao-mcp-server without a per-launch network fetch

CHANGELOG.md

@@ -31,6 +31,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+- mcp: bundled agent profiles now launch the installed `cao-mcp-server` console script instead of re-fetching the whole package from GitHub via `uvx --from git+…@main` on every agent launch — the cold fetch (~20s) exceeded some providers' MCP startup timeout (Codex: 10s), so agents came up without their orchestration tools (`handoff`/`assign`/`send_message`) and silently could not delegate; a shared resolver (`utils/mcp_resolution.py`) rewrites the bare command to a PATH-independent invocation (interpreter-sibling → PATH → `python -m`), used by all providers, and a regression test keeps new profiles from reintroducing the network fetch (#403)
+
 - claude_code: a backgrounded task ("✻ Waiting for N dynamic workflow(s) to finish") no longer reads as COMPLETED — the wait line has no spinner ellipsis (invisible to every PROCESSING check) while the printed response + idle ❯ box look like a finished turn, and it even matched the lenient completion pattern; both the raw-buffer and pyte screen paths now report PROCESSING until a newer response/completion summary appears, so dashboards and wait_until_terminal_status no longer see a mid-run terminal as done (#392)
 
 - fifo: non-blocking FIFO reader loop and event-loop-safe session teardown — reader threads can no longer be stranded in a blocking FIFO `open()` by a stop/reopen race, and `DELETE /sessions` runs teardown in a worker thread, so repeated create/delete cycles can no longer wedge cao-server (#382)

docs/agent-profile.md

@@ -65,11 +65,8 @@ allowedTools:
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # DEVELOPER AGENT

examples/assign/README.md

@@ -60,11 +60,8 @@ description: Your agent description
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 ```
 

examples/assign/analysis_supervisor.md

@@ -5,11 +5,8 @@ role: supervisor  # @cao-mcp-server, fs_read, fs_list. For fine-grained control,
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # ANALYSIS SUPERVISOR AGENT

examples/assign/data_analyst.md

@@ -5,11 +5,8 @@ role: developer  # @builtin, fs_*, execute_bash, @cao-mcp-server. For fine-grain
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # DATA ANALYST AGENT

examples/assign/report_generator.md

@@ -5,11 +5,8 @@ role: developer  # @builtin, fs_*, execute_bash, @cao-mcp-server. For fine-grain
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # REPORT GENERATOR AGENT

examples/aws/cloudwatch-logs/cloudwatch-logs-agent.md

@@ -7,11 +7,8 @@ allowedTools:
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # CloudWatch Logs Agent

examples/aws/dynamodb-delete/dynamodb-delete-agent.md

@@ -7,11 +7,8 @@ allowedTools:
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # DynamoDB Delete Agent

examples/aws/dynamodb-query/dynamodb-query-agent.md

@@ -7,11 +7,8 @@ allowedTools:
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # DynamoDB Query Agent

examples/aws/sqs-dlq-check/sqs-dlq-check-agent.md

@@ -7,11 +7,8 @@ allowedTools:
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # SQS DLQ Check Agent

examples/aws/sqs-monitor/sqs-monitor-agent.md

@@ -7,11 +7,8 @@ allowedTools:
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # SQS Monitor Agent

examples/aws/sqs-send/sqs-send-agent.md

@@ -7,11 +7,8 @@ allowedTools:
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # SQS Send Agent

examples/aws/stepfunction/stepfunction-agent.md

@@ -7,11 +7,8 @@ allowedTools:
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # Step Functions Agent

examples/codex-basic/codex_developer.md

@@ -6,11 +6,8 @@ role: developer  # @builtin, fs_*, execute_bash, @cao-mcp-server. For fine-grain
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 
 skills: [python, javascript, typescript, debugging, testing, api-development, documentation]
 experience_level: senior

examples/codex-basic/codex_documenter.md

@@ -6,11 +6,8 @@ role: developer  # @builtin, fs_*, execute_bash, @cao-mcp-server. For fine-grain
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 
 skills: [technical-writing, api-documentation, user-guides, tutorials, readme-creation, developer-docs]
 experience_level: senior

examples/codex-basic/codex_reviewer.md

@@ -6,11 +6,8 @@ role: reviewer  # @builtin, fs_read, fs_list, @cao-mcp-server. For fine-grained
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 
 skills: [code-review, security-audit, performance-analysis, best-practices, testing-strategies, documentation-review]
 experience_level: senior

examples/cross-provider/README.md

@@ -137,11 +137,8 @@ provider: codex
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 ```
 

examples/cross-provider/cross_provider_supervisor.md

@@ -5,11 +5,8 @@ role: supervisor  # @cao-mcp-server, fs_read, fs_list. For fine-grained control,
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # CROSS-PROVIDER SUPERVISOR AGENT

examples/cross-provider/data_analyst_claude_code.md

@@ -6,11 +6,8 @@ role: developer  # @builtin, fs_*, execute_bash, @cao-mcp-server. For fine-grain
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # DATA ANALYST AGENT

examples/cross-provider/data_analyst_codex.md

@@ -6,11 +6,8 @@ role: developer  # @builtin, fs_*, execute_bash, @cao-mcp-server. For fine-grain
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # DATA ANALYST AGENT

examples/cross-provider/data_analyst_copilot_cli.md

@@ -6,11 +6,8 @@ role: developer  # @builtin, fs_*, execute_bash, @cao-mcp-server. For fine-grain
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # DATA ANALYST AGENT

examples/cross-provider/data_analyst_kimi_cli.md

@@ -6,11 +6,8 @@ role: developer  # @builtin, fs_*, execute_bash, @cao-mcp-server. For fine-grain
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # DATA ANALYST AGENT

examples/cross-provider/data_analyst_kiro_cli.md

@@ -6,11 +6,8 @@ role: developer  # @builtin, fs_*, execute_bash, @cao-mcp-server. For fine-grain
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # DATA ANALYST AGENT

examples/cross-provider/report_generator_codex.md

@@ -6,11 +6,8 @@ role: developer  # @builtin, fs_*, execute_bash, @cao-mcp-server. For fine-grain
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # REPORT GENERATOR AGENT

examples/orchestration/dev-kimi.md

@@ -6,11 +6,8 @@ role: developer
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # CODING WORKER (Kimi)

examples/orchestration/dev-opus.md

@@ -7,11 +7,8 @@ role: developer
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # CODING WORKER (Opus)

examples/orchestration/dev-sonnet.md

@@ -7,11 +7,8 @@ role: developer
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # CODING WORKER (Sonnet)

examples/orchestration/reviewer-opus.md

@@ -7,11 +7,8 @@ role: reviewer
 mcpServers:
   cao-mcp-server:
     type: stdio
-    command: uvx
-    args:
-      - "--from"
-      - "git+https://github.com/awslabs/cli-agent-orchestrator.git@main"
-      - "cao-mcp-server"
+    command: cao-mcp-server
+    args: []
 ---
 
 # CODE REVIEWER (Opus)