feat(inbound): routed Route.To().WaitForAttribute — contract + central path (spec §6)

src/ZB.MOM.WW.ScadaBridge.Commons/Messages/InboundApi/RouteToInstanceRequest.cs

@@ -83,3 +83,46 @@ public record RouteToSetAttributesResponse(
     bool Success,
     string? ErrorMessage,
     DateTimeOffset Timestamp);
+
+/// <summary>
+/// Request to block until a remote instance attribute reaches a target value
+/// (spec §6 — <c>Route.To("inst").WaitForAttribute(name, targetValue, timeout)</c>).
+/// Value-equality ONLY across the wire: <see cref="TargetValueEncoded"/> carries the
+/// canonical <c>AttributeValueCodec</c>-encoded target; there is no predicate and no
+/// quality flag in the comparison. The site evaluates equality and either matches or
+/// times out.
+/// </summary>
+/// <param name="ParentExecutionId">
+/// Audit Log #23 (ParentExecutionId): mirrors <see cref="RouteToCallRequest.ParentExecutionId"/>.
+/// For an inbound-API-routed wait this is the inbound request's per-request execution id;
+/// future site-side audit emission for routed waits can stamp it as <c>ParentExecutionId</c>
+/// so the inbound→site execution-tree link survives the wait path. Additive trailing
+/// member — null for the Central UI sandbox path or for callers built before the field existed.
+/// </param>
+public record RouteToWaitForAttributeRequest(
+    string CorrelationId,
+    string InstanceUniqueName,
+    string AttributeName,
+    string? TargetValueEncoded,
+    TimeSpan Timeout,
+    DateTimeOffset Timestamp,
+    Guid? ParentExecutionId = null);
+
+/// <summary>
+/// Response from a remote attribute wait. <see cref="Success"/>/<see cref="ErrorMessage"/>
+/// convey the routing-level outcome (e.g. instance-not-found); <see cref="Matched"/>,
+/// <see cref="TimedOut"/>, <see cref="Value"/>, and <see cref="Quality"/> convey the wait
+/// outcome itself. When <see cref="Success"/> is <c>true</c>, exactly one of
+/// <see cref="Matched"/>/<see cref="TimedOut"/> holds: <see cref="Matched"/> means the
+/// attribute reached the target value (with <see cref="Value"/>/<see cref="Quality"/>
+/// captured at the match), <see cref="TimedOut"/> means the deadline elapsed first.
+/// </summary>
+public record RouteToWaitForAttributeResponse(
+    string CorrelationId,
+    bool Matched,
+    object? Value,
+    string? Quality,
+    bool TimedOut,
+    bool Success,
+    string? ErrorMessage,
+    DateTimeOffset Timestamp);