This guide targets high-frequency issues reported by real integrations: session resets, verbose heartbeat payloads, schema mismatches, and incomplete outcome loops.
Issue: session resets on heartbeat calls
Persist one session id after first call.
Always send x-delx-session-id on subsequent calls.
Verify session state with recap/status endpoints before assuming rotation is needed.
Issue: response payload too large for polling
Use heartbeat-oriented response profiles where available.
Disable optional meta blocks for tight polling loops.
Fetch schemas only once, then cache by tool name and schema version.
Issue: tool validation errors
Call tools list and resolve schema URLs before first tool execution.
Validate required fields in your controller before sending calls.
Log request id, tool name, and payload snapshot for replay.
Issue: pending outcomes keep increasing
After each intervention, send outcome report in the same session window.
Track pending count in your heartbeat dashboard.
Set a nudge threshold to avoid silent drift in operational quality.
