From 420c0c30e4f38c6cee25615ad4b5055574344486 Mon Sep 17 00:00:00 2001
From: Thomas Camlong <thomas@ajnart.fr>
Date: Tue, 16 Jun 2026 15:13:35 +0200
Subject: [PATCH] fix(beszel): MCP description accuracy and type strictness

- Add .default("1h") to timePeriod so MCP clients can omit it
- Include "1m" in the description's valid timePeriod values
- Clarify that getSystemStats uses only the first integrationId
- Use MantineSize type instead of plain string for itemRadius
---
 packages/api/src/router/widgets/beszel.ts             | 4 ++--
 packages/widgets/src/beszel-system-grid/component.tsx | 3 ++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/packages/api/src/router/widgets/beszel.ts b/packages/api/src/router/widgets/beszel.ts
index a20182240..da00ea4f5 100644
--- a/packages/api/src/router/widgets/beszel.ts
+++ b/packages/api/src/router/widgets/beszel.ts
@@ -147,14 +147,14 @@ export const beszelRouter = createTRPCRouter({
       mcp: {
         enabled: true,
         description:
-          "Get historical Beszel system metrics (CPU, memory, disk, network, temperature) and optional Docker container stats. REQUIRED: integrationIds (array of Beszel integration IDs from integration_all), systemId (from beszel_getSystems). OPTIONAL: timePeriod (1h/12h/24h/1w/30d, default 1h), includeDocker (default true)",
+          "Get historical Beszel system metrics (CPU, memory, disk, network, temperature) and optional Docker container stats. REQUIRED: integrationIds (pass the single integrationId from the beszel_getSystems entry containing the target system — only the first ID is used), systemId (from beszel_getSystems). OPTIONAL: timePeriod (1m/1h/12h/24h/1w/30d, default 1h), includeDocker (default true)",
       },
     })
     .concat(createManyIntegrationMiddleware("query", "beszel", "mock"))
     .input(
       z.object({
         systemId: z.string(),
-        timePeriod: z.enum(["1m", "1h", "12h", "24h", "1w", "30d"]),
+        timePeriod: z.enum(["1m", "1h", "12h", "24h", "1w", "30d"]).default("1h"),
         includeDocker: z.boolean().default(true),
       }),
     )
diff --git a/packages/widgets/src/beszel-system-grid/component.tsx b/packages/widgets/src/beszel-system-grid/component.tsx
index ab265e6ad..cd902963c 100644
--- a/packages/widgets/src/beszel-system-grid/component.tsx
+++ b/packages/widgets/src/beszel-system-grid/component.tsx
@@ -1,5 +1,6 @@
 "use client";
 
+import type { MantineSize } from "@mantine/core";
 import { Badge, Box, Card, Group, Progress, Text, Stack, useComputedColorScheme } from "@mantine/core";
 import {
   Activity,
@@ -153,7 +154,7 @@ interface SystemCardProps {
   size: SizeConfig;
   maxMetrics: number;
   backgroundColor: string;
-  itemRadius: string;
+  itemRadius: MantineSize;
 }
 
 const metricRenderers = [