Unpaged

Previous value: -"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker, endMarker (none | arrow | diamond | circle | crow's-foot; default circle at the start, arrow at the end), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker, endMarker (none | arrow | diamond | circle | crow's-foot; default circle at the start, arrow at the end), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Image (a picture): pictureKey, naturalWidth and naturalHeight exactly as image_import answered them, and an optional description (what a screen reader says, at most 1000 characters). A key the whiteboard does not hold is refused: import the picture first. An imported key can be used by element_create in the same whiteboard during this session. Give width alone or height alone and the other follows the picture's proportions; with neither, it lands at its natural size fitted to half the default canvas. Node link: isLink, linkTarget (node ID)."

Previous value: -"Array of update objects, each with 'elementId' and fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Setting fillStyle 'linear' or 'radial' needs a hex fillColor and a fillColor2, sent in the same update or already stored on the shape; fillStyle 'solid' turns a gradient back into a plain fill. A read can show properties whose names start with two underscores: they are internal, leave them as they are. A read can also show groupId (and groupRotation): group membership changes only through group_elements and ungroup_elements. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint, chart data/seriesColors) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols, sent as string[][] or as the { values: [...] } rows a read returns; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. A fill field needs the stroke to be closed, by the same update or already. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."New value: +"Array of update objects, each with 'elementId' and fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Setting fillStyle 'linear' or 'radial' needs a hex fillColor and a fillColor2, sent in the same update or already stored on the shape; fillStyle 'solid' turns a gradient back into a plain fill. A read can show properties whose names start with two underscores: they are internal, leave them as they are. A read can also show groupId (and groupRotation): group membership changes only through group_elements and ungroup_elements. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint, chart data/seriesColors) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols, sent as string[][] or as the { values: [...] } rows a read returns; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. A fill field needs the stroke to be closed, by the same update or already. Image elements (type 'image') are pictures. A read returns properties pictureKey, naturalWidth and naturalHeight (the stored picture's size in pixels) and an optional description (what a screen reader says for it) — never the picture's bytes or a link. An update may move, resize or turn a picture and set properties.description (at most 1000 characters; an empty one removes it); width alone or height alone keeps the picture's proportions, both together are taken as given. pictureKey, naturalWidth and naturalHeight never change: an update that changes them is refused. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."

Previous value: -"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"

Previous value: -"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"

Previous value: -"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"New value: +"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

Added value: +[
+  "string",
+  "null"
+]

Previous value: -"Element object with required 'type' field and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker, endMarker (none | arrow | diamond | circle | crow's-foot; default circle at the start, arrow at the end), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Element object with required 'type' field and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker, endMarker (none | arrow | diamond | circle | crow's-foot; default circle at the start, arrow at the end), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Image (a picture): pictureKey, naturalWidth and naturalHeight exactly as image_import answered them, and an optional description (what a screen reader says, at most 1000 characters). A key the whiteboard does not hold is refused: import the picture first. An imported key can be used by element_create in the same whiteboard during this session. Give width alone or height alone and the other follows the picture's proportions; with neither, it lands at its natural size fitted to half the default canvas. Node link: isLink, linkTarget (node ID)."

Previous value: -"Fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Setting fillStyle 'linear' or 'radial' needs a hex fillColor and a fillColor2, sent in the same update or already stored on the shape; fillStyle 'solid' turns a gradient back into a plain fill. A read can show properties whose names start with two underscores: they are internal, leave them as they are. A read can also show groupId (and groupRotation): group membership changes only through group_elements and ungroup_elements. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols, sent as string[][] or as the { values: [...] } rows a read returns; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. A fill field needs the stroke to be closed, by the same update or already. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."New value: +"Fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Setting fillStyle 'linear' or 'radial' needs a hex fillColor and a fillColor2, sent in the same update or already stored on the shape; fillStyle 'solid' turns a gradient back into a plain fill. A read can show properties whose names start with two underscores: they are internal, leave them as they are. A read can also show groupId (and groupRotation): group membership changes only through group_elements and ungroup_elements. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols, sent as string[][] or as the { values: [...] } rows a read returns; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. A fill field needs the stroke to be closed, by the same update or already. Image elements (type 'image') are pictures. A read returns properties pictureKey, naturalWidth and naturalHeight (the stored picture's size in pixels) and an optional description (what a screen reader says for it) — never the picture's bytes or a link. An update may move, resize or turn a picture and set properties.description (at most 1000 characters; an empty one removes it); width alone or height alone keeps the picture's proportions, both together are taken as given. pictureKey, naturalWidth and naturalHeight never change: an update that changes them is refused. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."

