From 963813607b1fb3042fa48e603d810bb39904bf48 Mon Sep 17 00:00:00 2001
From: Apple <apple@MacBook-Pro.local>
Date: Wed, 18 Feb 2026 05:58:54 -0800
Subject: [PATCH] Docs sync: align OPENAPI contracts with NODE1 runtime

---
 docs/OPENAPI_CONTRACTS.md | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/docs/OPENAPI_CONTRACTS.md b/docs/OPENAPI_CONTRACTS.md
index 4d8f84e8..edd36544 100644
--- a/docs/OPENAPI_CONTRACTS.md
+++ b/docs/OPENAPI_CONTRACTS.md
@@ -20,17 +20,17 @@ Gateway (BFF)  ──────►  Router  ──────►  Memory API
 Request:
 ```json
 {
-  "messages": [
-    {"role": "user", "content": "..."}
-  ],
+  "prompt": "...",
+  "model": "optional-model-override",
   "system_prompt": "optional override",
   "temperature": 0.3,
-  "max_tokens": 4000,
-  "tools": ["web_search", "memory_search"],
+  "max_tokens": 700,
+  "images": ["data:image/png;base64,<...>"],
   "metadata": {
     "user_id": "tg:123456",
     "chat_id": "-5289219705",
-    "trace_id": "uuid"
+    "trace_id": "uuid",
+    "agent_id": "helion"
   }
 }
 ```
@@ -38,13 +38,14 @@ Request:
 Response:
 ```json
 {
-  "agent_id": "helion",
-  "content": "...",
+  "response": "...",
   "model": "deepseek-chat",
   "backend": "deepseek-cloud",
   "tokens_used": 1234,
-  "tools_called": ["memory_search"],
-  "trace_id": "uuid"
+  "image_base64": null,
+  "file_base64": null,
+  "file_name": null,
+  "file_mime": null
 }
 ```