@underdogai/mesh-event-schemas 0.9.0 → 0.11.0

package/card.schema.json

@@ -0,0 +1,1918 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://chatops.theunderdog.ai/schemas/card.schema.json",
+  "title": "Mesh 카드 (org.corp.ui)",
+  "description": "채팅 타임라인에 그려지는 대화형 카드. 블록(닫힌 집합)을 위에서 아래로 쌓는다. 임의 HTML·코드는 없다.",
+  "type": "object",
+  "properties": {
+    "v": {
+      "type": "integer",
+      "const": 1,
+      "default": 1
+    },
+    "card_id": {
+      "description": "카드 인스턴스 ID(영숫자·하이픈). 버튼 회신·편집이 이 값으로 카드를 가리킨다",
+      "type": "string",
+      "minLength": 1
+    },
+    "title": {
+      "description": "카드 제목 — 짧게",
+      "type": "string"
+    },
+    "blocks": {
+      "description": "위에서 아래로 그릴 블록. 요약을 먼저, 버튼(actions)은 맨 아래",
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/Block"
+      },
+      "default": []
+    },
+    "steps": {
+      "description": "여러 단계 폼(마법사). 단계마다 blocks, 마지막에 한 번 제출",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "title": {
+            "type": "string"
+          },
+          "blocks": {
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/Block"
+            }
+          }
+        },
+        "required": [
+          "blocks"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "fallback": {
+      "description": "카드를 못 그리는 클라이언트가 보는 평문 요약(필수)",
+      "type": "string"
+    },
+    "state": {
+      "type": "string",
+      "enum": [
+        "open",
+        "submitted",
+        "cancelled",
+        "expired"
+      ]
+    },
+    "request_event_id": {
+      "type": "string"
+    },
+    "context": {
+      "type": "object",
+      "properties": {
+        "agent": {
+          "type": "string"
+        },
+        "entity": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "type",
+            "id"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": true
+    },
+    "expires_at": {
+      "description": "epoch ms. 지나면 입력이 잠긴다",
+      "type": "integer"
+    }
+  },
+  "required": [
+    "card_id",
+    "fallback"
+  ],
+  "additionalProperties": false,
+  "$defs": {
+    "Block": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/TextBlock"
+        },
+        {
+          "$ref": "#/$defs/HeadingBlock"
+        },
+        {
+          "$ref": "#/$defs/DividerBlock"
+        },
+        {
+          "$ref": "#/$defs/FieldsBlock"
+        },
+        {
+          "$ref": "#/$defs/ImageBlock"
+        },
+        {
+          "$ref": "#/$defs/ContextBlock"
+        },
+        {
+          "$ref": "#/$defs/BadgeBlock"
+        },
+        {
+          "$ref": "#/$defs/TableBlock"
+        },
+        {
+          "$ref": "#/$defs/ProgressBlock"
+        },
+        {
+          "$ref": "#/$defs/StepsBlock"
+        },
+        {
+          "$ref": "#/$defs/MetricBlock"
+        },
+        {
+          "$ref": "#/$defs/ChartBlock"
+        },
+        {
+          "$ref": "#/$defs/AvatarBlock"
+        },
+        {
+          "$ref": "#/$defs/AvatarGroupBlock"
+        },
+        {
+          "$ref": "#/$defs/GaugeBlock"
+        },
+        {
+          "$ref": "#/$defs/RatingBlock"
+        },
+        {
+          "$ref": "#/$defs/CalloutBlock"
+        },
+        {
+          "$ref": "#/$defs/EntityRefBlock"
+        },
+        {
+          "$ref": "#/$defs/KanbanBlock"
+        },
+        {
+          "$ref": "#/$defs/CountdownBlock"
+        },
+        {
+          "$ref": "#/$defs/ActivityBlock"
+        },
+        {
+          "$ref": "#/$defs/CodeBlock"
+        },
+        {
+          "$ref": "#/$defs/DiffBlock"
+        },
+        {
+          "$ref": "#/$defs/FileBlock"
+        },
+        {
+          "$ref": "#/$defs/CollapsibleBlock"
+        },
+        {
+          "$ref": "#/$defs/WidgetBlock"
+        },
+        {
+          "$ref": "#/$defs/InputBlock"
+        },
+        {
+          "$ref": "#/$defs/ToggleBlock"
+        },
+        {
+          "$ref": "#/$defs/SliderBlock"
+        },
+        {
+          "$ref": "#/$defs/RadioBlock"
+        },
+        {
+          "$ref": "#/$defs/SelectBlock"
+        },
+        {
+          "$ref": "#/$defs/CheckboxBlock"
+        },
+        {
+          "$ref": "#/$defs/LocationBlock"
+        },
+        {
+          "$ref": "#/$defs/ButtonBlock"
+        },
+        {
+          "$ref": "#/$defs/LinkButtonBlock"
+        },
+        {
+          "$ref": "#/$defs/ActionsBlock"
+        },
+        {
+          "$ref": "#/$defs/OverflowBlock"
+        }
+      ]
+    },
+    "TextBlock": {
+      "description": "문단. markdown:true 면 굵게·목록·링크·코드 등 안전한 마크다운",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "text"
+        },
+        "text": {
+          "type": "string"
+        },
+        "markdown": {
+          "description": "true 면 안전한 마크다운(굵게·목록·링크·코드·인용). 표는 table 블록",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "type",
+        "text"
+      ],
+      "additionalProperties": false
+    },
+    "HeadingBlock": {
+      "description": "소제목(level 1~3)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "heading"
+        },
+        "text": {
+          "type": "string"
+        },
+        "level": {
+          "type": "integer",
+          "enum": [
+            1,
+            2,
+            3
+          ]
+        }
+      },
+      "required": [
+        "type",
+        "text"
+      ],
+      "additionalProperties": false
+    },
+    "DividerBlock": {
+      "description": "가로 구분선",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "divider"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "FieldsBlock": {
+      "description": "라벨:값 목록. short:true 면 2열 그리드, long:true 면 문단 값",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "fields"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "value": {
+                "type": "string"
+              },
+              "short": {
+                "description": "true 면 2열 그리드에 좁게",
+                "type": "boolean"
+              },
+              "parts": {
+                "description": "값을 톤이 다른 조각으로(예: +214 −37). value 는 이어 붙인 평문 사본",
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "text": {
+                      "type": "string"
+                    },
+                    "tone": {
+                      "description": "색 톤",
+                      "$ref": "#/$defs/Tone"
+                    }
+                  },
+                  "required": [
+                    "text"
+                  ],
+                  "additionalProperties": false
+                }
+              },
+              "ref": {
+                "$ref": "#/$defs/Ref"
+              },
+              "long": {
+                "description": "true 면 문단 값(전체폭)",
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "label",
+              "value"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "columns": {
+          "description": "열 수 강제(드물게). 생략이 기본(auto-fit)",
+          "enum": [
+            2,
+            3,
+            "auto"
+          ]
+        }
+      },
+      "required": [
+        "type",
+        "items"
+      ],
+      "additionalProperties": false
+    },
+    "Tone": {
+      "type": "string",
+      "enum": [
+        "neutral",
+        "success",
+        "warning",
+        "danger",
+        "info"
+      ]
+    },
+    "Ref": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "user": {
+              "type": "string",
+              "pattern": "^@[^:]+:.+"
+            }
+          },
+          "required": [
+            "user"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "entity": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "id": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "required": [
+                "type",
+                "id"
+              ],
+              "additionalProperties": false
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "entity"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "ImageBlock": {
+      "description": "본문 그림(https url 또는 mxc)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "image"
+        },
+        "url": {
+          "description": "https URL",
+          "type": "string"
+        },
+        "mxc": {
+          "description": "mxc:// 미디어",
+          "type": "string"
+        },
+        "alt": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "ContextBlock": {
+      "description": "작은 보조 줄(문자열·아이콘 조각)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "context"
+        },
+        "elements": {
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "icon": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "icon"
+                ],
+                "additionalProperties": false
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "mxc": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "mxc"
+                ],
+                "additionalProperties": false
+              }
+            ]
+          }
+        }
+      },
+      "required": [
+        "type",
+        "elements"
+      ],
+      "additionalProperties": false
+    },
+    "BadgeBlock": {
+      "description": "상태 배지(tone 으로 색)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "badge"
+        },
+        "text": {
+          "type": "string"
+        },
+        "tone": {
+          "description": "색 톤",
+          "$ref": "#/$defs/Tone"
+        }
+      },
+      "required": [
+        "type",
+        "text"
+      ],
+      "additionalProperties": false
+    },
+    "TableBlock": {
+      "description": "표 — columns 와 같은 길이의 문자열 rows",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "table"
+        },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "required": [
+        "type",
+        "columns",
+        "rows"
+      ],
+      "additionalProperties": false
+    },
+    "ProgressBlock": {
+      "description": "진행 막대(0~100 정수, 생략하면 불확정)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "progress"
+        },
+        "value": {
+          "description": "0~100 정수. 생략하면 불확정",
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "label": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    "StepsBlock": {
+      "description": "작업 단계 타임라인(done·active·todo·error)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "steps"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "status": {
+                "type": "string",
+                "enum": [
+                  "done",
+                  "active",
+                  "todo",
+                  "error"
+                ]
+              },
+              "note": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "label"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "type",
+        "items"
+      ],
+      "additionalProperties": false
+    },
+    "MetricBlock": {
+      "description": "KPI 하나 — 값·목표·증감",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "metric"
+        },
+        "label": {
+          "type": "string"
+        },
+        "value": {
+          "type": "string"
+        },
+        "target": {
+          "type": "string"
+        },
+        "delta": {
+          "type": "string"
+        },
+        "tone": {
+          "description": "색 톤",
+          "$ref": "#/$defs/Tone"
+        }
+      },
+      "required": [
+        "type",
+        "label",
+        "value"
+      ],
+      "additionalProperties": false
+    },
+    "ChartBlock": {
+      "description": "작은 차트(sparkline·bar·line·donut)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "chart"
+        },
+        "variant": {
+          "type": "string",
+          "enum": [
+            "sparkline",
+            "bar",
+            "line",
+            "donut"
+          ]
+        },
+        "data": {
+          "description": "sparkline·line 은 순서대로 잇고, bar·donut 은 항목마다 막대·조각",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "value": {
+                "type": "number"
+              },
+              "tone": {
+                "description": "색 톤",
+                "$ref": "#/$defs/Tone"
+              }
+            },
+            "required": [
+              "value"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "caption": {
+          "type": "string"
+        },
+        "max": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "unit": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "variant",
+        "data"
+      ],
+      "additionalProperties": false
+    },
+    "AvatarBlock": {
+      "description": "사람 한 명(얼굴·이름·상태점)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "avatar"
+        },
+        "name": {
+          "description": "폼 값의 키 — 카드 안에서 고유",
+          "type": "string"
+        },
+        "initials": {
+          "type": "string"
+        },
+        "src": {
+          "type": "string"
+        },
+        "subtitle": {
+          "type": "string"
+        },
+        "ref": {
+          "$ref": "#/$defs/Ref"
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "online",
+            "away",
+            "busy",
+            "offline"
+          ]
+        }
+      },
+      "required": [
+        "type",
+        "name"
+      ],
+      "additionalProperties": false
+    },
+    "AvatarGroupBlock": {
+      "description": "사람 여럿을 겹쳐 쌓기(+N)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "avatarGroup"
+        },
+        "people": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "description": "폼 값의 키 — 카드 안에서 고유",
+                "type": "string"
+              },
+              "initials": {
+                "type": "string"
+              },
+              "src": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "max": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "label": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "people"
+      ],
+      "additionalProperties": false
+    },
+    "GaugeBlock": {
+      "description": "반원 게이지(점수·리스크)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "gauge"
+        },
+        "value": {
+          "type": "number"
+        },
+        "max": {
+          "type": "number"
+        },
+        "min": {
+          "type": "number"
+        },
+        "label": {
+          "type": "string"
+        },
+        "unit": {
+          "type": "string"
+        },
+        "tone": {
+          "description": "색 톤",
+          "$ref": "#/$defs/Tone"
+        }
+      },
+      "required": [
+        "type",
+        "value"
+      ],
+      "additionalProperties": false
+    },
+    "RatingBlock": {
+      "description": "별점(value/max)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "rating"
+        },
+        "value": {
+          "type": "number",
+          "minimum": 0
+        },
+        "max": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "label": {
+          "type": "string"
+        },
+        "symbol": {
+          "type": "string",
+          "enum": [
+            "star",
+            "dot"
+          ]
+        }
+      },
+      "required": [
+        "type",
+        "value"
+      ],
+      "additionalProperties": false
+    },
+    "CalloutBlock": {
+      "description": "톤 강조 상자(정보·경고·위험) — 제목 + 본문",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "callout"
+        },
+        "text": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string"
+        },
+        "tone": {
+          "description": "색 톤",
+          "$ref": "#/$defs/Tone"
+        },
+        "icon": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "text"
+      ],
+      "additionalProperties": false
+    },
+    "EntityRefBlock": {
+      "description": "엔티티(송장·리드·저장소…) 칩, url 이면 링크",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "entityRef"
+        },
+        "label": {
+          "type": "string"
+        },
+        "entity": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        },
+        "tone": {
+          "description": "색 톤",
+          "$ref": "#/$defs/Tone"
+        }
+      },
+      "required": [
+        "type",
+        "label"
+      ],
+      "additionalProperties": false
+    },
+    "KanbanBlock": {
+      "description": "칸반 보드(표시 전용) — 컬럼별 카드",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "kanban"
+        },
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string"
+              },
+              "tone": {
+                "description": "색 톤",
+                "$ref": "#/$defs/Tone"
+              },
+              "cards": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string"
+                    },
+                    "title": {
+                      "type": "string"
+                    },
+                    "tone": {
+                      "description": "색 톤",
+                      "$ref": "#/$defs/Tone"
+                    },
+                    "meta": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "badge": {
+                      "type": "object",
+                      "properties": {
+                        "label": {
+                          "type": "string"
+                        },
+                        "tone": {
+                          "description": "색 톤",
+                          "$ref": "#/$defs/Tone"
+                        }
+                      },
+                      "required": [
+                        "label"
+                      ],
+                      "additionalProperties": false
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "title"
+                  ],
+                  "additionalProperties": false
+                }
+              }
+            },
+            "required": [
+              "id",
+              "title",
+              "cards"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        },
+        "caption": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "columns"
+      ],
+      "additionalProperties": false
+    },
+    "CountdownBlock": {
+      "description": "마감까지 남은 시간(라이브, target 은 ISO 8601)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "countdown"
+        },
+        "target": {
+          "description": "ISO 8601 시각",
+          "type": "string",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string"
+        },
+        "tone": {
+          "description": "색 톤",
+          "$ref": "#/$defs/Tone"
+        },
+        "expiredText": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "target"
+      ],
+      "additionalProperties": false
+    },
+    "ActivityBlock": {
+      "description": "처리 이력(누가·무엇을·언제, 최신순)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "activity"
+        },
+        "label": {
+          "type": "string"
+        },
+        "maxVisible": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "who": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "$ref": "#/$defs/Ref"
+                  }
+                ]
+              },
+              "what": {
+                "description": "무엇을 했나(인라인 마크다운)",
+                "type": "string"
+              },
+              "at": {
+                "description": "ISO 8601 시각",
+                "type": "string",
+                "minLength": 1
+              },
+              "tone": {
+                "description": "색 톤",
+                "$ref": "#/$defs/Tone"
+              },
+              "to": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "$ref": "#/$defs/Ref"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "who",
+              "what",
+              "at"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "type",
+        "items"
+      ],
+      "additionalProperties": false
+    },
+    "CodeBlock": {
+      "description": "코드·JSON(읽기 전용)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "code"
+        },
+        "code": {
+          "type": "string"
+        },
+        "language": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "code"
+      ],
+      "additionalProperties": false
+    },
+    "DiffBlock": {
+      "description": "unified diff 색칠 표시",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "diff"
+        },
+        "filename": {
+          "type": "string"
+        },
+        "patch": {
+          "type": "string"
+        },
+        "additions": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "deletions": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "required": [
+        "type",
+        "patch"
+      ],
+      "additionalProperties": false
+    },
+    "FileBlock": {
+      "description": "첨부 파일 타일(이름·크기·다운로드)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "file"
+        },
+        "name": {
+          "description": "폼 값의 키 — 카드 안에서 고유",
+          "type": "string"
+        },
+        "size": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "mime": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        },
+        "mxc": {
+          "type": "string"
+        },
+        "caption": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "name"
+      ],
+      "additionalProperties": false
+    },
+    "CollapsibleBlock": {
+      "description": "접기/펼치기 — 펼치면 중첩 blocks",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "collapsible"
+        },
+        "title": {
+          "type": "string"
+        },
+        "open": {
+          "type": "boolean"
+        },
+        "tone": {
+          "description": "색 톤",
+          "$ref": "#/$defs/Tone"
+        },
+        "legacy_for": {
+          "type": "string",
+          "enum": [
+            "activity"
+          ]
+        },
+        "summary": {
+          "description": "접힌 채로 보이는 한 줄",
+          "type": "string"
+        },
+        "blocks": {
+          "description": "펼치면 보이는 중첩 블록",
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Block"
+          }
+        }
+      },
+      "required": [
+        "type",
+        "title",
+        "blocks"
+      ],
+      "additionalProperties": false
+    },
+    "WidgetBlock": {
+      "description": "샌드박스 iframe(허용 출처만) — 블록으로 안 될 때의 최후 수단",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "widget"
+        },
+        "url": {
+          "description": "허용 출처 https URL(클라가 검증)",
+          "type": "string"
+        },
+        "name": {
+          "description": "폼 값의 키 — 카드 안에서 고유",
+          "type": "string"
+        },
+        "widget_id": {
+          "type": "string"
+        },
+        "capabilities": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "height": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "width": {
+          "type": "string",
+          "enum": [
+            "column",
+            "wide",
+            "full"
+          ]
+        }
+      },
+      "required": [
+        "type",
+        "url"
+      ],
+      "additionalProperties": false
+    },
+    "InputBlock": {
+      "description": "입력칸(text·textarea·number·date·datetime·time·url·email·file), name 으로 값 수집",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "input"
+        },
+        "name": {
+          "description": "폼 값의 키 — 카드 안에서 고유",
+          "type": "string",
+          "minLength": 1
+        },
+        "input": {
+          "type": "string",
+          "enum": [
+            "text",
+            "textarea",
+            "number",
+            "date",
+            "datetime",
+            "time",
+            "url",
+            "email",
+            "file"
+          ]
+        },
+        "label": {
+          "type": "string"
+        },
+        "placeholder": {
+          "type": "string"
+        },
+        "required": {
+          "description": "비우면 제출이 잠긴다(서버도 재검증)",
+          "type": "boolean"
+        },
+        "value": {
+          "type": "string"
+        },
+        "accept": {
+          "type": "string"
+        },
+        "multiple": {
+          "type": "boolean"
+        },
+        "min": {
+          "description": "하한 — 날짜·시각은 그 형식, number 는 숫자 문자열, \"today\" 허용",
+          "type": "string"
+        },
+        "max": {
+          "description": "상한 — input.min 과 같은 형식",
+          "type": "string"
+        },
+        "minLength": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "maxLength": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "pattern": {
+          "description": "JS 정규식 소스(구분자·플래그 없이)",
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "name"
+      ],
+      "additionalProperties": false
+    },
+    "ToggleBlock": {
+      "description": "on/off 스위치(불리언)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "toggle"
+        },
+        "name": {
+          "description": "폼 값의 키 — 카드 안에서 고유",
+          "type": "string",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string"
+        },
+        "checked": {
+          "type": "boolean"
+        },
+        "onText": {
+          "type": "string"
+        },
+        "offText": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "name",
+        "label"
+      ],
+      "additionalProperties": false
+    },
+    "SliderBlock": {
+      "description": "정수 범위 슬라이더",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "slider"
+        },
+        "name": {
+          "description": "폼 값의 키 — 카드 안에서 고유",
+          "type": "string",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string"
+        },
+        "min": {
+          "type": "integer"
+        },
+        "max": {
+          "type": "integer"
+        },
+        "step": {
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "value": {
+          "description": "정수",
+          "type": "integer"
+        },
+        "unit": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "name"
+      ],
+      "additionalProperties": false
+    },
+    "RadioBlock": {
+      "description": "펼쳐진 단일 선택",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "radio"
+        },
+        "name": {
+          "description": "폼 값의 키 — 카드 안에서 고유",
+          "type": "string",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string"
+        },
+        "options": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              },
+              "hint": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "value",
+              "label"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "value": {
+          "type": "string"
+        },
+        "style": {
+          "type": "string",
+          "enum": [
+            "cards",
+            "segmented"
+          ]
+        },
+        "required": {
+          "description": "비우면 제출이 잠긴다(서버도 재검증)",
+          "type": "boolean"
+        },
+        "error": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "name",
+        "options"
+      ],
+      "additionalProperties": false
+    },
+    "SelectBlock": {
+      "description": "선택(단일·multi), 후보가 많으면 검색 목록",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "select"
+        },
+        "name": {
+          "description": "폼 값의 키 — 카드 안에서 고유",
+          "type": "string",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string"
+        },
+        "placeholder": {
+          "type": "string"
+        },
+        "options": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "value": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              },
+              "hint": {
+                "type": "string"
+              },
+              "ref": {
+                "$ref": "#/$defs/Ref"
+              }
+            },
+            "required": [
+              "value",
+              "label"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "value": {
+          "type": "string"
+        },
+        "multi": {
+          "description": "true 면 여러 개 선택",
+          "type": "boolean"
+        },
+        "source": {
+          "$ref": "#/$defs/SelectSource"
+        },
+        "style": {
+          "type": "string",
+          "enum": [
+            "list",
+            "segmented",
+            "dropdown",
+            "chips"
+          ]
+        },
+        "searchable": {
+          "type": "boolean"
+        },
+        "required": {
+          "description": "비우면 제출이 잠긴다(서버도 재검증)",
+          "type": "boolean"
+        },
+        "min": {
+          "description": "multi 전용 — 고른 개수 하한",
+          "type": "integer",
+          "minimum": 0
+        },
+        "max": {
+          "description": "multi 전용 — 고른 개수 상한",
+          "type": "integer",
+          "exclusiveMinimum": 0
+        },
+        "error": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "name",
+        "options"
+      ],
+      "additionalProperties": false
+    },
+    "SelectSource": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "room"
+            },
+            "exclude_self": {
+              "type": "boolean"
+            },
+            "exclude": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "include_bots": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "kind"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": {
+              "type": "string",
+              "const": "query"
+            },
+            "action_id": {
+              "description": "누르면 이 값으로 봇에 회신된다 — 봇이 처리하는 id 만",
+              "type": "string",
+              "minLength": 1
+            },
+            "min_chars": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "debounce_ms": {
+              "type": "integer",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "kind",
+            "action_id"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "CheckboxBlock": {
+      "description": "체크박스(불리언)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "checkbox"
+        },
+        "name": {
+          "description": "폼 값의 키 — 카드 안에서 고유",
+          "type": "string",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string"
+        },
+        "checked": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "type",
+        "name",
+        "label"
+      ],
+      "additionalProperties": false
+    },
+    "LocationBlock": {
+      "description": "사용자가 주는 현재 위치(버튼 → 권한창)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "location"
+        },
+        "name": {
+          "description": "폼 값의 키 — 카드 안에서 고유",
+          "type": "string",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string"
+        },
+        "purpose": {
+          "type": "string"
+        },
+        "required": {
+          "description": "비우면 제출이 잠긴다(서버도 재검증)",
+          "type": "boolean"
+        },
+        "precise": {
+          "type": "boolean"
+        },
+        "buttonText": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type",
+        "name"
+      ],
+      "additionalProperties": false
+    },
+    "ButtonBlock": {
+      "description": "버튼 하나 — 누르면 action_id 로 봇에 회신(보통 actions 안에 둔다)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "button"
+        },
+        "action_id": {
+          "description": "누르면 이 값으로 봇에 회신된다 — 봇이 처리하는 id 만",
+          "type": "string",
+          "minLength": 1
+        },
+        "text": {
+          "type": "string"
+        },
+        "style": {
+          "description": "primary 는 주 동작 하나에만, danger 는 파괴적 동작",
+          "$ref": "#/$defs/ButtonStyle"
+        },
+        "value": {
+          "description": "버튼 고유 페이로드 — 폼 값과 함께 회신",
+          "type": "string"
+        },
+        "confirm": {
+          "description": "누르기 전 확인 창",
+          "$ref": "#/$defs/Confirm"
+        },
+        "disabled": {
+          "type": "boolean"
+        },
+        "hidden_for": {
+          "description": "이 MXID 들에게 감춤(UX 일 뿐 권한 아님)",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "visible_for": {
+          "description": "이 MXID 들에게만 보임(UX 일 뿐 권한 아님)",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "disabled_reason": {
+          "type": "string"
+        },
+        "priority": {
+          "type": "string",
+          "enum": [
+            "primary",
+            "secondary"
+          ]
+        }
+      },
+      "required": [
+        "type",
+        "action_id",
+        "text"
+      ],
+      "additionalProperties": false
+    },
+    "ButtonStyle": {
+      "type": "string",
+      "enum": [
+        "default",
+        "primary",
+        "danger"
+      ]
+    },
+    "Confirm": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string"
+        },
+        "text": {
+          "type": "string"
+        },
+        "ok": {
+          "type": "string"
+        },
+        "cancel": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "title",
+        "text"
+      ],
+      "additionalProperties": false
+    },
+    "LinkButtonBlock": {
+      "description": "https 로 이동만 하는 버튼(회신 없음)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "linkButton"
+        },
+        "text": {
+          "type": "string"
+        },
+        "url": {
+          "description": "이동할 https URL — 봇 회신 없음",
+          "type": "string"
+        },
+        "style": {
+          "$ref": "#/$defs/ButtonStyle"
+        },
+        "external": {
+          "type": "boolean"
+        },
+        "priority": {
+          "type": "string",
+          "enum": [
+            "primary",
+            "secondary"
+          ]
+        }
+      },
+      "required": [
+        "type",
+        "text",
+        "url"
+      ],
+      "additionalProperties": false
+    },
+    "ActionsBlock": {
+      "description": "버튼 한 줄(button·linkButton·overflow) — 입력값과 함께 제출",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "actions"
+        },
+        "elements": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ActionElement"
+          }
+        }
+      },
+      "required": [
+        "type",
+        "elements"
+      ],
+      "additionalProperties": false
+    },
+    "ActionElement": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/ButtonBlock"
+        },
+        {
+          "$ref": "#/$defs/LinkButtonBlock"
+        },
+        {
+          "$ref": "#/$defs/OverflowBlock"
+        }
+      ]
+    },
+    "OverflowBlock": {
+      "description": "⋯ 메뉴(부차 액션 묶음)",
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "const": "overflow"
+        },
+        "label": {
+          "type": "string"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "action_id": {
+                "description": "누르면 이 값으로 봇에 회신된다 — 봇이 처리하는 id 만",
+                "type": "string",
+                "minLength": 1
+              },
+              "text": {
+                "type": "string"
+              },
+              "value": {
+                "type": "string"
+              },
+              "tone": {
+                "description": "색 톤",
+                "$ref": "#/$defs/Tone"
+              },
+              "confirm": {
+                "description": "누르기 전 확인 창",
+                "$ref": "#/$defs/Confirm"
+              },
+              "disabled": {
+                "type": "boolean"
+              },
+              "visible_for": {
+                "description": "이 MXID 들에게만 보임(UX 일 뿐 권한 아님)",
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "hidden_for": {
+                "description": "이 MXID 들에게 감춤(UX 일 뿐 권한 아님)",
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "disabled_reason": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "action_id",
+              "text"
+            ],
+            "additionalProperties": false
+          },
+          "minItems": 1
+        }
+      },
+      "required": [
+        "type",
+        "items"
+      ],
+      "additionalProperties": false
+    }
+  }
+}