@mentra/bluetooth-sdk 0.1.21-beta.5 → 3.1.0-dev.7

package/android/src/main/java/com/mentra/bluetoothsdk/sgcs/SGCManager.kt

@@ -56,6 +56,9 @@ abstract class SGCManager {
     abstract fun stopStream()
     abstract fun sendStreamKeepAlive(message: MutableMap<String, Any>)
     abstract fun startVideoRecording(requestId: String, save: Boolean, sound: Boolean)
+    open fun queryVideoRecordingStatus(requestId: String) {
+        Bridge.log("SGC: queryVideoRecordingStatus operation not supported")
+    }
 
     /**
      * Start video recording with optional per-recording resolution/fps. A width,
@@ -308,6 +311,11 @@ abstract class SGCManager {
         Bridge.log("SGC: sendSetSystemTime not supported on $type")
     }
 
+    /** Enable/disable Wi-Fi ADB on Mentra Live (no-op on other devices). */
+    open fun sendWifiAdbState(enabled: Boolean) {
+        Bridge.log("SGC: sendWifiAdbState not supported on $type")
+    }
+
     // User Context (for crash reporting)
     abstract fun sendUserEmailToGlasses(email: String)
 

package/android/src/main/java/com/mentra/bluetoothsdk/status/DeviceStatus.kt

@@ -43,6 +43,7 @@ internal data class GlassesStatus(
     val besFirmwareVersion: String,
     val mtkFirmwareVersion: String,
     val bluetoothMacAddress: String,
+    val wifiMacAddress: String,
     val leftMacAddress: String,
     val rightMacAddress: String,
     val macAddress: String,
@@ -50,6 +51,7 @@ internal data class GlassesStatus(
     val systemTimeMs: Long?,
     val otaVersionUrl: String,
     val appVersion: String,
+    val hotspotOtaVersion: Int,
     val bluetoothName: String,
     val serialNumber: String,
     val style: String,
@@ -85,12 +87,14 @@ internal data class GlassesStatus(
             "besFirmwareVersion" to besFirmwareVersion,
             "mtkFirmwareVersion" to mtkFirmwareVersion,
             "bluetoothMacAddress" to bluetoothMacAddress,
+            "wifiMacAddress" to wifiMacAddress,
             "leftMacAddress" to leftMacAddress,
             "rightMacAddress" to rightMacAddress,
             "macAddress" to macAddress,
             "buildNumber" to buildNumber,
             "otaVersionUrl" to otaVersionUrl,
             "appVersion" to appVersion,
+            "hotspotOtaVersion" to hotspotOtaVersion,
             "bluetoothName" to bluetoothName,
             "serialNumber" to serialNumber,
             "style" to style,
@@ -134,6 +138,7 @@ internal data class GlassesStatus(
                 besFirmwareVersion = stringValue(values, "besFirmwareVersion") ?: "",
                 mtkFirmwareVersion = stringValue(values, "mtkFirmwareVersion") ?: "",
                 bluetoothMacAddress = stringValue(values, "bluetoothMacAddress") ?: "",
+                wifiMacAddress = stringValue(values, "wifiMacAddress") ?: "",
                 leftMacAddress = stringValue(values, "leftMacAddress") ?: "",
                 rightMacAddress = stringValue(values, "rightMacAddress") ?: "",
                 macAddress = stringValue(values, "macAddress") ?: "",
@@ -141,6 +146,7 @@ internal data class GlassesStatus(
                 systemTimeMs = longValue(values, "systemTimeMs"),
                 otaVersionUrl = stringValue(values, "otaVersionUrl") ?: "",
                 appVersion = stringValue(values, "appVersion") ?: "",
+                hotspotOtaVersion = numberValue(values, "hotspotOtaVersion") ?: 0,
                 bluetoothName = stringValue(values, "bluetoothName") ?: "",
                 serialNumber = stringValue(values, "serialNumber") ?: "",
                 style = stringValue(values, "style") ?: "",
@@ -173,6 +179,7 @@ data class VersionInfoResult(
     val systemTimeMs: Long?,
     val otaVersionUrl: String,
     val appVersion: String,
+    val hotspotOtaVersion: Int,
 ) {
     internal fun toMap(): Map<String, Any> =
         buildMap {
@@ -184,6 +191,7 @@ data class VersionInfoResult(
             systemTimeMs?.let { put("systemTimeMs", it) }
             put("otaVersionUrl", otaVersionUrl)
             put("appVersion", appVersion)
+            put("hotspotOtaVersion", hotspotOtaVersion)
         }
 
     companion object {
@@ -197,6 +205,7 @@ data class VersionInfoResult(
                 systemTimeMs = status.systemTimeMs,
                 otaVersionUrl = status.otaVersionUrl,
                 appVersion = status.appVersion,
+                hotspotOtaVersion = status.hotspotOtaVersion,
             )
 
         internal fun fromMap(values: Map<String, Any>): VersionInfoResult =
@@ -209,6 +218,8 @@ data class VersionInfoResult(
                 systemTimeMs = longValue(values, "systemTimeMs", "system_time_ms"),
                 otaVersionUrl = stringValue(values, "otaVersionUrl", "ota_version_url") ?: "",
                 appVersion = stringValue(values, "appVersion", "app_version") ?: "",
+                hotspotOtaVersion =
+                    numberValue(values, "hotspotOtaVersion", "hotspot_ota_version") ?: 0,
             )
     }
 }
@@ -373,12 +384,14 @@ internal data class GlassesStatusUpdate(
     val besFirmwareVersion: String? = null,
     val mtkFirmwareVersion: String? = null,
     val bluetoothMacAddress: String? = null,
+    val wifiMacAddress: String? = null,
     val leftMacAddress: String? = null,
     val rightMacAddress: String? = null,
     val macAddress: String? = null,
     val buildNumber: String? = null,
     val otaVersionUrl: String? = null,
     val appVersion: String? = null,
+    val hotspotOtaVersion: Int? = null,
     val bluetoothName: String? = null,
     val serialNumber: String? = null,
     val style: String? = null,
@@ -422,12 +435,14 @@ internal data class GlassesStatusUpdate(
             putIfNotNull("besFirmwareVersion", besFirmwareVersion)
             putIfNotNull("mtkFirmwareVersion", mtkFirmwareVersion)
             putIfNotNull("bluetoothMacAddress", bluetoothMacAddress)
+            putIfNotNull("wifiMacAddress", wifiMacAddress)
             putIfNotNull("leftMacAddress", leftMacAddress)
             putIfNotNull("rightMacAddress", rightMacAddress)
             putIfNotNull("macAddress", macAddress)
             putIfNotNull("buildNumber", buildNumber)
             putIfNotNull("otaVersionUrl", otaVersionUrl)
             putIfNotNull("appVersion", appVersion)
+            putIfNotNull("hotspotOtaVersion", hotspotOtaVersion)
             putIfNotNull("bluetoothName", bluetoothName)
             putIfNotNull("serialNumber", serialNumber)
             putIfNotNull("style", style)
@@ -470,12 +485,14 @@ internal data class GlassesStatusUpdate(
                 besFirmwareVersion = optionalStringValue(values, "besFirmwareVersion"),
                 mtkFirmwareVersion = optionalStringValue(values, "mtkFirmwareVersion"),
                 bluetoothMacAddress = optionalStringValue(values, "bluetoothMacAddress"),
+                wifiMacAddress = optionalStringValue(values, "wifiMacAddress"),
                 leftMacAddress = optionalStringValue(values, "leftMacAddress"),
                 rightMacAddress = optionalStringValue(values, "rightMacAddress"),
                 macAddress = optionalStringValue(values, "macAddress"),
                 buildNumber = optionalStringValue(values, "buildNumber"),
                 otaVersionUrl = optionalStringValue(values, "otaVersionUrl"),
                 appVersion = optionalStringValue(values, "appVersion"),
+                hotspotOtaVersion = optionalNumberValue(values, "hotspotOtaVersion"),
                 bluetoothName = optionalStringValue(values, "bluetoothName"),
                 serialNumber = optionalStringValue(values, "serialNumber"),
                 style = optionalStringValue(values, "style"),

package/android/src/main/java/com/mentra/bluetoothsdk/types/DeviceModels.kt

@@ -43,6 +43,9 @@ data class Device(
     val rssi: Int? = null,
     /** Stable app-facing scan-result key. Do not parse; use typed fields instead. */
     val id: String = address?.takeIf { it.isNotBlank() } ?: "${model.deviceType}:$name",
+    val pairingMode: Boolean? = null,
+    val pairingCode: String? = null,
+    val securePairingCapable: Boolean? = null,
 ) {
     internal fun toMap(): Map<String, Any> =
         buildMap {
@@ -56,6 +59,9 @@ data class Device(
                 put("projectName", it)
             }
             rssi?.let { put("rssi", it) }
+            pairingMode?.let { put("pairingMode", it) }
+            pairingCode?.takeIf { it.isNotBlank() }?.let { put("pairingCode", it) }
+            securePairingCapable?.let { put("securePairingCapable", it) }
         }
 
     companion object {
@@ -66,6 +72,9 @@ data class Device(
             val projectName = stringValue(values, "projectName")?.takeIf { it.isNotBlank() }
             val rssi = numberValue(values, "rssi")
             val id = stringValue(values, "id")?.takeIf { it.isNotBlank() } ?: address ?: "${model}:$name"
+            val pairingMode = boolValue(values, "pairingMode")
+            val pairingCode = stringValue(values, "pairingCode")?.takeIf { it.isNotBlank() }
+            val securePairingCapable = boolValue(values, "securePairingCapable")
             return Device(
                 model = DeviceModel.fromDeviceType(model),
                 name = name,
@@ -73,6 +82,9 @@ data class Device(
                 projectName = projectName,
                 rssi = rssi,
                 id = id,
+                pairingMode = pairingMode,
+                pairingCode = pairingCode,
+                securePairingCapable = securePairingCapable,
             )
         }
     }

package/android/src/main/java/com/mentra/bluetoothsdk/utils/BleJsonCompact.java

@@ -14,7 +14,7 @@ import org.json.JSONArray;
 import org.json.JSONException;
 import org.json.JSONObject;
 
-/** BLE Wire Protocol v2 JSON compaction: short keys, enum ints, omitted defaults, config diff. */
+/** BLE Wire Protocol v2 JSON compaction with lossless fallback for ambiguous payloads. */
 public final class BleJsonCompact {
 
     private static final Map<String, String> LONG_TO_SHORT = new HashMap<>();
@@ -47,8 +47,6 @@ public final class BleJsonCompact {
             Collections.unmodifiableSet(new HashSet<>(Arrays.asList("ck", "chunked_msg")));
 
     private static long sessionConnectEpochMs;
-    private static boolean resolvedConfigSent;
-    private static String currentSessionResolvedConfigHash;
     private static final Map<String, JSONObject> resolvedConfigByHash = new HashMap<>();
 
     static {
@@ -102,8 +100,6 @@ public final class BleJsonCompact {
 
     public static void resetSession() {
         sessionConnectEpochMs = 0L;
-        resolvedConfigSent = false;
-        currentSessionResolvedConfigHash = null;
         resolvedConfigByHash.clear();
     }
 
@@ -160,7 +156,7 @@ public final class BleJsonCompact {
             return json;
         }
         String messageType = extractMessageType(json);
-        if (!shouldCompactOutbound(messageType)) {
+        if (!shouldCompactOutbound(messageType) || !canCompactLosslessly(json, true)) {
             return json;
         }
         return compactObject(json, true);
@@ -223,53 +219,85 @@ public final class BleJsonCompact {
         fromInt.put(code, value);
     }
 
-    private static JSONObject compactObject(JSONObject input, boolean topLevel) throws JSONException {
-        JSONObject output = new JSONObject();
+    /**
+     * Compact JSON has reserved short keys and enum integers. If an otherwise valid future payload
+     * already uses one of those wire representations, sending verbose JSON is the only way an older
+     * decoder can distinguish the original value.
+     */
+    private static boolean canCompactLosslessly(JSONObject input, boolean topLevel)
+            throws JSONException {
         String messageType = input.optString("type", input.optString("t", ""));
-        boolean skipResolvedConfig = false;
-
-        if (topLevel && shouldDiffResolvedConfig(messageType) && input.has("resolvedConfig")) {
-            JSONObject resolvedConfig = input.getJSONObject("resolvedConfig");
-            String hash = hashConfig(resolvedConfig);
-            resolvedConfigByHash.put(hash, cloneObject(resolvedConfig));
-            if (resolvedConfigSent && hash.equals(currentSessionResolvedConfigHash)) {
-                output.put(KEY_RESOLVED_CONFIG_HASH, hash);
-                skipResolvedConfig = true;
-            } else {
-                currentSessionResolvedConfigHash = hash;
-                resolvedConfigSent = true;
+        Iterator<String> keys = input.keys();
+        while (keys.hasNext()) {
+            String key = keys.next();
+            Object value = input.get(key);
+            if (SHORT_TO_LONG.containsKey(key)
+                    || (topLevel && KEY_RESOLVED_CONFIG_HASH.equals(key))
+                    || isAmbiguousEnumValue(key, value, messageType)) {
+                return false;
+            }
+            if (value instanceof JSONObject
+                    && !canCompactLosslessly((JSONObject) value, false)) {
+                return false;
+            }
+            if (value instanceof JSONArray
+                    && !canCompactArrayLosslessly((JSONArray) value)) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    private static boolean canCompactArrayLosslessly(JSONArray array) throws JSONException {
+        for (int i = 0; i < array.length(); i++) {
+            Object value = array.get(i);
+            if (value instanceof JSONObject
+                    && !canCompactLosslessly((JSONObject) value, false)) {
+                return false;
             }
+            if (value instanceof JSONArray
+                    && !canCompactArrayLosslessly((JSONArray) value)) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    private static boolean isAmbiguousEnumValue(
+            String key, Object value, String messageType) {
+        if (!(value instanceof Number)) {
+            return false;
         }
+        return "kind".equals(key)
+                || "source".equals(key)
+                || "aeStateName".equals(key)
+                || ("status".equals(key) && "photo_status".equals(messageType));
+    }
+
+    private static JSONObject compactObject(JSONObject input, boolean topLevel) throws JSONException {
+        JSONObject output = new JSONObject();
+        String messageType = input.optString("type", input.optString("t", ""));
 
         Iterator<String> keys = input.keys();
         while (keys.hasNext()) {
             String key = keys.next();
-            if (skipResolvedConfig && "resolvedConfig".equals(key)) {
-                continue;
-            }
             Object value = input.get(key);
-            String shortKey = LONG_TO_SHORT.getOrDefault(key, key);
+            // Keep the absolute timestamp under its verbose key. Legacy peers recognize it and
+            // therefore do not mistake it for the old session-relative `ts` representation.
+            String shortKey =
+                    topLevel && "timestamp".equals(key)
+                            ? key
+                            : LONG_TO_SHORT.getOrDefault(key, key);
             Object compacted = compactValue(key, value, messageType);
-            if (shouldOmit(compacted)) {
-                continue;
-            }
             output.put(shortKey, compacted);
         }
-
-        if (topLevel) {
-            compactTimestamp(output);
-        }
         return output;
     }
 
-    private static boolean shouldDiffResolvedConfig(String messageType) {
-        return "photo_status".equals(messageType) || "stream_status".equals(messageType);
-    }
-
     private static Object compactValue(String longKey, Object value, String messageType)
             throws JSONException {
         if (value == JSONObject.NULL || value == null) {
-            return null;
+            return JSONObject.NULL;
         }
         if (value instanceof JSONObject) {
             return compactObject((JSONObject) value, false);
@@ -321,40 +349,6 @@ public final class BleJsonCompact {
         return out;
     }
 
-    private static boolean shouldOmit(Object value) {
-        if (value == null || value == JSONObject.NULL) {
-            return true;
-        }
-        if (value instanceof Boolean && !((Boolean) value)) {
-            return true;
-        }
-        if (value instanceof JSONObject && ((JSONObject) value).length() == 0) {
-            return true;
-        }
-        if (value instanceof JSONArray && ((JSONArray) value).length() == 0) {
-            return true;
-        }
-        return false;
-    }
-
-    private static void compactTimestamp(JSONObject output) throws JSONException {
-        String tsKey = output.has("timestamp") ? "timestamp" : (output.has("ts") ? "ts" : null);
-        if (tsKey == null) {
-            return;
-        }
-        long absolute = output.optLong(tsKey);
-        if (absolute <= 0) {
-            return;
-        }
-        if (sessionConnectEpochMs <= 0) {
-            sessionConnectEpochMs = absolute;
-        }
-        output.put("ts", absolute - sessionConnectEpochMs);
-        if (!"ts".equals(tsKey)) {
-            output.remove(tsKey);
-        }
-    }
-
     private static JSONObject expandObject(JSONObject input, boolean topLevel) throws JSONException {
         JSONObject output = new JSONObject();
         String messageType = input.optString("type", input.optString("t", ""));
@@ -369,9 +363,6 @@ public final class BleJsonCompact {
             }
             String longKey = SHORT_TO_LONG.getOrDefault(key, key);
             Object expanded = expandValue(longKey, value, messageType);
-            if (expanded == null || expanded == JSONObject.NULL) {
-                continue;
-            }
             output.put(longKey, expanded);
         }
 
@@ -384,14 +375,12 @@ public final class BleJsonCompact {
     }
 
     private static void cacheResolvedConfigIfPresent(JSONObject output) throws JSONException {
-        if (!output.has("resolvedConfig")) {
+        if (!(output.opt("resolvedConfig") instanceof JSONObject)) {
             return;
         }
         JSONObject resolvedConfig = output.getJSONObject("resolvedConfig");
         String hash = hashConfig(resolvedConfig);
         resolvedConfigByHash.put(hash, cloneObject(resolvedConfig));
-        currentSessionResolvedConfigHash = hash;
-        resolvedConfigSent = true;
     }
 
     private static void expandResolvedConfigHash(JSONObject output) throws JSONException {
@@ -402,14 +391,14 @@ public final class BleJsonCompact {
         JSONObject cached = resolvedConfigByHash.get(hash);
         if (cached != null) {
             output.put("resolvedConfig", cloneObject(cached));
+            output.remove(KEY_RESOLVED_CONFIG_HASH);
         }
-        output.remove(KEY_RESOLVED_CONFIG_HASH);
     }
 
     private static Object expandValue(String longKey, Object value, String messageType)
             throws JSONException {
         if (value == JSONObject.NULL || value == null) {
-            return null;
+            return JSONObject.NULL;
         }
         if (value instanceof JSONObject) {
             return expandObject((JSONObject) value, false);
@@ -448,7 +437,13 @@ public final class BleJsonCompact {
 
     private static void expandTimestamp(JSONObject output) throws JSONException {
         if (!output.has("timestamp") && output.has("ts")) {
-            long delta = output.optLong("ts");
+            Object timestamp = output.opt("ts");
+            if (!(timestamp instanceof Number)) {
+                output.put("timestamp", timestamp);
+                output.remove("ts");
+                return;
+            }
+            long delta = ((Number) timestamp).longValue();
             long absolute = sessionConnectEpochMs > 0 ? sessionConnectEpochMs + delta : delta;
             output.put("timestamp", absolute);
             output.remove("ts");

package/android/src/main/java/com/mentra/bluetoothsdk/utils/K900ProtocolUtils.java

@@ -429,7 +429,7 @@ public class K900ProtocolUtils {
         String payloadStr;
         try {
             payloadStr = new String(payload, StandardCharsets.UTF_8);
-            android.util.Log.d("K900ProtocolUtils", "Extracted payload: " + payloadStr);
+            android.util.Log.d("K900ProtocolUtils", "Extracted JSON payload bytes: " + payloadLength);
         } catch (Exception e) {
             android.util.Log.e("K900ProtocolUtils", "Error converting payload to string", e);
             return null;
@@ -437,7 +437,7 @@ public class K900ProtocolUtils {
 
         // Check if it's valid JSON
         if (!payloadStr.startsWith("{") || !payloadStr.endsWith("}")) {
-            android.util.Log.d("K900ProtocolUtils", "Payload is not valid JSON: " + payloadStr);
+            android.util.Log.d("K900ProtocolUtils", "Payload is not valid JSON");
             return null;
         }
 
@@ -448,7 +448,7 @@ public class K900ProtocolUtils {
             // Check if this is C-wrapped format {"C": "..."}
             if (json.has(FIELD_C)) {
                 String innerContent = json.optString(FIELD_C, "");
-                android.util.Log.d("K900ProtocolUtils", "Detected C-wrapped format, inner content: " + innerContent);
+                android.util.Log.d("K900ProtocolUtils", "Detected C-wrapped format");
 
                 // Try to parse the inner content as JSON
                 try {

package/android/src/test/java/com/mentra/bluetoothsdk/OtaStartResponsePolicyTest.kt

@@ -0,0 +1,30 @@
+package com.mentra.bluetoothsdk
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.Test
+
+class OtaStartResponsePolicyTest {
+    @Test
+    fun batteryLowFailureRejectsPendingStart() {
+        assertThat(otaStartRejectionErrorCode(status("failed", "battery_low")))
+            .isEqualTo("battery_low")
+    }
+
+    @Test
+    fun unrelatedFailureDoesNotRejectPendingStart() {
+        assertThat(otaStartRejectionErrorCode(status("failed", "download_failed"))).isNull()
+    }
+
+    @Test
+    fun nonFailureDoesNotRejectPendingStart() {
+        assertThat(otaStartRejectionErrorCode(status("in_progress", "battery_low"))).isNull()
+    }
+
+    private fun status(status: String, errorMessage: String): OtaStatusEvent =
+        OtaStatusEvent.fromMap(
+            mapOf(
+                "status" to status,
+                "error_message" to errorMessage,
+            )
+        )
+}

package/android/src/test/java/com/mentra/bluetoothsdk/ScopedNetworkReadinessTest.kt

@@ -0,0 +1,39 @@
+package com.mentra.bluetoothsdk
+
+import org.junit.Assert.assertFalse
+import org.junit.Assert.assertTrue
+import org.junit.Test
+
+class ScopedNetworkReadinessTest {
+    @Test
+    fun `waits for the available network to become foreground`() {
+        val readiness = ScopedNetworkReadiness<String>()
+
+        readiness.onAvailable("glasses")
+
+        assertFalse(readiness.isReady("glasses", isForeground = false))
+        assertTrue(readiness.isReady("glasses", isForeground = true))
+    }
+
+    @Test
+    fun `rejects capabilities from a stale network`() {
+        val readiness = ScopedNetworkReadiness<String>()
+
+        readiness.onAvailable("old")
+        readiness.onAvailable("current")
+
+        assertFalse(readiness.isReady("old", isForeground = true))
+        assertTrue(readiness.isReady("current", isForeground = true))
+    }
+
+    @Test
+    fun `clears the candidate when the request ends`() {
+        val readiness = ScopedNetworkReadiness<String>()
+        readiness.onAvailable("glasses")
+
+        readiness.clear()
+
+        assertFalse(readiness.contains("glasses"))
+        assertFalse(readiness.isReady("glasses", isForeground = true))
+    }
+}

package/android/src/test/java/com/mentra/bluetoothsdk/otaserver/LocalOtaServerTest.kt

@@ -0,0 +1,82 @@
+package com.mentra.bluetoothsdk.otaserver
+
+import java.io.File
+import java.net.HttpURLConnection
+import java.net.URL
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.After
+import org.junit.Before
+import org.junit.Test
+
+class LocalOtaServerTest {
+    private lateinit var server: LocalOtaServer
+    private lateinit var artifactFile: File
+    private var port = 0
+
+    private val manifest = """{"apps":{"com.mentra.asg_client":{"versionCode":1}}}"""
+    private val artifactBytes = ByteArray(1024) { (it % 251).toByte() }
+    private val sha = "a".repeat(64)
+
+    @Before
+    fun startServer() {
+        artifactFile = File.createTempFile("ota-artifact", ".bin").apply {
+            writeBytes(artifactBytes)
+        }
+        server = LocalOtaServer(onLog = {})
+        server.configure(manifest, mapOf(sha to artifactFile))
+        port = server.start("127.0.0.1", 0)
+    }
+
+    @After
+    fun stopServer() {
+        server.close()
+        artifactFile.delete()
+    }
+
+    @Test
+    fun `serves the configured manifest`() {
+        val connection = open("/version.json")
+        assertThat(connection.responseCode).isEqualTo(200)
+        assertThat(connection.contentType).isEqualTo("application/json")
+        assertThat(connection.inputStream.readBytes().decodeToString()).isEqualTo(manifest)
+    }
+
+    @Test
+    fun `streams a full artifact`() {
+        val connection = open("/artifacts/$sha")
+        assertThat(connection.responseCode).isEqualTo(200)
+        assertThat(connection.inputStream.readBytes()).isEqualTo(artifactBytes)
+    }
+
+    @Test
+    fun `returns 404 for unknown artifacts`() {
+        val connection = open("/artifacts/${"b".repeat(64)}")
+        assertThat(connection.responseCode).isEqualTo(404)
+    }
+
+    @Test
+    fun `rejects non-GET methods`() {
+        val connection = open("/version.json")
+        connection.requestMethod = "POST"
+        connection.doOutput = true
+        connection.outputStream.use { it.write("{}".toByteArray()) }
+        assertThat(connection.responseCode).isEqualTo(405)
+    }
+
+    @Test
+    fun `reconfigures while running`() {
+        server.configure("""{"updated":true}""", emptyMap())
+        val manifestConnection = open("/version.json")
+        assertThat(manifestConnection.inputStream.readBytes().decodeToString())
+            .isEqualTo("""{"updated":true}""")
+        val artifactConnection = open("/artifacts/$sha")
+        assertThat(artifactConnection.responseCode).isEqualTo(404)
+    }
+
+    private fun open(path: String): HttpURLConnection {
+        val connection = URL("http://127.0.0.1:$port$path").openConnection() as HttpURLConnection
+        connection.connectTimeout = 5_000
+        connection.readTimeout = 5_000
+        return connection
+    }
+}