Agent Canvas 是 Alera 中一次 agent 运行共享的画布界面，由运行时宿主负责持久化、修订、决策、保留与事件。应使用 alera canvas 命令操作，而不要直接写入应用 socket 或修改运行时 SQLite。
用途：在 Alera 终端内发布结构化画布更新，并等待持久化决策结果。画布按工作区与终端会话划分，终端通过 ALERA_WORKSPACE_ID 和 ALERA_TERMINAL_SESSION_ID 标识其唯一画布，ALERA_TAB_ID 与 ALERA_AGENT_TYPE 在可用时使用。
主要命令：alera canvas capabilities --json；alera canvas catalog --workspace-id <workspace-id> --history --json；alera canvas examples --json；alera canvas publish --stdin --expected-revision <revision> --json；alera canvas events --workspace-id <workspace-id> --follow --json；alera canvas wait --decision-id <decision-id> --timeout-ms 600000 --json；alera canvas complete --canvas-id <canvas-id> --json；alera canvas close --canvas-id <canvas-id> --json。
使用方式：publish 接受一个 JSON 文档或换行分隔的 JSON 对象。校验或 expected-revision 检查失败时保留最后一个有效修订；遇到冲突可读取 catalog 并按其返回修订重试。决策请求在解决或超时前保持持久，重复解决已解决的决策是幂等的，超时不会取消 agent 运行。
限制：仅使用 capabilities 报告的十种受支持组件，优先语义合并并只发布有意义的变更。动作中不得包含任意命令、shell 文本、函数、源代码、外部请求、URL 或未校验路径。即时导航与类型化确认动作由 Alera 处理，破坏性动作需显式确认且限于所属画布。