WebSocket subscriptions

ws://your-host/v1/memory/ws

ws://your-host/v1/memory/ws?token=mns_live_xxx

interface WsSubscription {
  subscribe: {
    channel:
      | "facts.*"             // all fact events
      | "facts.created"       // new facts only
      | "tasks.*"             // task state changes
      | "events.*"            // new events
      | "session.{id}"        // session updates
      | "agent.{id}.recall"   // what an agent is recalling
      | "health"              // health metric updates
      | "federation.sync";    // cross-instance syncs
 
    filter?: {
      entityId?:   string;
      agentId?:    string;
      memoryType?: string;
    };
  };
}

interface WsEvent {
  channel: string;
  type:
    | "fact.created" | "fact.updated" | "fact.archived"
    | "task.created" | "task.transitioned" | "task.completed"
    | "event.recorded" | "recall.hit" | "session.collapsed"
    | "health.alert" | "federation.conflict";
  payload:   unknown;
  timestamp: string;
  traceId:   string;
}