@snokam/mcp-api 0.139.0 → 0.140.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "0.139.0",
+  "version": "0.140.0",
   "description": "MCP server exposing Snokam backend APIs as tools for Claude Code and other MCP clients",
   "type": "module",
   "bin": {

package/specs/production/chatgpt.json

@@ -712,6 +712,48 @@
         ]
       }
     },
+    "/v1.0/protected/realtime/usage-report": {
+      "post": {
+        "tags": [
+          "Realtime"
+        ],
+        "summary": "Report token usage for a realtime session",
+        "description": "Records cumulative token totals streamed to the client by the realtime API. Reports are validated against the session registry; unknown, expired or already-recorded reports are acknowledged without recording.",
+        "operationId": "ReportRealtimeUsage",
+        "requestBody": {
+          "description": "Cumulative session token totals",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/realtimeUsageReport"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of RealtimeUsageAck",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/realtimeUsageAck"
+                }
+              }
+            },
+            "x-ms-summary": "Report acknowledged"
+          }
+        },
+        "security": [
+          {
+            "Implicit": []
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/realtime/agents": {
       "get": {
         "tags": [
@@ -1580,6 +1622,10 @@
             "type": "string",
             "nullable": true
           },
+          "session_id": {
+            "type": "string",
+            "nullable": true
+          },
           "include": {
             "type": "object",
             "nullable": true
@@ -1629,6 +1675,39 @@
           }
         }
       },
+      "realtimeUsageAck": {
+        "type": "object",
+        "properties": {
+          "accepted": {
+            "type": "boolean",
+            "nullable": true
+          }
+        }
+      },
+      "realtimeUsageReport": {
+        "type": "object",
+        "properties": {
+          "session_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "input_tokens": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
+          "output_tokens": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
+          "cached_tokens": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          }
+        }
+      },
       "simpleResponseDto": {
         "type": "object",
         "properties": {

package/specs/test/chatgpt.json

@@ -712,6 +712,48 @@
         ]
       }
     },
+    "/v1.0/protected/realtime/usage-report": {
+      "post": {
+        "tags": [
+          "Realtime"
+        ],
+        "summary": "Report token usage for a realtime session",
+        "description": "Records cumulative token totals streamed to the client by the realtime API. Reports are validated against the session registry; unknown, expired or already-recorded reports are acknowledged without recording.",
+        "operationId": "ReportRealtimeUsage",
+        "requestBody": {
+          "description": "Cumulative session token totals",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/realtimeUsageReport"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Payload of RealtimeUsageAck",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/realtimeUsageAck"
+                }
+              }
+            },
+            "x-ms-summary": "Report acknowledged"
+          }
+        },
+        "security": [
+          {
+            "Implicit": []
+          },
+          {
+            "ApiKey": []
+          }
+        ]
+      }
+    },
     "/v1.0/realtime/agents": {
       "get": {
         "tags": [
@@ -1580,6 +1622,10 @@
             "type": "string",
             "nullable": true
           },
+          "session_id": {
+            "type": "string",
+            "nullable": true
+          },
           "include": {
             "type": "object",
             "nullable": true
@@ -1629,6 +1675,39 @@
           }
         }
       },
+      "realtimeUsageAck": {
+        "type": "object",
+        "properties": {
+          "accepted": {
+            "type": "boolean",
+            "nullable": true
+          }
+        }
+      },
+      "realtimeUsageReport": {
+        "type": "object",
+        "properties": {
+          "session_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "input_tokens": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
+          "output_tokens": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          },
+          "cached_tokens": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true
+          }
+        }
+      },
       "simpleResponseDto": {
         "type": "object",
         "properties": {