feat: upgrade investigation and presentation runtime

.opencode/tools/present_answer.ts

@@ -2,9 +2,35 @@ import { tool } from "../tool.js";
 import { answerUiInputSchema } from "../../src/chat/answer-ui.js";
 import catalog from "../../src/chat/answer-ui-catalog.json" with { type: "json" };
 
+// These complete call pairs also serve as executable contract examples in tests.
+export const answerUiExamples: Array<{
+  present_answer: ReturnType<typeof answerUiInputSchema.parse>;
+  final_answer: { answer: string; ui_block_ids: string[] };
+}> = [
+  {
+    present_answer: {
+      phase: "final" as const, block_id: "demo_comparison", fallback_text: "演练资料：甲管径 300 mm，乙管径 200 mm。",
+      spec: { root: "table", elements: { table: {
+        type: "Table", props: { title: "管径比较（用户提供的演练资料）", columns: ["对象", "管径（mm）"], rows: [["甲", "300"], ["乙", "200"]] }, children: [],
+      } } },
+    },
+    final_answer: { answer: "甲的管径较大，不能仅凭管径判断实际供水能力。\n\n[[ui:demo_comparison]]", ui_block_ids: ["demo_comparison"] },
+  },
+  {
+    present_answer: {
+      phase: "final" as const, block_id: "demo_trend", fallback_text: "演练资料：08:00、09:00、10:00 压力依次为 0.30、0.28、0.18 MPa。",
+      spec: { root: "chart", elements: { chart: {
+        type: "Chart", props: { title: "压力变化（MPa）", chart_type: "line", x_data: ["08:00", "09:00", "10:00"], series: [{ name: "压力（MPa）", data: [0.30, 0.28, 0.18] }], source: "用户提供的演练资料，非现场实测" }, children: [],
+      } } },
+    },
+    final_answer: { answer: "演练序列中后一个时段下降更明显，原因仍需其他证据判断。\n\n[[ui:demo_trend]]", ui_block_ids: ["demo_trend"] },
+  },
+];
+
 export default tool({
-  description: "把回答的一段内容发布为本地交互界面。spec 是 root + elements 的扁平树，每个元素包括 type、props、children。只组织真实查询资料或用户事实；无脚本、URL 或任意代码。不执行地图或业务动作，不等待浏览器，不代表业务完成。相同 block_id 更新本轮同一内容块。组件参数的 JSON Schema：" + JSON.stringify(catalog.props),
+  description: "把已有资料发布为保留在聊天中的交互内容。多对象同类字段比较优先用 Table，数值时间序列分析优先用 Chart，不等用户指定组件；简单解释、单个事实和简短确认直接用文字。用户明确要求纯文字时遵从。工作台窗口与地图动作另用 present_view。spec 是 root + elements 的扁平树，每个元素包括 type、props、children；单个组件可以直接作为 root。关键指标用 Metric，复杂结果用 Result（status 必须有真实依据），可复核依据用 Evidence，反复定位入口用 MapLocation，最终答复后的可选补充用 FollowUpForm。只组织查询结果或用户提供的资料，保留来源、单位、范围及演练标识；缺数不补造、不补零，不为布局凑卡片。无脚本、URL、CSS 或任意代码。Result 不执行动作，演练或记录成功不等于现场成功；发布不执行地图或业务动作，也不等待浏览器。Stack 的 columns/gap 仍必填，可选 intent=response|comparison|report、density=compact|comfortable；Section 可选 role=result|analysis|evidence|follow_up，Text 可选 title。需要保留的内容直接显式 phase=final，无须先发布 process；仅临时过程材料用 phase=process，省略仍默认 process。相同 block_id 只能同 phase 更新；过程材料转为最终内容须另用 block_id。final_answer 前完成所有更新，并通过独立正文锚点和 ui_block_ids 引用 final 块，正文不抄写整表或重复全文。下列是两组独立的最小调用示例，实际调用必须替换为本轮资料和 ID，不能复用演练数值：" + JSON.stringify(answerUiExamples) + "。组件参数的 JSON Schema：" + JSON.stringify(catalog.props),
   args: {
+    phase: tool.schema.enum(["process", "final"]).optional().describe("保留在最终答复中的内容显式填 final；临时核查材料填 process。省略默认 process。"),
     block_id: tool.schema.string().regex(/^[a-zA-Z0-9_-]{1,80}$/),
     fallback_text: tool.schema.string().min(1).max(4000),
     spec: tool.schema.object({ root: tool.schema.string(), elements: tool.schema.record(tool.schema.string(), tool.schema.object({
@@ -13,6 +39,6 @@ export default tool({
   },
   async execute(args) {
     const value = answerUiInputSchema.parse(args);
-    return JSON.stringify({ version: "answer-ui@1", ...value, recorded: true });
+    return JSON.stringify({ version: "answer-ui@1", ...value, phase: value.phase ?? "process", recorded: true });
   },
 });