Skip to main content

get_data_model

Returns a reference for DEON canvas items: item types, the coordinate system, per-type fields and value shapes, and the full list of shape names. An agent should call this when unsure how to create or update an item.

Tool name: get_data_model

Parameters

None.

Returns

A JSON reference document. The key sections:

  • overview — the coordinate system: world units, position = top-left {x,y}, size = {width,height}, angle in degrees (0–360), colors as CSS strings.
  • itemTypes — the eight item types (label, sticky-note, shape, connector, image, web, svg, document) and which tool creates each.
  • commonFieldsposition, size, scale, angle with their value shapes and defaults.
  • label, shape, connector, image — per-type fields and constraints (e.g. label auto-size rules, connector start/end points).
  • updateItemProperty — example property names and value shapes for update_item_property.
  • shapes — the full list of shape names accepted by create_shape.

Excerpt:

{
"overview": "A DEON project is a map of items on an infinite 2D canvas. ...",
"itemTypes": {
"label": "auto-sized text (create_item kind=\"label\")",
"sticky-note": "preset note with background (create_item kind=\"sticky\")",
"shape": "geometric shape (create_shape)",
"connector": "line/arrow between items (connect_items)",
"image": "raster image (upload_image)",
"web": "embedded web page",
"svg": "vector image",
"document": "document file (PDF/Word/PowerPoint)"
},
"commonFields": {
"position": "{ x: number, y: number } — top-left in world units (default 0,0)",
"size": "{ width: number, height: number } — min 5 per dimension",
"scale": "number > 0 (default 1)",
"angle": "number 0–360 degrees (default 0)"
},
"shapes": ["Rectangle", "RoundedRectangle", "…"]
}

Example

Called automatically by an agent before an unfamiliar update_item_property call.

{}