From a0d54b426d7b7304b0725ce2c49893cfe77531e9 Mon Sep 17 00:00:00 2001
From: ReaperOfVeriod <reaperofveriod@gmail.com>
Date: Sun, 25 Oct 2026 05:11:46 +0100
Subject: [PATCH] add bot secrets contract

---
 contracts/v1/bot-secrets-response.json | 19 +++++++++++++++++++
 fixtures/v1/bot-secrets.response.json  | 10 ++++++++++
 2 files changed, 29 insertions(+)
 create mode 100644 contracts/v1/bot-secrets-response.json
 create mode 100644 fixtures/v1/bot-secrets.response.json

diff --git a/contracts/v1/bot-secrets-response.json b/contracts/v1/bot-secrets-response.json
new file mode 100644
index 0000000..646bba7
--- /dev/null
+++ b/contracts/v1/bot-secrets-response.json
@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://trixie.reaperofveriod.nl/contracts/v1/bot-secrets-response.json",
+  "title": "Trixie bot secret metadata",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["id", "name", "description", "used_by", "created_at", "updated_at"],
+    "properties": {
+      "id": { "type": "string", "format": "uuid" },
+      "name": { "type": "string", "pattern": "^[A-Za-z0-9_]+$" },
+      "description": { "type": "string" },
+      "used_by": { "type": "array", "items": { "type": "string" } },
+      "created_at": { "type": "string", "format": "date-time" },
+      "updated_at": { "type": "string", "format": "date-time" }
+    }
+  }
+}
diff --git a/fixtures/v1/bot-secrets.response.json b/fixtures/v1/bot-secrets.response.json
new file mode 100644
index 0000000..2ec2c85
--- /dev/null
+++ b/fixtures/v1/bot-secrets.response.json
@@ -0,0 +1,10 @@
+[
+  {
+    "id": "00000000-0000-4000-8000-000000000002",
+    "name": "API_Key",
+    "description": "External API key",
+    "used_by": [],
+    "created_at": "2026-01-01T00:00:00Z",
+    "updated_at": "2026-01-01T00:00:00Z"
+  }
+]