# 访客事件流与文件边界

流式消息、附件暂存和任务产物读取有不同的完成条件，不能只检查HTTP成功。

## 消息与流

公开A2A仅注册POST并接受JSON-RPC 2.0的message/stream。消息必须引用事先创建的contextId，message.parts不能为空，且须有非空文本或文件/图像附件；MCP上下文data不能单独构成消息。text、file、image及指定MCP应用上下文data分支各有校验；任意data、provider交互答复、运行控制和反馈分支不作为公开消息能力。

不接受configuration.blocking=true，params及消息/运行metadata中的locale也被拒绝。params.metadata的同名值覆盖message.metadata。

流打开前检查当前链接、session和会话绑定。流打开后执行失败以JSON-RPC错误帧返回；成功终止必须由任务状态及终止帧判定。任务持久准入后，浏览器断开不取消已准入任务，可回读会话消息与任务事件。准入超时可能与持久化并发，使用返回contextId回读，不直接重复创建新任务。

后续事件重读重新检查链接。停用/轮换后可在下一次重读拒绝继续投影；这个读取边界不承诺后台执行立即取消。

## 附件

使用multipart字段file上传，实际文件最大200 MiB；handler约束整个请求为201 MiB以内。Content-Length未知时按201 MiB预占，不能当按实际文件字节计费。当前发布共享24小时1 GiB上传预算及100次预占尝试上限，失败或放弃尝试仍占用已预留量；429/code18表示预算不足。

上传返回暂存文件及file_token。提交消息需要同时提供：parts中的moi://files/{file_id}引用、metadata.attachments中的workspace_id/volume_id/file_id，以及metadata.webapp_file_credentials中每个file_id对应的file_token。不同访客、工作区、文件或过期凭据不能互换。metadata.files旧形式被拒绝；任意文件URL不产生文件授权。

file_token约束到访客、发布和文件，有独立签名purpose及有效期。上传成功不表示文件已提交给运行；

## 任务产物

下载/预览要求文件source=agent_tool且source_session_id/source_task_id匹配当前会话/任务，不接受任意已上传文件。下载使用attachment；预览使用inline，响应类型取实际元数据。

预览不支持、过大或转换失败分别返回415、413/code19、422/code20。在文件仍可下载且准入成立时可改用下载；预览流已经开始后发生错误会中断连接，不能承诺还有完整JSON错误包。
