用途：为 TanStack AI 的各活动提供可插拔、可按分类开关的调试日志，用于观察请求、流式分片、工具调用与错误等内部流程。依赖 ai-core，使用前应先阅读其规则。
主要能力：debug 选项适用于 chat()、summarize()、generateImage()、generateSpeech()、generateTranscription()、generateVideo()，实时会话适配器（如 openaiRealtime、elevenlabsRealtime）也接受同一选项。日志按分类输出，每行带 emoji 与 [tanstack-ai:<category>] 前缀。分类包括 request、provider、output、middleware、tools、agentLoop、config、errors；其中 middleware、tools、agentLoop、config 仅对 chat() 生效。
使用方式：debug 接受 boolean 或 DebugConfig。省略 debug 时仅 errors 生效；debug: true 开启全部分类；debug: false 全部关闭（含 errors）；传入对象时未指定的分类默认为 true，可用 logger 替换默认 ConsoleLogger。示例：chat({ adapter: openaiText('gpt-5.2'), messages, debug: true })。自定义 logger 需实现 debug、info、warn、error 方法，可接入 pino 等；默认 ConsoleLogger 可从 @tanstack/ai 导入。
限制与注意：省略 debug 不等于静默，错误仍会打印；需要完全静默应使用 debug: false 或 debug: { errors: false }。仅需观察内置流程时，debug 比编写日志中间件更快；中间件适合转换分片或配置。用户提供的 logger 若抛异常会被 SDK 吞掉，建议在 logger 内部自行捕获序列化错误。更丰富的结构化事件可参考 Observability 事件客户端。