From ec357d7c4f5762f28dada25fca148d5672fed581 Mon Sep 17 00:00:00 2001
From: krut_ni <nils.kruthoff@dlr.de>
Date: Tue, 10 Mar 2026 11:55:19 +0100
Subject: [PATCH] improved doc for switch

---
 .../Plugins/assistants/README.md              | 40 ++++++++++++++++++-
 1 file changed, 39 insertions(+), 1 deletion(-)

diff --git a/app/MindWork AI Studio/Plugins/assistants/README.md b/app/MindWork AI Studio/Plugins/assistants/README.md
index 2c10cd2a..2e92a50c 100644
--- a/app/MindWork AI Studio/Plugins/assistants/README.md	
+++ b/app/MindWork AI Studio/Plugins/assistants/README.md	
@@ -11,7 +11,7 @@ Supported types (matching the Blazor UI components):
 
 - `TEXT_AREA`: user input field based on `MudTextField`; requires `Name`, `Label`, and may include `HelperText`, `HelperTextOnFocus`, `Adornment`, `AdornmentIcon`, `AdornmentText`, `AdornmentColor`, `Counter`, `MaxLength`, `IsImmediate`, `UserPrompt`, `PrefillText`, `IsSingleLine`, `ReadOnly`, `Class`, `Style`.
 - `DROPDOWN`: selects between variants; `Props` must include `Name`, `Label`, `Default`, `Items`, and optionally `ValueType` plus `UserPrompt`.
-- `SWITCH`: boolean option; requires `Name`, `Label`, `Value`, `LabelOn`, `LabelOff`, and may include `UserPrompt`.
+- `SWITCH`: boolean option; requires `Name`, `Label`, `Value`, and may include `Disabled`, `UserPrompt`, `LabelOn`, `LabelOff`, `LabelPlacement`, `Icon`, `IconColor`, `CheckedColor`, `UncheckedColor`.
 - `COLOR_PICKER`: color input based on `MudColorPicker`; requires `Name`, `Label`, and may include `Placeholder`, `ShowAlpha`, `ShowToolbar`, `ShowModeSwitch`, `PickerVariant`, `UserPrompt`, `Class`, `Style`.
 - `PROVIDER_SELECTION` / `PROFILE_SELECTION`: hooks into the shared provider/profile selectors.
 - `WEB_CONTENT_READER`: renders `ReadWebContent`; include `Name`, `UserPrompt`, `Preselect`, `PreselectContentCleanerAgent`.
@@ -157,6 +157,44 @@ Example:
 }
 ```
 
+### `SWITCH` reference
+- Use `Type = "SWITCH"` to render a boolean toggle.
+- Required props:
+  - `Name`: unique state key used in prompt assembly and `BuildPrompt(input.fields)`.
+  - `Label`: visible label for the switch field.
+  - `Value`: initial boolean state (`true` or `false`).
+- Optional props:
+  - `Disabled`: defaults to `false`; disables user interaction while still allowing the value to be included in prompt assembly.
+  - `UserPrompt`: prompt context text for this field.
+  - `LabelOn`: text shown when the switch value is `true`.
+  - `LabelOff`: text shown when the switch value is `false`.
+  - `LabelPlacement`: one of `Bottom`, `End`, `Left`, `Right`, `Start`, `Top`; omitted values follow the renderer default.
+  - `Icon`: MudBlazor icon identifier string displayed inside the switch thumb.
+  - `IconColor`: one of the MudBlazor `Color` enum names such as `Primary`, `Secondary`, `Warning`; omitted values default to `Inherit`.
+  - `CheckedColor`: color used when the switch state is `true`; omitted values default to `Inherit`.
+  - `UncheckedColor`: color used when the switch state is `false`; omitted values default to `Inherit`.
+
+Example:
+```lua
+{
+  ["Type"] = "SWITCH",
+  ["Props"] = {
+    ["Name"] = "IncludeSummary",
+    ["Label"] = "Include summary",
+    ["Value"] = true,
+    ["Disabled"] = false,
+    ["UserPrompt"] = "Decide whether the final answer should include a short summary.",
+    ["LabelOn"] = "Summary enabled",
+    ["LabelOff"] = "Summary disabled",
+    ["LabelPlacement"] = "End",
+    ["Icon"] = "Icons.Material.Filled.Summarize",
+    ["IconColor"] = "Primary",
+    ["CheckedColor"] = "Success",
+    ["UncheckedColor"] = "Default"
+  }
+}
+```
+
 ### `COLOR_PICKER` reference
 - Use `Type = "COLOR_PICKER"` to render a MudBlazor color picker.
 - Required props: