@onekeyfe/hd-transport-web-device 1.2.0-alpha.1 → 1.2.0-alpha.100

package/dist/index.js

@@ -51,33 +51,22 @@ const REPORT_ID = transport.PROTOCOL_V1_REPORT_ID;
 const HEADER_LENGTH = transport.PROTOCOL_V1_MESSAGE_HEADER_SIZE;
 const PACKET_IO_MAX_RETRIES = 3;
 const PACKET_IO_RETRY_DELAY = 300;
-const PROTOCOL_PROBE_TIMEOUT = 1000;
-const WEBUSB_FILE_WRITE_LOG_BLOCK_PATTERN = /(?:^|[^a-z])(?:raw)?(?:filesystem|emmc)?filewrite$/i;
-function shouldSuppressWebUsbCallLog(name) {
-    const normalized = name.replace(/[_\s-]/g, '');
-    return WEBUSB_FILE_WRITE_LOG_BLOCK_PATTERN.test(normalized);
-}
-function isLogBlockCommand$1(name) {
-    var _a, _b;
-    return (_b = (_a = transport.LogBlockCommand === null || transport.LogBlockCommand === void 0 ? void 0 : transport.LogBlockCommand.has) === null || _a === void 0 ? void 0 : _a.call(transport.LogBlockCommand, name)) !== null && _b !== void 0 ? _b : false;
-}
-function shouldBlockWebUsbCallDataLog(name) {
-    const normalized = name.replace(/[_\s-]/g, '');
-    return isLogBlockCommand$1(name) || WEBUSB_FILE_WRITE_LOG_BLOCK_PATTERN.test(normalized);
-}
+const PROTOCOL_V1_PROBE_TIMEOUT = 5000;
+const PROTOCOL_V2_PROBE_TIMEOUT = 1000;
+const EXPECTED_PROTOCOL_V2_PROBE_ATTEMPTS = 2;
 function inferProtocolHintFromDeviceName$1(name) {
     return /\bpro\s*2\b/i.test(name !== null && name !== void 0 ? name : '') ? 'V2' : undefined;
 }
