From 69b1487fb7b31d790b07a2c3cb3b1d8cf3c70835 Mon Sep 17 00:00:00 2001
From: weichen <weichen@home.local>
Date: Sun, 11 Oct 2026 08:15:44 +0000
Subject: [PATCH] Mirror the optional node id/source fields in the frontend
 contract

Why: Core PR #25 adds optional id/source to UINode for the Generative
UI Surface layer; the TypeScript contract authority mirrors core types.

Evidence: Type-only additive change; combined verification runs in the
Dev workspace make test.

Impact: No component or behavior change.

Refs: Agent-System-Core #25; Dev task feature/generative-ui-u2
---
 src/contracts.ts | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/contracts.ts b/src/contracts.ts
index 1c86755..260bb98 100644
--- a/src/contracts.ts
+++ b/src/contracts.ts
@@ -185,6 +185,9 @@ export type UINodeType =
 
 export interface UINode {
   type: UINodeType;
+  /** Surface 层节点级标注（core ui.go U2）：整页唯一稳定 id 与事实来源标识，旧路径不填。 */
+  id?: string;
+  source?: string[];
   title?: string;
   items?: string[];
   kv?: [string, string][];