docs: daily engineering digest 2026-08-12

automations/livekit-agent/2026-08-12.markdown

@@ -0,0 +1,35 @@
+# LiveKit Agents 工程日报
+
+## 覆盖时间
+
+**2026-08-11 00:03 UTC — 2026-08-12 00:03 UTC**（与每日 cron 触发对齐）
+
+**本仓库（[Seventhen/agents](https://github.com/Seventhen/agents) `main`）**：过去 24 小时内 **无新合并提交**；`main` 仍停留在 2026-05-27（[#5857](https://github.com/livekit/agents/pull/5857)），相对上游 [livekit/agents](https://github.com/livekit/agents) **`main` 落后 428 个提交**（HEAD：`livekit-agents@1.6.9` + 20 commits）。
+
+**上游追踪（livekit/agents `main`）**：同期 **9 个已合并 PR**；以下要点均来自上游 commit/PR 记录。
+
+---
+
+## 要点变更
+
+- **Playout 启动时挂起 pending reply，修复语音打断竞态**（[#6745](https://github.com/livekit/agents/pull/6745)，Fixes AGT-3240）：当 SOS hold 解除或 SOS 先于当前 handle 到达时，pending reply 可能在用户恢复说话时立即进入 playout。PR 改用 playout silence gate（而非滞后的 `user_state`），并在 `say()`、pipeline 与 realtime 路径统一 reconciliation；取代 [#6733](https://github.com/livekit/agents/pull/6733)。新增 `tests/test_playout_launch_pause.py`（179 行）。影响：打断/恢复场景下 agent 不应再“抢话”。
+
+- **RemoteSession / SessionHost 可靠性三连修**：[#6781](https://github.com/livekit/agents/pull/6781) 修复 `run_input` 响应被静默丢弃（transport 吞掉 send 失败、room 消失时 early return、`aclose` 取消 in-flight handler、并发读写乱序）；[#6779](https://github.com/livekit/agents/pull/6779) 将“空 agent turn”（LLM 返回无 text/tool call）从 `RuntimeError` 改为合法 silence，避免 simulation 误报 agent failure；两者共新增 14+ 项测试（`test_remote_session.py`、`test_run_input_errors.py`）。影响：远程 session 与 hotel_receptionist 等 simulation 驱动场景。
+
+- **Inference 流式重试逻辑关键修复**（[#6697](https://github.com/livekit/agents/pull/6697)）：此前 gateway 首个 contentless delta（含 `extra_content.livekit` metadata）即清除 `retryable`，导致 **所有经 gateway 的流式响应从中途 stall 无法重试**；现仅在 emit text 或 tool call 后才清除 `retryable`，并将 stream body timeout 正确映射为 `APITimeoutError`。新增 `tests/test_inference_llm_retry.py`（236 行）。影响：simulation 与生产 inference 流的中途超时恢复能力显著改善。
+
+- **工具 schema：`const` 字段不再注入 null sentinel**（[#6688](https://github.com/livekit/agents/pull/6688)）：strict mode 下 discriminated union 的 tag 字段（如 `unit: Literal["celsius"]`）曾被错误允许 null，导致模型返回 `{"unit": null}` 时被解析为错误 variant（如 Fahrenheit 被当成 Celsius）。新增 `tests/test_tools.py` 覆盖多种 union/discriminator 形态。影响：多 variant 工具调用正确性。
+
+- **Simulation / Evals 推理优先级隔离**（[#6721](https://github.com/livekit/agents/pull/6721)、[#6794](https://github.com/livekit/agents/pull/6794)）：文本 simulation 与 eval judge 的 LiveKit Inference 请求统一 pin 到 `X-LiveKit-Inference-Priority: low`，避免 batch 负载与实时语音流量争抢 RPM/TPM；音频 simulation  deliberately 排除以保持延迟代表性。`InferenceClass` 新增 `low` 字面量。影响：gateway 侧尚未识别 `low`（当前等效 `standard`，见 LKINF-387），agents 侧先就位。
+
+- **LLM metrics 暴露 cache write token**（[#6655](https://github.com/livekit/agents/pull/6655)）：`LLMMetrics.cache_creation_tokens` 与 `LLMModelUsage.input_cache_creation_tokens` 现已贯通（此前 provider 已上报但被丢弃）；`log_metrics` 日志行同步包含。OTel counter 与 remote session proto 转发仍为 follow-up。
+
+---
+
+## Watchlist
+
+1. **Fork 漂移持续扩大（428 commits）**：上游 24h 内合入 voice lifecycle、inference retry、RemoteSession 等高风险修复；本 fork `main` 自 5 月 27 日以来无合并，生产若基于 fork 需计划 rebase/cherry-pick，至少 [#6697](https://github.com/livekit/agents/pull/6697)、[#6745](https://github.com/livekit/agents/pull/6745)、[#6781](https://github.com/livekit/agents/pull/6781)。
+
+2. **`low` inference class 网关侧尚未生效**：[#6721](https://github.com/livekit/agents/pull/6721)/[#6794](https://github.com/livekit/agents/pull/6794) 已发送 `low` header，但 gateway 目前仅识别 `standard`/`priority`（LKINF-387 跟踪中）；若 gateway 改为 reject 未知值，judge runs 可能中断——合并前需确认 gateway 行为。
+
+3. **RemoteSession 交付仍非 100% 保证**：[#6781](https://github.com/livekit/agents/pull/6781) PR 自述 mid-conversation send failure 仍可能导致 caller 60s timeout（仅多了 log）；PR 引用 [#6661](https://github.com/livekit/agents/issues/6661) 中 25–40% 失败率待 live 验证。打断相关开放 PR（[#6564](https://github.com/livekit/agents/pull/6564) adaptive interruption across tool calls 等）仍未合并，与 [#6745](https://github.com/livekit/agents/pull/6745) 形成叠加 rollout 面。