-class WebUsbTransport {
+class WebUsbTransport extends transport.ProtocolV2UsbTransportBase {
     constructor() {
+        super({
+            router: transport.PROTOCOL_V2_CHANNEL_USB,
+            maxFrameBytes: transport.PROTOCOL_V2_FRAME_MAX_BYTES,
+            logPrefix: 'ProtocolV2 WebUSB',
+        });
         this.deviceProtocol = new Map();
         this.deviceProtocolHints = new Map();
-        this.protocolV2Assemblers = new Map();
-        this.protocolV2Sessions = new Map();
-        this.protocolV2ReadTimeouts = new Map();
         this.deviceEndpoints = new Map();
-        this.mockSerialPaths = new WeakMap();
-        this.mockSerialCounter = 0;
         this.name = 'WebUsbTransport';
         this.stopped = false;
         this.configured = false;
@@ -101,10 +90,17 @@ class WebUsbTransport {
     }
     configureProtocolV2(signedData) {
         var _a;
+        const schemaSource = typeof signedData === 'string'
+            ? signedData
+            : (_a = JSON.stringify(signedData)) !== null && _a !== void 0 ? _a : String(signedData);
+        if (schemaSource === this.protocolV2SchemaSource)
+            return;
+        const hadProtocolV2Schema = this.protocolV2SchemaSource !== undefined;
         this.messagesV2 = parseConfigure$1(signedData);
-        this.protocolV2Sessions.clear();
-        this.protocolV2ReadTimeouts.clear();
-        (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug('[WebUsbTransport] Protocol V2 schema configured');
+        this.protocolV2SchemaSource = schemaSource;
+        if (!hadProtocolV2Schema)
+            return;
+        this.invalidateAllProtocolV2UsbLinks('Protocol V2 schema reconfigured').catch(error => { var _a; return (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug('[WebUsbTransport] schema link cleanup failed:', error); });
     }
     promptDeviceAccess() {
         return __awaiter(this, void 0, void 0, function* () {
@@ -126,28 +122,18 @@ class WebUsbTransport {
             return this.deviceList;
         });
     }
-    getDevicePath(device) {
-        var _a;
-        if (typeof device.serialNumber === 'string' && device.serialNumber.length > 0) {
-            return device.serialNumber;
-        }
-        let path = this.mockSerialPaths.get(device);
-        if (!path) {
-            this.mockSerialCounter += 1;
-            path = `mock-serial:${device.vendorId.toString(16)}:${device.productId.toString(16)}:${this.mockSerialCounter}`;
-            this.mockSerialPaths.set(device, path);
-            (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug(`[WebUSB] device has no serial number, using mock path: ${path}`);
-        }
-        return path;
-    }
     getConnectedDevices() {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.usb)
                 return [];
             const devices = yield this.usb.getDevices();
-            const onekeyDevices = devices.filter(dev => hdShared.ONEKEY_WEBUSB_FILTER.some(desc => dev.vendorId === desc.vendorId && dev.productId === desc.productId));
+            const onekeyDevices = devices.filter(dev => {
+                const isOneKey = hdShared.ONEKEY_WEBUSB_FILTER.some((desc) => dev.vendorId === desc.vendorId && dev.productId === desc.productId);
+                const hasSerialNumber = typeof dev.serialNumber === 'string' && dev.serialNumber.length > 0;
+                return isOneKey && hasSerialNumber && !hdShared.isKnownTrezorWebUsbDevice(dev);
+            });
             this.deviceList = onekeyDevices.map(device => {
-                const path = this.getDevicePath(device);
+                const path = device.serialNumber;
                 const protocolHint = inferProtocolHintFromDeviceName$1(device.productName);
                 if (protocolHint) {
                     this.deviceProtocolHints.set(path, protocolHint);
@@ -158,25 +144,22 @@ class WebUsbTransport {
                     commType: 'webusb',
                 };
             });
-            for (const dev of onekeyDevices) {
-                this.Log.debug(`[WebUSB] Device: name="${dev.productName}" serial="${dev.serialNumber}" ` +
-                    `VID=0x${dev.vendorId.toString(16)} PID=0x${dev.productId.toString(16)}`);
-            }
             return this.deviceList;
         });
     }
     acquire(input) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d;
         return __awaiter(this, void 0, void 0, function* () {
             if (!input.path)
                 return;
             try {
+                yield this.rotateProtocolV2UsbGeneration(input.path, 'WebUSB transport acquired');
                 yield this.closeOpenDevice(input.path);
                 yield this.connect((_a = input.path) !== null && _a !== void 0 ? _a : '', true);
                 const deviceName = (_b = this.deviceList.find(device => device.path === input.path)) === null || _b === void 0 ? void 0 : _b.device.productName;
                 const protocolHint = input.expectedProtocol
                     ? undefined
-                    : (_c = this.deviceProtocolHints.get(input.path)) !== null && _c !== void 0 ? _c : inferProtocolHintFromDeviceName$1(deviceName);
+                    : (_d = (_c = input.protocolHint) !== null && _c !== void 0 ? _c : this.deviceProtocolHints.get(input.path)) !== null && _d !== void 0 ? _d : inferProtocolHintFromDeviceName$1(deviceName);
                 if (protocolHint) {
                     this.deviceProtocolHints.set(input.path, protocolHint);
                 }
@@ -185,6 +168,7 @@ class WebUsbTransport {
             }
             catch (e) {
                 this.Log.debug('acquire error: ', e instanceof Error ? `${e.name}: ${e.message}` : String(e));
+                yield this.closeOpenDevice(input.path);
                 throw e;
             }
         });
@@ -192,32 +176,53 @@ class WebUsbTransport {
     createProtocolMismatchError(expected) {
         return hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, `Device protocol mismatch: expected ${expected}, but device did not respond to expected protocol`);
     }
+    createProtocolProbeTimeoutError(expected, attempts) {
+        return hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, `Protocol ${expected} probe timeout after ${attempts} attempts`);
+    }
     createProtocolDetectionError() {
-        return hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'Unable to detect USB protocol: device did not respond to Protocol V1 Initialize or Protocol V2 Ping');
+        return hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.DeviceNotFound);
     }
     detectProtocol(path, expectedProtocol, protocolHint) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             if (expectedProtocol === 'V1') {
                 if (yield this.probeProtocolV1(path)) {
                     this.deviceProtocol.set(path, 'V1');
-                    this.Log.debug(`[WebUsbTransport] detectProtocol: path=${path} -> V1 (expected)`);
                     return 'V1';
                 }
+                yield this.closeConnectionAfterProbe(path);
                 throw this.createProtocolMismatchError(expectedProtocol);
             }
             if (expectedProtocol === 'V2') {
-                this.deviceProtocol.set(path, 'V2');
-                this.Log.debug(`[WebUsbTransport] detectProtocol: path=${path} -> V2 (expected)`);
-                return 'V2';
+                for (let attempt = 1; attempt <= EXPECTED_PROTOCOL_V2_PROBE_ATTEMPTS; attempt += 1) {
+                    if (yield this.probeProtocolV2(path)) {
+                        this.deviceProtocol.set(path, 'V2');
+                        return 'V2';
+                    }
+                    if (attempt < EXPECTED_PROTOCOL_V2_PROBE_ATTEMPTS) {
+                        yield this.resetConnectionAfterProbe(path);
+                        (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug(`[WebUsbTransport] Protocol V2 probe timed out, retrying ${attempt + 1}/${EXPECTED_PROTOCOL_V2_PROBE_ATTEMPTS}`);
+                    }
+                    else {
+                        yield this.closeConnectionAfterProbe(path);
+                    }
+                }
+                this.deviceProtocol.delete(path);
+                throw this.createProtocolProbeTimeoutError(expectedProtocol, EXPECTED_PROTOCOL_V2_PROBE_ATTEMPTS);
             }
             const probeOrder = protocolHint === 'V2' || this.deviceProtocol.get(path) === 'V2' ? ['V2', 'V1'] : ['V1', 'V2'];
-            for (const protocol of probeOrder) {
+            for (const [index, protocol] of probeOrder.entries()) {
                 const detected = protocol === 'V1' ? yield this.probeProtocolV1(path) : yield this.probeProtocolV2(path);
                 if (detected) {
                     this.deviceProtocol.set(path, protocol);
-                    this.Log.debug(`[WebUsbTransport] detectProtocol: path=${path} -> ${protocol}`);
                     return protocol;
                 }
+                if (index < probeOrder.length - 1) {
+                    yield this.resetConnectionAfterProbe(path);
+                }
+                else {
+                    yield this.closeConnectionAfterProbe(path);
+                }
             }
             this.deviceProtocol.delete(path);
             throw this.createProtocolDetectionError();
@@ -284,10 +289,9 @@ class WebUsbTransport {
         };
     }
     connectToDevice(path, first) {
-        var _a, _b;
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             let device = yield this.findDevice(path);
-            this.Log.debug('[WebUsbTransport] connecting to device:', device.productName, 'PID:', device.productId);
             if (!device.opened) {
                 yield device.open();
             }
@@ -309,33 +313,30 @@ class WebUsbTransport {
             }
             const endpoints = this.discoverEndpoints(device);
             this.deviceEndpoints.set(path, endpoints);
-            (_b = this.protocolV2Assemblers.get(path)) === null || _b === void 0 ? void 0 : _b.reset();
-            this.protocolV2Assemblers.set(path, new transport.ProtocolV2FrameAssembler(transport.PROTOCOL_V2_FRAME_MAX_BYTES));
             yield device.claimInterface(endpoints.interfaceNumber);
             yield this.clearEndpointHalt(device, 'in', endpoints.endpointIn);
             yield this.clearEndpointHalt(device, 'out', endpoints.endpointOut);
         });
     }
     closeOpenDevice(path) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d;
         return __awaiter(this, void 0, void 0, function* () {
-            (_a = this.protocolV2Assemblers.get(path)) === null || _a === void 0 ? void 0 : _a.reset();
-            const current = (_b = this.deviceList.find(device => device.path === path)) === null || _b === void 0 ? void 0 : _b.device;
+            const current = (_a = this.deviceList.find(device => device.path === path)) === null || _a === void 0 ? void 0 : _a.device;
             if (!(current === null || current === void 0 ? void 0 : current.opened))
                 return;
             const endpoints = this.deviceEndpoints.get(path);
-            const ifaceNum = (_c = endpoints === null || endpoints === void 0 ? void 0 : endpoints.interfaceNumber) !== null && _c !== void 0 ? _c : this.interfaceId;
+            const ifaceNum = (_b = endpoints === null || endpoints === void 0 ? void 0 : endpoints.interfaceNumber) !== null && _b !== void 0 ? _b : this.interfaceId;
             try {
                 yield current.releaseInterface(ifaceNum);
             }
             catch (error) {
-                (_d = this.Log) === null || _d === void 0 ? void 0 : _d.debug('[WebUsbTransport] releaseInterface before reconnect failed:', error);
+                (_c = this.Log) === null || _c === void 0 ? void 0 : _c.debug('[WebUsbTransport] releaseInterface before reconnect failed:', error);
             }
             try {
                 yield current.close();
             }
             catch (error) {
-                (_e = this.Log) === null || _e === void 0 ? void 0 : _e.debug('[WebUsbTransport] close before reconnect failed:', error);
+                (_d = this.Log) === null || _d === void 0 ? void 0 : _d.debug('[WebUsbTransport] close before reconnect failed:', error);
             }
         });
     }
@@ -420,19 +421,11 @@ class WebUsbTransport {
         return copied.buffer;
     }
     transferOutWithRetry(path, packet) {
-        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             let lastError;
             for (let attempt = 1; attempt <= PACKET_IO_MAX_RETRIES; attempt += 1) {
                 try {
-                    const device = yield this.findDevice(path);
-                    if (!device.opened) {
-                        yield this.connect(path, false);
-                    }
-                    const endpoints = this.deviceEndpoints.get(path);
-                    const endpointOut = (_a = endpoints === null || endpoints === void 0 ? void 0 : endpoints.endpointOut) !== null && _a !== void 0 ? _a : this.endpointId;
-                    const transferBuffer = this.toArrayBuffer(packet.buffer.slice(packet.byteOffset, packet.byteOffset + packet.byteLength));
-                    yield device.transferOut(endpointOut, transferBuffer);
+                    yield this.transferOutOnce(path, packet);
                     return;
                 }
                 catch (error) {
@@ -453,6 +446,19 @@ class WebUsbTransport {
             throw lastError;
         });
     }
+    transferOutOnce(path, packet) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const device = yield this.findDevice(path);
+            if (!device.opened) {
+                yield this.connect(path, false);
+            }
+            const endpoints = this.deviceEndpoints.get(path);
+            const endpointOut = (_a = endpoints === null || endpoints === void 0 ? void 0 : endpoints.endpointOut) !== null && _a !== void 0 ? _a : this.endpointId;
+            const transferBuffer = this.toArrayBuffer(packet.buffer.slice(packet.byteOffset, packet.byteOffset + packet.byteLength));
+            yield device.transferOut(endpointOut, transferBuffer);
+        });
+    }
     transferInWithRetry(path, length, cancelToken) {
         var _a;
         return __awaiter(this, void 0, void 0, function* () {
@@ -492,29 +498,28 @@ class WebUsbTransport {
             throw lastError;
         });
     }
-    resetConnectionAfterProbe(path) {
-        var _a, _b;
+    transferInOnce(path, length) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
-            (_a = this.protocolV2Assemblers.get(path)) === null || _a === void 0 ? void 0 : _a.reset();
-            this.protocolV2Sessions.delete(path);
-            this.protocolV2ReadTimeouts.delete(path);
-            try {
-                const device = yield this.findDevice(path);
-                if (device.opened) {
-                    const endpoints = this.deviceEndpoints.get(path);
-                    const ifaceNum = (_b = endpoints === null || endpoints === void 0 ? void 0 : endpoints.interfaceNumber) !== null && _b !== void 0 ? _b : this.interfaceId;
-                    try {
-                        yield device.releaseInterface(ifaceNum);
-                    }
-                    catch (error) {
-                        this.Log.debug('[WebUsbTransport] releaseInterface after protocol probe error:', error);
-                    }
-                    yield device.close();
-                }
-            }
-            catch (error) {
-                this.Log.debug('[WebUsbTransport] close after protocol probe error:', error);
+            const device = yield this.findDevice(path);
+            if (!device.opened) {
+                throw new Error('USBDevice is not open for transferIn');
             }
+            const endpoints = this.deviceEndpoints.get(path);
+            const endpointIn = (_a = endpoints === null || endpoints === void 0 ? void 0 : endpoints.endpointIn) !== null && _a !== void 0 ? _a : this.endpointId;
+            const result = yield device.transferIn(endpointIn, length);
+            return this.getTransferInData(result);
+        });
+    }
+    closeConnectionAfterProbe(path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.rotateProtocolV2UsbGeneration(path, 'WebUSB protocol probe reset');
+            yield this.closeOpenDevice(path);
+        });
+    }
+    resetConnectionAfterProbe(path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.closeConnectionAfterProbe(path);
             yield this.getConnectedDevices();
             yield this.connect(path, false);
         });
