docs(codex): clarify raw tool output watchdog

steipete · steipete · commit 9421608aede3 · 2026-05-16T02:29:31.000+01:00
diff --git a/docs/plugins/codex-harness.md b/docs/plugins/codex-harness.md
@@ -529,17 +529,18 @@ eventually finish the native turn with `turn/completed`. If the app-server goes
 quiet for `appServer.turnCompletionIdleTimeoutMs`, OpenClaw best-effort
 interrupts the Codex turn, records a diagnostic timeout, and releases the
 OpenClaw session lane so follow-up chat messages are not queued behind a stale
-native turn. Any non-terminal notification for the same turn, including
-`rawResponseItem/completed`, disarms that short watchdog because Codex has
-proven the turn is still alive; the longer terminal watchdog continues to
+native turn. Most non-terminal notifications for the same turn, including raw
+assistant `rawResponseItem/completed` items, disarm that short watchdog because
+Codex has proven the turn is still alive; raw `custom_tool_call_output`
+completions keep the short post-tool watchdog armed because they are the
+turn-scoped tool-result handoff. The longer terminal watchdog continues to
 protect genuinely stuck turns. Global app-server notifications, such as
-rate-limit updates, do not reset turn-idle progress. When Codex emits a
-completed `agentMessage` item and then goes quiet without `turn/completed`,
-OpenClaw treats the assistant output as effectively complete, best-effort
-interrupts the native Codex turn, and releases the session lane. Timeout
-diagnostics include the last app-server notification method and, for raw
-assistant response items, the item type, role, id, and a bounded assistant text
-preview.
+rate-limit updates, do not reset turn-idle progress. When Codex emits a completed
+`agentMessage` item and then goes quiet without `turn/completed`, OpenClaw treats
+the assistant output as effectively complete, best-effort interrupts the native
+Codex turn, and releases the session lane. Timeout diagnostics include the last
+app-server notification method and, for raw assistant response items, the item
+type, role, id, and a bounded assistant text preview.
 
 Environment overrides remain available for local testing:
 