Previous value: -"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker, endMarker (none | arrow | diamond | circle | crow's-foot; default circle at the start, arrow at the end), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker, endMarker (none | arrow | diamond | circle | crow's-foot; default circle at the start, arrow at the end), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Image (a picture): pictureKey, naturalWidth and naturalHeight exactly as image_import answered them, and an optional description (what a screen reader says, at most 1000 characters). A key the whiteboard does not hold is refused: import the picture first. An imported key can be used by element_create in the same whiteboard during this session. Give width alone or height alone and the other follows the picture's proportions; with neither, it lands at its natural size fitted to half the default canvas. Node link: isLink, linkTarget (node ID)."

Previous value: -"Array of update objects, each with 'elementId' and fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget, locked. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Setting fillStyle 'linear' or 'radial' needs a hex fillColor and a fillColor2, sent in the same update or already stored on the shape; fillStyle 'solid' turns a gradient back into a plain fill. A read can show properties whose names start with two underscores: they are internal, leave them as they are. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint, chart data/seriesColors) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols, sent as string[][] or as the { values: [...] } rows a read returns; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. A fill field needs the stroke to be closed, by the same update or already. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."New value: +"Array of update objects, each with 'elementId' and fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Setting fillStyle 'linear' or 'radial' needs a hex fillColor and a fillColor2, sent in the same update or already stored on the shape; fillStyle 'solid' turns a gradient back into a plain fill. A read can show properties whose names start with two underscores: they are internal, leave them as they are. A read can also show groupId (and groupRotation): group membership changes only through group_elements and ungroup_elements. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint, chart data/seriesColors) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols, sent as string[][] or as the { values: [...] } rows a read returns; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. A fill field needs the stroke to be closed, by the same update or already. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."

Previous value: -"Fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget, locked. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Setting fillStyle 'linear' or 'radial' needs a hex fillColor and a fillColor2, sent in the same update or already stored on the shape; fillStyle 'solid' turns a gradient back into a plain fill. A read can show properties whose names start with two underscores: they are internal, leave them as they are. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols, sent as string[][] or as the { values: [...] } rows a read returns; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. A fill field needs the stroke to be closed, by the same update or already. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."New value: +"Fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Setting fillStyle 'linear' or 'radial' needs a hex fillColor and a fillColor2, sent in the same update or already stored on the shape; fillStyle 'solid' turns a gradient back into a plain fill. A read can show properties whose names start with two underscores: they are internal, leave them as they are. A read can also show groupId (and groupRotation): group membership changes only through group_elements and ungroup_elements. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols, sent as string[][] or as the { values: [...] } rows a read returns; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. A fill field needs the stroke to be closed, by the same update or already. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."