@@ -537,6 +542,14 @@ class WebUsbTransport {
                         timer = setTimeout(() => __awaiter(this, void 0, void 0, function* () {
                             timedOut = true;
                             onTimeout === null || onTimeout === void 0 ? void 0 : onTimeout();
+                            if (protocol === 'V1') {
+                                try {
+                                    yield this.resetConnectionAfterProbe(path);
+                                }
+                                catch (error) {
+                                    this.Log.debug('[WebUsbTransport] reset after Protocol V1 timeout failed:', error);
+                                }
+                            }
                             reject(new Error(`Protocol ${protocol} read timeout after ${timeoutMs}ms`));
                         }), timeoutMs);
                     }),
@@ -554,11 +567,12 @@ class WebUsbTransport {
                 return false;
             }
             try {
-                yield this.callProtocolV1(path, 'Initialize', {}, { timeoutMs: PROTOCOL_PROBE_TIMEOUT });
+                yield this.callProtocolV1(path, 'Initialize', {}, {
+                    timeoutMs: PROTOCOL_V1_PROBE_TIMEOUT,
+                });
                 return true;
             }
-            catch (error) {
-                this.Log.debug('[WebUsbTransport] Protocol V1 Initialize probe failed:', error);
+            catch (_error) {
                 return false;
             }
         });
@@ -570,10 +584,9 @@ class WebUsbTransport {
             }
             return transport.probeProtocolV2({
                 call: (name, data, options) => this.callProtocolV2(path, name, data, options),
-                timeoutMs: PROTOCOL_PROBE_TIMEOUT,
+                timeoutMs: PROTOCOL_V2_PROBE_TIMEOUT,
                 logger: this.Log,
                 logPrefix: 'ProtocolV2 WebUSB',
-                onProbeFailed: () => this.resetConnectionAfterProbe(path),
             });
         });
     }
@@ -590,12 +603,8 @@ class WebUsbTransport {
             if (!protocol) {
                 throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, `Device protocol has not been detected for ${path}`);
             }
-            if (shouldSuppressWebUsbCallLog(name)) ;
-            else if (shouldBlockWebUsbCallDataLog(name)) {
-                this.Log.debug('call-', ' name: ', name, ' protocol: ', protocol);
-            }
-            else {
-                this.Log.debug('call-', ' name: ', name, ' data: ', data, ' protocol: ', protocol);
+            if (!transport.shouldSuppressHighVolumeCallLog(name)) {
+                this.Log.debug('transport call', transport.createTransportCallLog(name, protocol, data));
             }
             if (protocol === 'V2') {
                 return this.callProtocolV2(path, name, data, options);
@@ -625,67 +634,8 @@ class WebUsbTransport {
         });
     }
     callProtocolV2(path, name, data, options) {
-        var _a;
-        return __awaiter(this, void 0, void 0, function* () {
-            const protocolV1Messages = this.messages;
-            if (!this.messagesV2) {
-                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.TransportNotConfigured, 'Protocol V2 schema not configured');
-            }
-            if (!protocolV1Messages) {
-                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.TransportNotConfigured);
-            }
-            let session = this.protocolV2Sessions.get(path);
-            if (!session) {
-                session = new transport.ProtocolV2Session({
-                    schemas: {
-                        protocolV1: protocolV1Messages,
-                        protocolV2: this.messagesV2,
-                    },
-                    router: transport.PROTOCOL_V2_CHANNEL_USB,
-                    writeFrame: (frame) => this.transferOutWithRetry(path, frame),
-                    readFrame: () => this.receiveProtocolV2Frame(path, this.protocolV2ReadTimeouts.get(path)),
-                    logger: this.Log,
-                    logPrefix: 'ProtocolV2 WebUSB',
-                    createTimeoutError: (messageName, timeoutMs) => new Error(`Protocol V2 response timeout after ${timeoutMs}ms for ${messageName}`),
-                });
-                this.protocolV2Sessions.set(path, session);
-            }
-            this.protocolV2ReadTimeouts.set(path, options === null || options === void 0 ? void 0 : options.timeoutMs);
-            (_a = this.protocolV2Assemblers.get(path)) === null || _a === void 0 ? void 0 : _a.reset();
-            try {
-                return yield session.call(name, data, options);
-            }
-            finally {
-                this.protocolV2ReadTimeouts.delete(path);
-            }
-        });
-    }
-    receiveProtocolV2Frame(path, timeoutMs) {
         return __awaiter(this, void 0, void 0, function* () {
-            let assembler = this.protocolV2Assemblers.get(path);
-            if (!assembler) {
-                assembler = new transport.ProtocolV2FrameAssembler(transport.PROTOCOL_V2_FRAME_MAX_BYTES);
-                this.protocolV2Assemblers.set(path, assembler);
-            }
-            let frame = assembler.push(new Uint8Array(0));
-            const deadline = timeoutMs ? Date.now() + timeoutMs : undefined;
-            while (!frame) {
-                const cancelToken = { cancelled: false };
-                const transferIn = this.transferInWithRetry(path, transport.PROTOCOL_V2_FRAME_MAX_BYTES, cancelToken);
-                const dataView = deadline
-                    ? yield this.withProtocolReadTimeout(path, transferIn, Math.max(deadline - Date.now(), 1), 'V2', () => {
-                        cancelToken.cancelled = true;
-                    })
-                    : yield transferIn;
-                const bytes = new Uint8Array(this.toArrayBuffer(dataView.buffer.slice(dataView.byteOffset, dataView.byteOffset + dataView.byteLength)));
-                try {
-                    frame = assembler.push(bytes);
-                }
-                catch (error) {
-                    throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.NetworkError, error instanceof Error ? error.message : String(error));
-                }
-            }
-            return frame;
+            return this.callProtocolV2Usb(path, name, data, options);
         });
     }
     receiveData(path, timeoutMs) {
@@ -726,44 +676,71 @@ class WebUsbTransport {
         });
     }
     release(path) {
-        var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
-            const device = yield this.findDevice(path);
-            const endpoints = this.deviceEndpoints.get(path);
-            const ifaceNum = (_a = endpoints === null || endpoints === void 0 ? void 0 : endpoints.interfaceNumber) !== null && _a !== void 0 ? _a : this.interfaceId;
-            yield device.releaseInterface(ifaceNum);
-            yield device.close();
+            yield this.invalidateProtocolV2UsbLink(path, 'WebUSB transport released');
+            yield this.closeOpenDevice(path);
             this.deviceProtocol.delete(path);
             this.deviceProtocolHints.delete(path);
-            (_b = this.protocolV2Assemblers.get(path)) === null || _b === void 0 ? void 0 : _b.reset();
-            this.protocolV2Assemblers.delete(path);
             this.deviceEndpoints.delete(path);
         });
     }
