Previous value: -"What the frame shows and what happens in it, as a concrete visual description for the storyboard image. To show a Story element (character, place, object) write its referenceHandle from list_entities, e.g. @ref_storyboard_char_alice_sheet for the character Alice. The server turns known handles into live references (they read back as @#<entityId>-story-element); unknown ones stay as plain text. Read-back @# tokens can be sent again unchanged. Describe the shot in story terms only, with no instruction to the generator (not \"Redraw board panel 3: …\" or \"keep the board's framing\"): the action also feeds the production and video prompts. Instructions about boards go in the panel prompt (set_prompt)."New value: +"What the frame shows and what happens in it, as a concrete visual description for the storyboard image. To show a Story element (character, place, object) write its referenceHandle from list_entities, e.g. @ref_storyboard_char_alice_sheet for the character Alice. The server turns known handles into live references (they read back as @#<entityId>-story-element); unknown ones stay as plain text. Read-back @# tokens can be sent again unchanged. Describe the shot in story terms only, with no instruction to the generator (not \"Redraw board panel 3: …\" or \"keep the board's framing\"): the action also feeds the production and video prompts. Boards go in attachments, and what to leave out of them in boardInstructions."

Added value: +{
+  "description": "Images to attach to the shot's panel, added to those it has (max 8); attaching an image again with another role changes its role. Same roles and modes as in create_shots.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "mediaId": {
+        "description": "The image, as a media id from import_media (a page or a crop), view_media or get_group.",
+        "maxLength": 200,
+        "minLength": 1,
+        "type": "string"
+      },
+      "mode": {
+        "description": "Board only. reference (default): the panel generator redraws the board in the storyboard style, keeping its staging, with the story elements' look. as-is: the board itself becomes the shot's selected panel, as set_shot_panel does (at most one per shot).",
+        "enum": [
+          "reference",
+          "as-is"
+        ],
+        "type": "string"
+      },
+      "role": {
+        "description": "board: the drawing of this shot's frame. context: material the panel reads but does not draw, such as the strip of the whole shot or a page with the director's notes.",
+        "enum": [
+          "board",
+          "context"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "mediaId",
+      "role"
+    ],
+    "type": "object"
+  },
+  "maxItems": 8,
+  "minItems": 1,
+  "type": "array"
+}

Added value: +{
+  "anyOf": [
+    {
+      "description": "What the redraw of the boards must do or leave out beyond the template, in the user's words, e.g. \"Leave out the camera arrows; keep the rain.\" Only when the user asked for something. Never cite the art direction.",
+      "maxLength": 2000,
+      "minLength": 1,
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "What the redraw of the shot's boards must do or leave out beyond the template, in the user's words; null clears it. Only when the user asked for something. Never cite the art direction."
+}

Previous value: -"What the frame shows and what happens in it, as a concrete visual description for the storyboard image. To show a Story element (character, place, object) write its referenceHandle from list_entities, e.g. @ref_storyboard_char_alice_sheet for the character Alice. The server turns known handles into live references (they read back as @#<entityId>-story-element); unknown ones stay as plain text. Read-back @# tokens can be sent again unchanged."New value: +"What the frame shows and what happens in it, as a concrete visual description for the storyboard image. To show a Story element (character, place, object) write its referenceHandle from list_entities, e.g. @ref_storyboard_char_alice_sheet for the character Alice. The server turns known handles into live references (they read back as @#<entityId>-story-element); unknown ones stay as plain text. Read-back @# tokens can be sent again unchanged. Describe the shot in story terms only, with no instruction to the generator (not \"Redraw board panel 3: …\" or \"keep the board's framing\"): the action also feeds the production and video prompts. Instructions about boards go in the panel prompt (set_prompt)."