feat(agent): add typed server API tools

.opencode/tools/get_job_status.ts

@@ -0,0 +1,3 @@
+import { tool } from "@opencode-ai/plugin";
+import { callServerApiTool } from "./server_api_shared.js";
+export default tool({ description: "读取分析或仿真任务的状态。", args: { job_id: tool.schema.string().uuid(), job_type: tool.schema.enum(["analysis", "simulation"]) }, execute: (args, context) => callServerApiTool("get_job_status", args, context.sessionID) });

.opencode/tools/get_project_context.ts

@@ -0,0 +1,3 @@
+import { tool } from "@opencode-ai/plugin";
+import { callServerApiTool } from "./server_api_shared.js";
+export default tool({ description: "读取当前受控项目的基本信息。", args: {}, execute: (_args, context) => callServerApiTool("get_project_context", {}, context.sessionID) });

.opencode/tools/list_monitoring_assets.ts

@@ -0,0 +1,3 @@
+import { tool } from "@opencode-ai/plugin";
+import { callServerApiTool } from "./server_api_shared.js";
+export default tool({ description: "列出当前项目的监测设备和监测点。", args: { include: tool.schema.enum(["devices", "points", "all"]).default("all") }, execute: (args, context) => callServerApiTool("list_monitoring_assets", args, context.sessionID) });

.opencode/tools/query_monitoring_readings.ts

@@ -0,0 +1,3 @@
+import { tool } from "@opencode-ai/plugin";
+import { callServerApiTool } from "./server_api_shared.js";
+export default tool({ description: "按设备、时间范围、粒度和允许指标查询监测读数。", args: { device_ids: tool.schema.array(tool.schema.string().uuid()).min(1).max(100), observed_from: tool.schema.string().datetime(), observed_to: tool.schema.string().datetime(), granularity: tool.schema.enum(["5m", "1h", "1d"]).default("5m"), metrics: tool.schema.array(tool.schema.enum(["flow_mean", "flow_total", "conductivity_mean", "velocity_mean", "temperature_mean", "level_mean"])).min(1).max(6) }, execute: (args, context) => callServerApiTool("query_monitoring_readings", args, context.sessionID) });

.opencode/tools/server_api_shared.ts

@@ -0,0 +1,13 @@
+const internalBaseUrl = process.env.TJWATER_AGENT_INTERNAL_BASE_URL ?? "http://127.0.0.1:8787";
+const internalToken = process.env.TJWATER_AGENT_INTERNAL_TOKEN ?? "";
+
+export const callServerApiTool = async (name: string, args: unknown, sessionID: string) => {
+  const response = await fetch(`${internalBaseUrl}/internal/tools/server-api/${name}`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", "x-agent-internal-token": internalToken },
+    body: JSON.stringify({ session_id: sessionID, args }),
+  });
+  const text = await response.text();
+  if (!response.ok) throw new Error("TJWater domain tool bridge rejected the request");
+  return text;
+};

.opencode/tools/start_data_quality_analysis.ts

@@ -0,0 +1,3 @@
+import { tool } from "@opencode-ai/plugin";
+import { callServerApiTool } from "./server_api_shared.js";
+export default tool({ description: "创建数据质量分析任务。此操作会创建后台任务，需要用户审批。", args: { device_ids: tool.schema.array(tool.schema.string().uuid()).min(1).max(100), observed_from: tool.schema.string().datetime(), observed_to: tool.schema.string().datetime() }, execute: (args, context) => callServerApiTool("start_data_quality_analysis", args, context.sessionID) });

.opencode/tools/start_simulation.ts

@@ -0,0 +1,3 @@
+import { tool } from "@opencode-ai/plugin";
+import { callServerApiTool } from "./server_api_shared.js";
+export default tool({ description: "基于已注册模型版本创建仿真任务。此操作会创建后台任务，需要用户审批。", args: { model_version_id: tool.schema.string().uuid(), parameters: tool.schema.record(tool.schema.string(), tool.schema.unknown()).default({}) }, execute: (args, context) => callServerApiTool("start_simulation", args, context.sessionID) });

.opencode/tools/view_history.ts

@@ -2,7 +2,7 @@ import { tool } from "@opencode-ai/plugin";
 import { executeFrontendAction } from "./frontend_action.js";
 
 export default tool({
-  description: "为选定的管网要素打开前端的历史记录或计算结果面板。",
+  description: "为选定的管网要素打开前端的历史记录或计算结果面板；必须提供 ISO8601 时间区间 start_time 和 end_time。",
   args: {
     reason: tool.schema
       .string()
@@ -17,12 +17,12 @@ export default tool({
       .describe("History data source type."),
     start_time: tool.schema
       .string()
-      .optional()
-      .describe("Optional ISO8601 start time."),
+      .datetime()
+      .describe("Required ISO8601 inclusive start time for the history query."),
     end_time: tool.schema
       .string()
-      .optional()
-      .describe("Optional ISO8601 end time."),
+      .datetime()
+      .describe("Required ISO8601 exclusive end time for the history query; must be after start_time."),
   },
   async execute(args, context) {
     return executeFrontendAction("view_history", args, context);

.opencode/tools/view_scada.ts

@@ -23,6 +23,9 @@ export default tool({
       .string()
       .optional()
       .describe("Optional ISO8601 end time."),
+    result_ref: tool.schema.string().optional().describe("Authorized large monitoring result reference."),
+    metrics: tool.schema.array(tool.schema.string()).optional().describe("Metrics represented by the result."),
+    granularity: tool.schema.enum(["5m", "1h", "1d"]).optional().describe("Reading aggregation granularity."),
   },
   async execute(args, context) {
     return executeFrontendAction("view_scada", args, context);