feat(agent): per-category tool timeouts with graceful degradation (#1890) (#2134)

.env.example

@@ -507,6 +507,15 @@ AGENT_SKILLS=
 # AGENT_PORTFOLIO_AGENT_TIMEOUT_S=0
 # AGENT_SKILL_AGENT_TIMEOUT_S=0
 
+# Agent 工具按类别默认超时（秒，0=关闭；未配置时回退到全局 tool_call_timeout_seconds 预算）
+# 有效超时按 first-wins 解析：显式 per-run tool_call_timeout_seconds > 单工具显式 timeout_seconds > 类别默认值 > 无限制；
+# 剩余 wall-clock 预算仅作不可突破的外层 cap；inf/nan/负数视为无限制。
+# market 类工具（get_market_indices / get_sector_rankings 等网络数据调用）复用 AGENT_DATA_TOOL_TIMEOUT_S，无独立开关。
+# AGENT_DATA_TOOL_TIMEOUT_S=0
+# AGENT_SEARCH_TOOL_TIMEOUT_S=0
+# AGENT_ANALYSIS_TOOL_TIMEOUT_S=0
+# AGENT_ACTION_TOOL_TIMEOUT_S=0
+
 # 策略专家并发数（仅 specialist 模式生效；范围 1-4，默认 3）
 # AGENT_SKILL_CONCURRENCY=3