Sessionplan

{'type': 'object', '$defs': {'item': {'type': 'object', 'allOf': [{'if': {'properties': {'type': {'const': 'block'}}}, 'then': {'not': {'required': ['children']}}}, {'if': {'properties': {'type': {'const': 'group'}}}, 'then': {'required': ['children'], 'properties': {'children': {'items': {'properties': {'type': {'enum': ['block', 'breakout']}}}}}}}, {'if': {'properties': {'type': {'const': 'breakout'}}}, 'then': {'required': ['children'], 'properties': {'children': {'items': {'properties': {'type': {'const': 'block'}}}}}}}], 'required': ['id', 'type', 'blockTypeId', 'title', 'duration', 'notes', 'material'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Non-empty stable identifier, unique across the complete item tree.'}, 'type': {'enum': ['block', 'group', 'breakout'], 'type': 'string', 'description': 'Item kind: block, sequential group, or parallel breakout.'}, 'lanes': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Number of breakout lanes, from 1 to 10 as supported by the editor. Defaults to 2 when omitted.'}, 'notes': {'type': 'string', 'description': 'Facilitator notes; supports *bold*, _italic_ and [label](URL).'}, 'title': {'type': 'string', 'description': 'Agenda item title.'}, 'children': {'type': 'array', 'items': {'$ref': '#/$defs/item'}, 'description': 'Groups contain blocks or breakouts; breakouts contain blocks. Blocks cannot have children.'}, 'duration': {'type': 'number', 'minimum': 0, 'description': 'Explicit section duration in minutes. Groups normally use the sum of children; breakouts use the longest lane. The encoder does not recalculate durations.'}, 'material': {'type': 'string', 'description': 'Materials, links or resources.'}, 'parallel': {'type': 'boolean', 'description': 'Whether a breakout runs in parallel. Use true for breakouts.'}, 'laneIndex': {'type': 'integer', 'minimum': 0, 'description': 'Zero-based lane index within the parent breakout; defaults to 0. Must be less than the parent lane count.'}, 'personIds': {'type': 'array', 'items': {'type': 'string'}, 'description': 'IDs of declared persons assigned to this item.'}, 'blockTypeId': {'type': ['string', 'null'], 'description': 'ID of a declared block type, or null.'}, 'lanePersons': {'type': 'object', 'description': 'Map of zero-based lane indices to arrays of declared person IDs. Keep this as a JSON object, including when empty.', 'propertyNames': {'pattern': '^(0|[1-9][0-9]*)$(?![\\s\\S])'}, 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'durationLocked': {'type': 'boolean', 'description': 'Preserve the explicit container duration when the editor recalculates the plan.'}, 'fixedStartTime': {'type': 'string', 'pattern': '^([01][0-9]|2[0-3]):[0-5][0-9]$(?![\\s\\S])', 'description': 'Optional local fixed start time (HH:MM, 00:00–23:59).'}, 'sameInAllBreakouts': {'type': 'boolean', 'description': 'Show lane-zero content in every lane; child laneIndex must then be zero or omitted.'}}, 'additionalProperties': False}, 'person': {'type': 'object', 'required': ['id', 'name', 'color'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Non-empty identifier, unique within this collection.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'color': {'type': 'string', 'description': 'CSS color, commonly a hexadecimal color such as #2C8DFE.'}}, 'additionalProperties': False}, 'workshop': {'type': 'object', 'required': ['title', 'description'], 'properties': {'date': {'type': ['string', 'null'], 'format': 'date', 'pattern': '^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}$(?![\\s\\S])', 'description': 'Optional calendar date (YYYY-MM-DD). Use null when no date is planned.'}, 'title': {'type': 'string', 'description': 'Session title.'}, 'startTime': {'type': ['string', 'null'], 'pattern': '^([01][0-9]|2[0-3]):[0-5][0-9]$(?![\\s\\S])', 'description': 'Optional local start time (HH:MM, 00:00–23:59). Use null when no start time is planned.'}, 'description': {'type': 'string', 'description': 'Session description or facilitator notes.'}, 'lastModified': {'type': 'string', 'format': 'date-time', 'pattern': '^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt]([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\.[0-9]+)?([Zz]|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$(?![\\s\\S])', 'description': 'Optional timestamp with T separator, seconds 00–59 and a time zone (Z or ±HH:MM), e.g. 2026-09-15T09:00:00.000Z.'}, 'durationLocked': {'type': 'boolean', 'description': 'Whether the target duration is locked.'}, 'targetDuration': {'type': 'number', 'minimum': 0, 'description': 'Optional target duration in minutes, greater than or equal to zero.'}}, 'additionalProperties': False}, 'blockType': {'type': 'object', 'required': ['id', 'name', 'color'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Non-empty identifier, unique within this collection.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'color': {'type': 'string', 'description': 'CSS color, commonly a hexadecimal color such as #2C8DFE.'}}, 'additionalProperties': False}}, 'required': ['session'], 'properties': {'session': {'type': 'object', 'title': 'Sessionplan document', 'required': ['version', 'workshop', 'blockTypes', 'persons', 'items'], 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/item'}, 'maxItems': 500, 'description': 'Ordered top-level blocks, groups or breakouts. The complete tree may contain at most 500 items.'}, 'persons': {'type': 'array', 'items': {'$ref': '#/$defs/person'}, 'description': 'Declared facilitators or participants referenced by personIds and lanePersons.'}, 'version': {'type': 'string', 'description': 'Document format version, currently 1.0; distinct from the v2 link codec and MCP protocol version.'}, 'workshop': {'$ref': '#/$defs/workshop', 'description': 'Workshop metadata.'}, 'blockTypes': {'type': 'array', 'items': {'$ref': '#/$defs/blockType'}, 'description': 'Declared block categories referenced by blockTypeId.'}}, 'description': 'Canonical format for newly generated Sessionplan documents. Include all required fields and only documented properties. Use declared category/person IDs and the supported item hierarchy.', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'required': ['link'], 'properties': {'link': {'type': 'string', 'description': 'Opaque, directly openable Sessionplan snapshot URL. Present this exact value verbatim; do not reconstruct, normalize, shorten, decode, or modify it.'}, 'summary': {'type': 'object', 'properties': {'title': {'type': 'string', 'description': 'Session title.'}, 'blockCount': {'type': 'integer', 'minimum': 0, 'description': 'Number of block items across the complete tree; containers are excluded.'}, 'totalDuration': {'type': 'number', 'minimum': 0, 'description': 'Sum of explicit top-level item durations in minutes; does not include fixed-start gaps or recalculate children.'}}, 'description': 'Optional compact summary of the encoded session.', 'additionalProperties': True}}, 'additionalProperties': True}

{'type': 'object', 'required': ['link'], 'properties': {'link': {'type': 'string', 'minLength': 1, 'description': 'Unmodified Sessionplan URL, URL hash, or v2 snapshot code supplied by the user.'}}, 'additionalProperties': False}

{'type': 'object', '$defs': {'item': {'type': 'object', 'allOf': [{'if': {'properties': {'type': {'const': 'block'}}}, 'then': {'properties': {'children': {'maxItems': 0}}}}, {'if': {'properties': {'type': {'const': 'group'}}}, 'then': {'properties': {'children': {'items': {'properties': {'type': {'enum': ['block', 'breakout']}}}}}}}, {'if': {'properties': {'type': {'const': 'breakout'}}}, 'then': {'properties': {'children': {'items': {'properties': {'type': {'const': 'block'}}}}}}}], 'required': ['id', 'type', 'title', 'duration'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'type': {'enum': ['block', 'group', 'breakout'], 'type': 'string'}, 'lanes': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'notes': {'type': 'string'}, 'title': {'type': 'string'}, 'children': {'type': 'array', 'items': {'$ref': '#/$defs/item'}}, 'duration': {'type': 'number', 'minimum': 0}, 'material': {'type': 'string'}, 'parallel': {'type': 'boolean'}, 'laneIndex': {'type': 'integer', 'minimum': 0}, 'personIds': {'type': 'array', 'items': {'type': 'string'}}, 'blockTypeId': {'type': ['string', 'null']}, 'lanePersons': {'type': 'object', 'propertyNames': {'pattern': '^(0|[1-9][0-9]*)$(?![\\s\\S])'}, 'additionalProperties': {'type': 'array', 'items': {'type': 'string'}}}, 'durationLocked': {'type': 'boolean'}, 'fixedStartTime': {'type': ['string', 'null'], 'pattern': '^(([01][0-9]|2[0-3]):[0-5][0-9])?$(?![\\s\\S])'}, 'sameInAllBreakouts': {'type': 'boolean'}}, 'additionalProperties': True}, 'person': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'color': {'type': 'string'}}, 'additionalProperties': True}, 'workshop': {'type': 'object', 'required': ['title'], 'properties': {'date': {'if': {'not': {'const': ''}}, 'then': {'format': 'date', 'pattern': '^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}$(?![\\s\\S])'}, 'type': ['string', 'null']}, 'title': {'type': 'string'}, 'startTime': {'type': ['string', 'null'], 'pattern': '^(([01][0-9]|2[0-3]):[0-5][0-9])?$(?![\\s\\S])'}, 'description': {'type': 'string'}, 'lastModified': {'type': 'string', 'format': 'date-time', 'pattern': '^(?!0000)[0-9]{4}-[0-9]{2}-[0-9]{2}[Tt]([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\.[0-9]+)?([Zz]|[+-]([01][0-9]|2[0-3]):[0-5][0-9])$(?![\\s\\S])'}, 'durationLocked': {'type': ['boolean', 'null']}, 'targetDuration': {'type': ['number', 'null'], 'minimum': 0}}, 'additionalProperties': True}, 'blockType': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'color': {'type': 'string'}}, 'additionalProperties': True}}, 'required': ['session'], 'properties': {'session': {'type': 'object', 'title': 'Sessionplan document', 'required': ['workshop', 'items'], 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/item'}, 'maxItems': 500}, 'persons': {'type': 'array', 'items': {'$ref': '#/$defs/person'}}, 'version': {'type': 'string'}, 'workshop': {'$ref': '#/$defs/workshop'}, 'blockTypes': {'type': 'array', 'items': {'$ref': '#/$defs/blockType'}}}, 'additionalProperties': True}}, 'additionalProperties': False}