+    getProtocolV2UsbSchemas() {
+        if (!this.messages || !this.messagesV2) {
+            throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.TransportNotConfigured);
+        }
+        return {
+            protocolV1: this.messages,
+            protocolV2: this.messagesV2,
+        };
+    }
+    getProtocolV2UsbLogger() {
+        return this.Log;
+    }
+    writeProtocolV2UsbPacket(path, frame, _context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.transferOutOnce(path, frame);
+        });
+    }
+    readProtocolV2UsbPacket(path, _context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const dataView = yield this.transferInOnce(path, transport.PROTOCOL_V2_FRAME_MAX_BYTES);
+            return new Uint8Array(this.toArrayBuffer(dataView.buffer.slice(dataView.byteOffset, dataView.byteOffset + dataView.byteLength)));
+        });
+    }
+    resetProtocolV2UsbNativeLink(path, _reason) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.closeOpenDevice(path);
+        });
+    }
+    onProtocolV2UsbLinkInvalidated(path, reason) {
+        var _a;
+        this.deviceProtocol.delete(path);
+        (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug(`[WebUsbTransport] Protocol V2 link invalidated: ${path}`, reason);
+    }
+    createProtocolV2UsbTimeoutError(name, timeoutMs) {
+        return new transport.ProtocolV2LinkError('response-timeout', `Protocol V2 response timeout after ${timeoutMs}ms for ${name}`);
+    }
     getProtocolType(path) {
         return this.deviceProtocol.get(path);
     }
 }
 
-const FILE_WRITE_LOG_BLOCK_PATTERN = /(?:^|[^a-z])(?:raw)?(?:filesystem|emmc)?filewrite$/i;
-function shouldSuppressHighVolumeCallLog(name) {
-    const normalized = name.replace(/[_\s-]/g, '');
-    return FILE_WRITE_LOG_BLOCK_PATTERN.test(normalized);
-}
-function isLogBlockCommand(name) {
-    var _a, _b;
-    return (_b = (_a = transport.LogBlockCommand === null || transport.LogBlockCommand === void 0 ? void 0 : transport.LogBlockCommand.has) === null || _a === void 0 ? void 0 : _a.call(transport.LogBlockCommand, name)) !== null && _b !== void 0 ? _b : false;
+const BLE_ATT_HEADER_BYTES = 3;
+function resolveBlePacketCapacity(mtu, maximumPacketCapacity, fallbackPacketCapacity) {
+    if (typeof mtu !== 'number' || !Number.isFinite(mtu) || mtu <= BLE_ATT_HEADER_BYTES) {
+        return fallbackPacketCapacity;
+    }
+    return Math.min(maximumPacketCapacity, Math.floor(mtu) - BLE_ATT_HEADER_BYTES);
 }
+
 const { parseConfigure, ProtocolV1, check } = transport__default["default"];
 function inferProtocolHintFromDeviceName(name) {
     return /\bpro\s*2\b/i.test(name !== null && name !== void 0 ? name : '') ? 'V2' : undefined;
 }
 const toBleDescriptor = (device, protocolType) => (Object.assign({ id: device.id, name: device.name, path: device.id, debug: false, commType: 'electron-ble' }, (protocolType ? { protocolType } : {})));
-const BLE_PACKET_SIZE = 192;
+const BLE_PACKET_SIZE_FALLBACK = 192;
+const BLE_PACKET_SIZE_MAXIMUM = 244;
 const BLE_WRITE_DELAY_MS = 5;
-const BLE_WRITE_MAX_RETRIES = 3;
-const BLE_WRITE_RETRY_DELAY_MS = 300;
-const BLE_RESPONSE_TIMEOUT_MS = 30000;
 const PROTOCOL_PROBE_TIMEOUT_MS = 1000;
 const PROTOCOL_V2_PROBE_TIMEOUT_MS = 5000;
 class ElectronBleTransport {
@@ -771,16 +748,40 @@ class ElectronBleTransport {
         this.name = 'ElectronBleTransport';
         this.configured = false;
         this.runPromise = null;
+        this.runPromiseDeviceId = null;
         this.connectedDevices = new Set();
         this.deviceProtocol = new Map();
         this.deviceProtocolHints = new Map();
+        this.deviceMtus = new Map();
+        this.devicePacketCapacities = new Map();
         this.v1Buffers = new Map();
         this.v2Assemblers = new Map();
         this.v2FrameQueues = new Map();
         this.v2FramePromises = new Map();
-        this.activeProtocolV2Call = null;
-        this.nextProtocolV2CallToken = 1;
+        this.protocolV2Links = new transport.ProtocolV2LinkManager({
+            getSchemas: () => {
+                if (!this._messages || !this._messagesV2) {
+                    throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.TransportNotConfigured);
+                }
+                return {
+                    protocolV1: this._messages,
+                    protocolV2: this._messagesV2,
+                };
+            },
+            classifyError: () => 'link-fatal',
+            onLinkInvalidated: (uuid, reason) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b;
+                (_a = this.v2Assemblers.get(uuid)) === null || _a === void 0 ? void 0 : _a.reset();
+                this.rejectProtocolV2Frames(uuid, new Error(reason));
+                (_b = this.Log) === null || _b === void 0 ? void 0 : _b.debug('[Electron BLE] Protocol V2 link invalidated:', uuid, reason);
+                if (reason.startsWith('Protocol V2 link-fatal error:')) {
+                    yield this.releaseNative(uuid);
+                }
+            }),
+        });
+        this.warnedMissingRelease = false;
         this.notificationCleanups = new Map();
+        this.mtuCleanups = new Map();
         this.disconnectCleanups = new Map();
         this.notificationTokens = new Map();
         this.nextNotificationToken = 1;
