Add the Surface contract types, node ids, and spec validation #25

Merged
weichen merged 1 commits from feature/generative-ui-u2-surface into main 2026-10-11 08:15:26 +00:00
Owner

Why: Generative UI proposal U2 needs the versioned, host-validated page envelope before backend work: identity/compat/version types, stable per-node ids with source annotations, catalog-driven validation (Go port of the U1 trial validator), and the surface.updated event.

Evidence: go vet + go test (valid spec from U1 shape, violations, limits, old-payload backward compat).

Impact: Additive only; UINode gains optional id/source, no symbol changes.

Refs: Documents proposal r2 U2/U1; Dev task feature/generative-ui-u2

Why: Generative UI proposal U2 needs the versioned, host-validated page envelope before backend work: identity/compat/version types, stable per-node ids with source annotations, catalog-driven validation (Go port of the U1 trial validator), and the surface.updated event. Evidence: go vet + go test (valid spec from U1 shape, violations, limits, old-payload backward compat). Impact: Additive only; UINode gains optional id/source, no symbol changes. Refs: Documents proposal r2 U2/U1; Dev task feature/generative-ui-u2
weichen added 1 commit 2026-10-11 08:15:24 +00:00
Why: The Generative UI proposal U2 needs a versioned, host-validated
envelope for agent-authored pages before any backend surface exists:
identity/compat/version envelopes, stable per-node ids with source
annotations, catalog-driven spec validation, and the surface.updated
projection event.

Evidence: go vet + go test in this repo (table tests cover a realistic
valid spec from the U1 trial shape, violations, limits, and old-payload
backward compatibility).

Impact: Additive only - UINode gains optional id/source (omitempty),
old card/form paths unaffected; no existing symbol changes.

Refs: Documents proposal 2026-10-10-generative-ui-plugin.md (r2, U2/U1
sections); Dev task feature/generative-ui-u2
weichen merged commit 452daf3ffa into main 2026-10-11 08:15:26 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: weichen/Agent-System-Core#25