feat(discovery): identify servers across addresses for TV handoff

contracts/api/v2/fixtures/get_system_info_ok.json

@@ -1,9 +1,10 @@
 {
   "server_version": "unavailable",
   "api_major": 2,
-  "contract_digest": "7866f390a42da02fa2ce39ffbd26d421c0778f32fc816935c9cf35f614d91598",
+  "contract_digest": "24920c001e4ac4d8bfc20b983b166a27790c14ce329b7e029123a897c8312933",
   "links": {
     "openapi": "/api/v2/openapi.json",
-    "capabilities": "/api/v2/capabilities"
+    "capabilities": "/api/v2/capabilities",
+    "identity": "/api/v2/system/identity"
   }
 }

contracts/api/v2/fixtures/index.json

@@ -11433,6 +11433,44 @@
       "schema": "#/components/schemas/CatalogFacetMatches",
       "body_file": "search_catalog_facet_ok.json"
     },
+    {
+      "name": "server_connections_ok",
+      "operation_id": "getServerConnections",
+      "scenario": "A signed-in client reads the addresses the deployment offers: the public URL, a connected provider with its overlay origin, and an installed provider whose plugin is not running.",
+      "request": {
+        "method": "GET",
+        "path": "/api/v2/system/connections",
+        "headers": {
+          "Authorization": "Bearer tok-member"
+        }
+      },
+      "expected_status": 200,
+      "response_headers": {
+        "Cache-Control": "private, no-cache",
+        "Content-Type": "application/json",
+        "ETag": "\"251d40c6578ba4f568f974b66faed17c5fd6ea82251fdc08ebc30e12c2be477f\""
+      },
+      "response_media_type": "application/json",
+      "schema": "#/components/schemas/ServerConnectionsDocument",
+      "body_file": "server_connections_ok.json"
+    },
+    {
+      "name": "server_identity_ok",
+      "operation_id": "getServerIdentity",
+      "scenario": "Discovery before login: the deployment's stable server identity, the same at every address.",
+      "request": {
+        "method": "GET",
+        "path": "/api/v2/system/identity"
+      },
+      "expected_status": 200,
+      "response_headers": {
+        "Cache-Control": "no-cache",
+        "Content-Type": "application/json"
+      },
+      "response_media_type": "application/json",
+      "schema": "#/components/schemas/ServerIdentity",
+      "body_file": "server_identity_ok.json"
+    },
     {
       "name": "set_file_markers_ok",
       "operation_id": "setFileMarkers",

contracts/api/v2/fixtures/server_connections_ok.json

@@ -0,0 +1,28 @@
+{
+  "revision": "82278f19ff5dc619091bee7b0efe5f375a0b25ec07002a424a5d15efbdc66900",
+  "state": "available",
+  "allowed": true,
+  "server_id": "3f2a9d5e-6b1c-4c7e-9a0d-2f4b8c1e7a35",
+  "current": {
+    "kind": "default"
+  },
+  "endpoints": [
+    {
+      "kind": "public",
+      "url": "https://silo.example.test"
+    },
+    {
+      "kind": "provider",
+      "provider": "down",
+      "display_name": "Down Overlay",
+      "state": "unavailable"
+    },
+    {
+      "kind": "provider",
+      "url": "https://silo.overlay.example.test",
+      "provider": "stub",
+      "display_name": "Stub Overlay",
+      "state": "connected"
+    }
+  ]
+}

contracts/api/v2/fixtures/server_identity_ok.json

@@ -0,0 +1,3 @@
+{
+  "server_id": "3f2a9d5e-6b1c-4c7e-9a0d-2f4b8c1e7a35"
+}