Grok Bot
0.5.0 把每个 Bot 的原生主会话提供为 coda/session@1 记录，不再声明 ACP Agent。只供预览版安装。协议依照 5.7.0。
登录与记录
在资源页添加 Grok Bot，打开 cursor.com/loginDeepControl 官方链接确认（手机可能需要再点 Continue）。沿用 0.4.0 的 PKCE 链接、/auth/poll 轮询及 /oauth/token refresh_token 续期；不是 Grok CLI 的设备码登录，不读取桌面凭据。凭据写在插件数据目录的 native-auth.json，权限 0600。续期失败时资源页提示重新登录。
Provider 每 30 秒重新读取登录及 Bot 名单；每个 Bot 自动建立一条记录，无选择下拉或会话命令。容器是登录账号，账号本人为 self: true, kind: person，Bot 为 kind: agent。
账号 ID 是 GetMe.userId（没有时用 authId）的 SHA-256；记录 ID 为 grok-bot:<账号摘要>:<URI 编码的 agentId>。不含本机 ID、插件目录或随机数，重装不变。服务端删除 Bot 或切换账号后撤下旧记录。
读取与发送
read从内存中的原生主会话 transcript 镜像分页读取，支持最新页、after和before；游标是<generation>:<updatedSeq>，BigInt 比较，不丢 uint64 精度。历史重置后旧游标报错，需重新读取。- 启动、重连及
cleared/cursorTooOld时全量读取一次历史，重建每个 Bot 的条目镜像；之后只按 Watch 的rows增量更新。read、head 和发送回显确认不再拉历史。generation 不变时保留本进程已交付的消息版本；generation 改变则清空旧消息。 - 变化的会话条目各自等待 1 秒无新正文变化才交付，不扫描或重拉完整历史；发布 head 不越过仍未稳定的较早条目。只持久化已暴露正文的摘要、序号及修订标记，不持久化正文镜像。
- 一个条目首次稳定暴露时就是普通消息，ID 为
<generation>:<entryId>，cursor 取首次暴露时的 updatedSeq，即使它与原生 seq 不同。只有索引记录的已暴露正文再变化，才追加<base>:edit:<updatedSeq>、带about: { message: <base>, change: "edit" }的修订。原生历史只保留当前版本，进程重启后不伪造已被覆盖的旧正文。 post使用 Coda 已创建的coda/run@1，handler 收下立即返回，后台发送并等待流事件更新镜像、确认回显后写终态。messageId 是按调用方、记录 ID、requestId 派生的 UUID；同请求只交给 handler 一次由 Coda 保证，插件不再保存posts.json或重复去重。完成返回{ message: { id, cursor } }；断线、接受后无回显等不确定结果为failed/unknown。重启遗留运行也标为unknown，不重发。- 只收文字。草稿为无操作；未提供停止或取消。
- widget 是列出选项的消息。回复该消息、正文填选项标签或值时调用
RespondGrokBotWidget；原生条目的respondedValue作为一条 self 回复读出，指向原 widget 并 mentions Bot。确认这条回复后完成 post。 - Routine 记录、活动、结算、思考均不造消息；Routine 的结论若由 Bot 发在主会话则正常读取。
正在做的事
同一 Watch 流的主 Bot agentState.live 保存在内存镜像，不增加原生请求。沿用 0.4.0 的 live.activity.kind：tool 优先显示 detail，其次 tool；thinking 显示 detail，未提供正文时显示「Grok 正在思考」。取首个可读行，按 Unicode 字符截到 200 字，participant 为 Bot 的参与者 ID。
沿用 0.4.0 的忙碌判定：isRunning、isComposingMessage、isRetrying、activity 或 awaiting 任一存在时，不让附带的旧 lastTurnSettlement 清除当前活动。无这些忙碌信号且有 lastTurnSettlement 时删除整个 activity；独立子 Agent 运行不阻止清除。不以消息静默或超时判定停止。重连和游标重置时连同 transcript 重建 live 状态，等待 Watch 的新快照。activity 只写 status，不造消息、不进 read、不推进 head。
正文变化的依据与验证边界
未经真实历史核实。 本次不读取真实凭据、不连接真实 xAI。依据是 0.4.0：
agent/watch.mjs的rows()按entryId保存updatedSeq和正文 SHA-256；同 ID 的更高序号且正文摘要变化会再次交给适配器。agent/session.mjs的nativeEvent()对send-message保存旧文本；新文本以前文开头时追加后缀，否则输出「Grok 修订消息」。旧测试updatedSeq changes and process reload do not redisplay an already delivered body覆盖正文未变时去重；transcript batches commit once, bound seen/hashes, and an evicted entry revision appears as new覆盖旧条目改写。
这些代码证明旧实现允许正文再次变化，不能证明线上总以完整消息到达，也不能证明每次变化都是人工修订。当前 1 秒稳定窗口只是对订阅条目的静默等待，不是上游完结信号；停顿后再次修改仍会以新修订交付。真实历史及稳定窗口是否合适留到预览空间真实环境验证。
测试使用假原生服务端，覆盖登录后记录、增量/向前翻页、修订、稳定 head、启动前已完成的流式消息、断线/游标重置重建、无额外历史读取、post 的请求派生 ID、流回显与未知结果、widget 回复以及 Routine 不镜像；记录及 read 输出按仓库协议契约校验。
绑定远端入口
需要支持协议 5.7.0 记录远端入口的 Coda。资源页每个 Bot 有一个「绑定」按钮；只有点击后才申请绑定码并发送指令，不在启动或同步时自动发送。
资源按钮打开 bind 视图，将记录 ID 作为 args 交给模块注册的 open 回调；每次打开只发送一次。页面显示「正在发绑定指令…」，收到模块结果后显示「已发给 Bot」或错误原因。模块确认记录仍属于当前账号的 Bot，调用 coda.protocols.remoteCode(recordId)，取返回的第一个 tailnet 入口，以账号本人的身份向该 Bot 发送一句话和一行 node coda-bot.mjs bind <address> <code>。未连接 tailnet 时直接报错，不发送；发送未确认时报告失败，不自动重发。插件须已激活。
在 Bot 云电脑保存 remote/coda-bot.mjs，让 Bot 阅读 remote/SKILL.md。先运行 node coda-bot.mjs net，然后执行收到的绑定命令。码有效期为 10 分钟；重新绑定会替换旧令牌。客户端经 /v1/remote-caller/bind 保存 token、record，经 /v1/remote-caller 调用工具；MCP 启动命令为 node coda-bot.mjs mcp [recordId]，多个 Bot 共用云电脑时必须指定各自记录 ID。旧版绑定需重新操作。
工具为 coda_machines、coda_machine_diagnostics、coda_read_thread、coda_read_tool_call、coda_workflow_list、coda_workflow_status，以及 coda_file_ticket。前六个走 tool；工单走 file_ticket，默认 workflow 为 bot-ticket，每次调用生成 requestId。遥测由 Bot 直接访问用户自己的看板，不再通过插件代理。
Routine 指令模板
先在 Coda 的「工作流」插件设置 workflows.remoteCallerWorkflows 中加入目标目录的 bot-ticket 白名单项（project 为目录 ID，workflow 为 bot-ticket）。同名流程在多个目录获准时，提工单需明确填写 project。
将下面的模板填好后放进自己的 Routine；真实看板地址只留在用户指令里，不提交到仓库：
阅读 coda-bot 的 Skill。每次巡检先读取已记录的问题，用 coda_workflow_status 查看已提工单的进度并更新记录。
从云电脑直接请求我的遥测看板：〈填写看板地址及需要读取的路径〉。结合机器状态和诊断调查性能、稳定性和逻辑问题，记录现象、影响、时间范围、版本及证据。
发现需要处理的新问题时，用 coda_file_ticket 提交到 bot-ticket，project 填〈目标目录 ID；白名单唯一时可省〉。为同一问题使用相同的稳定 key，记录返回的 run.id。已有未结束工单的同一问题不重复提，不用巡检时间或随机数生成 key。
后续 Routine 先看已提工单的进度，再调查新问题。收到聊天里的工单结论后更新记录；失败先查原因，修复后再核实新证据。
测试用假 HTTP 服务端验证远端请求，用假原生服务端验证打开绑定视图后以本人身份发送，并向页面报告成功或错误。未连接真实 Coda 5.7.0 或真实 Bot，未修改线上 Routine，未部署。停止第一版不做。