@@ -815,21 +816,32 @@ class ElectronBleTransport {
         throw error;
     }
     cleanupDeviceState(deviceId) {
-        var _a;
+        this.protocolV2Links
+            .invalidateLink(deviceId, 'Electron BLE device state cleaned')
+            .catch(error => { var _a; return (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug('[Electron BLE] link cleanup failed:', error); });
         this.connectedDevices.delete(deviceId);
         this.deviceProtocol.delete(deviceId);
+        this.deviceMtus.delete(deviceId);
+        this.devicePacketCapacities.delete(deviceId);
         this.v1Buffers.delete(deviceId);
         this.v2Assemblers.delete(deviceId);
         this.resetProtocolV2Frames(deviceId);
-        if (((_a = this.activeProtocolV2Call) === null || _a === void 0 ? void 0 : _a.uuid) === deviceId) {
-            this.activeProtocolV2Call = null;
-        }
         this.notificationTokens.delete(deviceId);
+        if (this.runPromise && this.runPromiseDeviceId === deviceId) {
+            this.runPromise.reject(hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleDeviceDisconnected));
+            this.runPromise = null;
+            this.runPromiseDeviceId = null;
+        }
         const notifyCleanup = this.notificationCleanups.get(deviceId);
         if (notifyCleanup) {
             notifyCleanup();
             this.notificationCleanups.delete(deviceId);
         }
+        const mtuCleanup = this.mtuCleanups.get(deviceId);
+        if (mtuCleanup) {
+            mtuCleanup();
+            this.mtuCleanups.delete(deviceId);
+        }
         const disconnectCleanup = this.disconnectCleanups.get(deviceId);
         if (disconnectCleanup) {
             disconnectCleanup();
@@ -850,9 +862,18 @@ class ElectronBleTransport {
         this.configured = true;
     }
     configureProtocolV2(signedData) {
-        var _a;
+        const configuration = typeof signedData === 'string' ? signedData : JSON.stringify(signedData);
+        if (this.protocolV2SchemaConfiguration === configuration) {
+            return;
+        }
+        const isReconfiguration = this.protocolV2SchemaConfiguration !== undefined;
         this._messagesV2 = parseConfigure(signedData);
-        (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug('[Electron BLE] Protocol V2 schema configured');
+        this.protocolV2SchemaConfiguration = configuration;
+        if (isReconfiguration) {
+            this.protocolV2Links
+                .invalidateAllLinks('Protocol V2 schema reconfigured')
+                .catch(error => { var _a; return (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug('[Electron BLE] schema link cleanup failed:', error); });
+        }
     }
     listen() {
         return __awaiter(this, void 0, void 0, function* () {
@@ -884,18 +905,20 @@ class ElectronBleTransport {
         });
     }
     acquire(input) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         return __awaiter(this, void 0, void 0, function* () {
             const { uuid, forceCleanRunPromise, expectedProtocol } = input;
             if (!uuid) {
                 throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleRequiredUUID);
             }
+            if (this.connectedDevices.has(uuid)) {
+                yield this.release(uuid);
+            }
             if (forceCleanRunPromise && this.runPromise) {
                 const error = hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleForceCleanRunPromise);
                 this.runPromise.reject(error);
-                this.rejectAllProtocolV2Frames(error);
                 this.runPromise = null;
-                this.activeProtocolV2Call = null;
+                this.runPromiseDeviceId = null;
             }
             try {
                 if (!((_a = window.desktopApi) === null || _a === void 0 ? void 0 : _a.nobleBle)) {
@@ -907,7 +930,7 @@ class ElectronBleTransport {
                 }
                 const protocolHint = expectedProtocol
                     ? undefined
-                    : (_b = this.deviceProtocolHints.get(uuid)) !== null && _b !== void 0 ? _b : inferProtocolHintFromDeviceName(device.name);
+                    : (_c = (_b = input.protocolHint) !== null && _b !== void 0 ? _b : this.deviceProtocolHints.get(uuid)) !== null && _c !== void 0 ? _c : inferProtocolHintFromDeviceName(device.name);
                 if (protocolHint) {
                     this.deviceProtocolHints.set(uuid, protocolHint);
                 }
@@ -918,16 +941,31 @@ class ElectronBleTransport {
                 catch (error) {
                     this.handleBluetoothError(error);
                 }
+                const mtuCleanup = this.createMtuSubscription(uuid);
+                if (mtuCleanup) {
+                    this.mtuCleanups.set(uuid, mtuCleanup);
+                }
                 this.v1Buffers.set(uuid, { buffer: [], bufferLength: 0 });
-                this.v2Assemblers.set(uuid, new transport.ProtocolV2FrameAssembler());
+                this.v2Assemblers.set(uuid, new transport.ProtocolV2FrameAssembler(transport.PROTOCOL_V2_BLE_FRAME_MAX_BYTES));
                 yield window.desktopApi.nobleBle.subscribe(uuid);
+                yield this.refreshBlePacketCapacity(uuid);
                 const cleanup = this.createNotificationSubscription(uuid);
                 this.notificationCleanups.set(uuid, cleanup);
+                const connectionToken = this.notificationTokens.get(uuid);
+                const protocolType = yield this.detectProtocol(uuid, expectedProtocol, protocolHint);
+                if (protocolType === 'V2') {
+                    (_d = this.Log) === null || _d === void 0 ? void 0 : _d.debug('[Electron BLE] Protocol V2 write configured', {
+                        writeMode: 'withoutResponse',
+                        negotiatedMtu: this.deviceMtus.get(uuid),
+                        packetCapacity: (_e = this.devicePacketCapacities.get(uuid)) !== null && _e !== void 0 ? _e : BLE_PACKET_SIZE_FALLBACK,
+                    });
+                }
                 const disconnectCleanup = window.desktopApi.nobleBle.onDeviceDisconnected((disconnectedDevice) => {
                     var _a;
-                    if (disconnectedDevice.id === uuid) {
+                    if (disconnectedDevice.id === uuid &&
+                        this.notificationTokens.get(uuid) === connectionToken) {
                         this.cleanupDeviceState(uuid);
-                        (_a = this.emitter) === null || _a === void 0 ? void 0 : _a.emit('device-disconnect', {
+                        (_a = this.emitter) === null || _a === void 0 ? void 0 : _a.emit(transport.TRANSPORT_EVENT.DEVICE_DISCONNECT, {
                             name: disconnectedDevice.name,
                             id: disconnectedDevice.id,
                             connectId: disconnectedDevice.id,
@@ -935,31 +973,43 @@ class ElectronBleTransport {
                     }
                 });
                 this.disconnectCleanups.set(uuid, disconnectCleanup);
-                const protocolType = yield this.detectProtocol(uuid, expectedProtocol, protocolHint);
-                (_c = this.emitter) === null || _c === void 0 ? void 0 : _c.emit('device-connect', {
-                    name: device.name,
-                    id: device.id,
-                    connectId: device.id,
-                });
                 return Object.assign(Object.assign({}, toBleDescriptor({ id: device.id, name: device.name }, protocolType)), { uuid });
             }
             catch (error) {
-                (_d = this.Log) === null || _d === void 0 ? void 0 : _d.error('[Electron BLE] acquire failed:', error);
+                (_f = this.Log) === null || _f === void 0 ? void 0 : _f.error('[Electron BLE] acquire failed:', error);
                 try {
-                    if (((_e = window.desktopApi) === null || _e === void 0 ? void 0 : _e.nobleBle) && this.connectedDevices.has(uuid)) {
+                    if (((_g = window.desktopApi) === null || _g === void 0 ? void 0 : _g.nobleBle) && this.connectedDevices.has(uuid)) {
                         yield window.desktopApi.nobleBle.unsubscribe(uuid);
                         yield window.desktopApi.nobleBle.disconnect(uuid);
                     }
                 }
                 catch (cleanupError) {
-                    (_f = this.Log) === null || _f === void 0 ? void 0 : _f.debug('[Electron BLE] acquire cleanup failed:', cleanupError);
+                    (_h = this.Log) === null || _h === void 0 ? void 0 : _h.debug('[Electron BLE] acquire cleanup failed:', cleanupError);
                 }
                 this.cleanupDeviceState(uuid);
                 throw error;
             }
         });
     }
-    release(id) {
+    release(id, _onclose, keepSession) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield this.protocolV2Links.invalidateLink(id, 'Electron BLE transport released');
+                yield this.releaseLogical(id, keepSession);
+            }
+            catch (error) {
+                (_a = this.Log) === null || _a === void 0 ? void 0 : _a.error('[Electron BLE] release failed:', error);
+                this.cleanupDeviceState(id);
+            }
+        });
+    }
+    disconnect(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.releaseNative(id);
+        });
+    }
+    releaseNative(id) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
             try {
@@ -977,11 +1027,35 @@ class ElectronBleTransport {
             }
         });
     }
+    releaseLogical(id, keepSession) {
+        var _a, _b, _c, _d;
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (!this.connectedDevices.has(id))
+                    return;
+                this.cleanupDeviceState(id);
+                const release = (_b = (_a = window.desktopApi) === null || _a === void 0 ? void 0 : _a.nobleBle) === null || _b === void 0 ? void 0 : _b.release;
+                if (!release) {
+                    if (!this.warnedMissingRelease) {
+                        this.warnedMissingRelease = true;
+                        (_c = this.Log) === null || _c === void 0 ? void 0 : _c.error('[Electron BLE] desktopApi.nobleBle.release is missing from the preload bridge; ' +
+                            'keep-alive idle countdown will never start — map NOBLE_BLE_RELEASE in the desktop preload');
+                    }
+                    return;
+                }
+                yield release(id, keepSession);
+            }
+            catch (error) {
+                (_d = this.Log) === null || _d === void 0 ? void 0 : _d.error('[Electron BLE] logical release failed:', error);
+                this.cleanupDeviceState(id);
+            }
+        });
+    }
     createProtocolMismatchError(expected) {
         return hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, `Device protocol mismatch: expected ${expected}, but device did not respond to expected protocol`);
     }
     createProtocolDetectionError() {
-        return hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleTimeoutError, 'Unable to detect BLE protocol: device did not respond to Protocol V1 Initialize or Protocol V2 Ping');
+        return hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleTimeoutError, 'Unable to detect BLE protocol: device did not respond to Protocol V1 GetFeatures or Protocol V2 Ping');
     }
     clearProbeProtocol(uuid, protocol) {
         if (this.deviceProtocol.get(uuid) === protocol) {
@@ -1000,9 +1074,12 @@ class ElectronBleTransport {
                 throw this.createProtocolMismatchError(expectedProtocol);
             }
             if (expectedProtocol === 'V2') {
-                this.deviceProtocol.set(uuid, 'V2');
-                (_b = this.Log) === null || _b === void 0 ? void 0 : _b.debug(`[Electron BLE] detectProtocol: uuid=${uuid} -> V2 (expected)`);
-                return 'V2';
+                if (yield this.probeProtocolV2(uuid)) {
+                    this.deviceProtocol.set(uuid, 'V2');
+                    (_b = this.Log) === null || _b === void 0 ? void 0 : _b.debug(`[Electron BLE] detectProtocol: uuid=${uuid} -> V2 (expected)`);
+                    return 'V2';
+                }
+                throw this.createProtocolMismatchError(expectedProtocol);
             }
             const probeOrder = protocolHint === 'V2' || this.deviceProtocol.get(uuid) === 'V2' ? ['V2', 'V1'] : ['V1', 'V2'];
             for (let i = 0; i < probeOrder.length; i += 1) {
@@ -1036,18 +1113,17 @@ class ElectronBleTransport {
         });
     }
     resetProbeStateAfterProtocolProbe(uuid, protocol) {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
         return __awaiter(this, void 0, void 0, function* () {
+            yield this.protocolV2Links.invalidateLink(uuid, `Reset notify state after Protocol ${protocol} probe`);
             this.v1Buffers.set(uuid, { buffer: [], bufferLength: 0 });
             (_a = this.v2Assemblers.get(uuid)) === null || _a === void 0 ? void 0 : _a.reset();
             this.resetProtocolV2Frames(uuid);
-            if (((_b = this.activeProtocolV2Call) === null || _b === void 0 ? void 0 : _b.uuid) === uuid) {
-                this.activeProtocolV2Call = null;
-            }
-            if (this.runPromise) {
+            if (this.runPromise && this.runPromiseDeviceId === uuid) {
                 const error = hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleForceCleanRunPromise);
                 this.runPromise.reject(error);
                 this.runPromise = null;
+                this.runPromiseDeviceId = null;
             }
             const notifyCleanup = this.notificationCleanups.get(uuid);
             if (notifyCleanup) {
@@ -1056,16 +1132,26 @@ class ElectronBleTransport {
             }
             this.notificationTokens.delete(uuid);
             try {
-                yield ((_d = (_c = window.desktopApi) === null || _c === void 0 ? void 0 : _c.nobleBle) === null || _d === void 0 ? void 0 : _d.unsubscribe(uuid));
+                yield ((_c = (_b = window.desktopApi) === null || _b === void 0 ? void 0 : _b.nobleBle) === null || _c === void 0 ? void 0 : _c.unsubscribe(uuid));
+            }
+            catch (error) {
+                (_d = this.Log) === null || _d === void 0 ? void 0 : _d.debug(`[Electron BLE] unsubscribe after Protocol ${protocol} probe failed:`, error);
+            }
+            try {
+                yield ((_f = (_e = window.desktopApi) === null || _e === void 0 ? void 0 : _e.nobleBle) === null || _f === void 0 ? void 0 : _f.disconnect(uuid));
             }
             catch (error) {
-                (_e = this.Log) === null || _e === void 0 ? void 0 : _e.debug(`[Electron BLE] unsubscribe after Protocol ${protocol} probe failed:`, error);
+                (_g = this.Log) === null || _g === void 0 ? void 0 : _g.debug(`[Electron BLE] disconnect after Protocol ${protocol} probe failed:`, error);
             }
+            this.connectedDevices.delete(uuid);
             try {
-                yield ((_g = (_f = window.desktopApi) === null || _f === void 0 ? void 0 : _f.nobleBle) === null || _g === void 0 ? void 0 : _g.subscribe(uuid));
+                yield ((_j = (_h = window.desktopApi) === null || _h === void 0 ? void 0 : _h.nobleBle) === null || _j === void 0 ? void 0 : _j.connect(uuid));
+                this.connectedDevices.add(uuid);
+                yield ((_l = (_k = window.desktopApi) === null || _k === void 0 ? void 0 : _k.nobleBle) === null || _l === void 0 ? void 0 : _l.subscribe(uuid));
+                yield this.refreshBlePacketCapacity(uuid);
             }
             catch (error) {
-                (_h = this.Log) === null || _h === void 0 ? void 0 : _h.debug(`[Electron BLE] resubscribe after Protocol ${protocol} probe failed:`, error);
+                (_m = this.Log) === null || _m === void 0 ? void 0 : _m.debug(`[Electron BLE] reconnect after Protocol ${protocol} probe failed:`, error);
                 throw error;
             }
             const cleanup = this.createNotificationSubscription(uuid);
@@ -1080,12 +1166,12 @@ class ElectronBleTransport {
             }
             try {
                 this.deviceProtocol.set(uuid, 'V1');
-                yield this.callProtocolV1(uuid, 'Initialize', {}, { timeoutMs: PROTOCOL_PROBE_TIMEOUT_MS });
+                yield this.callProtocolV1(uuid, 'GetFeatures', {}, { timeoutMs: PROTOCOL_PROBE_TIMEOUT_MS });
                 return true;
             }
             catch (error) {
                 this.clearProbeProtocol(uuid, 'V1');
-                (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug('[Electron BLE] Protocol V1 Initialize probe failed:', error);
+                (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug('[Electron BLE] Protocol V1 GetFeatures probe failed:', error);
                 return false;
             }
         });
@@ -1115,57 +1201,70 @@ class ElectronBleTransport {
             return detected;
         });
     }
-    writeWithChunking(uuid, hexData) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const totalBytes = hexData.length / 2;
-            if (totalBytes <= BLE_PACKET_SIZE) {
-                yield hdShared.wait(BLE_WRITE_DELAY_MS);
-                yield this.writeWithRetry(uuid, hexData);
-                return;
-            }
-            for (let offset = 0; offset < hexData.length;) {
-                const chunkHexLen = Math.min(BLE_PACKET_SIZE * 2, hexData.length - offset);
-                const chunkHex = hexData.substring(offset, offset + chunkHexLen);
-                offset += chunkHexLen;
-                yield this.writeWithRetry(uuid, chunkHex);
-                if (offset < hexData.length) {
-                    yield hdShared.wait(BLE_WRITE_DELAY_MS);
-                }
-            }
-        });
-    }
-    writeWithRetry(uuid, hexData) {
-        var _a, _b, _c;
+    writeOnce(uuid, hexData) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
-            let lastError;
             const nobleBle = (_a = window.desktopApi) === null || _a === void 0 ? void 0 : _a.nobleBle;
             if (!nobleBle) {
                 throw new Error('Noble BLE API not available');
             }
-            for (let attempt = 1; attempt <= BLE_WRITE_MAX_RETRIES; attempt++) {
-                try {
-                    yield nobleBle.write(uuid, hexData);
-                    return;
-                }
-                catch (error) {
-                    lastError = error;
-                    (_b = this.Log) === null || _b === void 0 ? void 0 : _b.error(`[Electron BLE] write failed (attempt ${attempt}/${BLE_WRITE_MAX_RETRIES}):`, error);
-                    if (attempt < BLE_WRITE_MAX_RETRIES) {
-                        yield hdShared.wait(BLE_WRITE_RETRY_DELAY_MS);
-                    }
-                }
+            yield nobleBle.write(uuid, hexData, { pacingDelayMs: 0 });
+        });
+    }
+    refreshBlePacketCapacity(uuid) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const device = yield ((_b = (_a = window.desktopApi) === null || _a === void 0 ? void 0 : _a.nobleBle) === null || _b === void 0 ? void 0 : _b.getDevice(uuid));
+            this.updateBlePacketCapacity(uuid, device === null || device === void 0 ? void 0 : device.mtu);
+        });
+    }
+    updateBlePacketCapacity(uuid, mtu) {
+        const packetCapacity = resolveBlePacketCapacity(mtu, BLE_PACKET_SIZE_MAXIMUM, BLE_PACKET_SIZE_FALLBACK);
+        if (typeof mtu === 'number') {
+            this.deviceMtus.set(uuid, mtu);
+        }
+        else {
+            this.deviceMtus.delete(uuid);
+        }
+        this.devicePacketCapacities.set(uuid, packetCapacity);
+    }
+    createMtuSubscription(uuid) {
+        var _a, _b;
+        const onMtuChanged = (_b = (_a = window.desktopApi) === null || _a === void 0 ? void 0 : _a.nobleBle) === null || _b === void 0 ? void 0 : _b.onMtuChanged;
+        if (!onMtuChanged)
+            return undefined;
+        return onMtuChanged(device => {
+            if (device.id === uuid) {
+                this.updateBlePacketCapacity(uuid, device.mtu);
             }
-            throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleWriteCharacteristicError, `BLE write failed after ${BLE_WRITE_MAX_RETRIES} attempts: ${(_c = lastError === null || lastError === void 0 ? void 0 : lastError.message) !== null && _c !== void 0 ? _c : lastError}`);
+        });
+    }
+    writeProtocolV2Frame(uuid, frame, context, assertCurrentGeneration) {
+        var _a;
+        const packetCapacity = (_a = this.devicePacketCapacities.get(uuid)) !== null && _a !== void 0 ? _a : BLE_PACKET_SIZE_FALLBACK;
+        const shouldPace = !context.highThroughput;
+        return transport.writeProtocolV2BleFrame({
+            frame,
+            packetCapacity,
+            assertActive: assertCurrentGeneration,
+            signal: context.signal,
+            abortMessage: `Protocol V2 BLE write aborted for ${context.messageName}`,
+            initialDelayMs: shouldPace && frame.length <= packetCapacity ? BLE_WRITE_DELAY_MS : 0,
+            burstSize: shouldPace ? 1 : undefined,
+            burstPauseMs: shouldPace ? BLE_WRITE_DELAY_MS : 0,
+            writePacket: packet => this.writeOnce(uuid, transport.bytesToHex(packet)),
         });
     }
     handleNotification(deviceId, hexData) {
         var _a, _b;
         if (hexData === 'PAIRING_REJECTED') {
             (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug('[Electron BLE] Pairing rejection detected for device:', deviceId);
-            if (this.runPromise) {
-                const error = hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleDeviceBondedCanceled);
+            const error = hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleDeviceBondedCanceled);
+            if (this.deviceProtocol.get(deviceId) === 'V2') {
+                this.rejectProtocolV2Frames(deviceId, error);
+            }
+            else if (this.runPromise && this.runPromiseDeviceId === deviceId) {
                 this.runPromise.reject(error);
-                this.rejectAllProtocolV2Frames(error);
             }
             return;
         }
@@ -1181,13 +1280,8 @@ class ElectronBleTransport {
         this.handleProtocolV1Notification(deviceId, hexData);
     }
     handleProtocolV2Notification(deviceId, hexData) {
-        var _a, _b, _c;
+        var _a;
         try {
-            if (!this.runPromise || ((_a = this.activeProtocolV2Call) === null || _a === void 0 ? void 0 : _a.uuid) !== deviceId) {
-                (_b = this.v2Assemblers.get(deviceId)) === null || _b === void 0 ? void 0 : _b.reset();
-                this.resetProtocolV2Frames(deviceId);
-                return;
-            }
             const bytes = transport.hexToBytes(hexData);
             if (bytes.length === 0)
                 return;
@@ -1199,12 +1293,9 @@ class ElectronBleTransport {
             }
         }
         catch (error) {
-            (_c = this.Log) === null || _c === void 0 ? void 0 : _c.error('[Electron BLE] Protocol V2 notification error:', error);
-            if (this.runPromise) {
-                const notifyError = hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleWriteCharacteristicError);
-                this.runPromise.reject(notifyError);
-                this.rejectAllProtocolV2Frames(notifyError);
-            }
+            (_a = this.Log) === null || _a === void 0 ? void 0 : _a.error('[Electron BLE] Protocol V2 notification error:', error);
+            const notifyError = hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleWriteCharacteristicError);
+            this.rejectProtocolV2Frames(deviceId, notifyError);
         }
     }
     getProtocolV2FrameQueue(uuid) {
@@ -1224,20 +1315,16 @@ class ElectronBleTransport {
         }
         this.getProtocolV2FrameQueue(uuid).push(frame);
     }
