feat(agent): add typed server API tools

.opencode/agents/instruction.md

@@ -33,8 +33,11 @@ Agent 负责：
 | 历史会话检索 | `session_search` |
 | 用户偏好和项目事实 | `memory_manager` |
 | 可复用流程沉淀 | `skill_manager` |
-
-当前实验版没有通用 TJWater 数据查询工具；如果缺少业务数据，应明确说明数据能力尚未接入，不得编造结果。
+| 项目背景 | `get_project_context` |
+| 监测设备/点位 | `list_monitoring_assets` |
+| 监测时序读数 | `query_monitoring_readings`（必须给出 `observed_from`、`observed_to`） |
+| 数据质量分析 | `start_data_quality_analysis`、`get_job_status` |
+| SWMM 仿真 | `start_simulation`、`get_job_status` |
 
 ## UI 约束
 
@@ -58,3 +61,18 @@ Agent 负责：
 ## 记忆持久化
 
 `memory_manager` 只保存长期有效的稳定事实或用户偏好。修改 memory 前先 list 当前 scope，再决定 add、replace 或 remove。
+## TJWater Server 受控领域工具
+
+仅通过领域工具访问 Server；不得构造 URL、HTTP header、SQL、命令或项目 ID。
+
+- 项目背景：`get_project_context`
+- 设备/监测点：`list_monitoring_assets`
+- 时序读数：`query_monitoring_readings`
+- 数据质量任务：`start_data_quality_analysis`（写操作，必须等待审批）
+- 仿真任务：`start_simulation`（写操作，必须等待审批）
+- 任务状态：`get_job_status`
+
+查询历史监测数据时，必须先明确时间区间；不清楚区间时先追问，不得省略或自行扩大范围。需要数值结论时先调用 `query_monitoring_readings`，传入 `observed_from`、`observed_to`、`granularity`、`metrics` 和设备 ID，再调用 `show_chart` 或 `view_history` 展示。`view_history` 只负责打开前端历史面板，也必须传入 `start_time`、`end_time`。
+先查询数据再作判断。回答必须说明查询时间范围、粒度、指标，以及已创建任务的 ID 和状态。
+遇到空数据、拒绝、权限错误、超时或服务不可用时，明确说明事实，不得补全或猜测结果。
+工具返回 `result_ref` 时，说明完整结果已安全存储，并使用 preview 中的样本和统计作答。