Previous value: -"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker, endMarker (none | arrow | diamond | circle | crow's-foot; default circle at the start, arrow at the end), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Element object with required 'type' field and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Element object with required 'type' field and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker, endMarker (none | arrow | diamond | circle | crow's-foot; default circle at the start, arrow at the end), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker, endMarker (none | arrow | diamond | circle | crow's-foot; default circle at the start, arrow at the end), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Element object with required 'type' field and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Element object with required 'type' field and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; a long item or title wraps onto more lines and its row grows taller, so give the checklist enough height for every row: rows past the bottom are hidden), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Added value: +{
+  "description": "Subset of `emails` who can comment and ask @agent for changes, without editing",
+  "items": {
+    "format": "email",
+    "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Subset of `emails` to grant edit access (live coediting)"New value: +"Subset of `emails` who can edit (live coediting) and comment"

Previous value: -"Email addresses to grant view access"New value: +"Email addresses to share with; new people listed only here get view access (look only, no comments)"

Previous value: -"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Element object with required 'type' field and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Element object with required 'type' field and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. The wrap width is stored and read back as frameWidth; an update takes it by either name, maxWidth or frameWidth, and the element's width follows it. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot), opacity (0 to 1: the line and its markers together). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle, opacity (0 to 1). Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor, strokeWidth, opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Set true to get every created element back in full (stored form). By default the reply is short: each element's id, type and revision token, in input order."New value: +"Set true to get every created element back in full (stored form). By default the reply is short: each element's id, type (the same value reads return as elementType) and revision token, in input order."

Previous value: -"Array of update objects, each with 'elementId' and fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget, locked. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint, chart data/seriesColors) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."New value: +"Array of update objects, each with 'elementId' and fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget, locked. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Setting fillStyle 'linear' or 'radial' needs a hex fillColor and a fillColor2, sent in the same update or already stored on the shape; fillStyle 'solid' turns a gradient back into a plain fill. A read can show properties whose names start with two underscores: they are internal, leave them as they are. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint, chart data/seriesColors) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols, sent as string[][] or as the { values: [...] } rows a read returns; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. A fill field needs the stroke to be closed, by the same update or already. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."

Previous value: -"Element object with required 'type' field and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor, strokeWidth, opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Element object with required 'type' field and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget, locked. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."New value: +"Fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget, locked. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Setting fillStyle 'linear' or 'radial' needs a hex fillColor and a fillColor2, sent in the same update or already stored on the shape; fillStyle 'solid' turns a gradient back into a plain fill. A read can show properties whose names start with two underscores: they are internal, leave them as they are. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols, sent as string[][] or as the { values: [...] } rows a read returns; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. A fill field needs the stroke to be closed, by the same update or already. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."

Previous value: -"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor, strokeWidth, opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow; a circle is an ellipse with equal width and height): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex, both REQUIRED then): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). A text element sizes itself: leave width and height out, and the width is measured from the text, or is maxWidth when you set one. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor (optional, default #1a1a1a), strokeWidth (optional, default 3), opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A fill field on a stroke that is not closed is refused. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20, default 3), cols (1..10, default 3), cells (optional string[][] matching rows×cols; without it the table is empty), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). width and height size the whole table. A read returns each row of cells as { values: [...] }. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Set true to get every created element back in full (stored form). By default the reply is short: each element's id, type and revision token, in input order."New value: +"Set true to get every created element back in full (stored form). By default the reply is short: each element's id, type (the same value reads return as elementType) and revision token, in input order."

Previous value: -"Array of element objects, each with 'type' and type-specific properties. Common fields: x, y, width, height, rotation, fillColor, strokeColor, strokeWidth. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Text label (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Text element: text, fillColor (REQUIRED hex; choose a deliberate color that contrasts with the canvas), fontSize, fontFamily, textAlign. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; p is optional pressure in [0,1]; maximum 2000 points), strokeColor, strokeWidth. Width/height are derived from point extents when omitted. Line: lineStyle, startMarker, endMarker. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), lineStyle, startMarker, endMarker, label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class: name, attributes, methods, stereotype. UML Note: text, fontSize, textColor, textAlign, verticalAlign, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor, strokeWidth, opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Added value: +{
+  "description": "Set true to get every created element back in full (stored form). By default the reply is short: each element's id, type and revision token, in input order.",
+  "type": "boolean"
+}

Previous value: -"Array of update objects, each with 'elementId' and fields to update. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint, chart data/seriesColors) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array. Geometry alone does not reshape the ink; when replacing points, also set width/height to their matching extents. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."New value: +"Array of update objects, each with 'elementId' and fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget, locked. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint, chart data/seriesColors) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."

Previous value: -"Element object with required 'type' field and type-specific properties. Common fields: x, y, width, height, rotation, fillColor, strokeColor, strokeWidth. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Text label (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Text element: text, fillColor (REQUIRED hex; choose a deliberate color that contrasts with the canvas), fontSize, fontFamily, textAlign. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; p is optional pressure in [0,1]; maximum 2000 points), strokeColor, strokeWidth. Width/height are derived from point extents when omitted. Line: lineStyle, startMarker, endMarker. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), lineStyle, startMarker, endMarker, label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class: name, attributes, methods, stereotype. UML Note: text, fontSize, textColor, textAlign, verticalAlign, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Element object with required 'type' field and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor, strokeWidth, opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Added value: +{
+  "description": "Set true for a short listing: each element's id, type, position, size, rotation, link fields and revision token, without its properties (text, points, cells, colors). Use element_get for one element's content.",
+  "type": "boolean"
+}

Previous value: -"Fields to update. Common: x, y, width, height, rotation. Use 'properties' for shape-specific changes (e.g., {properties: {fillColor: \"#00FF00\"}}). Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array. Geometry alone does not reshape the ink; when replacing points, also set width/height to their matching extents. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."New value: +"Fields to update. Geometry and link fields sit at the top level: x, y, width, height, rotation, isLink, linkTarget, locked. Everything else is a shape property and goes inside `properties` (e.g., {properties: {fillColor: \"#00FF00\", text: \"Done\"}}). A shape property outside `properties`, or a property the element's type does not have, is refused and nothing is written. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array, and the element's width/height follow the new points on their own. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."