-    rejectAllProtocolV2Frames(error) {
-        this.v2FrameQueues.clear();
-        for (const framePromise of this.v2FramePromises.values()) {
-            framePromise.reject(error);
-        }
-        this.v2FramePromises.clear();
-    }
     resetProtocolV2Frames(uuid) {
-        this.v2FrameQueues.delete(uuid);
-        this.v2FramePromises.delete(uuid);
+        this.rejectProtocolV2Frames(uuid, new Error(`Protocol V2 frame state reset for ${uuid}`));
     }
-    isActiveProtocolV2Call(uuid, token) {
-        var _a;
-        return ((_a = this.activeProtocolV2Call) === null || _a === void 0 ? void 0 : _a.uuid) === uuid && this.activeProtocolV2Call.token === token;
+    rejectProtocolV2Frames(uuid, error) {
+        this.v2FrameQueues.delete(uuid);
+        const framePromise = this.v2FramePromises.get(uuid);
+        if (framePromise) {
+            this.v2FramePromises.delete(uuid);
+            framePromise.reject(error);
+        }
     }
     readProtocolV2Frame(uuid) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -1262,17 +1349,20 @@ class ElectronBleTransport {
         const result = this.processProtocolV1Notification(deviceId, hexData);
         if (result.error) {
             (_a = this.Log) === null || _a === void 0 ? void 0 : _a.error('[Electron BLE] Protocol V1 packet processing error:', result.error);
-            if (this.runPromise) {
+            if (this.runPromise && this.runPromiseDeviceId === deviceId) {
                 this.runPromise.reject(hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleWriteCharacteristicError));
             }
             return;
         }
-        if (result.isComplete && result.completePacket && this.runPromise) {
+        if (result.isComplete &&
+            result.completePacket &&
+            this.runPromise &&
+            this.runPromiseDeviceId === deviceId) {
             this.runPromise.resolve(result.completePacket);
         }
     }
     call(uuid, name, data, options) {
-        var _a, _b;
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             if (!this._messages) {
                 throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.TransportNotConfigured);
@@ -1284,12 +1374,8 @@ class ElectronBleTransport {
             if (!protocol) {
                 throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, `Device protocol has not been detected for ${uuid}`);
             }
-            if (shouldSuppressHighVolumeCallLog(name)) ;
-            else if (isLogBlockCommand(name)) {
-                (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug('[Electron BLE] call', 'name:', name, 'protocol:', protocol);
-            }
-            else {
-                (_b = this.Log) === null || _b === void 0 ? void 0 : _b.debug('[Electron BLE] call', 'name:', name, 'data:', data, 'protocol:', protocol);
+            if (!transport.shouldSuppressHighVolumeCallLog(name)) {
+                (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug('transport call', transport.createTransportCallLog(name, protocol, data));
             }
             if (protocol === 'V2') {
                 return this.callProtocolV2(uuid, name, data, options);
@@ -1310,6 +1396,7 @@ class ElectronBleTransport {
             const runPromise = hdShared.createDeferred();
             runPromise.promise.catch(() => undefined);
             this.runPromise = runPromise;
+            this.runPromiseDeviceId = uuid;
             const messages = this._messages;
             const buffers = ProtocolV1.encodeTransportPackets(messages, name, data);
             let timeout;
@@ -1348,6 +1435,17 @@ class ElectronBleTransport {
             }
             catch (e) {
                 (_b = this.Log) === null || _b === void 0 ? void 0 : _b.error('[Electron BLE] Protocol V1 call error:', e);
+                const isProbeTimeout = name === 'GetFeatures' && (options === null || options === void 0 ? void 0 : options.timeoutMs) === PROTOCOL_PROBE_TIMEOUT_MS;
+                if ((e === null || e === void 0 ? void 0 : e.errorCode) === hdShared.HardwareErrorCode.BleTimeoutError) {
+                    this.v1Buffers.set(uuid, { buffer: [], bufferLength: 0 });
+                    const notifyCleanup = this.notificationCleanups.get(uuid);
+                    notifyCleanup === null || notifyCleanup === void 0 ? void 0 : notifyCleanup();
+                    this.notificationCleanups.delete(uuid);
+                    this.notificationTokens.delete(uuid);
+                    if (!isProbeTimeout) {
+                        yield this.releaseNative(uuid);
+                    }
+                }
                 throw e;
             }
             finally {
@@ -1355,82 +1453,66 @@ class ElectronBleTransport {
                     clearTimeout(timeout);
                 if (this.runPromise === runPromise) {
                     this.runPromise = null;
+                    this.runPromiseDeviceId = null;
                 }
             }
         });
     }
     callProtocolV2(uuid, name, data, options) {
-        var _a, _b, _c, _d, _e;
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             if (!this._messages || !this._messagesV2) {
                 throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.TransportNotConfigured);
             }
-            const forceRun = name === 'Initialize' || name === 'Cancel' || name === 'Ping';
-            if (this.runPromise) {
-                if (!forceRun) {
-                    throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.TransportCallInProgress);
-                }
-                const error = hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleForceCleanRunPromise);
-                this.runPromise.reject(error);
-                this.rejectAllProtocolV2Frames(error);
-                this.runPromise = null;
-                this.activeProtocolV2Call = null;
-            }
-            const runPromise = hdShared.createDeferred();
-            runPromise.promise.catch(() => undefined);
-            this.runPromise = runPromise;
-            const callToken = this.nextProtocolV2CallToken++;
-            this.activeProtocolV2Call = { uuid, token: callToken };
-            (_a = this.v2Assemblers.get(uuid)) === null || _a === void 0 ? void 0 : _a.reset();
-            this.resetProtocolV2Frames(uuid);
-            let completed = false;
-            const callOptions = Object.assign(Object.assign({}, options), { timeoutMs: (_b = options === null || options === void 0 ? void 0 : options.timeoutMs) !== null && _b !== void 0 ? _b : BLE_RESPONSE_TIMEOUT_MS });
+            const callOptions = options;
             try {
-                const session = new transport.ProtocolV2Session({
-                    schemas: {
-                        protocolV1: this._messages,
-                        protocolV2: this._messagesV2,
-                    },
-                    router: transport.PROTOCOL_V2_CHANNEL_BLE_UART,
-                    writeFrame: (frame) => this.writeWithChunking(uuid, transport.bytesToHex(frame)),
-                    readFrame: () => __awaiter(this, void 0, void 0, function* () {
-                        const rxFrame = yield this.readProtocolV2Frame(uuid);
-                        if (!(rxFrame instanceof Uint8Array)) {
-                            throw new Error('Response is not Uint8Array');
-                        }
-                        return rxFrame;
-                    }),
-                    logger: this.Log,
-                    logPrefix: 'ProtocolV2 BLE',
-                    createTimeoutError: (_messageName, timeout) => hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleTimeoutError, `BLE response timeout after ${timeout}ms for ${name}`),
-                });
-                const result = yield session.call(name, data, callOptions);
-                completed = true;
-                return result;
+                return yield this.protocolV2Links.call(uuid, () => this.createProtocolV2Adapter(uuid), name, data, callOptions);
             }
             catch (e) {
-                if (this.isActiveProtocolV2Call(uuid, callToken)) {
-                    (_c = this.v2Assemblers.get(uuid)) === null || _c === void 0 ? void 0 : _c.reset();
-                    this.resetProtocolV2Frames(uuid);
-                }
-                (_d = this.Log) === null || _d === void 0 ? void 0 : _d.error('[Electron BLE] Protocol V2 call error:', e);
+                (_a = this.Log) === null || _a === void 0 ? void 0 : _a.error('[Electron BLE] Protocol V2 call error:', e);
                 throw e;
             }
-            finally {
-                if (this.isActiveProtocolV2Call(uuid, callToken)) {
-                    if (!completed) {
-                        (_e = this.v2Assemblers.get(uuid)) === null || _e === void 0 ? void 0 : _e.reset();
-                    }
-                    this.resetProtocolV2Frames(uuid);
-                    this.activeProtocolV2Call = null;
-                }
-                if (this.runPromise === runPromise) {
-                    this.runPromise = null;
-                }
-            }
         });
     }
