@zlink-systems/stream-connector 0.25.0 → 0.27.0

package/dist/browser/index.global.js

@@ -43,6 +43,10 @@ var ZlinkStreamConnectorBundle = (() => {
   });
 
   // packages/stream-wire/src/lz4-pickle.ts
+  var LZ4_MIN_MATCH_LENGTH = 4;
+  var LZ4_MATCH_OFFSET_BYTES = 2;
+  var LZ4_EXTENDED_LENGTH_NIBBLE = 15;
+  var LZ4_EXTENDED_LENGTH_BYTE = 255;
   var defaultMaxDecompressedPayloadSize = 64 * 1024;
   function lz4PickleUncompressed(payload) {
     if (payload.length === 0) {
@@ -53,11 +57,7 @@ var ZlinkStreamConnectorBundle = (() => {
     pickled.set(payload, 1);
     return pickled;
   }
-  function lz4UnpicklePayload(payload, maxSize) {
-    const maxDecompressedSize = maxSize != null ? maxSize : defaultMaxDecompressedPayloadSize;
-    if (payload.length === 0) {
-      return new Uint8Array();
-    }
+  function readLz4Pickle(payload) {
     const header = payload[0];
     if ((header & 7) !== 0) {
       throw new Error("Unexpected LZ4 pickle version.");
@@ -69,7 +69,17 @@ var ZlinkStreamConnectorBundle = (() => {
     }
     const data = payload.subarray(dataOffset);
     const resultDiff = sizeOfDiff === 0 ? 0 : readLittleEndian(payload, 1, sizeOfDiff);
-    const resultLength = data.length + resultDiff;
+    return { data, resultDiff, resultLength: data.length + resultDiff };
+  }
+  function lz4PickledLength(payload) {
+    return payload.length === 0 ? 0 : readLz4Pickle(payload).resultLength;
+  }
+  function lz4UnpicklePayload(payload, maxSize) {
+    const maxDecompressedSize = maxSize != null ? maxSize : defaultMaxDecompressedPayloadSize;
+    if (payload.length === 0) {
+      return new Uint8Array();
+    }
+    const { data, resultDiff, resultLength } = readLz4Pickle(payload);
     if (resultLength > maxDecompressedSize) {
       throw new Error("LZ4 decoded payload exceeds maximum stream payload size.");
     }
@@ -112,15 +122,15 @@ var ZlinkStreamConnectorBundle = (() => {
       if (sourceOffset >= source.length) {
         break;
       }
-      if (source.length - sourceOffset < 2) {
+      if (source.length - sourceOffset < LZ4_MATCH_OFFSET_BYTES) {
         throw new Error("LZ4 match offset is incomplete.");
       }
       const matchOffset = source[sourceOffset] | source[sourceOffset + 1] << 8;
-      sourceOffset += 2;
+      sourceOffset += LZ4_MATCH_OFFSET_BYTES;
       if (matchOffset === 0 || matchOffset > targetOffset) {
         throw new Error("LZ4 match offset is invalid.");
       }
-      const matchLength = readLz4Length(source, token & 15, () => sourceOffset++) + 4;
+      const matchLength = readLz4Length(source, token & 15, () => sourceOffset++) + LZ4_MIN_MATCH_LENGTH;
       if (target.length - targetOffset < matchLength) {
         throw new Error("LZ4 match run exceeds output size.");
       }
@@ -136,7 +146,7 @@ var ZlinkStreamConnectorBundle = (() => {
   }
   function readLz4Length(source, nibble, nextOffset) {
     let length = nibble;
-    if (length !== 15) {
+    if (length !== LZ4_EXTENDED_LENGTH_NIBBLE) {
       return length;
     }
     for (; ; ) {
@@ -146,7 +156,7 @@ var ZlinkStreamConnectorBundle = (() => {
       }
       const value = source[offset];
       length += value;
-      if (value !== 255) {
+      if (value !== LZ4_EXTENDED_LENGTH_BYTE) {
         return length;
       }
     }
@@ -160,54 +170,200 @@ var ZlinkStreamConnectorBundle = (() => {
     ZlinkStreamCodec2[ZlinkStreamCodec2["Protobuf"] = 3] = "Protobuf";
     return ZlinkStreamCodec2;
   })(ZlinkStreamCodec || {});
+  var ZlinkStreamMessageKind = /* @__PURE__ */ ((ZlinkStreamMessageKind2) => {
+    ZlinkStreamMessageKind2[ZlinkStreamMessageKind2["Send"] = 1] = "Send";
+    ZlinkStreamMessageKind2[ZlinkStreamMessageKind2["Request"] = 2] = "Request";
+    ZlinkStreamMessageKind2[ZlinkStreamMessageKind2["Response"] = 3] = "Response";
+    ZlinkStreamMessageKind2[ZlinkStreamMessageKind2["Error"] = 4] = "Error";
+    ZlinkStreamMessageKind2[ZlinkStreamMessageKind2["Control"] = 5] = "Control";
+    return ZlinkStreamMessageKind2;
+  })(ZlinkStreamMessageKind || {});
+  var ZlinkStreamHeaderFlags = /* @__PURE__ */ ((ZlinkStreamHeaderFlags2) => {
+    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["None"] = 0] = "None";
+    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["HasRequestSeq"] = 1] = "HasRequestSeq";
+    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["HasMetadata"] = 2] = "HasMetadata";
+    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["PayloadCompressed"] = 4] = "PayloadCompressed";
+    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["HasCorrelationId"] = 8] = "HasCorrelationId";
+    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["HasFlowId"] = 16] = "HasFlowId";
+    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["HasActorSlot"] = 32] = "HasActorSlot";
+    return ZlinkStreamHeaderFlags2;
+  })(ZlinkStreamHeaderFlags || {});
+  var ZlinkStreamCloseReasonCode = /* @__PURE__ */ ((ZlinkStreamCloseReasonCode2) => {
+    ZlinkStreamCloseReasonCode2[ZlinkStreamCloseReasonCode2["ClientClose"] = 1] = "ClientClose";
+    ZlinkStreamCloseReasonCode2[ZlinkStreamCloseReasonCode2["IdleTimeout"] = 2] = "IdleTimeout";
+    ZlinkStreamCloseReasonCode2[ZlinkStreamCloseReasonCode2["HeartbeatTimeout"] = 3] = "HeartbeatTimeout";
+    ZlinkStreamCloseReasonCode2[ZlinkStreamCloseReasonCode2["ServerDrain"] = 4] = "ServerDrain";
+    ZlinkStreamCloseReasonCode2[ZlinkStreamCloseReasonCode2["ProtocolError"] = 5] = "ProtocolError";
+    ZlinkStreamCloseReasonCode2[ZlinkStreamCloseReasonCode2["TransportError"] = 6] = "TransportError";
+    return ZlinkStreamCloseReasonCode2;
+  })(ZlinkStreamCloseReasonCode || {});
+  var unicodeWhiteSpaceOnly = /^\p{White_Space}*$/u;
+  var validMessageKinds = new Set(
+    Object.values(ZlinkStreamMessageKind).filter((value) => typeof value === "number")
+  );
+  var validCodecs = new Set(
+    Object.values(ZlinkStreamCodec).filter((value) => typeof value === "number")
+  );
+  function isStreamWireMessageKind(value) {
+    return validMessageKinds.has(value);
+  }
+  function isStreamWireCodec(value) {
+    return validCodecs.has(value);
+  }
+  var UTF8_TWO_BYTE_MIN = 128;
+  var UTF8_THREE_BYTE_MIN = 2048;
+  var UTF16_HIGH_SURROGATE_MIN = 55296;
+  var UTF16_HIGH_SURROGATE_MAX = 56319;
+  var UTF16_LOW_SURROGATE_MIN = 56320;
+  var UTF16_LOW_SURROGATE_MAX = 57343;
+  var UINT8_MAX = 255;
+  var UINT16_MAX = 65535;
+  var UINT16_BYTES = 2;
+  var UINT32_BYTES = 4;
+  var UINT64_BYTES = 8;
+  var UINT64_MAX = 0xffffffffffffffffn;
+  var UINT32_MAX = 4294967295;
+  var ZLINK_STREAM_FRAME_PREFIX_BYTES = UINT16_BYTES + UINT32_BYTES;
+  var ZLINK_STREAM_MAX_PACKET_NAME_BYTES = UINT8_MAX;
+  var ZLINK_STREAM_MAX_METADATA_BYTES = 1024;
+  var FLOW_ID_BYTES = 36;
+  var FLOW_FIELDS_BYTES = FLOW_ID_BYTES + 1;
+  var HEADER_MIN_BYTES = 5;
+  var HEADER_FLAG_MASK = 1 /* HasRequestSeq */ | 2 /* HasMetadata */ | 4 /* PayloadCompressed */ | 8 /* HasCorrelationId */ | 16 /* HasFlowId */ | 32 /* HasActorSlot */;
+  var CONTROL_PAYLOAD_VERSION = 1;
+  var ACTOR_SLOT_OFFSET = 1;
+  var ACTOR_ID_LENGTH_OFFSET = ACTOR_SLOT_OFFSET + UINT16_BYTES;
+  var ACTOR_BOUND_PREFIX_BYTES = ACTOR_ID_LENGTH_OFFSET + 1;
+  var ACTOR_UNBOUND_BYTES = ACTOR_SLOT_OFFSET + UINT16_BYTES;
+  var CLOSING_DIAGNOSTIC_LENGTH_OFFSET = 2;
+  var CLOSING_PREFIX_BYTES = CLOSING_DIAGNOSTIC_LENGTH_OFFSET + UINT16_BYTES;
+  var MAX_CLOSING_DIAGNOSTIC_BYTES = 512;
+  function decodeStreamWireActorBoundPayload(payload) {
+    if (payload.length < ACTOR_BOUND_PREFIX_BYTES + 1 || payload[0] !== CONTROL_PAYLOAD_VERSION) {
+      throw new Error("Actor bound payload is invalid.");
+    }
+    const slot = readUInt16BE(payload, ACTOR_SLOT_OFFSET);
+    const idLength = payload[ACTOR_ID_LENGTH_OFFSET];
+    if (slot === 0 || idLength === 0 || payload.length !== ACTOR_BOUND_PREFIX_BYTES + idLength) {
+      throw new Error("Actor bound payload is invalid.");
+    }
+    try {
+      return { slot, actorId: decodeControlText(payload.subarray(ACTOR_BOUND_PREFIX_BYTES)) };
+    } catch (cause) {
+      throw new Error("Actor id is not valid UTF-8.", { cause });
+    }
+  }
+  function decodeStreamWireActorUnboundPayload(payload) {
+    if (payload.length !== ACTOR_UNBOUND_BYTES || payload[0] !== CONTROL_PAYLOAD_VERSION) {
+      throw new Error("Actor unbound payload is invalid.");
+    }
+    return readUInt16BE(payload, ACTOR_SLOT_OFFSET);
+  }
+  function decodeStreamWireSessionClosing(payload) {
+    if (payload.length < CLOSING_PREFIX_BYTES || payload[0] !== CONTROL_PAYLOAD_VERSION) {
+      throw new Error("Unsupported session-closing version.");
+    }
+    const closeReason = ZlinkStreamCloseReasonCode[payload[1]];
+    if (closeReason === void 0) throw new Error("Unknown session-closing reason.");
+    const length = readUInt16BE(payload, CLOSING_DIAGNOSTIC_LENGTH_OFFSET);
+    if (length > MAX_CLOSING_DIAGNOSTIC_BYTES || payload.length !== CLOSING_PREFIX_BYTES + length) {
+      throw new Error("Invalid session-closing diagnostic length.");
+    }
+    const diagnostic = length === 0 ? void 0 : decodeControlText(payload.subarray(CLOSING_PREFIX_BYTES));
+    return { closeReason, diagnostic };
+  }
+  function decodeControlText(value) {
+    return new TextDecoder("utf-8", { fatal: true }).decode(value);
+  }
+  function splitStreamWireFrames(chunk) {
+    if (chunk.length === 0) throw new Error("Stream frame prefix is incomplete.");
+    const frames = [];
+    let offset = 0;
+    while (offset < chunk.length) {
+      const remaining = chunk.length - offset;
+      if (remaining < ZLINK_STREAM_FRAME_PREFIX_BYTES) {
+        throw new Error("Stream frame prefix is incomplete.");
+      }
+      const headerLength = readUInt16BE(chunk, offset);
+      const payloadLength = readUInt32BE(chunk, offset + UINT16_BYTES);
+      const frameLength = ZLINK_STREAM_FRAME_PREFIX_BYTES + headerLength + payloadLength;
+      if (frameLength > remaining) throw new Error("Frame length does not match prefix.");
+      frames.push(chunk.subarray(offset, offset + frameLength));
+      offset += frameLength;
+    }
+    return frames;
+  }
+  var ZLINK_STREAM_RESERVED_PACKET_NAME_PREFIX = "$zlink.";
+  var ZlinkStreamControlPacket = Object.freeze({
+    HeartbeatPing: `${ZLINK_STREAM_RESERVED_PACKET_NAME_PREFIX}heartbeat.ping`,
+    HeartbeatPong: `${ZLINK_STREAM_RESERVED_PACKET_NAME_PREFIX}heartbeat.pong`,
+    ActorBound: `${ZLINK_STREAM_RESERVED_PACKET_NAME_PREFIX}actor.bound`,
+    ActorUnbound: `${ZLINK_STREAM_RESERVED_PACKET_NAME_PREFIX}actor.unbound`,
+    SessionClosing: "session-closing"
+  });
+  var ZlinkStreamContentType = Object.freeze({
+    Raw: "application/octet-stream",
+    Json: "application/json",
+    MessagePack: "application/x-msgpack",
+    Protobuf: "application/x-protobuf"
+  });
+  var contentTypesByCodec = /* @__PURE__ */ new Map([
+    [0 /* Raw */, ZlinkStreamContentType.Raw],
+    [1 /* Json */, ZlinkStreamContentType.Json],
+    [2 /* MessagePack */, ZlinkStreamContentType.MessagePack],
+    [3 /* Protobuf */, ZlinkStreamContentType.Protobuf]
+  ]);
+  var codecsByContentType = new Map(
+    Array.from(contentTypesByCodec, ([codec, contentType]) => [contentType, codec])
+  );
   var defaultHeaderFlags = {
-    hasRequestSeq: 1,
-    hasMetadata: 2,
-    hasCorrelationId: 8,
-    hasFlowId: 16,
-    hasActorSlot: 32
+    hasRequestSeq: 1 /* HasRequestSeq */,
+    hasMetadata: 2 /* HasMetadata */,
+    hasCorrelationId: 8 /* HasCorrelationId */,
+    hasFlowId: 16 /* HasFlowId */,
+    hasActorSlot: 32 /* HasActorSlot */
   };
   var ZLINK_STREAM_FORMAT_MARKER = 242;
-  var ZLINK_STREAM_RESPONSE_KIND = 3;
-  var ZLINK_STREAM_ERROR_KIND = 4;
   function encodeStreamWireFrame(header, payload) {
-    if (header.length > 65535) {
+    if (header.length > UINT16_MAX) {
       throw new Error("Stream header is too large.");
     }
-    if (payload.length > 4294967295) {
+    if (payload.length > UINT32_MAX) {
       throw new Error("Stream payload is too large.");
     }
-    const frame = new Uint8Array(6 + header.length + payload.length);
+    const frame = new Uint8Array(ZLINK_STREAM_FRAME_PREFIX_BYTES + header.length + payload.length);
     writeUInt16BE(frame, 0, header.length);
-    writeUInt32BE(frame, 2, payload.length);
-    frame.set(header, 6);
-    frame.set(payload, 6 + header.length);
+    writeUInt32BE(frame, UINT16_BYTES, payload.length);
+    frame.set(header, ZLINK_STREAM_FRAME_PREFIX_BYTES);
+    frame.set(payload, ZLINK_STREAM_FRAME_PREFIX_BYTES + header.length);
     return frame;
   }
   function decodeStreamWireFrame(frame) {
-    if (frame.length < 6) {
+    if (frame.length < ZLINK_STREAM_FRAME_PREFIX_BYTES) {
       throw new Error("Stream frame prefix is incomplete.");
     }
     const headerLength = readUInt16BE(frame, 0);
-    const payloadLength = readUInt32BE(frame, 2);
-    if (frame.length !== 6 + headerLength + payloadLength) {
+    const payloadLength = readUInt32BE(frame, UINT16_BYTES);
+    if (frame.length !== ZLINK_STREAM_FRAME_PREFIX_BYTES + headerLength + payloadLength) {
       throw new Error("Stream frame length does not match prefix.");
     }
     return {
-      header: frame.slice(6, 6 + headerLength),
-      payload: frame.slice(6 + headerLength)
+      header: frame.slice(
+        ZLINK_STREAM_FRAME_PREFIX_BYTES,
+        ZLINK_STREAM_FRAME_PREFIX_BYTES + headerLength
+      ),
+      payload: frame.slice(ZLINK_STREAM_FRAME_PREFIX_BYTES + headerLength)
     };
   }
   function encodeStreamWireHeader(header, flagOverrides) {
     const flags = flagOverrides != null ? flagOverrides : defaultHeaderFlags;
     const reply = isReplyKind(header.kind);
     const packetName = reply ? "" : header.name;
-    if (!reply) validateStreamWirePacketName(packetName);
-    const nameBytes = utf8Encode(packetName);
+    const nameBytes = reply ? new Uint8Array() : validateStreamWirePacketName(packetName);
     const hasRequestSeq = header.requestSeq !== void 0;
     const hasMetadata = header.metadata.size > 0;
     const correlationBytes = header.correlationId !== void 0 && header.correlationId.length > 0 ? utf8Encode(header.correlationId) : void 0;
-    if (correlationBytes !== void 0 && correlationBytes.length > 255) {
+    if (correlationBytes !== void 0 && correlationBytes.length > UINT8_MAX) {
       throw new Error("Stream correlation id is too large.");
     }
     const hasCorrelation = correlationBytes !== void 0;
@@ -220,7 +376,7 @@ var ZlinkStreamConnectorBundle = (() => {
     if (header.flowOrigin !== void 0 && ![1, 2, 3, 4].includes(header.flowOrigin)) {
       throw new Error("Stream flow origin is invalid.");
     }
-    if (header.actorSlot !== void 0 && (!Number.isInteger(header.actorSlot) || header.actorSlot < 1 || header.actorSlot > 65535)) {
+    if (header.actorSlot !== void 0 && (!Number.isInteger(header.actorSlot) || header.actorSlot < 1 || header.actorSlot > UINT16_MAX)) {
       throw new Error("Stream actor slot is invalid.");
     }
     let headerFlags = header.flags;
@@ -230,7 +386,7 @@ var ZlinkStreamConnectorBundle = (() => {
     headerFlags = hasFlow ? headerFlags | flags.hasFlowId : headerFlags & ~flags.hasFlowId;
     headerFlags = hasActorSlot ? headerFlags | flags.hasActorSlot : headerFlags & ~flags.hasActorSlot;
     const metadataBytes = hasMetadata ? encodeStreamWireMetadata(header.metadata) : new Uint8Array();
-    const size = 4 + (hasRequestSeq ? 8 : 0) + 1 + nameBytes.length + (hasMetadata ? 2 + metadataBytes.length : 0) + (hasCorrelation ? 1 + correlationBytes.length : 0) + (hasFlow ? 37 : 0) + (hasActorSlot ? 2 : 0);
+    const size = 4 + (hasRequestSeq ? UINT64_BYTES : 0) + 1 + nameBytes.length + (hasMetadata ? UINT16_BYTES + metadataBytes.length : 0) + (hasCorrelation ? 1 + correlationBytes.length : 0) + (hasFlow ? FLOW_FIELDS_BYTES : 0) + (hasActorSlot ? UINT16_BYTES : 0);
     const buffer = new Uint8Array(size);
     let offset = 0;
     buffer[offset++] = ZLINK_STREAM_FORMAT_MARKER;
@@ -242,14 +398,14 @@ var ZlinkStreamConnectorBundle = (() => {
         throw new Error("Request sequence must not be zero.");
       }
       writeBigUInt64BE(buffer, offset, header.requestSeq);
-      offset += 8;
+      offset += UINT64_BYTES;
     }
     buffer[offset++] = nameBytes.length;
     buffer.set(nameBytes, offset);
     offset += nameBytes.length;
     if (hasMetadata) {
       writeUInt16BE(buffer, offset, metadataBytes.length);
-      offset += 2;
+      offset += UINT16_BYTES;
       buffer.set(metadataBytes, offset);
       offset += metadataBytes.length;
     }
@@ -260,7 +416,7 @@ var ZlinkStreamConnectorBundle = (() => {
     }
     if (hasFlow) {
       buffer.set(asciiEncode(header.flowId), offset);
-      offset += 36;
+      offset += FLOW_ID_BYTES;
       buffer[offset++] = header.flowOrigin;
     }
     if (hasActorSlot) {
@@ -271,7 +427,7 @@ var ZlinkStreamConnectorBundle = (() => {
   function decodeStreamWireHeader(header, flagOverrides, includeFlow = true) {
     const flags = flagOverrides != null ? flagOverrides : defaultHeaderFlags;
     let offset = 0;
-    if (header.length < 5) {
+    if (header.length < HEADER_MIN_BYTES) {
       throw new Error("Stream header is incomplete.");
     }
     if (header[offset++] !== ZLINK_STREAM_FORMAT_MARKER) {
@@ -285,29 +441,28 @@ var ZlinkStreamConnectorBundle = (() => {
     const hasCorrelation = (headerFlags & flags.hasCorrelationId) !== 0;
     const hasFlow = (headerFlags & flags.hasFlowId) !== 0;
     const hasActorSlot = (headerFlags & flags.hasActorSlot) !== 0;
-    if ((headerFlags & ~63) !== 0) {
+    if ((headerFlags & ~HEADER_FLAG_MASK) !== 0) {
       throw new Error("Unknown mandatory stream header flag.");
     }
     let requestSeq;
     if (hasRequestSeq) {
-      if (header.length - offset < 8) {
+      if (header.length - offset < UINT64_BYTES) {
         throw new Error("Stream request sequence is incomplete.");
       }
       requestSeq = readBigUInt64BE(header, offset);
       if (requestSeq === 0n) {
         throw new Error("Request sequence must not be zero.");
       }
-      offset += 8;
+      offset += UINT64_BYTES;
     }
     if (header.length - offset < 1) {
       throw new Error("Stream packet name length is missing.");
     }
     const nameLength = header[offset++];
-    if (!isReplyKind(kind) && nameLength === 0 || header.length - offset < nameLength) {
+    if ((isReplyKind(kind) ? nameLength !== 0 : nameLength === 0) || header.length - offset < nameLength) {
       throw new Error("Stream packet name is invalid.");
     }
-    const decodedName = utf8Decode(header.subarray(offset, offset + nameLength));
-    const name = isReplyKind(kind) ? "" : decodedName;
+    const name = utf8Decode(header.subarray(offset, offset + nameLength));
     offset += nameLength;
     const decodedMetadata = hasMetadata ? decodeStreamWireHeaderMetadata(header, offset) : { metadata: /* @__PURE__ */ new Map(), offset };
     offset = decodedMetadata.offset;
@@ -326,14 +481,14 @@ var ZlinkStreamConnectorBundle = (() => {
     let flowId;
     let flowOrigin;
     if (hasFlow) {
-      if (header.length - offset < 37) {
+      if (header.length - offset < FLOW_FIELDS_BYTES) {
         throw new Error("Stream flow fields are incomplete.");
       }
       if (includeFlow) {
-        flowId = asciiDecode(header.subarray(offset, offset + 36));
+        flowId = asciiDecode(header.subarray(offset, offset + FLOW_ID_BYTES));
         validateFlowId(flowId);
       }
-      offset += 36;
+      offset += FLOW_ID_BYTES;
       const decodedFlowOrigin = header[offset++];
       if (includeFlow && ![1, 2, 3, 4].includes(decodedFlowOrigin)) {
         throw new Error("Stream flow origin is invalid.");
@@ -342,14 +497,14 @@ var ZlinkStreamConnectorBundle = (() => {
     }
     let actorSlot;
     if (hasActorSlot) {
-      if (header.length - offset < 2) {
+      if (header.length - offset < UINT16_BYTES) {
         throw new Error("Stream actor slot is incomplete.");
       }
       actorSlot = readUInt16BE(header, offset);
       if (actorSlot === 0) {
         throw new Error("Stream actor slot must not be zero.");
       }
-      offset += 2;
+      offset += UINT16_BYTES;
     }
     if (offset !== header.length) {
       throw new Error("Stream header has trailing bytes.");
@@ -379,47 +534,47 @@ var ZlinkStreamConnectorBundle = (() => {
     if (value.some((byte) => byte > 127)) throw new Error("Stream flow id must be ASCII.");
     return String.fromCharCode(...value);
   }
-  function encodeStreamWireMetadata(metadata) {
-    if (metadata.size > 255) {
+  function streamWireMetadataSize(metadata) {
+    if (metadata.size > UINT8_MAX) {
       throw new Error("Metadata entry count must not exceed 255.");
     }
     let size = 1;
-    const encoded = [...metadata].map(([key, value]) => {
-      const keyBytes = utf8Encode(key);
-      const valueBytes = utf8Encode(value);
-      if (keyBytes.length === 0 || keyBytes.length > 255) {
+    for (const [key, value] of metadata) {
+      const keySize = utf8Size(key);
+      const valueSize = utf8Size(value);
+      if (keySize === 0 || keySize > UINT8_MAX) {
         throw new Error("Metadata key length is invalid.");
       }
-      if (valueBytes.length > 65535) {
+      if (valueSize > UINT16_MAX) {
         throw new Error("Metadata value is too large.");
       }
-      size += 1 + keyBytes.length + 2 + valueBytes.length;
-      return { keyBytes, valueBytes };
-    });
-    const buffer = new Uint8Array(size);
+      size += 1 + keySize + UINT16_BYTES + valueSize;
+    }
+    return size;
+  }
+  function encodeStreamWireMetadata(metadata) {
+    const buffer = new Uint8Array(streamWireMetadataSize(metadata));
     let offset = 0;
     buffer[offset++] = metadata.size;
-    for (const { keyBytes, valueBytes } of encoded) {
+    for (const [key, value] of metadata) {
+      const keyBytes = utf8Encode(key);
+      const valueBytes = utf8Encode(value);
       buffer[offset++] = keyBytes.length;
       buffer.set(keyBytes, offset);
       offset += keyBytes.length;
       writeUInt16BE(buffer, offset, valueBytes.length);
-      offset += 2;
+      offset += UINT16_BYTES;
       buffer.set(valueBytes, offset);
       offset += valueBytes.length;
     }
     return buffer;
   }
-  function decodeStreamWireMetadata(metadata) {
-    const decoded = decodeStreamWireMetadataAt(metadata, 0, metadata.length);
-    if (decoded.offset !== metadata.length) {
-      throw new Error("Stream metadata payload has trailing bytes.");
-    }
-    return decoded.metadata;
-  }
   function lz4PickleUncompressed2(payload) {
     return lz4PickleUncompressed(payload);
   }
+  function lz4PickledLength2(payload) {
+    return lz4PickledLength(payload);
+  }
   function lz4UnpicklePayload2(payload, maxDecompressedSize) {
     return lz4UnpicklePayload(payload, maxDecompressedSize != null ? maxDecompressedSize : defaultMaxDecompressedPayloadSize);
   }
@@ -430,11 +585,11 @@ var ZlinkStreamConnectorBundle = (() => {
     return new TextDecoder().decode(value);
   }
   function decodeStreamWireHeaderMetadata(header, offset) {
-    if (header.length - offset < 2) {
+    if (header.length - offset < UINT16_BYTES) {
       throw new Error("Stream metadata section is incomplete.");
     }
     const metadataLength = readUInt16BE(header, offset);
-    offset += 2;
+    offset += UINT16_BYTES;
     if (header.length - offset < metadataLength) {
       throw new Error("Stream metadata payload is incomplete.");
     }
@@ -460,7 +615,7 @@ var ZlinkStreamConnectorBundle = (() => {
         throw new Error("Stream metadata value length is missing.");
       }
       const valueLength = readUInt16BE(source, offset);
-      offset += 2;
+      offset += UINT16_BYTES;
       if (end - offset < valueLength) {
         throw new Error("Stream metadata value is incomplete.");
       }
@@ -477,16 +632,17 @@ var ZlinkStreamConnectorBundle = (() => {
   }
   function validateStreamWirePacketName(name) {
     const nameBytes = utf8Encode(name);
-    if (name.trim().length === 0 || nameBytes.length > 255) {
+    if (unicodeWhiteSpaceOnly.test(name) || nameBytes.length > ZLINK_STREAM_MAX_PACKET_NAME_BYTES) {
       throw new Error("Stream packet name is invalid.");
     }
+    return nameBytes;
   }
   function isReplyKind(kind) {
-    return kind === ZLINK_STREAM_RESPONSE_KIND || kind === ZLINK_STREAM_ERROR_KIND;
+    return kind === 3 /* Response */ || kind === 4 /* Error */;
   }
   function writeUInt16BE(buffer, offset, value) {
-    buffer[offset] = value >>> 8 & 255;
-    buffer[offset + 1] = value & 255;
+    buffer[offset] = value >>> 8 & UINT8_MAX;
+    buffer[offset + 1] = value & UINT8_MAX;
   }
   function readUInt16BE(buffer, offset) {
     return buffer[offset] << 8 | buffer[offset + 1];
@@ -495,10 +651,10 @@ var ZlinkStreamConnectorBundle = (() => {
     return buffer[offset] * 16777216 + (buffer[offset + 1] << 16 | buffer[offset + 2] << 8 | buffer[offset + 3]);
   }
   function writeUInt32BE(buffer, offset, value) {
-    buffer[offset] = value >>> 24 & 255;
-    buffer[offset + 1] = value >>> 16 & 255;
-    buffer[offset + 2] = value >>> 8 & 255;
-    buffer[offset + 3] = value & 255;
+    buffer[offset] = value >>> 24 & UINT8_MAX;
+    buffer[offset + 1] = value >>> 16 & UINT8_MAX;
+    buffer[offset + 2] = value >>> 8 & UINT8_MAX;
+    buffer[offset + 3] = value & UINT8_MAX;
   }
   function writeBigUInt64BE(buffer, offset, value) {
     for (let index = 7; index >= 0; index -= 1) {
@@ -513,6 +669,19 @@ var ZlinkStreamConnectorBundle = (() => {
     }
     return value;
   }
+  function utf8Size(value) {
+    let size = 0;
+    for (let index = 0; index < value.length; index += 1) {
+      const code = value.charCodeAt(index);
+      if (code < UTF8_TWO_BYTE_MIN) size += 1;
+      else if (code < UTF8_THREE_BYTE_MIN) size += 2;
+      else if (code >= UTF16_HIGH_SURROGATE_MIN && code <= UTF16_HIGH_SURROGATE_MAX && index + 1 < value.length && value.charCodeAt(index + 1) >= UTF16_LOW_SURROGATE_MIN && value.charCodeAt(index + 1) <= UTF16_LOW_SURROGATE_MAX) {
+        size += 4;
+        index += 1;
+      } else size += 3;
+    }
+    return size;
+  }
 
   // packages/stream-connector/src/Contracts/ZlinkStreamEnums.ts
   var ZlinkStreamTransport = /* @__PURE__ */ ((ZlinkStreamTransport2) => {
@@ -530,24 +699,6 @@ var ZlinkStreamConnectorBundle = (() => {
     ZlinkStreamDispatchMode2["Immediate"] = "immediate";
     return ZlinkStreamDispatchMode2;
   })(ZlinkStreamDispatchMode || {});
-  var ZlinkStreamMessageKind = /* @__PURE__ */ ((ZlinkStreamMessageKind2) => {
-    ZlinkStreamMessageKind2[ZlinkStreamMessageKind2["Send"] = 1] = "Send";
-    ZlinkStreamMessageKind2[ZlinkStreamMessageKind2["Request"] = 2] = "Request";
-    ZlinkStreamMessageKind2[ZlinkStreamMessageKind2["Response"] = 3] = "Response";
-    ZlinkStreamMessageKind2[ZlinkStreamMessageKind2["Error"] = 4] = "Error";
-    ZlinkStreamMessageKind2[ZlinkStreamMessageKind2["Control"] = 5] = "Control";
-    return ZlinkStreamMessageKind2;
-  })(ZlinkStreamMessageKind || {});
-  var ZlinkStreamHeaderFlags = /* @__PURE__ */ ((ZlinkStreamHeaderFlags2) => {
-    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["None"] = 0] = "None";
-    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["HasRequestSeq"] = 1] = "HasRequestSeq";
-    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["HasMetadata"] = 2] = "HasMetadata";
-    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["PayloadCompressed"] = 4] = "PayloadCompressed";
-    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["HasCorrelationId"] = 8] = "HasCorrelationId";
-    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["HasFlowId"] = 16] = "HasFlowId";
-    ZlinkStreamHeaderFlags2[ZlinkStreamHeaderFlags2["HasActorSlot"] = 32] = "HasActorSlot";
-    return ZlinkStreamHeaderFlags2;
-  })(ZlinkStreamHeaderFlags || {});
   var ZlinkStreamErrorCode = /* @__PURE__ */ ((ZlinkStreamErrorCode2) => {
     ZlinkStreamErrorCode2["Disconnected"] = "disconnected";
     ZlinkStreamErrorCode2["ConfigurationError"] = "configurationError";
@@ -559,6 +710,7 @@ var ZlinkStreamConnectorBundle = (() => {
     ZlinkStreamErrorCode2["SendFailed"] = "sendFailed";
     ZlinkStreamErrorCode2["CompressionFailed"] = "compressionFailed";
     ZlinkStreamErrorCode2["DecompressionFailed"] = "decompressionFailed";
+    ZlinkStreamErrorCode2["TlsValidationFailed"] = "tlsValidationFailed";
     ZlinkStreamErrorCode2["UserCallbackFailed"] = "userCallbackFailed";
     ZlinkStreamErrorCode2["RemoteError"] = "remoteError";
     return ZlinkStreamErrorCode2;
@@ -573,6 +725,15 @@ var ZlinkStreamConnectorBundle = (() => {
     return ZlinkStreamConnectionState3;
   })(ZlinkStreamConnectionState || {});
 
+  // packages/stream-connector/src/Contracts/ZlinkStreamModels.ts
+  var ZlinkStreamException = class extends Error {
+    constructor(error) {
+      super(error.message);
+      this.error = error;
+      this.name = "ZlinkStreamException";
+    }
+  };
+
   // packages/stream-connector/src/Contracts/ZlinkStreamMetadata.ts
   var _ZlinkStreamMetadataMap = class _ZlinkStreamMetadataMap {
     constructor(values) {
@@ -606,25 +767,13 @@ var ZlinkStreamConnectorBundle = (() => {
   var ZlinkStreamMetadataMap = _ZlinkStreamMetadataMap;
   function validateMetadataKey(key) {
     if (key.length === 0) {
-      throw new Error("Metadata key must not be empty.");
-    }
-    for (let index = 0; index < key.length; index++) {
-      const code = key.charCodeAt(index);
-      if (code < 32 || code > 126 || key[index] === "=") {
-        throw new Error('Metadata key must contain printable ASCII characters except "=".');
-      }
+      throw new ZlinkStreamException({
+        code: "validationFailed" /* ValidationFailed */,
+        message: "Metadata key must not be empty."
+      });
     }
   }
 
-  // packages/stream-connector/src/Contracts/ZlinkStreamModels.ts
-  var ZlinkStreamException = class extends Error {
-    constructor(error) {
-      super(error.message);
-      this.error = error;
-      this.name = "ZlinkStreamException";
-    }
-  };
-
   // packages/stream-connector/src/Contracts/ZlinkStreamJsonCodec.ts
   var zlinkStreamJsonCodecName = "json";
   var codecOptions = {};
@@ -677,6 +826,10 @@ var ZlinkStreamConnectorBundle = (() => {
   }
 
   // packages/stream-connector/src/Runtime/ZlinkStreamSupport.ts
+  var BACKING_ARRAY_COMPACTION_MIN_HEAD = 1024;
+  function shouldCompactBackingArray(head, length) {
+    return head >= BACKING_ARRAY_COMPACTION_MIN_HEAD && head * 2 >= length;
+  }
   function connectorError(code, message, cause) {
     return new ZlinkStreamException({ code, message, cause });
   }
@@ -690,15 +843,21 @@ var ZlinkStreamConnectorBundle = (() => {
     if (error instanceof ZlinkStreamException) {
       return error.error;
     }
-    return {
-      code: "remoteError" /* RemoteError */,
-      message: error instanceof Error ? error.message : String(error),
-      cause: error
-    };
+    throw error;
   }
   function subscription(dispose) {
     return { dispose };
   }
+  function* currentRegistrations(registrations, snapshot = Array.from(registrations)) {
+    for (const registration of snapshot) {
+      if (registrations.has(registration)) yield registration;
+    }
+  }
+  function registerHandler(handlers, handler) {
+    const registration = { handler };
+    handlers.add(registration);
+    return subscription(() => handlers.delete(registration));
+  }
   function throwIfAborted(signal) {
     if ((signal == null ? void 0 : signal.aborted) === true) {
       throw connectorError("disconnected" /* Disconnected */, "Operation canceled.");
@@ -718,9 +877,6 @@ var ZlinkStreamConnectorBundle = (() => {
       signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
     });
   }
-  function utf8Encode2(value) {
-    return new TextEncoder().encode(value);
-  }
   function utf8Decode2(value) {
     return new TextDecoder().decode(value);
   }
@@ -739,59 +895,48 @@ var ZlinkStreamConnectorBundle = (() => {
       }
     },
     async expectFailure(action, errorKind) {
-      let failure;
       try {
         await action();
-      } catch (error) {
-        failure = error;
-      }
-      if (failure === void 0) {
-        throw connectorError("validationFailed" /* ValidationFailed */, "Expected action to fail.");
-      }
-      const streamError = unwrapStreamError(failure);
-      if (errorKind !== void 0 && streamError.code !== errorKind) {
-        throw connectorError(
-          "validationFailed" /* ValidationFailed */,
-          `Expected failure kind '${errorKind}', got '${streamError.code}'.`,
-          failure
-        );
+      } catch (failure) {
+        if (!(failure instanceof ZlinkStreamException)) throw failure;
+        const streamError = failure.error;
+        if (errorKind !== void 0 && streamError.code !== errorKind) {
+          throw connectorError(
+            "validationFailed" /* ValidationFailed */,
+            `Expected failure kind '${errorKind}', got '${streamError.code}'.`,
+            failure
+          );
+        }
+        return streamError;
       }
-      return streamError;
+      throw connectorError("validationFailed" /* ValidationFailed */, "Expected action to fail.");
     },
     async expectTimeout(action) {
-      let failure;
       try {
         await action();
-      } catch (error) {
-        failure = error;
-      }
-      if (failure === void 0) {
-        throw connectorError("validationFailed" /* ValidationFailed */, "Expected action to time out.");
-      }
-      const code = unwrapStreamError(failure).code;
-      if (code !== "requestTimeout" /* RequestTimeout */ && code !== "connectTimeout" /* ConnectTimeout */) {
-        throw failure;
+      } catch (failure) {
+        if (!(failure instanceof ZlinkStreamException) || failure.error.code !== "requestTimeout" /* RequestTimeout */ && failure.error.code !== "connectTimeout" /* ConnectTimeout */) {
+          throw failure;
+        }
+        return;
       }
+      throw connectorError("validationFailed" /* ValidationFailed */, "Expected action to time out.");
     }
   };
 
   // packages/stream-connector/src/Runtime/Protocol/ZlinkStreamPacketNameValidator.ts
   function validateName(name, allowReserved = false) {
-    if (name.length === 0) {
-      throw connectorError("validationFailed" /* ValidationFailed */, "Message name must not be empty.");
+    try {
+      validateStreamWirePacketName(name);
+    } catch (cause) {
+      throw connectorError("validationFailed" /* ValidationFailed */, "Message name is invalid.", cause);
     }
-    if (!allowReserved && name.startsWith("$zlink.")) {
+    if (!allowReserved && name.startsWith(ZLINK_STREAM_RESERVED_PACKET_NAME_PREFIX)) {
       throw connectorError(
         "validationFailed" /* ValidationFailed */,
         "Message name uses a reserved zlink prefix."
       );
     }
-    if (utf8Encode2(name).length > 255) {
-      throw connectorError(
-        "validationFailed" /* ValidationFailed */,
-        "Message name must not exceed 255 UTF-8 bytes."
-      );
-    }
   }
 
   // packages/stream-connector/src/Runtime/Calls/ZlinkStreamCallBuilders.ts
@@ -864,9 +1009,10 @@ var ZlinkStreamConnectorBundle = (() => {
     }
   };
   var ZlinkStreamRequestBuilder = class {
-    constructor(connector, name, payload, actorSlot, validateActor) {
+    constructor(connector, name, payload, enqueueCallback, actorSlot, validateActor) {
       this.connector = connector;
       this.payload = payload;
+      this.enqueueCallback = enqueueCallback;
       __publicField(this, "state");
       this.state = new ZlinkStreamCallBuilderState(name, actorSlot, validateActor);
     }
@@ -901,8 +1047,10 @@ var ZlinkStreamConnectorBundle = (() => {
       );
       if (typeof signalOrCallback === "function") {
         operation.then(
-          (value) => signalOrCallback({ isSuccess: true, value }),
-          (error) => signalOrCallback({ isSuccess: false, error: unwrapStreamError(error) })
+          (value) => this.enqueueCallback(() => signalOrCallback({ isSuccess: true, value })),
+          (error) => this.enqueueCallback(
+            () => signalOrCallback({ isSuccess: false, error: unwrapStreamError(error) })
+          )
         );
         return;
       }
@@ -1113,6 +1261,12 @@ var ZlinkStreamConnectorBundle = (() => {
       return lz4PickleUncompressed2(payload);
     },
     decompress(payload, maxDecompressedSize) {
+      if (lz4PickledLength2(payload) > maxDecompressedSize) {
+        throw connectorError(
+          "frameTooLarge" /* FrameTooLarge */,
+          "LZ4 decoded payload exceeds MaxReceivePayloadSize."
+        );
+      }
       return lz4UnpicklePayload2(payload, maxDecompressedSize);
     }
   };
@@ -1124,7 +1278,11 @@ var ZlinkStreamConnectorBundle = (() => {
         "Compression codec is not configured."
       );
     }
-    return codec.compress(payload);
+    try {
+      return codec.compress(payload);
+    } catch (cause) {
+      throw connectorError("compressionFailed" /* CompressionFailed */, "Compression failed.", cause);
+    }
   }
   function decompressIfNeeded(header, payload, compression, compressionCodec, maxDecompressedSize) {
     if ((header.flags & 4 /* PayloadCompressed */) === 0) {
@@ -1137,15 +1295,20 @@ var ZlinkStreamConnectorBundle = (() => {
         "Compression codec is not configured."
       );
     }
+    let decompressed;
     try {
-      const decompressed = codec.decompress(payload, maxDecompressedSize);
-      if (decompressed.length > maxDecompressedSize) {
-        throw new Error("Decoded payload exceeds MaxReceivePayloadSize.");
-      }
-      return decompressed;
+      decompressed = codec.decompress(payload, maxDecompressedSize);
     } catch (cause) {
+      if (cause instanceof ZlinkStreamException) throw cause;
       throw connectorError("decompressionFailed" /* DecompressionFailed */, "Decompression failed.", cause);
     }
+    if (decompressed.length > maxDecompressedSize) {
+      throw connectorError(
+        "frameTooLarge" /* FrameTooLarge */,
+        "Decompressed payload exceeds MaxReceivePayloadSize."
+      );
+    }
+    return decompressed;
   }
   function resolveCompressionCodec(compression, compressionCodec) {
     if (compression === "none" /* None */) {
@@ -1154,9 +1317,165 @@ var ZlinkStreamConnectorBundle = (() => {
     return compressionCodec != null ? compressionCodec : zlinkStreamLz4CompressionCodec;
   }
 
+  // packages/stream-connector/src/Contracts/ZlinkStreamConnectorOptions.ts
+  var ZLINK_STREAM_DEFAULT_PAYLOAD_BYTES = 64 * 1024;
+
+  // packages/stream-connector/src/Runtime/Transport/ZlinkStreamEndpoint.ts
+  function inferTransport(endpoint) {
+    const url = parseEndpoint(endpoint);
+    switch (url.protocol) {
+      case "ws:":
+        return "webSocket" /* WebSocket */;
+      case "wss:":
+        return "webSocketSecure" /* WebSocketSecure */;
+      default:
+        throw connectorError(
+          "configurationError" /* ConfigurationError */,
+          "The TypeScript Stream Connector supports only ws:// and wss:// endpoints."
+        );
+    }
+  }
+  function parseEndpoint(endpoint) {
+    try {
+      return new URL(endpoint);
+    } catch (cause) {
+      throw connectorError("configurationError" /* ConfigurationError */, "Endpoint is invalid.", cause);
+    }
+  }
+
+  // packages/stream-connector/src/Runtime/ZlinkStreamConnectorOptions.ts
+  function normalizeOptions(options, defaultTransportFactory) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
+    const endpoint = options.endpoint;
+    if (endpoint.trim().length === 0) {
+      throw connectorError("configurationError" /* ConfigurationError */, "Endpoint must not be empty.");
+    }
+    const inferredTransport = inferTransport(endpoint);
+    if (options.transport !== void 0 && options.transport !== inferredTransport) {
+      throw connectorError(
+        "configurationError" /* ConfigurationError */,
+        "Configured transport conflicts with endpoint scheme."
+      );
+    }
+    const normalized = {
+      endpoint,
+      transport: inferredTransport,
+      connectTimeoutMs: (_a = options.connectTimeoutMs) != null ? _a : 5e3,
+      requestTimeoutMs: (_b = options.requestTimeoutMs) != null ? _b : 3e4,
+      waitTimeoutMs: (_c = options.waitTimeoutMs) != null ? _c : 5e3,
+      heartbeat: {
+        enabled: (_e = (_d = options.heartbeat) == null ? void 0 : _d.enabled) != null ? _e : true,
+        intervalMs: (_g = (_f = options.heartbeat) == null ? void 0 : _f.intervalMs) != null ? _g : 1e3,
+        timeoutMs: (_i = (_h = options.heartbeat) == null ? void 0 : _h.timeoutMs) != null ? _i : 5e3
+      },
+      reconnect: {
+        enabled: (_k = (_j = options.reconnect) == null ? void 0 : _j.enabled) != null ? _k : true,
+        initialDelayMs: (_m = (_l = options.reconnect) == null ? void 0 : _l.initialDelayMs) != null ? _m : 250,
+        maxDelayMs: (_o = (_n = options.reconnect) == null ? void 0 : _n.maxDelayMs) != null ? _o : 5e3,
+        backoffFactor: (_q = (_p = options.reconnect) == null ? void 0 : _p.backoffFactor) != null ? _q : 2,
+        maxAttempts: ((_r = options.reconnect) == null ? void 0 : _r.maxAttempts) === void 0 ? 3 : options.reconnect.maxAttempts
+      },
+      maxSendPayloadSize: (_s = options.maxSendPayloadSize) != null ? _s : ZLINK_STREAM_DEFAULT_PAYLOAD_BYTES,
+      maxReceivePayloadSize: (_t = options.maxReceivePayloadSize) != null ? _t : ZLINK_STREAM_DEFAULT_PAYLOAD_BYTES,
+      dispatchMode: (_u = options.dispatchMode) != null ? _u : "manual" /* Manual */,
+      compression: (_v = options.compression) != null ? _v : "lz4" /* Lz4 */,
+      compressionCodec: options.compressionCodec,
+      nameResolver: (_w = options.nameResolver) != null ? _w : defaultPacketNameResolver,
+      transportFactory: (_x = options.transportFactory) != null ? _x : defaultTransportFactory,
+      codec: options.codec
+    };
+    validatePositive(normalized.connectTimeoutMs, "ConnectTimeout");
+    validatePositive(normalized.requestTimeoutMs, "RequestTimeout");
+    validatePositive(normalized.waitTimeoutMs, "WaitTimeout");
+    validatePositive(normalized.maxSendPayloadSize, "MaxSendPayloadSize");
+    validatePositive(normalized.maxReceivePayloadSize, "MaxReceivePayloadSize");
+    validateHeartbeat(normalized.heartbeat);
+    validateReconnect(normalized.reconnect);
+    if (((_y = options.heartbeat) == null ? void 0 : _y.enabled) !== void 0 && typeof options.heartbeat.enabled !== "boolean") {
+      throw connectorError(
+        "validationFailed" /* ValidationFailed */,
+        "Heartbeat enabled must be boolean."
+      );
+    }
+    if (((_z = options.reconnect) == null ? void 0 : _z.enabled) !== void 0 && typeof options.reconnect.enabled !== "boolean") {
+      throw connectorError(
+        "validationFailed" /* ValidationFailed */,
+        "Reconnect enabled must be boolean."
+      );
+    }
+    if (options.compressionCodec !== void 0 && !hasMethods(options.compressionCodec, "compress", "decompress")) {
+      throw connectorError("validationFailed" /* ValidationFailed */, "Compression codec is invalid.");
+    }
+    if (options.codec !== void 0 && !hasMethods(options.codec, "encode", "decode")) {
+      throw connectorError("validationFailed" /* ValidationFailed */, "Payload codec is invalid.");
+    }
+    if (options.nameResolver !== void 0 && !hasMethods(options.nameResolver, "resolve")) {
+      throw connectorError("validationFailed" /* ValidationFailed */, "Packet name resolver is invalid.");
+    }
+    if (options.transportFactory !== void 0 && !hasMethods(options.transportFactory, "connect")) {
+      throw connectorError("validationFailed" /* ValidationFailed */, "Transport factory is invalid.");
+    }
+    if (!Object.values(ZlinkStreamDispatchMode).includes(normalized.dispatchMode)) {
+      throw connectorError("validationFailed" /* ValidationFailed */, "DispatchMode is invalid.");
+    }
+    if (!Object.values(ZlinkStreamCompression).includes(normalized.compression)) {
+      throw connectorError("validationFailed" /* ValidationFailed */, "Compression is invalid.");
+    }
+    validateCompressionCodec(normalized);
+    return normalized;
+  }
+  var defaultPacketNameResolver = {
+    resolve(payloadType) {
+      const declared = payloadType.packetName;
+      if (typeof declared === "string" && declared.length > 0) {
+        return declared;
+      }
+      return payloadType.name;
+    }
+  };
+  function validateCompressionCodec(options) {
+    const compression = options.compression;
+    if (compression === "none" /* None */) {
+      if (options.compressionCodec !== void 0) {
+        throw connectorError(
+          "configurationError" /* ConfigurationError */,
+          "compressionCodec cannot be set when compression is none."
+        );
+      }
+    }
+  }
+  function validatePositive(value, name) {
+    if (!Number.isFinite(value) || value <= 0) {
+      throw connectorError("validationFailed" /* ValidationFailed */, `${name} must be positive.`);
+    }
+  }
+  function hasMethods(value, ...names) {
+    if (value === null || typeof value !== "object") return false;
+    const candidate = value;
+    return names.every((name) => typeof candidate[name] === "function");
+  }
+  function validateHeartbeat(options) {
+    const intervalMs = options.intervalMs;
+    const timeoutMs = options.timeoutMs;
+    validatePositive(intervalMs, "Heartbeat interval");
+    validatePositive(timeoutMs, "Heartbeat timeout");
+  }
+  function validateReconnect(options) {
+    validatePositive(options.initialDelayMs, "Reconnect InitialDelay");
+    validatePositive(options.maxDelayMs, "Reconnect MaxDelay");
+    validatePositive(options.backoffFactor, "Reconnect BackoffFactor");
+    const maxAttempts = options.maxAttempts;
+    if (maxAttempts !== null && !(Number.isFinite(maxAttempts) && maxAttempts > 0)) {
+      throw connectorError(
+        "validationFailed" /* ValidationFailed */,
+        "Reconnect MaxAttempts must be null or positive."
+      );
+    }
+  }
+
   // packages/stream-connector/src/Runtime/Protocol/ZlinkStreamFrameCodec.ts
   var ZlinkStreamFrameCodec = class {
-    static encode(header, payload, maxPayloadSize = 64 * 1024) {
+    static encode(header, payload, maxPayloadSize = ZLINK_STREAM_DEFAULT_PAYLOAD_BYTES) {
       validatePayload(payload.length, maxPayloadSize);
       try {
         return encodeStreamWireFrame(header, payload);
@@ -1177,35 +1496,14 @@ var ZlinkStreamConnectorBundle = (() => {
     }
   };
   function splitZlinkStreamFrames(chunk) {
-    if (chunk.length === 0) {
+    try {
+      return splitStreamWireFrames(chunk);
+    } catch (cause) {
       throw connectorError(
         "frameDecodeFailed" /* FrameDecodeFailed */,
-        "Stream frame prefix is incomplete."
+        cause instanceof Error ? cause.message : "Frame length does not match prefix."
       );
     }
-    const frames = [];
-    let offset = 0;
-    while (offset < chunk.length) {
-      const remaining = chunk.length - offset;
-      if (remaining < 6) {
-        throw connectorError(
-          "frameDecodeFailed" /* FrameDecodeFailed */,
-          "Stream frame prefix is incomplete."
-        );
-      }
-      const headerLength = chunk[offset] << 8 | chunk[offset + 1];
-      const payloadLength = chunk[offset + 2] * 16777216 + (chunk[offset + 3] << 16) + (chunk[offset + 4] << 8) + chunk[offset + 5];
-      const frameLength = 6 + headerLength + payloadLength;
-      if (frameLength > remaining) {
-        throw connectorError(
-          "frameDecodeFailed" /* FrameDecodeFailed */,
-          "Frame length does not match prefix."
-        );
-      }
-      frames.push(chunk.subarray(offset, offset + frameLength));
-      offset += frameLength;
-    }
-    return frames;
   }
   function validatePayload(payloadLength, maxPayloadSize) {
     if (payloadLength > maxPayloadSize) {
@@ -1217,59 +1515,34 @@ var ZlinkStreamConnectorBundle = (() => {
   }
 
   // packages/stream-connector/src/Runtime/Protocol/ZlinkStreamMetadataCodec.ts
-  var ZLINK_STREAM_MAX_METADATA_BYTES = 1024;
   var ZlinkStreamMetadataCodec = class {
     static size(metadata) {
+      let size;
       try {
-        const size = metadata.count === 0 ? 0 : encodeStreamWireMetadata(metadata.values).length;
-        if (size > ZLINK_STREAM_MAX_METADATA_BYTES) {
-          throw connectorError(
-            "validationFailed" /* ValidationFailed */,
-            `Metadata must not exceed ${ZLINK_STREAM_MAX_METADATA_BYTES} bytes.`
-          );
-        }
-        return size;
+        size = metadata.count === 0 ? 0 : streamWireMetadataSize(metadata.values);
       } catch (cause) {
         throw connectorError(
           "validationFailed" /* ValidationFailed */,
-          streamWireErrorMessage(cause),
+          cause instanceof Error ? cause.message : "Metadata is invalid.",
           cause
         );
       }
-    }
-    static write(metadata, destination) {
-      try {
-        destination.set(encodeStreamWireMetadata(metadata.values));
-      } catch (cause) {
+      if (size > ZLINK_STREAM_MAX_METADATA_BYTES) {
         throw connectorError(
           "validationFailed" /* ValidationFailed */,
-          streamWireErrorMessage(cause),
-          cause
-        );
-      }
-    }
-    static decode(metadata) {
-      try {
-        const values = decodeStreamWireMetadata(metadata);
-        return values.size === 0 ? ZlinkStreamMetadataMap.empty : ZlinkStreamMetadataMap.from(values);
-      } catch (cause) {
-        throw connectorError(
-          "frameDecodeFailed" /* FrameDecodeFailed */,
-          streamWireErrorMessage(cause),
-          cause
+          `Metadata must not exceed ${ZLINK_STREAM_MAX_METADATA_BYTES} bytes.`
         );
       }
+      return size;
     }
   };
-  function streamWireErrorMessage(cause) {
-    return cause instanceof Error ? cause.message : "Metadata is invalid.";
-  }
 
   // packages/stream-connector/src/Runtime/Protocol/ZlinkStreamHeaderCodec.ts
   var ZlinkStreamHeaderCodec = class {
     static encode(header) {
       const reply = isReplyKind2(header.kind);
       if (!reply) validateName(header.name, header.kind === 5 /* Control */);
+      validateEncodeFlags(header.flags);
       validateHeaderSemantics(header);
       ZlinkStreamMetadataCodec.size(header.metadata);
       try {
@@ -1286,7 +1559,7 @@ var ZlinkStreamConnectorBundle = (() => {
       } catch (cause) {
         throw connectorError(
           "validationFailed" /* ValidationFailed */,
-          streamWireErrorMessage2(cause),
+          streamWireErrorMessage(cause),
           cause
         );
       }
@@ -1306,25 +1579,24 @@ var ZlinkStreamConnectorBundle = (() => {
           correlationId: wire.correlationId,
           actorSlot: wire.actorSlot
         };
+        if (!isReplyKind2(decoded.kind)) {
+          validateName(decoded.name, decoded.kind === 5 /* Control */);
+        }
+        validateHeaderSemantics(decoded);
       } catch (cause) {
         throw connectorError(
           "frameDecodeFailed" /* FrameDecodeFailed */,
-          streamWireErrorMessage2(cause),
+          streamWireErrorMessage(cause),
           cause
         );
       }
-      validateEnum(decoded.kind, decoded.codec, decoded.flags);
-      if (!isReplyKind2(decoded.kind)) {
-        validateName(decoded.name, decoded.kind === 5 /* Control */);
-      }
-      validateHeaderSemantics(decoded);
       return decoded;
     }
   };
   function isReplyKind2(kind) {
     return kind === 3 /* Response */ || kind === 4 /* Error */;
   }
-  function streamWireErrorMessage2(cause) {
+  function streamWireErrorMessage(cause) {
     return cause instanceof Error ? cause.message : "Stream header is invalid.";
   }
   function buildHeader(kind, name, codec, metadata, compress, requestSeq, correlationId, actorSlot) {
@@ -1354,7 +1626,7 @@ var ZlinkStreamConnectorBundle = (() => {
     };
   }
   function validateHeaderSemantics(header) {
-    validateEnum(header.kind, header.codec, header.flags);
+    validateEnum(header.kind, header.codec);
     const hasRequestSeq = header.requestSeq !== void 0 || (header.flags & 1 /* HasRequestSeq */) !== 0;
     const hasMetadata = header.metadata.count > 0 || (header.flags & 2 /* HasMetadata */) !== 0;
     if (header.kind === 1 /* Send */ && hasRequestSeq) {
@@ -1387,13 +1659,15 @@ var ZlinkStreamConnectorBundle = (() => {
       }
     }
   }
-  function validateEnum(kind, codec, flags) {
-    if (![1, 2, 3, 4, 5].includes(kind)) {
+  function validateEnum(kind, codec) {
+    if (!isStreamWireMessageKind(kind)) {
       throw connectorError("frameDecodeFailed" /* FrameDecodeFailed */, "Unknown stream message kind.");
     }
-    if (![0, 1, 2, 3].includes(codec)) {
+    if (!isStreamWireCodec(codec)) {
       throw connectorError("frameDecodeFailed" /* FrameDecodeFailed */, "Unknown stream codec.");
     }
+  }
+  function validateEncodeFlags(flags) {
     const known = 1 /* HasRequestSeq */ | 2 /* HasMetadata */ | 4 /* PayloadCompressed */ | 8 /* HasCorrelationId */ | 16 /* HasFlowId */ | 32 /* HasActorSlot */;
     if ((flags & ~known) !== 0) {
       throw connectorError("frameDecodeFailed" /* FrameDecodeFailed */, "Unknown stream header flag.");
@@ -1401,8 +1675,8 @@ var ZlinkStreamConnectorBundle = (() => {
   }
 
   // packages/stream-connector/src/Runtime/Protocol/ZlinkStreamFrameProtocol.ts
-  var ZLINK_STREAM_HEARTBEAT_PING = "$zlink.heartbeat.ping";
-  var ZLINK_STREAM_HEARTBEAT_PONG = "$zlink.heartbeat.pong";
+  var ZLINK_STREAM_HEARTBEAT_PING = ZlinkStreamControlPacket.HeartbeatPing;
+  var ZLINK_STREAM_HEARTBEAT_PONG = ZlinkStreamControlPacket.HeartbeatPong;
   var ZlinkStreamFrameProtocol = class {
     constructor(options) {
       this.options = options;
@@ -1470,178 +1744,39 @@ var ZlinkStreamConnectorBundle = (() => {
     }
   };
 
-  // packages/stream-connector/src/Runtime/Transport/ZlinkStreamEndpoint.ts
-  function inferTransport(endpoint) {
-    const url = parseEndpoint(endpoint);
-    switch (url.protocol) {
-      case "ws:":
-        return "webSocket" /* WebSocket */;
-      case "wss:":
-        return "webSocketSecure" /* WebSocketSecure */;
-      default:
-        throw connectorError(
-          "configurationError" /* ConfigurationError */,
-          "The TypeScript Stream Connector supports only ws:// and wss:// endpoints."
-        );
-    }
-  }
-  function parseEndpoint(endpoint) {
-    try {
-      return new URL(endpoint);
-    } catch (cause) {
-      throw connectorError("configurationError" /* ConfigurationError */, "Endpoint is invalid.", cause);
-    }
-  }
-
-  // packages/stream-connector/src/Runtime/ZlinkStreamConnectorOptions.ts
-  function normalizeOptions(options, defaultTransportFactory) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C;
-    const endpoint = options.endpoint;
-    if (endpoint.trim().length === 0) {
-      throw connectorError("configurationError" /* ConfigurationError */, "Endpoint must not be empty.");
-    }
-    const inferredTransport = inferTransport(endpoint);
-    if (options.transport !== void 0 && options.transport !== inferredTransport) {
-      throw connectorError(
-        "configurationError" /* ConfigurationError */,
-        "Configured transport conflicts with endpoint scheme."
-      );
-    }
-    validatePositive((_a = options.connectTimeoutMs) != null ? _a : 5e3, "ConnectTimeout");
-    validatePositive((_b = options.requestTimeoutMs) != null ? _b : 3e4, "RequestTimeout");
-    validatePositive((_c = options.waitTimeoutMs) != null ? _c : 5e3, "WaitTimeout");
-    validatePositive((_d = options.maxSendPayloadSize) != null ? _d : 64 * 1024, "MaxSendPayloadSize");
-    validatePositive((_e = options.maxReceivePayloadSize) != null ? _e : 64 * 1024, "MaxReceivePayloadSize");
-    validateHeartbeat(options.heartbeat);
-    validateReconnect(options.reconnect);
-    return {
-      endpoint,
-      transport: inferredTransport,
-      connectTimeoutMs: (_f = options.connectTimeoutMs) != null ? _f : 5e3,
-      requestTimeoutMs: (_g = options.requestTimeoutMs) != null ? _g : 3e4,
-      waitTimeoutMs: (_h = options.waitTimeoutMs) != null ? _h : 5e3,
-      heartbeat: {
-        enabled: (_j = (_i = options.heartbeat) == null ? void 0 : _i.enabled) != null ? _j : true,
-        intervalMs: (_l = (_k = options.heartbeat) == null ? void 0 : _k.intervalMs) != null ? _l : 1e3,
-        timeoutMs: (_n = (_m = options.heartbeat) == null ? void 0 : _m.timeoutMs) != null ? _n : 5e3
-      },
-      reconnect: {
-        enabled: (_p = (_o = options.reconnect) == null ? void 0 : _o.enabled) != null ? _p : true,
-        initialDelayMs: (_r = (_q = options.reconnect) == null ? void 0 : _q.initialDelayMs) != null ? _r : 250,
-        maxDelayMs: (_t = (_s = options.reconnect) == null ? void 0 : _s.maxDelayMs) != null ? _t : 5e3,
-        backoffFactor: (_v = (_u = options.reconnect) == null ? void 0 : _u.backoffFactor) != null ? _v : 2,
-        maxAttempts: ((_w = options.reconnect) == null ? void 0 : _w.maxAttempts) === void 0 ? 3 : options.reconnect.maxAttempts
-      },
-      maxSendPayloadSize: (_x = options.maxSendPayloadSize) != null ? _x : 64 * 1024,
-      maxReceivePayloadSize: (_y = options.maxReceivePayloadSize) != null ? _y : 64 * 1024,
-      dispatchMode: (_z = options.dispatchMode) != null ? _z : "manual" /* Manual */,
-      compression: (_A = options.compression) != null ? _A : "lz4" /* Lz4 */,
-      compressionCodec: resolveCompressionCodec2(options),
-      nameResolver: (_B = options.nameResolver) != null ? _B : defaultPacketNameResolver,
-      transportFactory: (_C = options.transportFactory) != null ? _C : defaultTransportFactory,
-      codec: options.codec
-    };
-  }
-  var defaultPacketNameResolver = {
-    resolve(payloadType) {
-      const declared = payloadType.packetName;
-      if (typeof declared === "string" && declared.length > 0) {
-        return declared;
-      }
-      return payloadType.name;
-    }
-  };
-  function resolveCompressionCodec2(options) {
-    var _a;
-    const compression = (_a = options.compression) != null ? _a : "lz4" /* Lz4 */;
-    if (compression === "none" /* None */) {
-      if (options.compressionCodec !== void 0) {
-        throw connectorError(
-          "configurationError" /* ConfigurationError */,
-          "compressionCodec cannot be set when compression is none."
-        );
-      }
-      return void 0;
-    }
-    return options.compressionCodec;
-  }
-  function validatePositive(value, name) {
-    if (value <= 0) {
-      throw connectorError("validationFailed" /* ValidationFailed */, `${name} must be positive.`);
-    }
-  }
-  function validateHeartbeat(options) {
-    var _a, _b, _c;
-    const enabled = (_a = options == null ? void 0 : options.enabled) != null ? _a : true;
-    const intervalMs = (_b = options == null ? void 0 : options.intervalMs) != null ? _b : 1e3;
-    const timeoutMs = (_c = options == null ? void 0 : options.timeoutMs) != null ? _c : 5e3;
-    if (!enabled) {
-      return;
-    }
-    validatePositive(intervalMs, "Heartbeat interval");
-    validatePositive(timeoutMs, "Heartbeat timeout");
-    if (timeoutMs <= intervalMs) {
-      throw connectorError(
-        "validationFailed" /* ValidationFailed */,
-        "Heartbeat timeout must be greater than the heartbeat interval."
-      );
-    }
-  }
-  function validateReconnect(options) {
-    var _a, _b, _c, _d;
-    const enabled = (_a = options == null ? void 0 : options.enabled) != null ? _a : true;
-    if (!enabled) {
-      return;
-    }
-    validatePositive((_b = options == null ? void 0 : options.initialDelayMs) != null ? _b : 250, "Reconnect InitialDelay");
-    validatePositive((_c = options == null ? void 0 : options.maxDelayMs) != null ? _c : 5e3, "Reconnect MaxDelay");
-    if (((_d = options == null ? void 0 : options.backoffFactor) != null ? _d : 2) < 1) {
-      throw connectorError(
-        "validationFailed" /* ValidationFailed */,
-        "Reconnect BackoffFactor must be at least 1.0."
-      );
-    }
-    const maxAttempts = (options == null ? void 0 : options.maxAttempts) === void 0 ? 3 : options.maxAttempts;
-    if (maxAttempts !== null && !(Number.isFinite(maxAttempts) && maxAttempts > 0)) {
-      throw connectorError(
-        "validationFailed" /* ValidationFailed */,
-        "Reconnect MaxAttempts must be null or positive."
-      );
-    }
-  }
-
   // packages/stream-connector/src/Runtime/ZlinkStreamPendingRequests.ts
   var ZlinkStreamPendingRequests = class {
     constructor() {
       __publicField(this, "nextRequestSeq", 1n);
       __publicField(this, "active", /* @__PURE__ */ new Map());
     }
-    get count() {
-      return this.active.size;
-    }
     create(packetName, timeoutMs) {
+      if (this.nextRequestSeq > UINT64_MAX) {
+        throw connectorError("sendFailed" /* SendFailed */, "Request sequence is exhausted.");
+      }
       const requestSeq = this.nextRequestSeq++;
       let timeout;
       let resolvePending;
       let rejectPending;
       const promise = new Promise(
         (resolve, reject) => {
-          timeout = setTimeout(() => {
-            this.active.delete(requestSeq);
-            reject(
-              connectorError(
-                "requestTimeout" /* RequestTimeout */,
-                `Request '${packetName}' timed out.`
-              )
-            );
-          }, timeoutMs);
           resolvePending = resolve;
           rejectPending = (error) => reject(connectorError(error.code, error.message, error.cause));
         }
       );
-      this.active.set(requestSeq, {
+      const tracked = {
         packetName,
         promise,
+        startTimeout: () => {
+          if (timeout !== void 0 || this.active.get(requestSeq) !== tracked) return;
+          timeout = setTimeout(() => {
+            this.active.delete(requestSeq);
+            rejectPending({
+              code: "requestTimeout" /* RequestTimeout */,
+              message: `Request '${packetName}' timed out.`
+            });
+          }, timeoutMs);
+        },
         resolve: (value) => {
           if (timeout !== void 0) {
             clearTimeout(timeout);
@@ -1659,8 +1794,9 @@ var ZlinkStreamConnectorBundle = (() => {
             clearTimeout(timeout);
           }
         }
-      });
-      return { requestSeq, promise };
+      };
+      this.active.set(requestSeq, tracked);
+      return { requestSeq, promise, startTimeout: tracked.startTimeout };
     }
     /* stream connector spec §5.2: a pending request is matched by request_seq alone. */
     resolve(requestSeq, value, metadata) {
@@ -1668,8 +1804,9 @@ var ZlinkStreamConnectorBundle = (() => {
       if (pending === void 0) {
         return false;
       }
+      const payload = value();
       this.active.delete(requestSeq);
-      pending.resolve({ name: pending.packetName, metadata, payload: value });
+      pending.resolve({ name: pending.packetName, metadata, payload });
       return true;
     }
     reject(requestSeq, error) {
@@ -1697,7 +1834,156 @@ var ZlinkStreamConnectorBundle = (() => {
     }
   };
 
+  // packages/stream-connector/src/Runtime/ZlinkStreamActors.ts
+  var ACTOR_BOUND = ZlinkStreamControlPacket.ActorBound;
+  var ACTOR_UNBOUND = ZlinkStreamControlPacket.ActorUnbound;
+  var zlinkStreamActorBinding = Symbol("zlink.stream.actorBinding");
+  var DefaultZlinkStreamActor = class {
+    constructor(connector, actorId, slot) {
+      this.connector = connector;
+      this.actorId = actorId;
+      this.slot = slot;
+      __publicField(this, "bound", true);
+    }
+    get isBound() {
+      return this.bound;
+    }
+    send(payload, messageType) {
+      this.ensureBound();
+      return this.connector.sendForActor(this, payload, messageType);
+    }
+    request(payload, messageType) {
+      this.ensureBound();
+      return this.connector.requestForActor(this, payload, messageType);
+    }
+    on(nameOrType, handler, messageType) {
+      return this.connector.onActorMessage(this, nameOrType, handler, messageType);
+    }
+    ensureBound() {
+      if (!this.bound) {
+        throw connectorError(
+          "validationFailed" /* ValidationFailed */,
+          `Actor '${this.actorId}' is no longer bound.`
+        );
+      }
+    }
+    close() {
+      this.bound = false;
+    }
+  };
+  var ZlinkStreamActors = class {
+    constructor(connector, receivedMessages, events) {
+      this.connector = connector;
+      this.receivedMessages = receivedMessages;
+      this.events = events;
+      __publicField(this, "bySlot", /* @__PURE__ */ new Map());
+      __publicField(this, "byId", /* @__PURE__ */ new Map());
+      __publicField(this, "boundHandlers", /* @__PURE__ */ new Set());
+      __publicField(this, "unboundHandlers", /* @__PURE__ */ new Set());
+    }
+    get snapshot() {
+      return Object.freeze(Array.from(this.bySlot.values()));
+    }
+    find(actorId) {
+      return this.byId.get(actorId);
+    }
+    onBound(handler) {
+      return registerHandler(this.boundHandlers, handler);
+    }
+    onUnbound(handler) {
+      return registerHandler(this.unboundHandlers, handler);
+    }
+    processControl(name, payload, signal) {
+      if (name === ACTOR_BOUND) {
+        this.bind(payload, signal);
+        return true;
+      }
+      if (name === ACTOR_UNBOUND) {
+        this.unbind(payload, signal);
+        return true;
+      }
+      return false;
+    }
+    resolve(slot) {
+      const actor = this.bySlot.get(slot);
+      if (actor === void 0) {
+        throw connectorError(
+          "frameDecodeFailed" /* FrameDecodeFailed */,
+          `Actor slot '${slot}' is not bound.`
+        );
+      }
+      return actor;
+    }
+    closeAll(signal) {
+      for (const actor of this.bySlot.values()) {
+        this.bySlot.delete(actor.slot);
+        this.byId.delete(actor.actorId);
+        actor.close();
+        this.queue(this.unboundHandlers, actor, signal);
+      }
+    }
+    bind(payload, signal) {
+      let binding;
+      try {
+        binding = decodeStreamWireActorBoundPayload(payload);
+      } catch (cause) {
+        throw connectorError(
+          "frameDecodeFailed" /* FrameDecodeFailed */,
+          cause instanceof Error ? cause.message : "Actor bound payload is invalid.",
+          cause instanceof Error ? cause.cause : void 0
+        );
+      }
+      const { slot, actorId } = binding;
+      if (actorId.length === 0 || this.bySlot.has(slot) || this.byId.has(actorId)) {
+        throw invalidControl("Actor bound identity is already in use.");
+      }
+      const actor = new DefaultZlinkStreamActor(this.connector, actorId, slot);
+      this.bySlot.set(slot, actor);
+      this.byId.set(actorId, actor);
+      this.queue(this.boundHandlers, actor, signal);
+    }
+    unbind(payload, signal) {
+      let slot;
+      try {
+        slot = decodeStreamWireActorUnboundPayload(payload);
+      } catch (cause) {
+        throw connectorError(
+          "frameDecodeFailed" /* FrameDecodeFailed */,
+          cause instanceof Error ? cause.message : "Actor unbound payload is invalid."
+        );
+      }
+      const actor = this.bySlot.get(slot);
+      if (slot === 0 || actor === void 0) {
+        throw invalidControl(`Actor slot '${slot}' is not bound.`);
+      }
+      this.bySlot.delete(slot);
+      this.byId.delete(actor.actorId);
+      actor.close();
+      this.queue(this.unboundHandlers, actor, signal);
+    }
+    queue(handlers, actor, signal) {
+      this.receivedMessages.enqueueCallback(
+        () => {
+          for (const { handler } of currentRegistrations(handlers)) {
+            this.events.runUserCallback(
+              () => handler(actor, signal),
+              "Actor lifecycle handler failed.",
+              signal
+            );
+          }
+        },
+        () => handlers.size
+      );
+    }
+  };
+  function invalidControl(message) {
+    return connectorError("frameDecodeFailed" /* FrameDecodeFailed */, message);
+  }
+
   // packages/stream-connector/src/Runtime/ZlinkStreamReceivedMessages.ts
+  function receives(registration, message) {
+    return registration.actor === void 0 || registration.actor.isBound && registration.actor === message[zlinkStreamActorBinding];
+  }
   var ZlinkStreamReceivedMessages = class {
     /**
      * @param deliverOnArrival `Immediate` runs registered handlers on the receive
@@ -1714,10 +2000,10 @@ var ZlinkStreamConnectorBundle = (() => {
       // queue is not a simple FIFO. Tombstones let us remove a deliverable entry
       // without shifting every later message on the hot receive path.
       __publicField(this, "queue", []);
+      __publicField(this, "deliverable", []);
       __publicField(this, "queueHead", 0);
       __publicField(this, "queuedCount", 0);
-      __publicField(this, "drainTask");
-      // True for as long as `drain` is on the stack, handler awaits included. It
+      // True for as long as `pump` is on the stack. It
       // marks the execution context a registered handler runs in, so a `dispatch`
       // made from inside a handler is recognised as re-entry rather than a fresh
       // pump. It is not a lock: a single event loop admits no second thread, and
@@ -1728,19 +2014,32 @@ var ZlinkStreamConnectorBundle = (() => {
       // so consuming does not lower it and the dispatch mode does not change it.
       __publicField(this, "receivedCounts", /* @__PURE__ */ new Map());
     }
-    on(name, handler) {
+    /**
+     * @param actor The Actor handle that registers the handler, if any. Its
+     *   handler receives only that Actor's packets.
+     */
+    on(name, handler, actor) {
       validateName(name);
       let set = this.handlers.get(name);
       if (set === void 0) {
         set = /* @__PURE__ */ new Set();
         this.handlers.set(name, set);
       }
-      set.add(handler);
-      if (this.deliverOnArrival && this.hasQueuedMessage(name)) {
-        queueMicrotask(() => this.scheduleDrain());
+      const registration = { handle: handler, actor };
+      set.add(registration);
+      let newlyDeliverable = false;
+      for (let index = this.queueHead; index < this.queue.length; index += 1) {
+        const queued = this.queue[index];
+        if ((queued == null ? void 0 : queued.kind) === "message" && queued.indexed !== true && queued.message.name === name && receives(registration, queued.message)) {
+          this.indexDeliverable(index);
+          newlyDeliverable = true;
+        }
+      }
+      if (this.deliverOnArrival && newlyDeliverable) {
+        queueMicrotask(() => this.pump());
       }
       return subscription(() => {
-        set.delete(handler);
+        set.delete(registration);
         if (set.size === 0 && this.handlers.get(name) === set) {
           this.handlers.delete(name);
         }
@@ -1812,6 +2111,11 @@ var ZlinkStreamConnectorBundle = (() => {
       this.queue.push(...submittedCallbacks);
       this.queueHead = 0;
       this.queuedCount = submittedCallbacks.length;
+      this.deliverable.length = 0;
+      for (let index = 0; index < this.queue.length; index += 1) {
+        this.queue[index].indexed = false;
+        this.indexDeliverable(index);
+      }
     }
     /**
      * Releases every registered wait surface because the connection it was
@@ -1843,60 +2147,38 @@ var ZlinkStreamConnectorBundle = (() => {
       }
       this.queue.push({ kind: "message", message, signal });
       this.queuedCount += 1;
+      this.indexDeliverable(this.queue.length - 1);
       if (this.deliverOnArrival) {
-        this.scheduleDrain();
+        this.pump();
       }
     }
-    enqueueCallback(callback) {
-      this.queue.push({ kind: "callback", callback });
+    /**
+     * @param callbacks The number of handler calls `callback` makes when it runs
+     *   with the handlers registered at that moment; a callback that runs a set
+     *   of handlers reads the set's size. One callback by default.
+     */
+    enqueueCallback(callback, callbacks = () => 1) {
+      this.queue.push({ kind: "callback", callback, callbacks });
       this.queuedCount += 1;
+      this.indexDeliverable(this.queue.length - 1);
       if (this.deliverOnArrival) {
-        this.scheduleDrain();
+        this.pump();
       }
     }
     /**
      * Runs the registered handlers the receive path left queued. `Manual` calls
-     * this from `dispatch`; `Immediate` has already drained on arrival.
+     * this from `dispatch`; `Immediate` drains on arrival.
      *
-     * A handler that calls `dispatch` arrives back here from inside the drain it
-     * was started by. `scheduleDrain` would find `drainTask` already set and
-     * return, and the await below would then be the drain waiting on itself —
-     * a deadlock with neither timeout nor error. The drain loop already takes
-     * every message a handler exists for, so there is nothing a second drain
-     * would deliver and returning is the whole of the correct behaviour.
+     * The drain is synchronous: the connector does not wait for a handler
+     * (spec stream-connector 32 §7), so nothing inside it awaits. A handler that
+     * calls `dispatch` arrives back here from inside the drain it was started by;
+     * the running loop already takes every deliverable entry, so returning is the
+     * whole of the correct behaviour.
      */
-    async pump() {
+    pump() {
       if (this.draining) {
         return;
       }
-      this.scheduleDrain();
-      await this.drainTask;
-    }
-    offerQueued(name, registration) {
-      for (let index = this.queueHead; index < this.queue.length; index += 1) {
-        const queued = this.queue[index];
-        if (queued === void 0 || queued.kind !== "message" || queued.message.name !== name) {
-          continue;
-        }
-        if (!registration.consume(queued.message)) {
-          continue;
-        }
-        this.removeAt(index);
-        return;
-      }
-    }
-    scheduleDrain() {
-      if (this.drainTask !== void 0) {
-        return;
-      }
-      this.drainTask = this.drain().finally(() => {
-        this.drainTask = void 0;
-        if (this.deliverOnArrival && this.findDeliverableIndex() >= 0) {
-          this.scheduleDrain();
-        }
-      });
-    }
-    async drain() {
       this.draining = true;
       try {
         for (let index = this.findDeliverableIndex(); index >= 0; index = this.findDeliverableIndex()) {
@@ -1904,30 +2186,53 @@ var ZlinkStreamConnectorBundle = (() => {
           if (queued === void 0) continue;
           this.removeAt(index);
           if (queued.kind === "callback") {
-            await queued.callback();
+            this.events.runUserCallback(queued.callback, "Connector callback failed.");
             continue;
           }
           const { message, signal } = queued;
-          const handlers = Array.from(this.handlers.get(message.name));
-          for (const handler of handlers) {
-            try {
-              await handler(message, signal);
-            } catch (cause) {
-              await this.events.publishError(
-                {
-                  code: "userCallbackFailed" /* UserCallbackFailed */,
-                  message: "Typed message handler failed.",
-                  cause
-                },
-                signal
-              );
-            }
+          const handlers = this.receiversOf(message);
+          for (const handler of currentRegistrations(this.handlers.get(message.name), handlers)) {
+            if (!receives(handler, message)) continue;
+            this.events.runUserCallback(
+              () => handler.handle(message, signal),
+              "Typed message handler failed.",
+              signal
+            );
           }
         }
       } finally {
         this.draining = false;
       }
     }
+    /**
+     * True while a registered callback runs from {@link pump}: the execution
+     * context spec stream-connector 32 §7 calls "inside a handler".
+     */
+    get dispatching() {
+      return this.draining;
+    }
+    get pendingCallbacks() {
+      let count = 0;
+      for (let index = this.queueHead; index < this.queue.length; index += 1) {
+        const queued = this.queue[index];
+        if ((queued == null ? void 0 : queued.kind) === "callback" && queued.callbacks() > 0) count += 1;
+        if ((queued == null ? void 0 : queued.kind) === "message" && this.receiversOf(queued.message).length > 0) count += 1;
+      }
+      return count;
+    }
+    offerQueued(name, registration) {
+      for (let index = this.queueHead; index < this.queue.length; index += 1) {
+        const queued = this.queue[index];
+        if (queued === void 0 || queued.kind !== "message" || queued.message.name !== name) {
+          continue;
+        }
+        if (!registration.consume(queued.message)) {
+          continue;
+        }
+        this.removeAt(index);
+        return;
+      }
+    }
     removeAt(index) {
       this.queue[index] = void 0;
       this.queuedCount -= 1;
@@ -1935,21 +2240,60 @@ var ZlinkStreamConnectorBundle = (() => {
       this.compactQueue();
     }
     findDeliverableIndex() {
-      var _a, _b;
-      for (let index = this.queueHead; index < this.queue.length; index += 1) {
+      while (this.deliverable.length > 0) {
+        const index = this.deliverable[0];
         const queued = this.queue[index];
-        if (queued !== void 0 && (queued.kind === "callback" || ((_b = (_a = this.handlers.get(queued.message.name)) == null ? void 0 : _a.size) != null ? _b : 0) > 0)) {
+        if (this.isDeliverable(queued)) {
           return index;
         }
+        if (queued !== void 0) queued.indexed = false;
+        this.removeDeliverable();
       }
       return -1;
     }
-    hasQueuedMessage(name) {
-      for (let index = this.queueHead; index < this.queue.length; index += 1) {
-        const queued = this.queue[index];
-        if ((queued == null ? void 0 : queued.kind) === "message" && queued.message.name === name) return true;
+    indexDeliverable(index) {
+      const queued = this.queue[index];
+      if (queued === void 0 || !this.isDeliverable(queued) || queued.indexed === true) return;
+      queued.indexed = true;
+      let position = this.deliverable.length;
+      this.deliverable.push(index);
+      while (position > 0) {
+        const parent = Math.floor((position - 1) / 2);
+        if (this.deliverable[parent] <= index) break;
+        this.deliverable[position] = this.deliverable[parent];
+        position = parent;
       }
-      return false;
+      this.deliverable[position] = index;
+    }
+    isDeliverable(queued) {
+      return (queued == null ? void 0 : queued.kind) === "callback" || (queued == null ? void 0 : queued.kind) === "message" && this.receiversOf(queued.message).length > 0;
+    }
+    /**
+     * Spec stream-connector 32 §7 and §10: the handlers that receive `message`
+     * are the connector handlers for its name and the handle handlers of the
+     * Actor it carries. A packet no handler receives stays in the queue for the
+     * wait surfaces. This is the one place that decides it.
+     */
+    receiversOf(message) {
+      const set = this.handlers.get(message.name);
+      if (set === void 0) return [];
+      return Array.from(set).filter((registration) => receives(registration, message));
+    }
+    removeDeliverable() {
+      if (this.deliverable.length === 0) return;
+      const last = this.deliverable.pop();
+      if (this.deliverable.length === 0) return;
+      let position = 0;
+      for (; ; ) {
+        const left = position * 2 + 1;
+        if (left >= this.deliverable.length) break;
+        const right = left + 1;
+        const child = right < this.deliverable.length && this.deliverable[right] < this.deliverable[left] ? right : left;
+        if (this.deliverable[child] >= last) break;
+        this.deliverable[position] = this.deliverable[child];
+        position = child;
+      }
+      this.deliverable[position] = last;
     }
     advanceHead() {
       while (this.queueHead < this.queue.length && this.queue[this.queueHead] === void 0) {
@@ -1960,22 +2304,106 @@ var ZlinkStreamConnectorBundle = (() => {
       if (this.queuedCount === 0) {
         this.queue.length = 0;
         this.queueHead = 0;
+        this.deliverable.length = 0;
         return;
       }
-      if (this.queueHead >= 1024 && this.queueHead * 2 >= this.queue.length) {
-        this.queue.splice(0, this.queueHead);
+      const removed = this.queue.length - this.queuedCount;
+      if (shouldCompactBackingArray(removed, this.queue.length)) {
+        let destination = 0;
+        for (let source = this.queueHead; source < this.queue.length; source += 1) {
+          const queued = this.queue[source];
+          if (queued !== void 0) this.queue[destination++] = queued;
+        }
+        this.queue.length = destination;
         this.queueHead = 0;
+        this.deliverable.length = 0;
+        for (let index = 0; index < this.queue.length; index += 1) {
+          const queued = this.queue[index];
+          if (queued === void 0) continue;
+          queued.indexed = false;
+          this.indexDeliverable(index);
+        }
       }
     }
   };
 
   // packages/stream-connector/src/Runtime/ZlinkStreamFrameSender.ts
+  var ZlinkStreamConnectionWriteQueue = class {
+    /**
+     * @param writeFailed Ends the connection whose transport write failed (spec
+     *   stream-connector 32 §9: a transport write failure ends the connection as
+     *   `TransportError`).
+     */
+    constructor(connection, writeFailed) {
+      this.connection = connection;
+      this.writeFailed = writeFailed;
+      __publicField(this, "queue", /* @__PURE__ */ new Set());
+      __publicField(this, "active");
+    }
+    enqueue(operation) {
+      this.queue.add(operation);
+      this.advance();
+    }
+    cancel(operation, error) {
+      if (this.queue.delete(operation) || this.active === operation) operation.fail(error);
+    }
+    /**
+     * Spec stream-connector 32 §7: when the connection ends, frames that have not
+     * reached the transport are not written and the frame being written is not
+     * waited for. The operations of both fail with `error`.
+     */
+    failAll(error) {
+      const operations = Array.from(this.queue);
+      if (this.active !== void 0) operations.unshift(this.active);
+      this.queue.clear();
+      this.active = void 0;
+      for (const operation of operations) operation.fail(error);
+    }
+    advance() {
+      if (this.active !== void 0) return;
+      const next = this.queue.values().next().value;
+      if (next === void 0) return;
+      this.queue.delete(next);
+      this.active = next;
+      let write;
+      try {
+        write = Promise.resolve(this.connection.write(next.frame));
+      } catch (error) {
+        write = Promise.reject(error);
+      }
+      void write.then(
+        () => next.complete(),
+        (cause) => this.failWrite(next, cause)
+      ).finally(() => {
+        if (this.active !== next) return;
+        this.active = void 0;
+        this.advance();
+      });
+    }
+    /**
+     * Spec stream-connector 32 §9: a transport write failure is `SendFailed` for
+     * the operation of that write, and it ends the connection. The ending fails
+     * every other operation of the connection with `Disconnected`. A write that
+     * fails after the connection already ended belongs to that ending, which has
+     * already failed its operation with `Disconnected`.
+     */
+    failWrite(operation, cause) {
+      if (this.active !== operation) return;
+      const error = {
+        code: "sendFailed" /* SendFailed */,
+        message: `Frame write failed: ${cause instanceof Error ? cause.message : String(cause)}`,
+        cause
+      };
+      operation.fail(new ZlinkStreamException(error));
+      this.writeFailed(error);
+    }
+  };
   var ZlinkStreamFrameSender = class {
     constructor(protocol) {
       this.protocol = protocol;
-      __publicField(this, "pendingWrites", /* @__PURE__ */ new Set());
+      __publicField(this, "queues", /* @__PURE__ */ new Map());
     }
-    async send(connection, kind, name, payload, metadata, compress, requestSeq, signal, correlationId, actorSlot) {
+    async send(connection, kind, name, payload, metadata, compress, requestSeq, signal, correlationId, actorSlot, expiry, onAccepted) {
       throwIfAborted(signal);
       await this.write(
         connection,
@@ -1987,224 +2415,96 @@ var ZlinkStreamConnectorBundle = (() => {
           compress,
           requestSeq,
           correlationId,
-          actorSlot
-        ),
-        signal
-      );
-    }
-    async sendControl(connection, name, signal) {
-      await this.write(connection, this.protocol.encodeControl(name), signal);
-    }
-    async drain(signal) {
-      while (this.pendingWrites.size > 0) {
-        throwIfAborted(signal);
-        await Promise.allSettled(Array.from(this.pendingWrites));
-      }
-    }
-    async write(connection, frame, signal) {
-      const write = connection.write(frame, signal);
-      this.pendingWrites.add(write);
-      try {
-        await write;
-      } finally {
-        this.pendingWrites.delete(write);
-      }
-    }
-  };
-
-  // packages/stream-connector/src/Runtime/Protocol/ZlinkSessionClosing.ts
-  var ZLINK_SESSION_CLOSING = "session-closing";
-  var reasons = {
-    1: "ClientClose",
-    2: "IdleTimeout",
-    3: "HeartbeatTimeout",
-    4: "ServerDrain",
-    5: "ProtocolError",
-    6: "TransportError"
-  };
-  function decodeSessionClosing(payload) {
-    if (payload.length < 4 || payload[0] !== 1)
-      throw new Error("Unsupported session-closing version.");
-    const closeReason = reasons[payload[1]];
-    if (closeReason === void 0) throw new Error("Unknown session-closing reason.");
-    const length = payload[2] << 8 | payload[3];
-    if (length > 512 || payload.length !== 4 + length)
-      throw new Error("Invalid session-closing diagnostic length.");
-    const diagnostic = length === 0 ? void 0 : new TextDecoder("utf-8", { fatal: true }).decode(payload.subarray(4));
-    return { closeReason, diagnostic };
-  }
-
-  // packages/stream-connector/src/Runtime/ZlinkStreamActors.ts
-  var ACTOR_BOUND = "$zlink.actor.bound";
-  var ACTOR_UNBOUND = "$zlink.actor.unbound";
-  var zlinkStreamActorBinding = Symbol("zlink.stream.actorBinding");
-  var DefaultZlinkStreamActor = class {
-    constructor(connector, actorId, slot) {
-      this.connector = connector;
-      this.actorId = actorId;
-      this.slot = slot;
-      __publicField(this, "bound", true);
-    }
-    get isBound() {
-      return this.bound;
-    }
-    send(payload, messageType) {
-      this.ensureBound();
-      return this.connector.sendForActor(this, payload, messageType);
-    }
-    request(payload, messageType) {
-      this.ensureBound();
-      return this.connector.requestForActor(this, payload, messageType);
-    }
-    on(nameOrType, handler, messageType) {
-      return this.connector.onActorMessage(this, nameOrType, handler, messageType);
-    }
-    ensureBound() {
-      if (!this.bound) {
-        throw connectorError(
-          "validationFailed" /* ValidationFailed */,
-          `Actor '${this.actorId}' is no longer bound.`
-        );
-      }
-    }
-    close() {
-      this.bound = false;
-    }
-  };
-  var ZlinkStreamActors = class {
-    constructor(connector, receivedMessages, events) {
-      this.connector = connector;
-      this.receivedMessages = receivedMessages;
-      this.events = events;
-      __publicField(this, "bySlot", /* @__PURE__ */ new Map());
-      __publicField(this, "byId", /* @__PURE__ */ new Map());
-      __publicField(this, "issued", []);
-      __publicField(this, "boundHandlers", /* @__PURE__ */ new Set());
-      __publicField(this, "unboundHandlers", /* @__PURE__ */ new Set());
-    }
-    get snapshot() {
-      return Object.freeze(Array.from(this.bySlot.values()));
-    }
-    find(actorId) {
-      return this.byId.get(actorId);
-    }
-    onBound(handler) {
-      this.boundHandlers.add(handler);
-      return subscription(() => this.boundHandlers.delete(handler));
-    }
-    onUnbound(handler) {
-      this.unboundHandlers.add(handler);
-      return subscription(() => this.unboundHandlers.delete(handler));
-    }
-    processControl(name, payload, signal) {
-      if (name === ACTOR_BOUND) {
-        this.bind(payload, signal);
-        return true;
-      }
-      if (name === ACTOR_UNBOUND) {
-        this.unbind(payload, signal);
-        return true;
-      }
-      return false;
-    }
-    resolve(slot) {
-      const actor = this.bySlot.get(slot);
-      if (actor === void 0) {
-        throw connectorError(
-          "frameDecodeFailed" /* FrameDecodeFailed */,
-          `Actor slot '${slot}' is not bound.`
-        );
-      }
-      return actor;
-    }
-    closeAll(signal) {
-      for (const actor of this.issued) {
-        if (!actor.isBound) continue;
-        this.bySlot.delete(actor.slot);
-        this.byId.delete(actor.actorId);
-        actor.close();
-        this.queue(this.unboundHandlers, actor, signal);
-      }
-      this.issued.length = 0;
-    }
-    bind(payload, signal) {
-      if (payload.length < 5 || payload[0] !== 1) {
-        throw invalidControl("Actor bound payload is invalid.");
-      }
-      const slot = payload[1] << 8 | payload[2];
-      const idLength = payload[3];
-      if (slot === 0 || idLength === 0 || payload.length !== 4 + idLength) {
-        throw invalidControl("Actor bound payload is invalid.");
-      }
-      let actorId;
-      try {
-        actorId = new TextDecoder("utf-8", { fatal: true }).decode(payload.subarray(4));
-      } catch (cause) {
-        throw connectorError(
-          "frameDecodeFailed" /* FrameDecodeFailed */,
-          "Actor id is not valid UTF-8.",
-          cause
-        );
-      }
-      if (actorId.length === 0 || this.bySlot.has(slot) || this.byId.has(actorId)) {
-        throw invalidControl("Actor bound identity is already in use.");
-      }
-      const actor = new DefaultZlinkStreamActor(this.connector, actorId, slot);
-      this.bySlot.set(slot, actor);
-      this.byId.set(actorId, actor);
-      this.issued.push(actor);
-      this.queue(this.boundHandlers, actor, signal);
-    }
-    unbind(payload, signal) {
-      if (payload.length !== 3 || payload[0] !== 1) {
-        throw invalidControl("Actor unbound payload is invalid.");
-      }
-      const slot = payload[1] << 8 | payload[2];
-      const actor = this.bySlot.get(slot);
-      if (slot === 0 || actor === void 0) {
-        throw invalidControl(`Actor slot '${slot}' is not bound.`);
-      }
-      this.bySlot.delete(slot);
-      this.byId.delete(actor.actorId);
-      actor.close();
-      this.queue(this.unboundHandlers, actor, signal);
+          actorSlot
+        ),
+        signal,
+        expiry,
+        onAccepted
+      );
     }
-    queue(handlers, actor, signal) {
-      this.receivedMessages.enqueueCallback(() => {
-        for (const handler of Array.from(handlers)) {
-          this.invoke(handler, actor, signal);
-        }
+    /**
+     * Writes a control frame (heartbeat ping or pong). A control frame belongs to
+     * no operation: its write failure ends the connection through the write
+     * queue like any other write (spec stream-connector 32 §9), and a connection
+     * that has already ended does not write it. The promise settles when the
+     * write has ended either way.
+     */
+    sendControl(connection, name) {
+      const queue = this.queues.get(connection);
+      if (queue === void 0) return Promise.resolve();
+      const frame = this.protocol.encodeControl(name);
+      return new Promise((resolve) => {
+        queue.enqueue({ frame, complete: resolve, fail: () => resolve() });
       });
     }
-    invoke(handler, actor, signal) {
-      try {
-        Promise.resolve(handler(actor, signal)).catch((cause) => {
-          void this.events.publishError(
-            {
-              code: "userCallbackFailed" /* UserCallbackFailed */,
-              message: "Actor lifecycle handler failed.",
-              cause
-            },
-            signal
-          );
-        });
-      } catch (cause) {
-        void this.events.publishError(
-          {
-            code: "userCallbackFailed" /* UserCallbackFailed */,
-            message: "Actor lifecycle handler failed.",
-            cause
-          },
-          signal
-        );
+    /**
+     * Gives a connection that has just been established its own write queue.
+     * `writeFailed` ends that connection when one of its transport writes fails.
+     */
+    open(connection, writeFailed) {
+      this.queues.set(connection, new ZlinkStreamConnectionWriteQueue(connection, writeFailed));
+    }
+    /**
+     * Ends the write queue of a connection that has ended, by close and by
+     * transport loss alike. Every operation still in it fails with `error`.
+     */
+    failUnwritten(connection, error) {
+      const queue = this.queues.get(connection);
+      if (queue === void 0) return;
+      this.queues.delete(connection);
+      queue.failAll(error);
+    }
+    write(connection, frame, signal, expiry, onAccepted) {
+      throwIfAborted(signal);
+      const queue = this.queues.get(connection);
+      if (queue === void 0) {
+        throw connectorError("disconnected" /* Disconnected */, "Connector is not connected.");
       }
+      let operation;
+      let settled = false;
+      const promise = new Promise((resolve, reject) => {
+        const cleanup = () => signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
+        const onAbort = () => queue.cancel(
+          operation,
+          connectorError("disconnected" /* Disconnected */, "Operation canceled.")
+        );
+        operation = {
+          frame,
+          complete: () => {
+            if (settled) return;
+            settled = true;
+            cleanup();
+            resolve();
+          },
+          fail: (error) => {
+            if (settled) return;
+            settled = true;
+            cleanup();
+            reject(error);
+          }
+        };
+        signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
+        onAccepted == null ? void 0 : onAccepted();
+        expiry == null ? void 0 : expiry.then(void 0, (error) => queue.cancel(operation, error));
+        queue.enqueue(operation);
+      });
+      return promise;
     }
   };
-  function invalidControl(message) {
-    return connectorError("frameDecodeFailed" /* FrameDecodeFailed */, message);
-  }
+
+  // packages/stream-connector/src/Runtime/Protocol/ZlinkSessionClosing.ts
+  var ZLINK_SESSION_CLOSING = ZlinkStreamControlPacket.SessionClosing;
 
   // packages/stream-connector/src/Runtime/ZlinkStreamReceiveDispatcher.ts
+  function closeReasonFor(error) {
+    return error.code === "frameDecodeFailed" /* FrameDecodeFailed */ || error.code === "frameTooLarge" /* FrameTooLarge */ ? "ProtocolError" : "TransportError";
+  }
+  var ZlinkStreamConnectionEnd = class extends Error {
+    constructor(error) {
+      super(error.message);
+      this.error = error;
+    }
+  };
   var ZlinkStreamReceiveDispatcher = class {
     constructor(protocol, pendingRequests, receivedMessages, frameSender, events, actors, serverClosing) {
       this.protocol = protocol;
@@ -2224,15 +2524,20 @@ var ZlinkStreamConnectorBundle = (() => {
      *   the recheck the rest of a dead connection's batch lands on the new
      *   connection's state, and the §10 arrival counts, which start at 0 when a
      *   connection is established, take the stale frames on top.
-     * @param connectionForSend Resolves the connection a reply belongs on at the
-     *   moment it is written. The captured `connection` is the one the batch was
-     *   read from, which a reconnect may already have replaced.
      */
-    async readAndDispatch(connection, signal, isCurrent, connectionForSend) {
+    async readAndDispatch(connection, signal, isCurrent) {
       if ((connection == null ? void 0 : connection.read) === void 0) {
         return { available: false, inbound: false };
       }
-      const frameBytes = await connection.read(signal);
+      let frameBytes;
+      try {
+        frameBytes = await connection.read(signal);
+      } catch (cause) {
+        if ((signal == null ? void 0 : signal.aborted) === true) throw cause;
+        throw new ZlinkStreamConnectionEnd(
+          toStreamError(cause, "disconnected" /* Disconnected */, "Transport read failed.")
+        );
+      }
       if (isCurrent !== void 0 && !isCurrent()) {
         return { available: false, inbound: false };
       }
@@ -2243,87 +2548,96 @@ var ZlinkStreamConnectorBundle = (() => {
       try {
         frames = this.protocol.decodeFrames(frameBytes);
       } catch (cause) {
-        throw cause;
+        throw new ZlinkStreamConnectionEnd(
+          toStreamError(cause, "frameDecodeFailed" /* FrameDecodeFailed */, "Frame decode failed.")
+        );
       }
       for (const frame of frames) {
         if (isCurrent !== void 0 && !isCurrent()) {
           break;
         }
         try {
-          await this.dispatch(connection, frame.header, frame.payload, signal, connectionForSend);
+          await this.dispatch(connection, frame.header, frame.payload, signal);
         } catch (cause) {
-          if (frame.header.kind === 5 /* Control */ && frame.header.name === ZLINK_STREAM_HEARTBEAT_PING) {
-            throw cause;
-          }
+          if (cause instanceof ZlinkStreamConnectionEnd) throw cause;
           const error = toStreamError(
             cause,
             "frameDecodeFailed" /* FrameDecodeFailed */,
             "Frame dispatch failed."
           );
           if (error.code === "frameDecodeFailed" /* FrameDecodeFailed */) {
-            throw cause;
+            throw new ZlinkStreamConnectionEnd(error);
           }
-          await this.events.publishError(error, signal);
+          this.events.publishError(error, signal);
         }
       }
       return { available: true, inbound: true };
     }
-    async dispatch(connection, header, payload, signal, connectionForSend) {
+    /**
+     * Spec stream-connector 32 §4.7 and §9: a decompressed payload over the
+     * receive limit is `FrameTooLarge` and ends the connection as a protocol
+     * error, like a wire payload over the limit. A payload that does not
+     * decompress fails only its packet.
+     */
+    decodePayload(header, payload) {
+      try {
+        return this.protocol.decodePayload(header, payload);
+      } catch (cause) {
+        const error = toStreamError(
+          cause,
+          "decompressionFailed" /* DecompressionFailed */,
+          "Decompression failed."
+        );
+        if (error.code === "frameTooLarge" /* FrameTooLarge */) {
+          throw new ZlinkStreamConnectionEnd(error);
+        }
+        throw cause;
+      }
+    }
+    async dispatch(connection, header, payload, signal) {
       const actor = header.actorSlot === void 0 ? void 0 : this.actors.resolve(header.actorSlot);
       if (header.kind === 3 /* Response */ && header.requestSeq !== void 0) {
         try {
-          if (!this.pendingRequests.resolve(
+          this.pendingRequests.resolve(
             header.requestSeq,
-            {
+            () => ({
               codec: header.codec,
-              payload: this.protocol.decodePayload(header, payload)
-            },
+              payload: this.decodePayload(header, payload)
+            }),
             header.metadata
-          )) {
-            await this.events.publishError(
-              {
-                code: "frameDecodeFailed" /* FrameDecodeFailed */,
-                message: `Response request sequence '${header.requestSeq}' has no pending request.`
-              },
-              signal
-            );
-          }
+          );
         } catch (cause) {
+          if (cause instanceof ZlinkStreamConnectionEnd) throw cause;
           const decodeError = toStreamError(
             cause,
             "decompressionFailed" /* DecompressionFailed */,
             "Decompression failed."
           );
           if (!this.pendingRequests.reject(header.requestSeq, decodeError)) {
-            await this.events.publishError(decodeError, signal);
+            this.events.publishError(decodeError, signal);
           }
         }
         return;
       }
-      if (header.kind === 4 /* Error */ && header.requestSeq !== void 0) {
+      if (header.kind === 4 /* Error */) {
+        let error;
         try {
-          const remoteError = decodeRemoteError(this.protocol, header, payload);
-          if (!this.pendingRequests.reject(header.requestSeq, remoteError)) {
-            await this.events.publishError(remoteError, signal);
-          }
+          error = decodeRemoteError(this.decodePayload(header, payload));
         } catch (cause) {
-          const decodeError = toStreamError(
+          if (cause instanceof ZlinkStreamConnectionEnd) throw cause;
+          error = toStreamError(
             cause,
             "frameDecodeFailed" /* FrameDecodeFailed */,
             "Remote error payload is invalid."
           );
-          if (!this.pendingRequests.reject(header.requestSeq, decodeError)) {
-            await this.events.publishError(decodeError, signal);
-          }
         }
-        return;
-      }
-      if (header.kind === 4 /* Error */) {
-        await this.events.publishError(decodeRemoteError(this.protocol, header, payload), signal);
+        if (header.requestSeq === void 0 || !this.pendingRequests.reject(header.requestSeq, error)) {
+          this.events.publishError(error, signal);
+        }
         return;
       }
       if (header.kind === 5 /* Control */) {
-        await this.dispatchControl(connection, header, payload, signal, connectionForSend);
+        await this.dispatchControl(connection, header, payload, signal);
         return;
       }
       if (header.kind === 1 /* Send */) {
@@ -2331,7 +2645,7 @@ var ZlinkStreamConnectorBundle = (() => {
           {
             name: header.name,
             metadata: header.metadata,
-            payload: { codec: header.codec, payload: this.protocol.decodePayload(header, payload) },
+            payload: { codec: header.codec, payload: this.decodePayload(header, payload) },
             actorId: actor == null ? void 0 : actor.actorId,
             [zlinkStreamActorBinding]: actor
           },
@@ -2339,13 +2653,13 @@ var ZlinkStreamConnectorBundle = (() => {
         );
       }
     }
-    async dispatchControl(connection, header, payload, signal, connectionForSend) {
-      var _a, _b;
+    async dispatchControl(connection, header, payload, signal) {
+      var _a;
       if (this.actors.processControl(header.name, payload, signal)) {
         return;
       }
       if (header.name === ZLINK_SESSION_CLOSING) {
-        const closing = decodeSessionClosing(payload);
+        const closing = decodeStreamWireSessionClosing(payload);
         await ((_a = this.serverClosing) == null ? void 0 : _a.call(this, closing.closeReason));
         return;
       }
@@ -2356,18 +2670,7 @@ var ZlinkStreamConnectorBundle = (() => {
         );
       }
       if (header.name === ZLINK_STREAM_HEARTBEAT_PING) {
-        try {
-          await this.frameSender.sendControl(
-            (_b = connectionForSend == null ? void 0 : connectionForSend()) != null ? _b : connection,
-            ZLINK_STREAM_HEARTBEAT_PONG,
-            signal
-          );
-        } catch (cause) {
-          throw connectorError(
-            "sendFailed" /* SendFailed */,
-            cause instanceof Error ? cause.message : "Heartbeat pong send failed."
-          );
-        }
+        await this.frameSender.sendControl(connection, ZLINK_STREAM_HEARTBEAT_PONG);
         return;
       }
       if (header.name !== ZLINK_STREAM_HEARTBEAT_PONG) {
@@ -2375,8 +2678,7 @@ var ZlinkStreamConnectorBundle = (() => {
       }
     }
   };
-  function decodeRemoteError(protocol, header, payload) {
-    const decodedPayload = protocol.decodePayload(header, payload);
+  function decodeRemoteError(decodedPayload) {
     let decoded;
     try {
       decoded = JSON.parse(utf8Decode2(decodedPayload));
@@ -2398,8 +2700,11 @@ var ZlinkStreamConnectorBundle = (() => {
   }
 
   // packages/stream-connector/src/Runtime/ZlinkStreamConnectorLifecycle.ts
+  var RECONNECT_JITTER_FLOOR = 0.5;
   function randomizedDelay(baseDelayMs) {
-    return Math.round(baseDelayMs * (0.5 + Math.random() * 0.5));
+    return Math.round(
+      baseDelayMs * (RECONNECT_JITTER_FLOOR + Math.random() * (1 - RECONNECT_JITTER_FLOOR))
+    );
   }
   var ZlinkStreamConnectorLifecycle = class {
     constructor(options, pendingRequests, frameSender, receiveDispatcher, receivedMessages, actors, events) {
@@ -2422,11 +2727,11 @@ var ZlinkStreamConnectorBundle = (() => {
       __publicField(this, "lastInboundAt", 0);
       __publicField(this, "closeTask");
       __publicField(this, "connectTask");
+      __publicField(this, "connectAbort");
       __publicField(this, "disconnectTask");
       __publicField(this, "closeRequested", false);
       __publicField(this, "disconnectedPublished", false);
       __publicField(this, "closeReasonValue");
-      __publicField(this, "lateConnectCleanupError");
     }
     get isConnected() {
       return this.currentState === "connected" /* Connected */;
@@ -2455,18 +2760,22 @@ var ZlinkStreamConnectorBundle = (() => {
       });
       return await this.connectTask;
     }
+    /**
+     * Spec stream-connector 32 §7: close does not wait for a connect attempt or a
+     * reconnect delay to run its course. The attempts listen to one controller
+     * the lifecycle owns; close aborts it, and the caller's signal is forwarded
+     * to it.
+     */
     async connectOnce(signal) {
-      var _a;
-      await this.setState("connecting" /* Connecting */, void 0, signal);
+      const attempts = new AbortController();
+      const forwardAbort = () => attempts.abort();
+      signal == null ? void 0 : signal.addEventListener("abort", forwardAbort, { once: true });
+      this.connectAbort = attempts;
+      this.setState("connecting" /* Connecting */, void 0, signal);
       try {
-        const connection = await this.connectWithReconnect(signal);
+        const connection = await this.connectWithReconnect(attempts.signal);
         if (this.closeRequested) {
-          try {
-            await connection.close(signal);
-          } catch (error) {
-            this.lateConnectCleanupError = error;
-            throw error;
-          }
+          await this.closeTransport(connection, void 0, signal);
           throw connectorError(
             "disconnected" /* Disconnected */,
             "Connector closed while connecting."
@@ -2474,41 +2783,62 @@ var ZlinkStreamConnectorBundle = (() => {
         }
         this.currentConnection = connection;
         this.connectionGeneration += 1;
+        const generation = this.connectionGeneration;
+        this.frameSender.open(connection, (error) => {
+          void this.disconnectForTransportFailure(error, connection, generation);
+        });
         this.disconnectedPublished = false;
         this.receivedMessages.resetForNewConnection();
         this.lastInboundAt = Date.now();
-        await this.setState("connected" /* Connected */, void 0, signal);
+        this.setState("connected" /* Connected */, void 0, signal);
         this.startHeartbeat();
         this.startReceiveLoop();
       } catch (cause) {
         if (this.closeRequested) {
           const message = cause instanceof Error ? cause.message : "Connector closed while connecting.";
-          const error2 = toStreamError(cause, "disconnected" /* Disconnected */, message);
-          throw new ZlinkStreamException(error2);
+          throw connectorError("disconnected" /* Disconnected */, message, cause);
+        }
+        if ((signal == null ? void 0 : signal.aborted) === true) {
+          this.setState("disconnected" /* Disconnected */, void 0, signal);
+          throwIfAborted(signal);
         }
         const error = toStreamError(cause, "connectTimeout" /* ConnectTimeout */, "Connect failed.");
-        (_a = this.closeReasonValue) != null ? _a : this.closeReasonValue = "TransportError";
-        void this.setState("disconnected" /* Disconnected */, error, signal);
-        this.publishDisconnectedWithoutWaiting(signal);
+        this.closeReasonValue = "TransportError";
+        this.setState("disconnected" /* Disconnected */, error, signal);
+        this.disconnectedPublished = false;
+        this.publishDisconnected(signal);
         throw new ZlinkStreamException(error);
+      } finally {
+        signal == null ? void 0 : signal.removeEventListener("abort", forwardAbort);
+        this.connectAbort = void 0;
       }
     }
+    /**
+     * Spec stream-connector 32 §7: a `close` called outside the registered
+     * handlers and callbacks returns once the close work has ended. One called
+     * from inside them returns right after starting it; the result goes to the
+     * outside caller, so a callback never waits for the close of the path that
+     * is running it.
+     */
     async close(signal) {
-      this.closeReasonValue = "ClientClose";
-      this.closeRequested = true;
-      if (this.closeTask !== void 0) {
-        return await this.closeTask;
+      var _a;
+      if (this.currentConnection !== void 0 || this.closeReasonValue === void 0) {
+        this.closeReasonValue = "ClientClose";
       }
-      if (this.currentState === "closed" /* Closed */) {
+      this.closeRequested = true;
+      if (this.closeTask === void 0 && this.currentState === "closed" /* Closed */) {
         return;
       }
-      this.closeTask = this.closeOnce(signal).finally(() => {
+      const closeTask = (_a = this.closeTask) != null ? _a : this.closeTask = this.closeOnce(signal).finally(() => {
         this.closeTask = void 0;
       });
-      return await this.closeTask;
+      if (this.receivedMessages.dispatching) {
+        void closeTask.catch(() => void 0);
+        return;
+      }
+      return await closeTask;
     }
     async serverClosing(reason) {
-      this.closeReasonValue = reason;
       const error = {
         code: "disconnected" /* Disconnected */,
         message: `Server closed the session: ${reason}.`
@@ -2516,42 +2846,19 @@ var ZlinkStreamConnectorBundle = (() => {
       await this.disconnectForTransportFailure(
         error,
         this.currentConnection,
-        this.connectionGeneration
+        this.connectionGeneration,
+        reason
       );
     }
     async closeOnce(signal) {
-      var _a, _b;
-      await ((_a = this.connectTask) == null ? void 0 : _a.catch(() => void 0));
-      await ((_b = this.disconnectTask) == null ? void 0 : _b.catch(() => void 0));
-      const connection = this.currentConnection;
-      this.stopHeartbeat();
-      this.stopReceiveLoop();
-      this.currentConnection = void 0;
-      const errors = [];
-      if (this.lateConnectCleanupError !== void 0) {
-        errors.push(this.lateConnectCleanupError);
-        this.lateConnectCleanupError = void 0;
-      }
-      try {
-        await this.frameSender.drain(signal);
-      } catch (error) {
-        errors.push(error);
-      }
-      try {
-        await (connection == null ? void 0 : connection.close(signal));
-      } catch (error) {
-        errors.push(error);
-      }
-      this.pendingRequests.failAll({
-        code: "disconnected" /* Disconnected */,
-        message: "Connector closed."
-      });
-      this.receivedMessages.connectionEnded();
-      this.actors.closeAll(signal);
-      this.queueState("closed" /* Closed */, void 0, signal);
-      this.queueDisconnected(signal);
-      if (errors.length === 1) throw errors[0];
-      if (errors.length > 1) throw new AggregateError(errors, "Stream connector close failed.");
+      var _a, _b, _c;
+      (_a = this.connectAbort) == null ? void 0 : _a.abort();
+      await ((_b = this.connectTask) == null ? void 0 : _b.catch(() => void 0));
+      await ((_c = this.disconnectTask) == null ? void 0 : _c.catch(() => void 0));
+      await this.tearDownConnection(
+        { code: "disconnected" /* Disconnected */, message: "Connector closed." },
+        signal
+      );
     }
     /**
      * Spec stream-connector 32 §7: `dispatch` runs the callbacks the receive loop
@@ -2567,7 +2874,7 @@ var ZlinkStreamConnectorBundle = (() => {
       if (this.options.dispatchMode !== "immediate" /* Immediate */) {
         await this.settleReceiveLoop();
       }
-      await this.receivedMessages.pump();
+      this.receivedMessages.pump();
     }
     connectionForSend() {
       if (this.currentConnection === void 0 || this.currentState !== "connected" /* Connected */) {
@@ -2580,8 +2887,7 @@ var ZlinkStreamConnectorBundle = (() => {
       const result = await this.receiveDispatcher.readAndDispatch(
         connection,
         signal,
-        () => this.isCurrentConnection(connection, generation),
-        () => this.connectionForSend()
+        () => this.isCurrentConnection(connection, generation)
       );
       if (result.inbound && this.isCurrentConnection(connection, generation)) {
         this.lastInboundAt = Date.now();
@@ -2590,7 +2896,10 @@ var ZlinkStreamConnectorBundle = (() => {
     }
     async connectWithReconnect(signal) {
       let attempt = 0;
-      let delayMs = this.options.reconnect.initialDelayMs;
+      let delayMs = Math.min(
+        this.options.reconnect.initialDelayMs,
+        this.options.reconnect.maxDelayMs
+      );
       let lastError;
       const maxAttempts = this.options.reconnect.enabled ? this.options.reconnect.maxAttempts : 1;
       const unlimited = maxAttempts === null;
@@ -2600,10 +2909,10 @@ var ZlinkStreamConnectorBundle = (() => {
           return await this.options.transportFactory.connect(this.options, signal);
         } catch (cause) {
           lastError = toStreamError(cause, "connectTimeout" /* ConnectTimeout */, "Connect failed.");
-          if (!this.options.reconnect.enabled || !unlimited && attempt >= maxAttempts) {
+          if (this.closeRequested || !this.options.reconnect.enabled || !unlimited && attempt >= maxAttempts) {
             break;
           }
-          await this.setState("reconnecting" /* Reconnecting */, lastError, signal);
+          this.setState("reconnecting" /* Reconnecting */, lastError, signal);
           await delay(randomizedDelay(delayMs), signal);
           delayMs = Math.min(
             this.options.reconnect.maxDelayMs,
@@ -2673,12 +2982,8 @@ var ZlinkStreamConnectorBundle = (() => {
         }
       } catch (cause) {
         if (signal.aborted) return;
-        const error = toStreamError(
-          cause,
-          "frameDecodeFailed" /* FrameDecodeFailed */,
-          "Receive loop failed."
-        );
-        await this.disconnectForTransportFailure(error, connection, generation);
+        if (!(cause instanceof ZlinkStreamConnectionEnd)) throw cause;
+        await this.disconnectForTransportFailure(cause.error, connection, generation);
       } finally {
         this.receiveLoopSleeping = false;
         this.releaseReceiveLoopSettled();
@@ -2735,57 +3040,97 @@ var ZlinkStreamConnectorBundle = (() => {
         return;
       }
       if (Date.now() - this.lastInboundAt > this.options.heartbeat.timeoutMs) {
-        this.closeReasonValue = "HeartbeatTimeout";
         const error = { code: "disconnected" /* Disconnected */, message: "Heartbeat timed out." };
         await this.disconnectForTransportFailure(
           error,
           this.currentConnection,
-          this.connectionGeneration
+          this.connectionGeneration,
+          "HeartbeatTimeout"
         );
         return;
       }
-      const connection = this.currentConnection;
-      const generation = this.connectionGeneration;
-      try {
-        await this.frameSender.sendControl(this.connectionForSend(), ZLINK_STREAM_HEARTBEAT_PING);
-      } catch (cause) {
-        const error = toStreamError(cause, "sendFailed" /* SendFailed */, "Heartbeat send failed.");
-        await this.disconnectForTransportFailure(error, connection, generation);
-      }
+      await this.frameSender.sendControl(this.connectionForSend(), ZLINK_STREAM_HEARTBEAT_PING);
     }
-    async disconnectForTransportFailure(error, origin, generation) {
-      var _a;
-      (_a = this.closeReasonValue) != null ? _a : this.closeReasonValue = "TransportError";
+    /**
+     * @param reason Given only where the reason is not read from `error`: a
+     *   server `session-closing` and the heartbeat timeout. Every other ending
+     *   takes it from {@link closeReasonFor}.
+     */
+    async disconnectForTransportFailure(error, origin, generation, reason = closeReasonFor(error)) {
       if (this.closeRequested || this.currentState === "closed" /* Closed */) {
         return;
       }
       if (origin !== void 0 && !this.isCurrentConnection(origin, generation)) {
         return;
       }
+      this.closeReasonValue = reason;
       if (this.disconnectTask !== void 0) {
         return await this.disconnectTask;
       }
-      this.disconnectTask = this.tearDownConnection(error).finally(() => {
-        this.disconnectTask = void 0;
+      let resolve;
+      let reject;
+      const pending = new Promise((complete, fail) => {
+        resolve = complete;
+        reject = fail;
       });
-      await this.disconnectTask;
-      await this.announceDisconnect(error);
+      const task = pending.finally(() => {
+        if (this.disconnectTask === task) this.disconnectTask = void 0;
+      });
+      this.disconnectTask = task;
+      void this.tearDownConnection(error).then(resolve, reject);
+      await task;
+      this.announceDisconnect();
     }
     isCurrentConnection(connection, generation) {
       return !this.closeRequested && this.currentConnection === connection && this.connectionGeneration === generation;
     }
-    /** Transport teardown only — no application callback runs from here. */
-    async tearDownConnection(error) {
+    /**
+     * Ends the current connection, for close and for transport loss alike. No
+     * application callback runs before terminal operations settle. Spec stream-connector 32 §7 and §9:
+     * every operation the ending connection fails (the frames it has not
+     * written, the one it is writing and the pending requests) fails with
+     * `Disconnected`, whatever ended it; the cause stays in the close reason.
+     * The transport is closed without waiting for the frames.
+     */
+    async tearDownConnection(error, signal) {
       this.stopHeartbeat();
       this.stopReceiveLoop();
       const connection = this.currentConnection;
       this.currentConnection = void 0;
-      this.pendingRequests.failAll(error);
+      const disconnected = { code: "disconnected" /* Disconnected */, message: error.message };
+      if (connection !== void 0) {
+        this.frameSender.failUnwritten(
+          connection,
+          connectorError(disconnected.code, disconnected.message)
+        );
+      }
+      this.pendingRequests.failAll(disconnected);
       this.receivedMessages.connectionEnded();
-      this.actors.closeAll();
+      this.actors.closeAll(signal);
+      await this.closeTransport(connection, error, signal);
+    }
+    async closeTransport(connection, error, signal) {
       try {
-        await (connection == null ? void 0 : connection.close());
-      } catch {
+        try {
+          await (connection == null ? void 0 : connection.close(signal));
+        } finally {
+          this.setState(
+            this.closeRequested ? "closed" /* Closed */ : "disconnected" /* Disconnected */,
+            this.closeRequested ? void 0 : error,
+            signal
+          );
+        }
+      } catch (cause) {
+        this.events.publishError(
+          {
+            code: "disconnected" /* Disconnected */,
+            message: `Transport close failed: ${cause instanceof Error ? cause.message : String(cause)}`,
+            cause
+          },
+          signal
+        );
+      } finally {
+        this.publishDisconnected(signal);
       }
     }
     /**
@@ -2796,10 +3141,7 @@ var ZlinkStreamConnectorBundle = (() => {
      * handler that is slow — or whose promise never settles at all — must not
      * cost the connector the attempt.
      */
-    async announceDisconnect(error) {
-      if (this.closeRequested) return;
-      this.queueState("disconnected" /* Disconnected */, error);
-      this.queueDisconnected();
+    announceDisconnect() {
       if (this.shouldReconnect()) {
         queueMicrotask(() => {
           void this.connect().catch(() => void 0);
@@ -2809,112 +3151,127 @@ var ZlinkStreamConnectorBundle = (() => {
     shouldReconnect() {
       return this.options.reconnect.enabled && !this.closeRequested;
     }
-    // Synchronous test-and-set, taken before any await, so the single disconnect
-    // notification the spec promises is claimed by exactly one caller even when
-    // the publishing itself is deferred.
-    claimDisconnectedPublish() {
-      if (this.disconnectedPublished) return false;
-      this.disconnectedPublished = true;
-      return true;
-    }
-    async publishDisconnectedOnce(signal) {
-      if (!this.claimDisconnectedPublish()) return;
-      await this.events.publishDisconnected(signal);
-    }
     /**
-     * Spec stream-connector 32 §7: the connector runs the registered handler, it
-     * does not wait for it to finish. `close` returns once its own work is done —
-     * the drain, the transport close, the pending requests — having run the
-     * disconnect handler but without looking at whether that handler has ended.
-     *
-     * Starting the publish without awaiting it still runs every handler right
-     * here: an `async` function body runs synchronously up to its first `await`,
-     * and `publishDisconnected` reaches each handler before that point. So the
-     * handler has run by the time `close` returns, which is what the spec asks
-     * for, while a handler that calls `close` no longer waits for the very
-     * `closeTask` it is running inside. Java and C++ hand the handler to a queue
-     * and return the same way.
-     *
-     * `claimDisconnectedPublish` is taken by the same call and before any await,
-     * so deferring the completion never turns the one notification into two.
-     *
-     * Nothing awaits the promise, so a rejection would reach the process as an
-     * unhandled rejection and kill it. Handler failures are already contained
-     * where they were before this call stopped waiting — the `Promise.allSettled`
-     * in `publishDisconnected` — and this `catch` covers what is left rather than
-     * reporting the same failure a second time on the error surface.
+     * Spec stream-connector 32 §6 and §7: one disconnect notification per
+     * lifecycle event, handed to the dispatch queue. The connector does not wait
+     * for the handler; `Manual` runs it when the application pumps dispatch.
+     * The flag is tested and set synchronously, so concurrent callers for the
+     * same event claim it once.
      */
-    publishDisconnectedWithoutWaiting(signal) {
-      void this.publishDisconnectedOnce(signal).catch(() => void 0);
-    }
-    queueDisconnected(signal) {
-      if (!this.claimDisconnectedPublish()) return;
-      this.receivedMessages.enqueueCallback(() => {
-        void this.events.publishDisconnected(signal).catch(() => void 0);
-      });
-    }
-    queueState(current, error, signal) {
-      const change = this.transitionState(current, error);
-      if (change === void 0) return;
-      this.receivedMessages.enqueueCallback(() => {
-        void this.publishStateChange(change, signal).catch(() => void 0);
-      });
-    }
-    async setState(current, error, signal) {
-      const change = this.transitionState(current, error);
-      if (change === void 0) return;
-      await this.publishStateChange(change, signal);
+    publishDisconnected(signal) {
+      if (this.disconnectedPublished) return;
+      this.disconnectedPublished = true;
+      this.events.publishDisconnected(signal);
     }
-    transitionState(current, error) {
+    setState(current, error, signal) {
       const previous = this.currentState;
       this.currentState = current;
-      if (previous === current && error === void 0) {
-        return void 0;
-      }
-      return { previous, current, error };
-    }
-    async publishStateChange(change, signal) {
-      await this.events.publishStateChanged(change, signal);
-      if (change.error !== void 0) await this.events.publishError(change.error, signal);
+      if (previous === current && error === void 0) return;
+      this.events.publishStateChanged({ previous, current, error }, signal);
+      if (error !== void 0) this.events.publishError(error, signal);
     }
   };
 
   // packages/stream-connector/src/Runtime/ZlinkStreamConnectorEvents.ts
   var ZlinkStreamConnectorEvents = class {
-    constructor() {
+    /**
+     * @param enqueueCallback Queues a callback that calls the number of handlers
+     *   `callbacks` reports for the handlers registered at that moment.
+     */
+    constructor(enqueueCallback) {
+      this.enqueueCallback = enqueueCallback;
       __publicField(this, "errorHandlers", /* @__PURE__ */ new Set());
       __publicField(this, "disconnectedHandlers", /* @__PURE__ */ new Set());
       __publicField(this, "stateHandlers", /* @__PURE__ */ new Set());
     }
     onError(handler) {
-      this.errorHandlers.add(handler);
-      return subscription(() => this.errorHandlers.delete(handler));
+      return registerHandler(this.errorHandlers, handler);
     }
     onDisconnected(handler) {
-      this.disconnectedHandlers.add(handler);
-      return subscription(() => this.disconnectedHandlers.delete(handler));
+      return registerHandler(this.disconnectedHandlers, handler);
     }
     onStateChanged(handler) {
-      this.stateHandlers.add(handler);
-      return subscription(() => this.stateHandlers.delete(handler));
+      return registerHandler(this.stateHandlers, handler);
+    }
+    publishError(error, signal) {
+      this.publish(this.errorHandlers, (handler) => handler(error, signal), signal);
     }
-    async publishError(error, signal) {
-      await this.publish(
-        Array.from(this.errorHandlers).map((handler) => () => handler(error, signal))
+    publishDisconnected(signal) {
+      this.publish(this.disconnectedHandlers, (handler) => handler(signal), signal);
+    }
+    publishStateChanged(change, signal) {
+      this.publish(this.stateHandlers, (handler) => handler(change, signal), signal);
+    }
+    /**
+     * Spec stream-connector 32 §7: the connector runs a registered callback and
+     * does not wait for it to finish. A thrown or rejected failure reaches the
+     * error handlers as `UserCallbackFailed`.
+     */
+    runUserCallback(run, failureMessage, signal) {
+      this.invoke(
+        run,
+        (cause) => this.publishError(
+          { code: "userCallbackFailed" /* UserCallbackFailed */, message: failureMessage, cause },
+          signal
+        )
       );
     }
-    async publishDisconnected(signal) {
-      await this.publish(
-        Array.from(this.disconnectedHandlers).map((handler) => () => handler(signal))
+    publish(handlers, invoke, signal) {
+      this.enqueueCallback(
+        () => {
+          for (const handler of currentRegistrations(handlers)) {
+            const report = (cause) => this.reportFailure(
+              cause,
+              signal,
+              handlers === this.errorHandlers ? handler : void 0
+            );
+            this.invoke(() => invoke(handler.handler), report);
+          }
+        },
+        () => handlers.size
       );
     }
-    async publishStateChanged(change, signal) {
-      await this.publish(
-        Array.from(this.stateHandlers).map((handler) => () => handler(change, signal))
+    reportFailure(cause, signal, failedHandler) {
+      const error = {
+        code: "userCallbackFailed" /* UserCallbackFailed */,
+        message: "Connector event handler failed.",
+        cause
+      };
+      if (failedHandler === void 0) {
+        this.publishError(error, signal);
+        return;
+      }
+      this.reportToRemaining(error, signal, /* @__PURE__ */ new Set([failedHandler]));
+    }
+    reportToRemaining(error, signal, attempted) {
+      const remaining = Array.from(this.errorHandlers).filter(
+        (candidate) => !attempted.has(candidate)
+      );
+      if (remaining.length === 0) return;
+      const nextAttempted = new Set(attempted);
+      for (const handler of remaining) nextAttempted.add(handler);
+      this.enqueueCallback(
+        () => {
+          for (const handler of currentRegistrations(this.errorHandlers, remaining)) {
+            const report = (cause) => this.reportToRemaining({ ...error, cause }, signal, nextAttempted);
+            const callback = handler.handler;
+            this.invoke(() => callback(error, signal), report);
+          }
+        },
+        () => {
+          let count = 0;
+          const registrations = currentRegistrations(this.errorHandlers, remaining);
+          while (registrations.next().done !== true) count += 1;
+          return count;
+        }
       );
     }
-    async publish(handlers) {
-      await Promise.allSettled(handlers.map(async (handler) => handler()));
+    invoke(run, report) {
+      try {
+        Promise.resolve(run()).catch(report);
+      } catch (cause) {
+        report(cause);
+      }
     }
   };
 
@@ -2985,11 +3342,7 @@ var ZlinkStreamConnectorBundle = (() => {
       if (this.closed || this.socket.readyState !== 1) {
         throw connectorError("disconnected" /* Disconnected */, "Remote stream is not connected.");
       }
-      try {
-        this.socket.send(frame);
-      } catch (cause) {
-        throw connectorError("sendFailed" /* SendFailed */, "Send failed.", cause);
-      }
+      this.socket.send(frame);
     }
     async read(signal) {
       throwIfAborted(signal);
@@ -3007,18 +3360,19 @@ var ZlinkStreamConnectorBundle = (() => {
         await this.waitForMessage(signal);
       }
     }
+    /**
+     * Spec stream-connector 32 §7: closing does not wait for the peer to read or
+     * answer. `WebSocket.close` sends the close frame after the data already
+     * handed to `send`, so a frame whose write completed is not torn.
+     */
     async close(signal) {
       throwIfAborted(signal);
+      this.removeListeners();
       if (!this.closed) {
         this.closed = true;
         this.socket.close();
-        this.wakeReader();
-      }
-      try {
-        await waitForClose(this.socket, signal);
-      } finally {
-        this.removeListeners();
       }
+      this.wakeReader();
     }
     waitForMessage(signal) {
       if (this.readWaiter !== void 0) {
@@ -3057,28 +3411,13 @@ var ZlinkStreamConnectorBundle = (() => {
       const message = this.messages[this.messageHead];
       this.messages[this.messageHead] = void 0;
       this.messageHead += 1;
-      if (this.messageHead >= 1024 && this.messageHead * 2 >= this.messages.length) {
+      if (shouldCompactBackingArray(this.messageHead, this.messages.length)) {
         this.messages.splice(0, this.messageHead);
         this.messageHead = 0;
       }
       return message;
     }
   };
-  function waitForClose(socket, signal) {
-    if (socket.readyState === 3) return Promise.resolve();
-    return new Promise((resolve, reject) => {
-      const onClose = () => finish();
-      const onAbort = () => finish(connectorError("disconnected" /* Disconnected */, "Close canceled."));
-      const finish = (error) => {
-        socket.removeEventListener("close", onClose);
-        signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
-        if (error === void 0) resolve();
-        else reject(error);
-      };
-      socket.addEventListener("close", onClose, { once: true });
-      signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
-    });
-  }
   async function waitForOpen(socket, connectTimeoutMs, signal) {
     throwIfAborted(signal);
     await new Promise((resolve, reject) => {
@@ -3087,8 +3426,8 @@ var ZlinkStreamConnectorBundle = (() => {
         connectTimeoutMs
       );
       const onOpen = () => finish();
-      const onClose = () => finish(connectorError("connectTimeout" /* ConnectTimeout */, "Connect closed before opening."));
-      const onError = () => finish(connectorError("connectTimeout" /* ConnectTimeout */, "Connect failed."));
+      const onClose = () => finish(connectorError("disconnected" /* Disconnected */, "Connect closed before opening."));
+      const onError = () => finish(connectorError("disconnected" /* Disconnected */, "Connect failed."));
       const onAbort = () => finish(connectorError("disconnected" /* Disconnected */, "Connect canceled."));
       const finish = (error) => {
         clearTimeout(timeout);
@@ -3127,7 +3466,9 @@ var ZlinkStreamConnectorBundle = (() => {
     constructor(options) {
       __publicField(this, "receivedMessages");
       __publicField(this, "lifecycle");
-      __publicField(this, "events", new ZlinkStreamConnectorEvents());
+      __publicField(this, "events", new ZlinkStreamConnectorEvents(
+        (callback, callbacks) => this.receivedMessages.enqueueCallback(callback, callbacks)
+      ));
       __publicField(this, "correlationCounter", 0n);
       __publicField(this, "pendingRequests", new ZlinkStreamPendingRequests());
       __publicField(this, "frameSender");
@@ -3173,7 +3514,7 @@ var ZlinkStreamConnectorBundle = (() => {
       return this.lifecycle.state;
     }
     get pendingDispatchCount() {
-      return this.pendingRequests.count;
+      return this.receivedMessages.pendingCallbacks;
     }
     get actors() {
       return this.boundActors.snapshot;
@@ -3208,12 +3549,10 @@ var ZlinkStreamConnectorBundle = (() => {
       return this.events.onStateChanged(handler);
     }
     onRequestSending(handler) {
-      this.requestSendingHandlers.add(handler);
-      return subscription(() => this.requestSendingHandlers.delete(handler));
+      return registerHandler(this.requestSendingHandlers, handler);
     }
     onReplyReceived(handler) {
-      this.replyReceivedHandlers.add(handler);
-      return subscription(() => this.replyReceivedHandlers.delete(handler));
+      return registerHandler(this.replyReceivedHandlers, handler);
     }
     async connect(signal) {
       await this.lifecycle.connect(signal);
@@ -3230,7 +3569,12 @@ var ZlinkStreamConnectorBundle = (() => {
     }
     request(payload, messageType) {
       const encoded = this.encodePayload(payload, messageType);
-      return new ZlinkStreamRequestBuilder(this, this.resolveNameOrDefault(encoded), encoded);
+      return new ZlinkStreamRequestBuilder(
+        this,
+        this.resolveNameOrDefault(encoded),
+        encoded,
+        (callback) => this.receivedMessages.enqueueCallback(callback)
+      );
     }
     on(nameOrType, handler, messageType) {
       const encodedHandler = (message, signal) => handler(
@@ -3263,29 +3607,25 @@ var ZlinkStreamConnectorBundle = (() => {
         this,
         this.resolveNameOrDefault(encoded),
         encoded,
+        (callback) => this.receivedMessages.enqueueCallback(callback),
         actor.slot,
         () => actor.ensureBound()
       );
     }
     onActorMessage(actor, nameOrType, handler, messageType) {
-      const encodedHandler = (message, signal) => {
-        if (message[zlinkStreamActorBinding] !== actor) {
-          return;
-        }
-        return handler(
-          {
-            name: message.name,
-            metadata: message.metadata,
-            payload: this.decodePayload(
-              message.payload,
-              messageType != null ? messageType : typeof nameOrType === "function" ? nameOrType : void 0
-            ),
-            actorId: message.actorId
-          },
-          signal
-        );
-      };
-      return this.receivedMessages.on(this.observedName(nameOrType), encodedHandler);
+      const encodedHandler = (message, signal) => handler(
+        {
+          name: message.name,
+          metadata: message.metadata,
+          payload: this.decodePayload(
+            message.payload,
+            messageType != null ? messageType : typeof nameOrType === "function" ? nameOrType : void 0
+          ),
+          actorId: message.actorId
+        },
+        signal
+      );
+      return this.receivedMessages.on(this.observedName(nameOrType), encodedHandler, actor);
     }
     waitFor(nameOrType) {
       return new ZlinkStreamWaitBuilder(this, this.observedName(nameOrType));
@@ -3410,7 +3750,7 @@ var ZlinkStreamConnectorBundle = (() => {
       }
       return payload;
     }
-    async sendEncoded(kind, name, payload, metadata, compress, requestSeq, signal, correlationId, actorSlot) {
+    async sendEncoded(kind, name, payload, metadata, compress, requestSeq, signal, correlationId, actorSlot, expiry, onAccepted) {
       await this.frameSender.send(
         this.lifecycle.connectionForSend(),
         kind,
@@ -3421,7 +3761,9 @@ var ZlinkStreamConnectorBundle = (() => {
         requestSeq,
         signal,
         correlationId,
-        actorSlot
+        actorSlot,
+        expiry,
+        onAccepted
       );
     }
     /**
@@ -3444,37 +3786,48 @@ var ZlinkStreamConnectorBundle = (() => {
         }
       };
       let pending;
+      let stopCancellation;
       try {
         throwIfAborted(signal);
-        for (const handler of Array.from(this.requestSendingHandlers)) {
+        for (const { handler } of currentRegistrations(this.requestSendingHandlers)) {
           try {
             handler(sendingContext);
           } catch (cause) {
-            queueMicrotask(() => {
-              void this.events.publishError(
-                toStreamError(
-                  cause,
-                  "userCallbackFailed" /* UserCallbackFailed */,
-                  "Request sending hook failed."
-                ),
-                signal
-              );
-            });
+            this.events.publishError(
+              {
+                code: "userCallbackFailed" /* UserCallbackFailed */,
+                message: "Request sending hook failed.",
+                cause
+              },
+              signal
+            );
           }
         }
         pending = this.pendingRequests.create(name, timeoutMs);
-        await this.sendEncoded(
+        const accepted = pending;
+        const write = this.sendEncoded(
           2 /* Request */,
           name,
           payload,
           requestMetadata,
           compress,
-          pending.requestSeq,
+          accepted.requestSeq,
           signal,
           this.nextCorrelationId(),
-          actorSlot
+          actorSlot,
+          accepted.promise,
+          accepted.startTimeout
         );
-        const reply = await pending.promise;
+        const canceled = new Promise((_, reject) => {
+          const onAbort = () => reject(connectorError("disconnected" /* Disconnected */, "Operation canceled."));
+          signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
+          stopCancellation = () => signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
+        });
+        const reply = await Promise.race([
+          write.then(() => accepted.promise),
+          accepted.promise,
+          canceled
+        ]);
         this.publishReplyReceived(
           {
             requestPacketName: name,
@@ -3488,6 +3841,7 @@ var ZlinkStreamConnectorBundle = (() => {
         return reply.payload;
       } catch (error) {
         if (pending !== void 0) this.pendingRequests.cancel(pending.requestSeq);
+        if ((signal == null ? void 0 : signal.aborted) === true) throw error;
         this.publishReplyReceived(
           {
             requestPacketName: name,
@@ -3499,26 +3853,24 @@ var ZlinkStreamConnectorBundle = (() => {
           signal
         );
         throw error;
+      } finally {
+        stopCancellation == null ? void 0 : stopCancellation();
       }
     }
     publishReplyReceived(context, signal) {
       if (this.replyReceivedHandlers.size === 0) return;
-      this.receivedMessages.enqueueCallback(async () => {
-        for (const handler of Array.from(this.replyReceivedHandlers)) {
-          try {
-            await handler(context, signal);
-          } catch (cause) {
-            await this.events.publishError(
-              toStreamError(
-                cause,
-                "userCallbackFailed" /* UserCallbackFailed */,
-                "Reply received hook failed."
-              ),
+      this.receivedMessages.enqueueCallback(
+        () => {
+          for (const { handler } of currentRegistrations(this.replyReceivedHandlers)) {
+            this.events.runUserCallback(
+              () => handler(context, signal),
+              "Reply received hook failed.",
               signal
             );
           }
-        }
-      });
+        },
+        () => this.replyReceivedHandlers.size
+      );
     }
     resolveNameOrDefault(payload) {
       if (payload.messageType === void 0) {