Set format: int64 on Metrics memory/disk fields to prevent overflow

Author: beran-t

openapi-public.yml

@@ -2212,21 +2212,27 @@ components:
         mem_total:
           type: integer
           description: Total virtual memory in bytes
+          format: int64
         mem_used:
           type: integer
           description: Used virtual memory in bytes
+          format: int64
         disk_used:
           type: integer
           description: Used disk space in bytes
+          format: int64
         disk_total:
           type: integer
           description: Total disk space in bytes
+          format: int64
         mem_used_mib:
           type: integer
           description: Used virtual memory in MiB
+          format: int64
         mem_total_mib:
           type: integer
           description: Total virtual memory in MiB
+          format: int64
     connect-protocol-version:
       type: number
       title: Connect-Protocol-Version

scripts/generate_openapi_reference.py

@@ -649,7 +649,7 @@ def fix_spec_issues(spec: dict[str, Any]) -> None:
         log_level["description"] = "Severity level for log entries (e.g. info, warn, error)"
         fixes.append("LogLevel: removed enum constraint, fixed description")
 
-    # 4. Metrics schema missing mem_used_mib and mem_total_mib
+    # 4. Metrics schema: add missing fields and set format: int64 on byte/MiB fields
     metrics = schemas.get("Metrics")
     if metrics and "properties" in metrics:
         props = metrics["properties"]
@@ -665,6 +665,13 @@ def fix_spec_issues(spec: dict[str, Any]) -> None:
                 "description": "Total virtual memory in MiB",
             }
             fixes.append("Metrics: added 'mem_total_mib'")
+        # Byte and MiB values can exceed int32 — set format: int64
+        int64_fields = ("mem_total", "mem_used", "disk_used", "disk_total",
+                        "mem_used_mib", "mem_total_mib")
+        for field in int64_fields:
+            if field in props and props[field].get("format") != "int64":
+                props[field]["format"] = "int64"
+        fixes.append("Metrics: set format int64 on memory/disk fields")
 
     # 5. Streaming RPC endpoints: wrong content-type and missing headers
     #    Server requires application/connect+json with envelope framing,