这是 AUP Web-only widget,不是 cross-device primitive,也不是 Web Device layout component。
该名称登记在 AUP_WIDGETS(packages/aup/src/aup-types.ts)。结构校验可以接受它,Web runtime(或注明的原生目标)可以实现它。它不是 18 个跨设备 AUP_PRIMITIVES 之一,不会经 fillPrimitives 进入 DeviceCaps.primitives,也不是 Web Device 主题/站点 layout component(例如 content-card 或 page-breadcrumb)。
用途
按 src 限定工具/读/exec 边界的交互 agent 对话表面;可选 dataPath 做会话持久化。客户端复用 chat renderer。
边界
- 不要把该类型写成可移植 primitive。
- 不要与 Web Device layout-component 参考页混装在
widgets/下。 - parser 接受名称 ≠ 可移植性或产品就绪声明。
作者入口
AUP tree / DSL type: "agent"。Registry 记录 mode、welcome、dataPath 与 config 事件。
表面
交互 Web session。不是静态 document renderer 条目。
Fallback
作为 widget 无 degradation chain。需要 session、身份与 AFS 范围审查。
证据
| Source | Path |
|---|---|
| Registration | packages/aup/src/aup-types.ts; packages/aup/src/aup-dsl.ts |
| Registry | providers/runtime/ui/src/aup-registry.ts (agent) |
| Interactive switch | providers/runtime/ui/src/web-page/core.ts case "agent"→renderAupChat`` |
| Handlers | providers/runtime/ui/src/agent-handler.ts |
路径相对于本文档基线所用的 Arc 仓库 checkout。
Sample
公开 sample 层面 internal / experimental。 交互 Web runtime(有时含 Web Device widget 包)存在注册与 renderer,但本站不提供 docs-safe live sample。不要仅凭类型名推断产品就绪。
相关
- Widgets hub — 仅导航
- Primitive 类型分类 — 18 vs 42 边界
- 自定义 primitive 与 Web widget
- 内部矩阵:
docs/aup/capability-matrix.md