@zlink-systems/stream-connector 0.25.0 → 0.27.0

package/dist/browser/index.mjs

@@ -1,4 +1,8 @@
 // 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) {
@@ -9,11 +13,7 @@ function lz4PickleUncompressed(payload) {
   pickled.set(payload, 1);
   return pickled;
 }
-function lz4UnpicklePayload(payload, maxSize) {
-  const maxDecompressedSize = 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.");
@@ -25,7 +25,17 @@ function lz4UnpicklePayload(payload, maxSize) {
   }
   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 ?? 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.");
   }
@@ -68,15 +78,15 @@ function decodeLz4Block(source, resultLength) {
     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.");
     }
@@ -92,7 +102,7 @@ function decodeLz4Block(source, resultLength) {
 }
 function readLz4Length(source, nibble, nextOffset) {
   let length = nibble;
-  if (length !== 15) {
+  if (length !== LZ4_EXTENDED_LENGTH_NIBBLE) {
     return length;
   }
   for (; ; ) {
@@ -102,7 +112,7 @@ function readLz4Length(source, nibble, nextOffset) {
     }
     const value = source[offset];
     length += value;
-    if (value !== 255) {
+    if (value !== LZ4_EXTENDED_LENGTH_BYTE) {
       return length;
     }
   }
@@ -116,54 +126,200 @@ var ZlinkStreamCodec = /* @__PURE__ */ ((ZlinkStreamCodec2) => {
   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 ?? 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;
@@ -176,7 +332,7 @@ function encodeStreamWireHeader(header, flagOverrides) {
   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;
@@ -186,7 +342,7 @@ function encodeStreamWireHeader(header, flagOverrides) {
   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;
@@ -198,14 +354,14 @@ function encodeStreamWireHeader(header, flagOverrides) {
       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;
   }
@@ -216,7 +372,7 @@ function encodeStreamWireHeader(header, flagOverrides) {
   }
   if (hasFlow) {
     buffer.set(asciiEncode(header.flowId), offset);
-    offset += 36;
+    offset += FLOW_ID_BYTES;
     buffer[offset++] = header.flowOrigin;
   }
   if (hasActorSlot) {
@@ -227,7 +383,7 @@ function encodeStreamWireHeader(header, flagOverrides) {
 function decodeStreamWireHeader(header, flagOverrides, includeFlow = true) {
   const flags = 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) {
@@ -241,29 +397,28 @@ function decodeStreamWireHeader(header, flagOverrides, includeFlow = true) {
   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;
@@ -282,14 +437,14 @@ function decodeStreamWireHeader(header, flagOverrides, includeFlow = true) {
   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.");
@@ -298,14 +453,14 @@ function decodeStreamWireHeader(header, flagOverrides, includeFlow = true) {
   }
   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.");
@@ -335,47 +490,47 @@ function asciiDecode(value) {
   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 ?? defaultMaxDecompressedPayloadSize);
 }
@@ -386,11 +541,11 @@ function utf8Decode(value) {
   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.");
   }
@@ -416,7 +571,7 @@ function decodeStreamWireMetadataAt(source, offset, end) {
       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.");
     }
@@ -433,16 +588,17 @@ function decodeStreamWireMetadataAt(source, offset, end) {
 }
 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];
@@ -451,10 +607,10 @@ function readUInt32BE(buffer, offset) {
   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) {
@@ -469,6 +625,19 @@ function readBigUInt64BE(buffer, offset) {
   }
   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) => {
@@ -486,24 +655,6 @@ var ZlinkStreamDispatchMode = /* @__PURE__ */ ((ZlinkStreamDispatchMode2) => {
   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";
@@ -515,6 +666,7 @@ var ZlinkStreamErrorCode = /* @__PURE__ */ ((ZlinkStreamErrorCode2) => {
   ZlinkStreamErrorCode2["SendFailed"] = "sendFailed";
   ZlinkStreamErrorCode2["CompressionFailed"] = "compressionFailed";
   ZlinkStreamErrorCode2["DecompressionFailed"] = "decompressionFailed";
+  ZlinkStreamErrorCode2["TlsValidationFailed"] = "tlsValidationFailed";
   ZlinkStreamErrorCode2["UserCallbackFailed"] = "userCallbackFailed";
   ZlinkStreamErrorCode2["RemoteError"] = "remoteError";
   return ZlinkStreamErrorCode2;
@@ -529,6 +681,15 @@ var ZlinkStreamConnectionState = /* @__PURE__ */ ((ZlinkStreamConnectionState3)
   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) {
@@ -561,25 +722,13 @@ var ZlinkStreamMetadataMap = class _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 = {};
@@ -631,6 +780,10 @@ function isPrototypeKey(key) {
 }
 
 // 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 });
 }
@@ -644,15 +797,21 @@ function unwrapStreamError(error) {
   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?.aborted === true) {
     throw connectorError("disconnected" /* Disconnected */, "Operation canceled.");
@@ -672,9 +831,6 @@ function delay(delayMs, signal) {
     signal?.addEventListener("abort", onAbort, { once: true });
   });
 }
-function utf8Encode2(value) {
-  return new TextEncoder().encode(value);
-}
 function utf8Decode2(value) {
   return new TextDecoder().decode(value);
 }
@@ -693,59 +849,48 @@ var zlinkStreamAssert = {
     }
   },
   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
@@ -817,9 +962,10 @@ var ZlinkStreamSendBuilder = class {
   }
 };
 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;
     this.state = new ZlinkStreamCallBuilderState(name, actorSlot, validateActor);
   }
   state;
@@ -853,8 +999,10 @@ var ZlinkStreamRequestBuilder = class {
     );
     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;
     }
@@ -1059,6 +1207,12 @@ var zlinkStreamLz4CompressionCodec = {
     return lz4PickleUncompressed2(payload);
   },
   decompress(payload, maxDecompressedSize) {
+    if (lz4PickledLength2(payload) > maxDecompressedSize) {
+      throw connectorError(
+        "frameTooLarge" /* FrameTooLarge */,
+        "LZ4 decoded payload exceeds MaxReceivePayloadSize."
+      );
+    }
     return lz4UnpicklePayload2(payload, maxDecompressedSize);
   }
 };
@@ -1070,7 +1224,11 @@ function compressPayload(payload, compression, compressionCodec) {
       "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) {
@@ -1083,15 +1241,20 @@ function decompressIfNeeded(header, payload, compression, compressionCodec, maxD
       "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 */) {
@@ -1100,122 +1263,231 @@ function resolveCompressionCodec(compression, compressionCodec) {
   return compressionCodec ?? zlinkStreamLz4CompressionCodec;
 }
 
-// packages/stream-connector/src/Runtime/Protocol/ZlinkStreamFrameCodec.ts
-var ZlinkStreamFrameCodec = class {
-  static encode(header, payload, maxPayloadSize = 64 * 1024) {
-    validatePayload(payload.length, maxPayloadSize);
-    try {
-      return encodeStreamWireFrame(header, payload);
-    } catch (cause) {
-      throw connectorError("frameTooLarge" /* FrameTooLarge */, "Frame is too large.", cause);
-    }
-  }
-  static decode(frame) {
-    try {
-      return decodeStreamWireFrame(frame);
-    } catch (cause) {
+// 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(
-        "frameDecodeFailed" /* FrameDecodeFailed */,
-        "Frame length does not match prefix.",
-        cause
+        "configurationError" /* ConfigurationError */,
+        "The TypeScript Stream Connector supports only ws:// and wss:// endpoints."
       );
-    }
   }
-};
-function splitZlinkStreamFrames(chunk) {
-  if (chunk.length === 0) {
+}
+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) {
+  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(
-      "frameDecodeFailed" /* FrameDecodeFailed */,
-      "Stream frame prefix is incomplete."
+      "configurationError" /* ConfigurationError */,
+      "Configured transport conflicts with endpoint scheme."
     );
   }
-  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;
+  const normalized = {
+    endpoint,
+    transport: inferredTransport,
+    connectTimeoutMs: options.connectTimeoutMs ?? 5e3,
+    requestTimeoutMs: options.requestTimeoutMs ?? 3e4,
+    waitTimeoutMs: options.waitTimeoutMs ?? 5e3,
+    heartbeat: {
+      enabled: options.heartbeat?.enabled ?? true,
+      intervalMs: options.heartbeat?.intervalMs ?? 1e3,
+      timeoutMs: options.heartbeat?.timeoutMs ?? 5e3
+    },
+    reconnect: {
+      enabled: options.reconnect?.enabled ?? true,
+      initialDelayMs: options.reconnect?.initialDelayMs ?? 250,
+      maxDelayMs: options.reconnect?.maxDelayMs ?? 5e3,
+      backoffFactor: options.reconnect?.backoffFactor ?? 2,
+      maxAttempts: options.reconnect?.maxAttempts === void 0 ? 3 : options.reconnect.maxAttempts
+    },
+    maxSendPayloadSize: options.maxSendPayloadSize ?? ZLINK_STREAM_DEFAULT_PAYLOAD_BYTES,
+    maxReceivePayloadSize: options.maxReceivePayloadSize ?? ZLINK_STREAM_DEFAULT_PAYLOAD_BYTES,
+    dispatchMode: options.dispatchMode ?? "manual" /* Manual */,
+    compression: options.compression ?? "lz4" /* Lz4 */,
+    compressionCodec: options.compressionCodec,
+    nameResolver: options.nameResolver ?? defaultPacketNameResolver,
+    transportFactory: options.transportFactory ?? 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 (options.heartbeat?.enabled !== void 0 && typeof options.heartbeat.enabled !== "boolean") {
+    throw connectorError(
+      "validationFailed" /* ValidationFailed */,
+      "Heartbeat enabled must be boolean."
+    );
   }
-  return frames;
-}
-function validatePayload(payloadLength, maxPayloadSize) {
-  if (payloadLength > maxPayloadSize) {
+  if (options.reconnect?.enabled !== void 0 && typeof options.reconnect.enabled !== "boolean") {
     throw connectorError(
       "validationFailed" /* ValidationFailed */,
-      "Payload exceeds MaxSendPayloadSize."
+      "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;
 }
-
-// packages/stream-connector/src/Runtime/Protocol/ZlinkStreamMetadataCodec.ts
-var ZLINK_STREAM_MAX_METADATA_BYTES = 1024;
-var ZlinkStreamMetadataCodec = class {
-  static size(metadata) {
-    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;
-    } catch (cause) {
+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(
-        "validationFailed" /* ValidationFailed */,
-        streamWireErrorMessage(cause),
-        cause
+        "configurationError" /* ConfigurationError */,
+        "compressionCodec cannot be set when compression is none."
       );
     }
   }
-  static write(metadata, destination) {
+}
+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 = ZLINK_STREAM_DEFAULT_PAYLOAD_BYTES) {
+    validatePayload(payload.length, maxPayloadSize);
+    try {
+      return encodeStreamWireFrame(header, payload);
+    } catch (cause) {
+      throw connectorError("frameTooLarge" /* FrameTooLarge */, "Frame is too large.", cause);
+    }
+  }
+  static decode(frame) {
     try {
-      destination.set(encodeStreamWireMetadata(metadata.values));
+      return decodeStreamWireFrame(frame);
     } catch (cause) {
       throw connectorError(
-        "validationFailed" /* ValidationFailed */,
-        streamWireErrorMessage(cause),
+        "frameDecodeFailed" /* FrameDecodeFailed */,
+        "Frame length does not match prefix.",
         cause
       );
     }
   }
-  static decode(metadata) {
+};
+function splitZlinkStreamFrames(chunk) {
+  try {
+    return splitStreamWireFrames(chunk);
+  } catch (cause) {
+    throw connectorError(
+      "frameDecodeFailed" /* FrameDecodeFailed */,
+      cause instanceof Error ? cause.message : "Frame length does not match prefix."
+    );
+  }
+}
+function validatePayload(payloadLength, maxPayloadSize) {
+  if (payloadLength > maxPayloadSize) {
+    throw connectorError(
+      "validationFailed" /* ValidationFailed */,
+      "Payload exceeds MaxSendPayloadSize."
+    );
+  }
+}
+
+// packages/stream-connector/src/Runtime/Protocol/ZlinkStreamMetadataCodec.ts
+var ZlinkStreamMetadataCodec = class {
+  static size(metadata) {
+    let size;
     try {
-      const values = decodeStreamWireMetadata(metadata);
-      return values.size === 0 ? ZlinkStreamMetadataMap.empty : ZlinkStreamMetadataMap.from(values);
+      size = metadata.count === 0 ? 0 : streamWireMetadataSize(metadata.values);
     } catch (cause) {
       throw connectorError(
-        "frameDecodeFailed" /* FrameDecodeFailed */,
-        streamWireErrorMessage(cause),
+        "validationFailed" /* ValidationFailed */,
+        cause instanceof Error ? cause.message : "Metadata is invalid.",
         cause
       );
     }
+    if (size > ZLINK_STREAM_MAX_METADATA_BYTES) {
+      throw connectorError(
+        "validationFailed" /* ValidationFailed */,
+        `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 {
@@ -1232,7 +1504,7 @@ var ZlinkStreamHeaderCodec = class {
     } catch (cause) {
       throw connectorError(
         "validationFailed" /* ValidationFailed */,
-        streamWireErrorMessage2(cause),
+        streamWireErrorMessage(cause),
         cause
       );
     }
@@ -1252,25 +1524,24 @@ var ZlinkStreamHeaderCodec = class {
         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) {
@@ -1300,7 +1571,7 @@ function buildHeader(kind, name, codec, metadata, compress, requestSeq, correlat
   };
 }
 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) {
@@ -1333,13 +1604,15 @@ function validateHeaderSemantics(header) {
     }
   }
 }
-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.");
@@ -1347,8 +1620,8 @@ function validateEnum(kind, codec, flags) {
 }
 
 // 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;
@@ -1416,172 +1689,37 @@ var ZlinkStreamFrameProtocol = class {
   }
 };
 
-// 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) {
-  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(options.connectTimeoutMs ?? 5e3, "ConnectTimeout");
-  validatePositive(options.requestTimeoutMs ?? 3e4, "RequestTimeout");
-  validatePositive(options.waitTimeoutMs ?? 5e3, "WaitTimeout");
-  validatePositive(options.maxSendPayloadSize ?? 64 * 1024, "MaxSendPayloadSize");
-  validatePositive(options.maxReceivePayloadSize ?? 64 * 1024, "MaxReceivePayloadSize");
-  validateHeartbeat(options.heartbeat);
-  validateReconnect(options.reconnect);
-  return {
-    endpoint,
-    transport: inferredTransport,
-    connectTimeoutMs: options.connectTimeoutMs ?? 5e3,
-    requestTimeoutMs: options.requestTimeoutMs ?? 3e4,
-    waitTimeoutMs: options.waitTimeoutMs ?? 5e3,
-    heartbeat: {
-      enabled: options.heartbeat?.enabled ?? true,
-      intervalMs: options.heartbeat?.intervalMs ?? 1e3,
-      timeoutMs: options.heartbeat?.timeoutMs ?? 5e3
-    },
-    reconnect: {
-      enabled: options.reconnect?.enabled ?? true,
-      initialDelayMs: options.reconnect?.initialDelayMs ?? 250,
-      maxDelayMs: options.reconnect?.maxDelayMs ?? 5e3,
-      backoffFactor: options.reconnect?.backoffFactor ?? 2,
-      maxAttempts: options.reconnect?.maxAttempts === void 0 ? 3 : options.reconnect.maxAttempts
-    },
-    maxSendPayloadSize: options.maxSendPayloadSize ?? 64 * 1024,
-    maxReceivePayloadSize: options.maxReceivePayloadSize ?? 64 * 1024,
-    dispatchMode: options.dispatchMode ?? "manual" /* Manual */,
-    compression: options.compression ?? "lz4" /* Lz4 */,
-    compressionCodec: resolveCompressionCodec2(options),
-    nameResolver: options.nameResolver ?? defaultPacketNameResolver,
-    transportFactory: options.transportFactory ?? 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) {
-  const compression = options.compression ?? "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) {
-  const enabled = options?.enabled ?? true;
-  const intervalMs = options?.intervalMs ?? 1e3;
-  const timeoutMs = options?.timeoutMs ?? 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) {
-  const enabled = options?.enabled ?? true;
-  if (!enabled) {
-    return;
-  }
-  validatePositive(options?.initialDelayMs ?? 250, "Reconnect InitialDelay");
-  validatePositive(options?.maxDelayMs ?? 5e3, "Reconnect MaxDelay");
-  if ((options?.backoffFactor ?? 2) < 1) {
-    throw connectorError(
-      "validationFailed" /* ValidationFailed */,
-      "Reconnect BackoffFactor must be at least 1.0."
-    );
-  }
-  const maxAttempts = 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 {
   nextRequestSeq = 1n;
   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);
@@ -1599,8 +1737,9 @@ var ZlinkStreamPendingRequests = class {
           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) {
@@ -1608,8 +1747,9 @@ var ZlinkStreamPendingRequests = class {
     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) {
@@ -1637,50 +1777,212 @@ var ZlinkStreamPendingRequests = class {
   }
 };
 
-// packages/stream-connector/src/Runtime/ZlinkStreamReceivedMessages.ts
-var ZlinkStreamReceivedMessages = class {
-  /**
-   * @param deliverOnArrival `Immediate` runs registered handlers on the receive
-   *   path; `Manual` leaves them queued until {@link pump} runs them on the
-   *   caller's thread (spec stream-connector 32 §7). Wait surfaces observe the
-   *   queue in both modes, so they never depend on this flag.
-   */
-  constructor(events, deliverOnArrival) {
-    this.events = events;
-    this.deliverOnArrival = deliverOnArrival;
+// 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;
   }
-  handlers = /* @__PURE__ */ new Map();
-  observers = /* @__PURE__ */ new Map();
-  // A handler can be registered after messages for another name arrive, so the
-  // queue is not a simple FIFO. Tombstones let us remove a deliverable entry
-  // without shifting every later message on the hot receive path.
-  queue = [];
-  queueHead = 0;
-  queuedCount = 0;
-  drainTask;
-  // True for as long as `drain` is on the stack, handler awaits included. 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
-  // nothing ever waits for this flag to fall.
-  draining = false;
-  // Spec stream-connector 32 §10: arrivals per packet name on the current
-  // connection. It is raised where a packet arrives, never where one is taken,
-  // so consuming does not lower it and the dispatch mode does not change it.
-  receivedCounts = /* @__PURE__ */ new Map();
-  on(name, handler) {
-    validateName(name);
-    let set = this.handlers.get(name);
-    if (set === void 0) {
+  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;
+  }
+  bySlot = /* @__PURE__ */ new Map();
+  byId = /* @__PURE__ */ new Map();
+  boundHandlers = /* @__PURE__ */ new Set();
+  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
+   *   path; `Manual` leaves them queued until {@link pump} runs them on the
+   *   caller's thread (spec stream-connector 32 §7). Wait surfaces observe the
+   *   queue in both modes, so they never depend on this flag.
+   */
+  constructor(events, deliverOnArrival) {
+    this.events = events;
+    this.deliverOnArrival = deliverOnArrival;
+  }
+  handlers = /* @__PURE__ */ new Map();
+  observers = /* @__PURE__ */ new Map();
+  // A handler can be registered after messages for another name arrive, so the
+  // queue is not a simple FIFO. Tombstones let us remove a deliverable entry
+  // without shifting every later message on the hot receive path.
+  queue = [];
+  deliverable = [];
+  queueHead = 0;
+  queuedCount = 0;
+  // 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
+  // nothing ever waits for this flag to fall.
+  draining = false;
+  // Spec stream-connector 32 §10: arrivals per packet name on the current
+  // connection. It is raised where a packet arrives, never where one is taken,
+  // so consuming does not lower it and the dispatch mode does not change it.
+  receivedCounts = /* @__PURE__ */ new Map();
+  /**
+   * @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?.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);
       }
@@ -1750,6 +2052,11 @@ var ZlinkStreamReceivedMessages = class {
     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
@@ -1780,60 +2087,38 @@ var ZlinkStreamReceivedMessages = class {
     }
     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()) {
@@ -1841,30 +2126,53 @@ var ZlinkStreamReceivedMessages = class {
         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?.kind === "callback" && queued.callbacks() > 0) count += 1;
+      if (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;
@@ -1872,20 +2180,60 @@ var ZlinkStreamReceivedMessages = class {
     this.compactQueue();
   }
   findDeliverableIndex() {
-    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" || (this.handlers.get(queued.message.name)?.size ?? 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?.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?.kind === "callback" || 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) {
@@ -1896,251 +2244,207 @@ var ZlinkStreamReceivedMessages = class {
     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;
+  }
+  queue = /* @__PURE__ */ new Set();
+  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;
   }
-  pendingWrites = /* @__PURE__ */ new Set();
-  async send(connection, kind, name, payload, metadata, compress, requestSeq, signal, correlationId, actorSlot) {
+  queues = /* @__PURE__ */ new Map();
+  async send(connection, kind, name, payload, metadata, compress, requestSeq, signal, correlationId, actorSlot, expiry, onAccepted) {
     throwIfAborted(signal);
     await this.write(
       connection,
       this.protocol.encode(
         kind,
         name,
-        payload,
-        metadata,
-        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;
-  }
-  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;
-  }
-  bySlot = /* @__PURE__ */ new Map();
-  byId = /* @__PURE__ */ new Map();
-  issued = [];
-  boundHandlers = /* @__PURE__ */ new Set();
-  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);
+        payload,
+        metadata,
+        compress,
+        requestSeq,
+        correlationId,
+        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?.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?.addEventListener("abort", onAbort, { once: true });
+      onAccepted?.();
+      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;
@@ -2160,15 +2464,20 @@ var ZlinkStreamReceiveDispatcher = class {
    *   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?.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?.aborted === true) throw cause;
+      throw new ZlinkStreamConnectionEnd(
+        toStreamError(cause, "disconnected" /* Disconnected */, "Transport read failed.")
+      );
+    }
     if (isCurrent !== void 0 && !isCurrent()) {
       return { available: false, inbound: false };
     }
@@ -2179,87 +2488,96 @@ var ZlinkStreamReceiveDispatcher = class {
     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 */) {
@@ -2267,7 +2585,7 @@ var ZlinkStreamReceiveDispatcher = class {
         {
           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?.actorId,
           [zlinkStreamActorBinding]: actor
         },
@@ -2275,12 +2593,12 @@ var ZlinkStreamReceiveDispatcher = class {
       );
     }
   }
-  async dispatchControl(connection, header, payload, signal, connectionForSend) {
+  async dispatchControl(connection, header, payload, signal) {
     if (this.actors.processControl(header.name, payload, signal)) {
       return;
     }
     if (header.name === ZLINK_SESSION_CLOSING) {
-      const closing = decodeSessionClosing(payload);
+      const closing = decodeStreamWireSessionClosing(payload);
       await this.serverClosing?.(closing.closeReason);
       return;
     }
@@ -2291,18 +2609,7 @@ var ZlinkStreamReceiveDispatcher = class {
       );
     }
     if (header.name === ZLINK_STREAM_HEARTBEAT_PING) {
-      try {
-        await this.frameSender.sendControl(
-          connectionForSend?.() ?? 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) {
@@ -2310,8 +2617,7 @@ var ZlinkStreamReceiveDispatcher = class {
     }
   }
 };
-function decodeRemoteError(protocol, header, payload) {
-  const decodedPayload = protocol.decodePayload(header, payload);
+function decodeRemoteError(decodedPayload) {
   let decoded;
   try {
     decoded = JSON.parse(utf8Decode2(decodedPayload));
@@ -2333,8 +2639,11 @@ function decodeRemoteError(protocol, header, payload) {
 }
 
 // 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) {
@@ -2358,11 +2667,11 @@ var ZlinkStreamConnectorLifecycle = class {
   lastInboundAt = 0;
   closeTask;
   connectTask;
+  connectAbort;
   disconnectTask;
   closeRequested = false;
   disconnectedPublished = false;
   closeReasonValue;
-  lateConnectCleanupError;
   get isConnected() {
     return this.currentState === "connected" /* Connected */;
   }
@@ -2389,17 +2698,22 @@ var ZlinkStreamConnectorLifecycle = class {
     });
     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) {
-    await this.setState("connecting" /* Connecting */, void 0, signal);
+    const attempts = new AbortController();
+    const forwardAbort = () => attempts.abort();
+    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."
@@ -2407,41 +2721,61 @@ var ZlinkStreamConnectorLifecycle = class {
       }
       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?.aborted === true) {
+        this.setState("disconnected" /* Disconnected */, void 0, signal);
+        throwIfAborted(signal);
       }
       const error = toStreamError(cause, "connectTimeout" /* ConnectTimeout */, "Connect failed.");
-      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?.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;
+    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 = 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}.`
@@ -2449,41 +2783,18 @@ var ZlinkStreamConnectorLifecycle = class {
     await this.disconnectForTransportFailure(
       error,
       this.currentConnection,
-      this.connectionGeneration
+      this.connectionGeneration,
+      reason
     );
   }
   async closeOnce(signal) {
+    this.connectAbort?.abort();
     await this.connectTask?.catch(() => void 0);
     await this.disconnectTask?.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?.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.");
+    await this.tearDownConnection(
+      { code: "disconnected" /* Disconnected */, message: "Connector closed." },
+      signal
+    );
   }
   /**
    * Spec stream-connector 32 §7: `dispatch` runs the callbacks the receive loop
@@ -2499,7 +2810,7 @@ var ZlinkStreamConnectorLifecycle = class {
     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 */) {
@@ -2512,8 +2823,7 @@ var ZlinkStreamConnectorLifecycle = class {
     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();
@@ -2522,7 +2832,10 @@ var ZlinkStreamConnectorLifecycle = class {
   }
   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;
@@ -2532,10 +2845,10 @@ var ZlinkStreamConnectorLifecycle = class {
         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,
@@ -2603,12 +2916,8 @@ var ZlinkStreamConnectorLifecycle = class {
       }
     } 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();
@@ -2664,56 +2973,97 @@ var ZlinkStreamConnectorLifecycle = class {
       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) {
-    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;
+    });
+    const task = pending.finally(() => {
+      if (this.disconnectTask === task) this.disconnectTask = void 0;
     });
-    await this.disconnectTask;
-    await this.announceDisconnect(error);
+    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?.close();
-    } catch {
+      try {
+        await 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);
     }
   }
   /**
@@ -2724,10 +3074,7 @@ var ZlinkStreamConnectorLifecycle = class {
    * 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);
@@ -2737,110 +3084,127 @@ var ZlinkStreamConnectorLifecycle = class {
   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 {
+  /**
+   * @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;
+  }
   errorHandlers = /* @__PURE__ */ new Set();
   disconnectedHandlers = /* @__PURE__ */ new Set();
   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);
+  }
+  publishDisconnected(signal) {
+    this.publish(this.disconnectedHandlers, (handler) => handler(signal), signal);
   }
-  async publishError(error, signal) {
-    await this.publish(
-      Array.from(this.errorHandlers).map((handler) => () => handler(error, 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);
+    }
   }
 };
 
@@ -2878,11 +3242,7 @@ var BrowserWebSocketConnection = class {
     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);
@@ -2900,18 +3260,19 @@ var BrowserWebSocketConnection = class {
       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();
   }
   onMessage = (event) => {
     try {
@@ -2982,28 +3343,13 @@ var BrowserWebSocketConnection = class {
     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?.removeEventListener("abort", onAbort);
-      if (error === void 0) resolve();
-      else reject(error);
-    };
-    socket.addEventListener("close", onClose, { once: true });
-    signal?.addEventListener("abort", onAbort, { once: true });
-  });
-}
 async function waitForOpen(socket, connectTimeoutMs, signal) {
   throwIfAborted(signal);
   await new Promise((resolve, reject) => {
@@ -3012,8 +3358,8 @@ async function waitForOpen(socket, connectTimeoutMs, signal) {
       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);
@@ -3053,7 +3399,9 @@ var DefaultZlinkStreamConnector = class {
   static heartbeatPongName = ZLINK_STREAM_HEARTBEAT_PONG;
   receivedMessages;
   lifecycle;
-  events = new ZlinkStreamConnectorEvents();
+  events = new ZlinkStreamConnectorEvents(
+    (callback, callbacks) => this.receivedMessages.enqueueCallback(callback, callbacks)
+  );
   correlationCounter = 0n;
   pendingRequests = new ZlinkStreamPendingRequests();
   frameSender;
@@ -3100,7 +3448,7 @@ var DefaultZlinkStreamConnector = class {
     return this.lifecycle.state;
   }
   get pendingDispatchCount() {
-    return this.pendingRequests.count;
+    return this.receivedMessages.pendingCallbacks;
   }
   get actors() {
     return this.boundActors.snapshot;
@@ -3135,12 +3483,10 @@ var DefaultZlinkStreamConnector = class {
     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);
@@ -3157,7 +3503,12 @@ var DefaultZlinkStreamConnector = class {
   }
   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(
@@ -3190,29 +3541,25 @@ var DefaultZlinkStreamConnector = class {
       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 ?? (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 ?? (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));
@@ -3334,7 +3681,7 @@ var DefaultZlinkStreamConnector = class {
     }
     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,
@@ -3345,7 +3692,9 @@ var DefaultZlinkStreamConnector = class {
       requestSeq,
       signal,
       correlationId,
-      actorSlot
+      actorSlot,
+      expiry,
+      onAccepted
     );
   }
   /**
@@ -3368,37 +3717,48 @@ var DefaultZlinkStreamConnector = class {
       }
     };
     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?.addEventListener("abort", onAbort, { once: true });
+        stopCancellation = () => signal?.removeEventListener("abort", onAbort);
+      });
+      const reply = await Promise.race([
+        write.then(() => accepted.promise),
+        accepted.promise,
+        canceled
+      ]);
       this.publishReplyReceived(
         {
           requestPacketName: name,
@@ -3412,6 +3772,7 @@ var DefaultZlinkStreamConnector = class {
       return reply.payload;
     } catch (error) {
       if (pending !== void 0) this.pendingRequests.cancel(pending.requestSeq);
+      if (signal?.aborted === true) throw error;
       this.publishReplyReceived(
         {
           requestPacketName: name,
@@ -3423,26 +3784,24 @@ var DefaultZlinkStreamConnector = class {
         signal
       );
       throw error;
+    } finally {
+      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) {