diff --git a/docs/api/openapi.yaml b/docs/api/openapi.yaml
index 255762cab..0f5a70cf3 100644
--- a/docs/api/openapi.yaml
+++ b/docs/api/openapi.yaml
@@ -16272,6 +16272,21 @@ components:
               - label
               - value
             additionalProperties: false
+        toolCalls:
+          description: "v1.20.0 — the retrieval-tool trace for this turn: which tools the Coach called and whether each found
+            data. Metadata only (no values). Absent on the legacy snapshot path and on turns that called no tools."
+          type: array
+          items:
+            type: object
+            properties:
+              name:
+                type: string
+              present:
+                type: boolean
+            required:
+              - name
+              - present
+            additionalProperties: false
       required:
         - windows
         - metrics
@@ -20464,6 +20479,10 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/IllnessRedFlag"
+        sleepContext:
+          anyOf:
+            - $ref: "#/components/schemas/IllnessSleepContext"
+            - type: "null"
       required:
         - episodeId
         - preOnset
@@ -20474,10 +20493,12 @@ components:
         - feltBetterDay
         - gapDriverType
         - redFlags
+        - sleepContext
       additionalProperties: false
       description: "The retrospective correlation findings for one episode: pre-onset anomaly scan, nadir, per-vital
         physiological returns (incl. the user-logged symptom-burden track, `type:FUNCTIONAL_IMPACT`), the headline
-        recovery-gap (median of per-track gaps), the driving metric (`gapDriverType`), and any red flags."
+        recovery-gap (median of per-track gaps), the driving metric (`gapDriverType`), any red flags, and an optional
+        sleep-as-context observation (`sleepContext`, never in the gap)."
     IllnessVitalDeviation:
       type: object
       properties:
@@ -20558,6 +20579,29 @@ components:
       additionalProperties: false
       description: A retrospective red-flag escalation (sustained low SpO2 or sustained fever) against absolute clinical
         floors. Copy must escalate ('seek care if this recurs'), never reassure.
+    IllnessSleepContext:
+      type: object
+      properties:
+        baselineMeanMinutes:
+          type: number
+        episodeMeanMinutes:
+          type: number
+        deltaMinutes:
+          type: number
+        nightsCounted:
+          type: integer
+          minimum: -9007199254740991
+          maximum: 9007199254740991
+      required:
+        - baselineMeanMinutes
+        - episodeMeanMinutes
+        - deltaMinutes
+        - nightsCounted
+      additionalProperties: false
+      description: "A neutral sleep-as-context observation: the user's median asleep minutes over the well baseline vs the
+        mean over the episode window, and their signed delta (positive = slept more than usual). A pure OBSERVATION
+        surfaced alongside the gap — NEVER a recovery return and NEVER part of the headline recovery-gap. Withheld (the
+        field is null) on thin sleep data or a sub-floor delta."
     IllnessInsightsEnvelope:
       type: object
       properties: