add bot command contract

2026-10-25 05:08:12 +01:00
parent 2856d04396
commit 5564a30bf9
2 changed files with 43 additions and 0 deletions
@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://trixie.reaperofveriod.nl/contracts/v1/bot-commands-response.json",
+  "title": "Trixie bot command list",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["id", "name", "description", "permission_level", "aliases", "tags", "cooldown_seconds", "cooldown_scope", "response_template", "error_template", "enabled", "failure_count", "disabled_reason"],
+    "properties": {
+      "id": { "type": "string", "format": "uuid" },
+      "name": { "type": "string", "pattern": "^[A-Za-z0-9_-]+$" },
+      "description": { "type": "string" },
+      "permission_level": { "enum": ["everyone", "subscriber", "moderator", "broadcaster"] },
+      "aliases": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+      "tags": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
+      "cooldown_seconds": { "type": "integer", "minimum": 0, "maximum": 86400 },
+      "cooldown_scope": { "enum": ["global", "user", "role"] },
+      "response_template": { "type": "string" },
+      "error_template": { "type": ["string", "null"] },
+      "enabled": { "type": "boolean" },
+      "failure_count": { "type": "integer", "minimum": 0 },
+      "disabled_reason": { "type": ["string", "null"] }
+    }
+  }
+}