diff --git a/src/ZB.MOM.WW.ScadaBridge.Commons/Messages/Management/FlowDebugCommands.cs b/src/ZB.MOM.WW.ScadaBridge.Commons/Messages/Management/FlowDebugCommands.cs
index 7231b1e9..42e89448 100644
--- a/src/ZB.MOM.WW.ScadaBridge.Commons/Messages/Management/FlowDebugCommands.cs
+++ b/src/ZB.MOM.WW.ScadaBridge.Commons/Messages/Management/FlowDebugCommands.cs
@@ -24,6 +24,27 @@ public record FlowDebugRunMethodCommand(int ApiMethodId, JsonElement? Parameters
/// How long to wait for a spawned run before reporting NO_TRIGGER_WITHIN_WINDOW.
public record FlowDebugRunValueChangeCommand(int InstanceId, string AttributeName, string Value, int WaitSeconds = 45);
+///
+/// Flow Debugger Live run of a site script by name (design 2026-09-08). The runner resolves the
+/// script's effective definition from the flattened instance configuration and branches on its
+/// trigger kind: a ValueChange/Conditional script is fired by WRITING its monitored
+/// attribute () and polling for the spawned run, exactly like
+/// ; every other kind is invoked DIRECTLY through the
+/// traced routed-call path with . Deployer role; refuses on a standby
+/// with STANDBY_NODE.
+///
+/// The instance the script belongs to.
+/// Canonical script name from the flattened configuration (case-insensitive).
+/// Call kinds: flat JSON object validated against the script's ParameterDefinitions; null = none.
+/// Write kinds: canonical string value to write to the trigger's attribute.
+/// Write kinds: how long to wait for a spawned run before NO_TRIGGER_WITHIN_WINDOW.
+public record FlowDebugRunScriptCommand(
+ int InstanceId,
+ string ScriptName,
+ JsonElement? Parameters,
+ string? Value,
+ int WaitSeconds = 45);
+
///
/// Flow Debugger Replay (design 2026-09-05 ยง7.1): returns the audit events of the execution
/// tree that belongs to, from the central store.