Previous value: -"Array of element objects, each with 'type' and type-specific properties. Common fields: x, y, width, height, rotation, fillColor, strokeColor, strokeWidth. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Text label (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Text element: text, fillColor (REQUIRED hex; choose a deliberate color that contrasts with the canvas), fontSize, fontFamily, textAlign. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; p is optional pressure in [0,1]; maximum 2000 points), strokeColor, strokeWidth. Width/height are derived from point extents when omitted. Line: lineStyle, startMarker, endMarker. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), lineStyle, startMarker, endMarker, label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class: name, attributes, methods, stereotype. UML Note: text, fontSize, textColor, textAlign, verticalAlign, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. A field that is not listed here for the element's type is refused: nothing is created and the error names the field. Common fields: x, y, width, height, rotation. x/y are the top-left corner and cannot be negative, also on a rotated shape; a shape that reaches past the canvas edge is moved back inside. rotation is any angle in degrees (stored as 0-359) and turns the shape about its center. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Colors are hex, #RGB or #RRGGBB. Layer order is creation order: in one call, earlier array entries are drawn under later ones. batch_reorder_elements changes it afterwards. Shapes (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): fillColor and strokeColor are both REQUIRED — choose them, there is no default. fillColor is a hex color or 'none' for an outline-only shape that shows what is behind it; strokeWidth 0 draws no outline, and strokeColor may then be left out; opacity (0 to 1, default 1) makes the whole shape see-through — fill, outline and label together; fillStyle 'linear' or 'radial' turns the fill into a two-color gradient from fillColor to fillColor2 (both hex): linear runs along gradientAngle in degrees (0 = left to right, the default; 90 = top to bottom) and turns with the shape's rotation, radial runs from fillColor at the center to fillColor2 at the edge; rectangle also takes cornerRadius, block-arrow takes direction (right | left | up | down). Text label on those shapes: text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Markdown traps: a line that starts with a number and a dot is a list item and is renumbered from 1 (write `2\\.` to keep the number); a line break inside a paragraph needs two trailing spaces before the newline; runs of spaces collapse to one. Text element: text, fillColor (REQUIRED hex — it is the color of the letters, a text element has no background; choose one that contrasts with the canvas), fontSize, fontFamily (Inter and Outfit are loaded; any other font depends on the viewer's device), fontWeight (100-900), lineHeight, textAlign, maxWidth (wrap width). Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; maximum 2000 points), strokeColor, strokeWidth, opacity (0 to 1). The line is smoothed through the points, so sparse points round off corners; straight: true joins them with straight lines and keeps corners sharp. closed: true joins the last point back to the first and makes the stroke a shape that takes a fill: fillColor (hex or 'none', the default), and the same fillStyle / fillColor2 / gradientAngle gradient as the basic shapes. A closed stroke that crosses itself fills everything it encloses; one stroke cannot have a hole. strokeWidth 0 draws no line, which leaves a filled closed stroke without an outline. Use a closed filled stroke for any organic filled shape instead of stacking ellipses or hatching. p is optional pressure in [0,1] and is drawn: the line is strokeWidth wide at p = 1 and thins to a third of it at p = 0; a stroke without p keeps one thickness. width/height are always the extent of the points; a value sent for either is ignored. Line: runs from (x, y) to (x + width, y + height); width and height cannot be negative, so tilt it the other way with rotation. strokeColor, strokeWidth, lineStyle (solid | dashed | dotted), startMarker, endMarker (none | arrow | diamond | circle | crow's-foot). Bezier curve: placed like a line, from (x, y) to (x + width, y + height); controlPoint1X/controlPoint1Y (offset from the start) and controlPoint2X/controlPoint2Y (offset from the end) bend it, and without them it is a gentle S. strokeColor, strokeWidth, lineStyle. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), strokeColor, strokeWidth, lineStyle, startMarker (default circle), endMarker (default arrow), label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class and UML Interface: name, attributes, methods, stereotype. UML Component, Package and Artifact: name, stereotype. All UML shapes: fillColor, strokeColor, strokeWidth. UML Note: text, fontSize, textColor, textAlign, verticalAlign, strokeColor, strokeWidth, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor, fontFamily, fontSize, textAlign (left | center | right), verticalAlign (top | middle | bottom). Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically; an item shows its first 40 characters), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Added value: +{
+  "description": "Set true to get every created element back in full (stored form). By default the reply is short: each element's id, type and revision token, in input order.",
+  "type": "boolean"
+}

Previous value: -"Array of element objects, each with 'type' and type-specific properties. Common fields: x, y, width, height, rotation, fillColor, strokeColor, strokeWidth. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Text label (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Text element: text, fillColor (REQUIRED hex; choose a deliberate color that contrasts with the canvas), fontSize, fontFamily, textAlign. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; p is optional pressure in [0,1]; maximum 2000 points), strokeColor, strokeWidth. Width/height are derived from point extents when omitted. Line: lineStyle, startMarker, endMarker. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), lineStyle, startMarker, endMarker, label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class: name, attributes, methods, stereotype. UML Note: text, fontSize, textColor, textAlign, verticalAlign, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. Common fields: x, y, width, height, rotation, fillColor, strokeColor, strokeWidth. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Text label (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Text element: text, fillColor (REQUIRED hex; choose a deliberate color that contrasts with the canvas), fontSize, fontFamily, textAlign. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; p is optional pressure in [0,1]; maximum 2000 points), strokeColor, strokeWidth. Width/height are derived from point extents when omitted. Line: lineStyle, startMarker, endMarker. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), lineStyle, startMarker, endMarker, label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class: name, attributes, methods, stereotype. UML Note: text, fontSize, textColor, textAlign, verticalAlign, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Array of update objects, each with 'elementId' and fields to update. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols. For freehand strokes, properties.points replaces the local point array. Geometry alone does not reshape the ink; when replacing points, also set width/height to their matching extents. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."New value: +"Array of update objects, each with 'elementId' and fields to update. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint, chart data/seriesColors) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array. Geometry alone does not reshape the ink; when replacing points, also set width/height to their matching extents. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."

