T

weichen 626f8e1062 Add the Surface contract types, node ids, and spec validation

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

2026-10-11 08:15:10 +00:00

policy

Bootstrap the repository skeleton: README, agent rules, policy index, project facts

2026-09-29 17:30:31 +00:00

testdata/golden

Add script steps and critic fields to workflow definitions

2026-10-01 15:55:52 +00:00

Add the usage split fields to the TypeScript contract authority (N3 WP6)

2026-10-07 17:41:21 +00:00

.gitignore

Bootstrap the repository skeleton: README, agent rules, policy index, project facts

2026-09-29 17:30:31 +00:00

activity.go

Add activity card, card events, HITL anchoring and UI vocabulary extension

2026-09-30 06:22:00 +00:00

AGENTS.md

Record Gitea access facts in AGENTS.md

2026-09-30 16:06:15 +00:00

conformance_test.go

Add script steps and critic fields to workflow definitions

2026-10-01 15:55:52 +00:00

data.go

Add the owner field to tenant-scoped domain contracts

2026-09-30 02:39:50 +00:00

events.go

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

2026-10-11 08:15:10 +00:00

go.mod

Define the core contracts: domain model

2026-09-29 17:34:58 +00:00

hitl.go

Add session permission mode and confirmation detail

2026-10-03 17:02:28 +00:00

model.go

Add last-request and cache fields to Usage (N3 WP6)

2026-10-07 16:34:27 +00:00

plugin_v2_test.go

Accept plugin manifest apiVersion 2.0-experimental

2026-10-01 10:34:29 +00:00

plugin_v2.go

Accept plugin manifest apiVersion 2.0-experimental

2026-10-01 10:34:29 +00:00

plugin.go

Add script steps and critic fields to workflow definitions

2026-10-01 15:55:52 +00:00

profile.go

Add the prompt module contract and profile references

2026-09-30 10:28:59 +00:00

PROJECT.md

Document executable Core verification commands

2026-10-05 12:29:42 +00:00

prompts.go

Add optional tools, model, and maxTurns to prompt modules

2026-10-01 15:21:47 +00:00

README.md

Define the core contracts: domain model

2026-09-29 17:34:58 +00:00

retrieval.go

Add the retrieval pipeline component contracts

2026-09-30 02:39:50 +00:00

surface_test.go

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

2026-10-11 08:15:10 +00:00

surface.go

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

2026-10-11 08:15:10 +00:00

tools.go

Add session permission mode and confirmation detail

2026-10-03 17:02:28 +00:00

ui.go

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

2026-10-11 08:15:10 +00:00

README.md

Agent-System-Core

系统核心契约：领域模型（Project/Conversation/Message/Run/Artifact/Plan）、流式事件信封、 HITL 卡片协议、插件 API 与 manifest、AgentProfile 画像、设置 schema、UI 扩展词汇、文档解析（ParsedDocument IR）与检索/记忆契约。Go 模块路径 agent-system-core。

三态一致

同一契约以三种形态发布，变更须保持一致：

Go 类型（*.go，camelCase JSON 标签）——后端与代码插件使用。
黄金样本（testdata/golden/*.json）——线格式权威，go test ./... 强校验；变更显式重生成（go test ./... -update）。
TS 类型（ts/types.ts）——前端镜像，前端测试按黄金样本做形状断言。

原则

只含契约与纯函数，不含实现、不含 I/O、不依赖生态仓。
前向兼容：字段只增不删；消费方对未知 type/词汇静默忽略（v 字段协商）。
摄取 IR（ParsedDocument）是解析器与下游的隔离层；检索/记忆契约先行、实现后置。

验证

go test ./...

README.md Unescape Escape

Agent-System-Core

三态一致

原则

验证

README.md