Prefer multi-NE execManagedNe batch and parallelize read MCP tools.

Guide ops to use ne_ids/ume_ne_ids for sweeps, raise exec wall-clock for batches, and mark inventory/list MCP tools read_only so consecutive queries can run in parallel.

Co-authored-by: Cursor <cursoragent@cursor.com>

runtime/tools/mcp/adapter.py

@@ -21,8 +21,9 @@ def _mcp_row_env_config(row: dict[str, Any]) -> tuple[list[str], dict[str, str]]
 
 # Long-running netx tools exceed the generic MCP row timeout (often 30s).
 # Production WA ops showed execManagedNe p90/p95 glued to ~30000ms timeouts.
+# Batch multi-NE exec posts once to /exec-batch (server concurrency); allow longer wall clock.
 _MCP_TOOL_TIMEOUT_OVERRIDES_S: dict[str, float] = {
-    "execManagedNe": 320.0,
+    "execManagedNe": 620.0,
     "sqlQueryUme": 90.0,
     "findTopologyPaths": 60.0,
     "aggregateUmeAlarmsRaw": 60.0,
@@ -44,6 +45,26 @@ _MCP_LIST_CACHE_TTL_S: dict[str, float] = {
     "findTopologyPaths": 60.0,
 }
 
+# Safe to run in parallel with other consecutive read-only tools (separate MCP stdio processes).
+# Do NOT include execManagedNe: same-tool fans share one stdio lock — use ne_ids/ume_ne_ids batch instead.
+_MCP_READ_ONLY_TOOLS: frozenset[str] = frozenset(
+    {
+        "listCliTargets",
+        "listManagedNe",
+        "getManagedNe",
+        "getUmeNe",
+        "queryUmeNeInventory",
+        "queryUmeAlarms",
+        "queryUmeAlarmsRaw",
+        "aggregateUmeAlarms",
+        "aggregateUmeAlarmsRaw",
+        "listUmeAlarmFields",
+        "runUmeDiagnostics",
+        "findTopologyPaths",
+        "sqlQueryUme",
+    }
+)
+
 _MCP_LIST_CACHE_LOCK = threading.Lock()
 _MCP_LIST_CACHE: dict[str, tuple[float, float, dict[str, Any]]] = {}
 
@@ -176,6 +197,7 @@ class _McpBoundTool:
             timeout_s=self.timeout_s,
             required_permissions=self.required_permissions,
             execution_mode="subprocess",
+            read_only=self.tool_name in _MCP_READ_ONLY_TOOLS,
         )
 
 

runtime/workspaces/ops/ROLE_SYSTEM.en.md

@@ -38,7 +38,7 @@ You are the ops specialist (network operations expert).
 - Spreadsheet delivery: `ume_alarm_xlsx_report` or `write_xlsx(deliverable=true)` — never claim a file was sent without deliverable marking.
 - **Field default is English**: WhatsApp channel dispatch defaults to `lang=en`; user-visible replies must contain **zero CJK**. Translate Chinese tool fields before display.
 - Group chats default to **per-speaker session isolation** (members do not share dialogue memory within the same group).
-- Call `listCliTargets` at most once per session and reuse ids; batch `execManagedNe` commands; default `read_timeout_sec=60` — on timeout raise it, no blind retries.
+- Call `listCliTargets` at most once per session and reuse ids; for many NEs with the same show commands use one `execManagedNe(ne_ids|ume_ne_ids=..., commands=...)` (server concurrency) — do not loop one-NE calls; default `read_timeout_sec=60` — on timeout raise it, no blind retries.
 - Replies like `YES` / `confirm` / `继续` / `please continue`: continue the previous unfinished task — do **not** re-ask for confirmation or restart the query.
 - On `tool_invalid_arguments`, fix args using the returned `example`; on timeout hints, raise `read_timeout_sec` or shrink commands.
 

runtime/workspaces/ops/ROLE_SYSTEM.md

@@ -29,7 +29,7 @@
 - 用户要表格/Excel：`ume_alarm_xlsx_report` 或 `write_xlsx(deliverable=true)`；禁止只写文件不投递。
 - **现场默认英文**：WhatsApp 渠道默认 `lang=en`；英文会话回复不得含汉字；工具中文字段先翻译再展示。
 - 群聊默认按**发言人隔离会话**（同群不同人互不串上下文）；勿假设「群共享一个对话记忆」。
-- `listCliTargets` 每会话最多查一次并复用 id；`execManagedNe` 合并 commands，超时调 `read_timeout_sec`（默认 60），禁止盲重试。
+- `listCliTargets` 每会话最多查一次并复用 id；多台同命令用 `execManagedNe(ne_ids|ume_ne_ids=..., commands=...)` 一批并发，勿逐台循环；超时调 `read_timeout_sec`（默认 60），禁止盲重试。
 - 用户回复 `YES` / `confirm` / `确认` / `可以` / `继续` / `please continue`：直接承接上一未完成任务继续执行，**不要**再问一遍确认或重开查询。
 - 工具返回 `tool_invalid_arguments` 时按返回的 `example` 修正参数；返回超时 hint 时提高 `read_timeout_sec` 或减命令，禁止相同参数重试。