Previous value: -"Element object with required 'type' field and type-specific properties. Common fields: x, y, width, height, rotation, fillColor, strokeColor, strokeWidth. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Text label (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Text element: text, fillColor (REQUIRED hex; choose a deliberate color that contrasts with the canvas), fontSize, fontFamily, textAlign. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; p is optional pressure in [0,1]; maximum 2000 points), strokeColor, strokeWidth. Width/height are derived from point extents when omitted. Line: lineStyle, startMarker, endMarker. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), lineStyle, startMarker, endMarker, label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class: name, attributes, methods, stereotype. UML Note: text, fontSize, textColor, textAlign, verticalAlign, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Node link: isLink, linkTarget (node ID)."New value: +"Element object with required 'type' field and type-specific properties. Common fields: x, y, width, height, rotation, fillColor, strokeColor, strokeWidth. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Text label (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Text element: text, fillColor (REQUIRED hex; choose a deliberate color that contrasts with the canvas), fontSize, fontFamily, textAlign. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; p is optional pressure in [0,1]; maximum 2000 points), strokeColor, strokeWidth. Width/height are derived from point extents when omitted. Line: lineStyle, startMarker, endMarker. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), lineStyle, startMarker, endMarker, label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class: name, attributes, methods, stereotype. UML Note: text, fontSize, textColor, textAlign, verticalAlign, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"Fields to update. Common: x, y, width, height, rotation. Use 'properties' for shape-specific changes (e.g., {properties: {fillColor: \"#00FF00\"}}). Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols. For freehand strokes, properties.points replaces the local point array. Geometry alone does not reshape the ink; when replacing points, also set width/height to their matching extents. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."New value: +"Fields to update. Common: x, y, width, height, rotation. Use 'properties' for shape-specific changes (e.g., {properties: {fillColor: \"#00FF00\"}}). Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols; chart data and seriesColors are replaced whole too. For freehand strokes, properties.points replaces the local point array. Geometry alone does not reshape the ink; when replacing points, also set width/height to their matching extents. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."

Previous value: -"expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token."New value: +"expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint, chart data/seriesColors) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token."

Previous value: -"Array of element objects, each with 'type' and type-specific properties. Common fields: x, y, width, height, rotation, fillColor, strokeColor, strokeWidth. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Text label (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Text element: text, fillColor (REQUIRED hex; choose a deliberate color that contrasts with the canvas), fontSize, fontFamily, textAlign. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; p is optional pressure in [0,1]; maximum 2000 points), strokeColor, strokeWidth. Width/height are derived from point extents when omitted. Line: lineStyle, startMarker, endMarker. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), lineStyle, startMarker, endMarker, label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class: name, attributes, methods, stereotype. UML Note: text, fontSize, textColor, textAlign, verticalAlign, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Node link: isLink, linkTarget (node ID)."New value: +"Array of element objects, each with 'type' and type-specific properties. Common fields: x, y, width, height, rotation, fillColor, strokeColor, strokeWidth. Position alternatives: centerX/centerY compute x/y from the center point; do not combine x with centerX or y with centerY. Text label (rectangle, triangle, diamond, hexagon, ellipse, block-arrow): text, fontSize, textColor, textAlign, verticalAlign. Text element content, supported shape labels, and table cells use raw CommonMark Markdown. Supported formatting includes **bold**, *italic*, `inline code`, ~~strike~~, [links](url), nested `-` / `1.` lists, and fenced code blocks. A fenced ```mermaid block renders as a Mermaid diagram; other supported language-tagged fences render as syntax-highlighted code. Escape literal Markdown markers with backslash. Text element: text, fillColor (REQUIRED hex; choose a deliberate color that contrasts with the canvas), fontSize, fontFamily, textAlign. Freehand pen stroke: type 'freehand', points (REQUIRED non-empty array of element-local {x, y, p?}; minimum x and y must both be 0; p is optional pressure in [0,1]; maximum 2000 points), strokeColor, strokeWidth. Width/height are derived from point extents when omitted. Line: lineStyle, startMarker, endMarker. Connector: startElementId, endElementId, startAnchor (REQUIRED), endAnchor (REQUIRED), lineStyle, startMarker, endMarker, label. Connector anchors must be one of corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; 'center' is rejected. Pick the facing edges/corners. corner-top is the triangle apex and is triangle-only. UML Class: name, attributes, methods, stereotype. UML Note: text, fontSize, textColor, textAlign, verticalAlign, colorVariant ('yellow' | 'peach' | 'pink' | 'mint' | 'sky' | 'lavender'); fillColor overrides colorVariant. Table: rows (1..20), cols (1..10), cells (string[][] matching rows×cols), borderColor, backgroundColor, textColor. Checklist: title and items (up to 200 {text, checked} entries; ids are assigned automatically), fillColor, strokeColor, strokeWidth, textColor, checkboxColor, fontSize. Chart: chartType (bar | line | pie | number; pie uses the first series, number shows the latest value of the first series with its change), title, data ({ series: up to 6 names, rows: up to 60 { label, values } with one number or null per series, never more values than series }), seriesColors (hex, one per series by position; per slice for pie — when you reorder or remove series, send seriesColors in the new order), valuePrefix / valueSuffix (e.g. \"$\", \"%\"), target (number card), showLegend, showValues, fillColor, strokeColor, strokeWidth, textColor, fontSize. Charts have no text property. Node link: isLink, linkTarget (node ID)."

Previous value: -"The board this key listens to — the documentId you just created or were asked to watch"New value: +"The whiteboard this key listens to — the documentId you just created or were asked to watch"

Previous value: -"Array of update objects, each with 'elementId' and fields to update. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a board a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols. For freehand strokes, properties.points replaces the local point array. Geometry alone does not reshape the ink; when replacing points, also set width/height to their matching extents. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."New value: +"Array of update objects, each with 'elementId' and fields to update. Per entry: expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token. Any stale or token-less composite entry aborts the WHOLE batch. Updates merge per key: omitted properties are preserved, provided ones are replaced whole. For checklists, properties.items replaces the entire item list (ids are backfilled) — omit items to keep it; table cells are likewise replaced whole and reshaped to the table's rows×cols. For freehand strokes, properties.points replaces the local point array. Geometry alone does not reshape the ink; when replacing points, also set width/height to their matching extents. Connector startAnchor/endAnchor may only be set to a corner/edge (corner-tl, corner-tr, corner-bl, corner-br, corner-top, edge-top, edge-right, edge-bottom, edge-left; corner-top is the triangle apex, triangle-only); 'center' is rejected. Omit the anchor keys to leave a legacy connector's anchors untouched."

Previous value: -"expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a board a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token."New value: +"expectedRevision is the element's `revision` token from the read this change is based on (every read tool returns it per element). It is REQUIRED when properties replaces a composite value (cells, items, points, text, uml attributes/methods, startEndpoint/endEndpoint) and optional otherwise. If the element changed since that read the write fails with a CONFLICT asking you to re-read; a composite write without the token fails with a MissingRevisionError. To change one cell, row, or item of a whiteboard a human may also be editing, prefer table_update_cell / table_append_row / checklist_toggle_item — they work on current state and need no token."