API Reference

Session 事件

Session.subscribe() 会发出哪些事件类型以及各自表示什么

Session 事件

session.subscribe() 当前会发出的核心事件类型:

  • turn-start
  • text-delta
  • reasoning-delta
  • tool-call
  • tool-result
  • assistant-step
  • turn-finish
  • error

最常见的是 text-delta

如果你只是做实时文本输出,通常只需要先处理:

if (event.type === "text-delta") {
  process.stdout.write(event.text);
}

如果你要做更完整的体验,通常还应同时处理:

  • turn-start
  • turn-finish
  • error
  • assistant-step
  • tool-call
  • tool-result

assistant-step 对 chat bridge 这类 transport 很有用,因为它可以拿到 step 级可见回复,同时又不需要自己接管 Session history 落盘。