feat: publish Agent Studio integrations and setup guide

docs/event-mapping.md

@@ -10,9 +10,9 @@ Pi 发出的事件首先经过 `PiEventAdapter` 变成经过裁剪和脱敏的 `
 | HTTP message input | `user.message` | user message，附件仅为 IDs |
 | Harness 开始 run | `run.started` | `isRunning=true`，显示停止按钮 |
 | `message_update.text_delta` | `assistant.delta` | 按稳定 messageId 追加文本 |
-| assistant `message_end` | `assistant.completed` | assistant message complete |
+| 最终 assistant `message_end`（非 toolUse / error） | `assistant.completed` | assistant message complete |
 | `tool_execution_start` | `tool.requested` | 创建工具调用 part |
-| `tool_execution_end` 成功 | `tool.completed` | 工具卡显示 result |
+| `tool_execution_end` 成功 | `tool.completed` | 自定义工具使用 Pi result.details 展示指标和保存结果 |
 | `tool_execution_end` 失败 | `tool.failed` | 工具卡显示安全错误 |
 | Broker 请求 | `approval.required` | 打开服务器审批 Dialog |
 | Broker 决策 / 超时 / 取消 | `approval.resolved` | 关闭 pending 状态 |
@@ -41,6 +41,8 @@ flowchart LR
 
 真实路径匹配避免仅凭用户提供的字符串伪造 Skill 活动。事件由 Session 队列串行处理，因此异步 `realpath` 不会导致 read end 越过 read start。
 
+运行时索引匹配 Session 内的只读 Skill 正文快照，目录面板仍展示来源路径。模型尚未输出文本时，首个工具事件也会建立 assistant 消息，避免工具卡片一直隐藏到最终回复。
+
 ## 顺序、重放与去重
 
 - 每个 Session 的 sequence 从 1 单调递增。