+    createProtocolV2Adapter(uuid) {
+        var _a;
+        const generation = (_a = this.notificationTokens.get(uuid)) !== null && _a !== void 0 ? _a : 0;
+        const assertCurrentGeneration = () => {
+            if (this.notificationTokens.get(uuid) !== generation) {
+                throw new Error(`Protocol V2 notification generation changed for ${uuid}`);
+            }
+        };
+        return {
+            router: transport.PROTOCOL_V2_CHANNEL_BLE_UART,
+            maxFrameBytes: transport.PROTOCOL_V2_BLE_FRAME_MAX_BYTES,
+            generation,
+            prepareCall: () => {
+                var _a;
+                assertCurrentGeneration();
+                (_a = this.v2Assemblers.get(uuid)) === null || _a === void 0 ? void 0 : _a.reset();
+                this.resetProtocolV2Frames(uuid);
+            },
+            writeFrame: (frame, context) => this.writeProtocolV2Frame(uuid, frame, context, assertCurrentGeneration),
+            readFrame: () => __awaiter(this, void 0, void 0, function* () {
+                assertCurrentGeneration();
+                const rxFrame = yield this.readProtocolV2Frame(uuid);
+                if (!(rxFrame instanceof Uint8Array)) {
+                    throw new Error('Response is not Uint8Array');
+                }
+                return rxFrame;
+            }),
+            reset: (reason) => {
+                var _a;
+                (_a = this.v2Assemblers.get(uuid)) === null || _a === void 0 ? void 0 : _a.reset();
+                this.rejectProtocolV2Frames(uuid, new Error(reason));
+            },
+            logger: this.Log,
+            logPrefix: 'ProtocolV2 BLE',
+            createTimeoutError: (messageName, timeout) => hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleTimeoutError, `BLE response timeout after ${timeout}ms for ${messageName}`),
+        };
+    }
     processProtocolV1Notification(deviceId, hexData) {
+        var _a;
         try {
             if (typeof hexData !== 'string') {
                 return { isComplete: false, error: 'Invalid hexData type' };
@@ -1449,6 +1531,10 @@ class ElectronBleTransport {
                 bufferState.buffer = [...data.subarray(3)];
             }
             else {
+                if (bufferState.buffer.length === 0) {
+                    (_a = this.Log) === null || _a === void 0 ? void 0 : _a.debug('[Electron BLE] Orphan continuation chunk discarded');
+                    return { isComplete: false };
+                }
                 bufferState.buffer = bufferState.buffer.concat([...data]);
             }
             if (bufferState.buffer.length - transport.PROTOCOL_V1_MESSAGE_HEADER_SIZE >= bufferState.bufferLength) {