@dsh-std/presentation

English | 中文

拟议设计见 Presentation Operations。

运行时插件可以向已连接表现客户端请求的小型、调用作用域内操作。

协议

v1alpha1 定义五个彼此独立的表现协议：

• OpenExternal 请求客户端打开 HTTP 或 HTTPS URI；
• CopyText 请求客户端把文本复制到剪贴板；
• Notification 请求客户端显示信息、警告或错误文本；
• UserInteraction 承载结构化 question、单次 approval 和 secret input。
• ExternalRedirect 在用户侧接收一次 HTTP redirect，并可按调用方要求独占精确的 loopback URI。

Facet 在清单中声明每项所需操作。客户端只为当前连接声明自己能够执行的协议。仅当全部必需表现协议可用时，运行时才接纳命令；运行时也只接受该 facet 事先声明的操作。操作属于当前调用，不是全局事件总线或持久客户端能力。

本包提供 protocol definitions、调用作用域内的类型化 client/implementation binder、请求与结果校验。Host 创建 client 时绑定 request identity 与 origin，Consumer 只提交 operation 自有输入。它不执行 UI 工作；原生应用、终端、浏览器、编辑器和自动化客户端可以实现不同子集。

普通操作可以从 @dsh-std/presentation/operations 导入，交互协议可以从 @dsh-std/presentation/interaction 导入。Host 交给领域调用的 PresentationDescriptor 只是当前 invocation active agreements 的投影，不是额外的 Snapshot 协议。

已知限制与暂缓事项

• OpenExternal 有意拒绝非 HTTP(S) URI scheme。
• 协议不定义剪贴板读取、任意 UI tree 或文件选择器。
• v1alpha1 不包含投递确认与持久回放。