Previous value: -"Research context captured so far."New value: +"Research context captured so far: only the user's brief and material relevant to the research question, never tool errors, status messages, internal links or process notes."

Previous value: -"Additional research context or constraints."New value: +"Research context the Minds should see: the brief, concept or other material relevant to the research question, and the user's constraints. When the draft starts, these notes are shown to every Mind. Never tool errors, status or retry messages, Minds or other internal links, or your own process notes."

Previous value: -"Research objective or intent captured so far."New value: +"The user's research objective or intent captured so far. Never tool errors, status or retry messages, Minds or other internal links, or your own process notes."

Previous value: -"Ordered source URLs supplied as Study context. When omitted on create, the draft has none; when omitted on a revision, the saved URLs are kept."New value: +"Ordered source URLs the user supplied as material for the research. Never Minds workspace or other internal links. When omitted on create, the draft has none; when omitted on a revision, the saved URLs are kept."

Removed value: -{}

Removed value: -[]

Previous value: -"Ordered source URLs supplied as Study context."New value: +"Ordered source URLs supplied as Study context. When omitted on create, the draft has none; when omitted on a revision, the saved URLs are kept."

Removed value: -"guided-research"

Previous value: -"Research method selected for the draft. Use list_research_methods as the availability authority."New value: +"Research method selected for the draft. Use list_research_methods as the availability authority. When omitted on create, guided-research applies; when omitted on a revision, the saved method is kept."

Removed value: -{}

Removed value: -"context"

Previous value: -"Exact planner step to reopen, such as context, audiences, method, questions, or confirm. The legacy value groups remains accepted when reopening an older draft."New value: +"Exact planner step to reopen, such as context, audiences, method, questions, or confirm. The legacy value groups remains accepted when reopening an older draft. When omitted on create, context applies; when omitted on a revision, the saved step is kept."

Removed value: -"custom"

Previous value: -"Planning mode to restore. Defaults to custom for agent-authored planning state."New value: +"Planning mode to restore. When omitted on create, custom applies; when omitted on a revision, the saved mode is kept."

Removed value: -[]

Previous value: -"Manual research questions in their intended order."New value: +"Manual research questions in their intended order. When omitted on create, the draft has none; when omitted on a revision, the saved questions are kept."

Added value: +{
+  "description": "Study context files for the draft: images, video and audio are stimulus respondents see, documents are background. They are kept on later saves of the same draft. Files shared in this conversation: uploaded or generated images, PDFs, documents. Each is copied into Minds storage on receipt; its file_id is its attachment id.",
+  "items": {
+    "properties": {
+      "download_url": {
+        "description": "Download URL the chat host supplies for this file.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "file_id": {
+        "description": "The chat host's ID for this file.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "file_name": {
+        "description": "File name when the host supplies it.",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mime_type": {
+        "description": "MIME type when the host supplies it.",
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "download_url",
+      "file_id"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "default": {},
+  "description": "Research context captured so far.",
+  "properties": {
+    "notes": {
+      "description": "Additional research context or constraints.",
+      "type": "string"
+    },
+    "objective": {
+      "description": "Research objective or intent captured so far.",
+      "type": "string"
+    },
+    "sourceUrls": {
+      "default": [],
+      "description": "Ordered source URLs supplied as Study context.",
+      "items": {
+        "format": "uri",
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "website": {
+      "description": "Primary website associated with the research context.",
+      "format": "uri",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Removed value: -{
-  "default": "context",
-  "description": "Exact planner step to reopen, such as context, audiences, method, questions, or confirm. The legacy value groups remains accepted when reopening an older draft.",
-  "maxLength": 100,
-  "minLength": 1,
-  "type": "string"
-}

Added value: +{
+  "description": "Which durable draft to revise, and the retry key. Omit to create a new draft.",
+  "properties": {
+    "expectedRevision": {
+      "description": "Exact current revision. Required with draftId so stale updates cannot overwrite newer planning state.",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991,
+      "type": "integer"
+    },
+    "id": {
+      "description": "Existing Study draft ID to revise. Omit to create a new durable draft.",
+      "format": "uuid",
+      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+      "type": "string"
+    },
+    "idempotencyKey": {
+      "description": "Creation only: choose a stable key before the first save and reuse it after an uncertain result. Reuse returns the existing draft; use draftId and expectedRevision to change it.",
+      "maxLength": 200,
+      "minLength": 1,
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Removed value: -{
-  "description": "Existing Study draft ID to revise. Omit to create a new durable draft.",
-  "format": "uuid",
-  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-  "type": "string"
-}

Removed value: -{
-  "description": "Exact current revision. Required with draftId so stale updates cannot overwrite newer planning state.",
-  "exclusiveMinimum": 0,
-  "maximum": 9007199254740991,
-  "type": "integer"
-}

Removed value: -{
-  "description": "Legacy alias for audienceIds. Accepted for compatibility.",
-  "items": {
-    "format": "uuid",
-    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Creation only: choose a stable key before the first save and reuse it after an uncertain result. Reuse returns the existing draft; use draftId and expectedRevision to change it.",
-  "maxLength": 200,
-  "minLength": 1,
-  "type": "string"
-}

Removed value: -{
-  "default": "custom",
-  "description": "Planning mode to restore. Defaults to custom for agent-authored planning state.",
-  "enum": [
-    "quick",
-    "custom"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Additional research context or constraints.",
-  "type": "string"
-}

Removed value: -{
-  "description": "Research objective or intent captured so far.",
-  "type": "string"
-}

Added value: +{
+  "default": {},
+  "description": "Planner state to restore when the draft is reopened.",
+  "properties": {
+    "currentStep": {
+      "default": "context",
+      "description": "Exact planner step to reopen, such as context, audiences, method, questions, or confirm. The legacy value groups remains accepted when reopening an older draft.",
+      "maxLength": 100,
+      "minLength": 1,
+      "type": "string"
+    },
+    "mode": {
+      "default": "custom",
+      "description": "Planning mode to restore. Defaults to custom for agent-authored planning state.",
+      "enum": [
+        "quick",
+        "custom"
+      ],
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Removed value: -{
-  "default": [],
-  "description": "Ordered source URLs supplied as Study context.",
-  "items": {
-    "format": "uri",
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Primary website associated with the research context.",
-  "format": "uri",
-  "type": "string"
-}

Added value: +{
+  "description": "Creation only: choose a stable key before the first save and reuse it after an uncertain result. Reuse returns the existing draft; use draftId and expectedRevision to change it.",
+  "maxLength": 200,
+  "minLength": 1,
+  "type": "string"
+}

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": {},
+  "properties": {
+    "draft": {
+      "description": "The saved draft."
+    }
+  },
+  "type": "object"
+}

Previous value: -"Exact planner step to reopen, such as context, groups (Audiences), method, questions, or confirm."New value: +"Exact planner step to reopen, such as context, audiences, method, questions, or confirm. The legacy value groups remains accepted when reopening an older draft."

Added value: +{
+  "description": "Existing Audience IDs selected for the Study. Preferred.",
+  "items": {
+    "format": "uuid",
+    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Exact planner step to reopen, such as context, groups, method, questions, or confirm."New value: +"Exact planner step to reopen, such as context, groups (Audiences), method, questions, or confirm."

Removed value: -[]

Previous value: -"Existing Audience group IDs selected for the Study."New value: +"Legacy alias for audienceIds. Accepted for compatibility."

Removed value: -false

Added value: +"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"

Added value: +9007199254740991

Added value: +"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"