feat: ship agent-first mission control v0.2.57

backend/Models/DomainEvents.cs

@@ -0,0 +1,38 @@
+using System.Text.Json;
+
+namespace Nexus.Api.Models;
+
+/// <summary>
+/// Transport-safe reference to a Nexus or OpenClaw-owned entity. Routing stays
+/// a frontend concern, so this contract deliberately contains no URL.
+/// </summary>
+public sealed record EntityRefDto(
+    string Type,
+    string Id,
+    string? Label = null);
+
+public sealed record OperationResultDto(
+    string OperationId,
+    string Status,
+    int Revision,
+    EntityRefDto? PrimaryRef,
+    IReadOnlyList<EntityRefDto> AffectedRefs,
+    string? TraceId);
+
+/// <summary>
+/// Content-minimized event sent to authenticated Mission Control clients.
+/// Payloads may carry state and correlation metadata, but never prompts,
+/// credentials, markdown content, tool arguments, or entity names.
+/// </summary>
+public sealed record DomainEventDto(
+    long Sequence,
+    string EventType,
+    EntityRefDto Entity,
+    int EntityRevision,
+    DateTimeOffset OccurredAt,
+    JsonElement Payload);
+
+public static class DomainEventTypes
+{
+    public const string ResyncRequired = "resync_required";
+}