agent-relay 2.0.24 → 2.0.26

package/packages/sdk/dist/protocol/framing.js

@@ -1,206 +0,0 @@
-/**
- * Frame encoding/decoding for the Agent Relay protocol.
- * @agent-relay/sdk
- *
- * Wire format:
- * - 1 byte: format indicator (0 = JSON, 1 = MessagePack)
- * - 4 bytes: big-endian payload length
- * - N bytes: payload (JSON or MessagePack encoded)
- *
- * Legacy format (for backwards compatibility):
- * - 4 bytes: big-endian payload length
- * - N bytes: JSON payload
- */
-export const MAX_FRAME_BYTES = 1024 * 1024; // 1 MiB
-export const HEADER_SIZE = 5; // 1 byte format + 4 bytes length
-export const LEGACY_HEADER_SIZE = 4; // For backwards compatibility
-// Format indicator bytes
-const FORMAT_JSON = 0;
-const FORMAT_MSGPACK = 1;
-// Optional MessagePack - loaded dynamically if available
-let msgpack = null;
-/**
- * Initialize MessagePack support.
- * Install @msgpack/msgpack to enable: npm install @msgpack/msgpack
- */
-export async function initMessagePack() {
-    if (msgpack)
-        return true;
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const mod = await import('@msgpack/msgpack');
-        const encode = mod.encode || mod.default?.encode;
-        const decode = mod.decode || mod.default?.decode;
-        if (encode && decode) {
-            msgpack = { encode, decode };
-            return true;
-        }
-        return false;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Check if MessagePack is available.
- */
-export function hasMessagePack() {
-    return msgpack !== null;
-}
-/**
- * Encode a message envelope into a framed buffer.
- *
- * @param envelope - The envelope to encode
- * @param format - Wire format to use (default: 'json')
- * @returns Framed buffer ready for socket write
- */
-export function encodeFrame(envelope, format = 'json') {
-    let data;
-    let formatByte;
-    if (format === 'msgpack' && msgpack) {
-        const encoded = msgpack.encode(envelope);
-        data = Buffer.from(encoded.buffer, encoded.byteOffset, encoded.byteLength);
-        formatByte = FORMAT_MSGPACK;
-    }
-    else {
-        data = Buffer.from(JSON.stringify(envelope), 'utf-8');
-        formatByte = FORMAT_JSON;
-    }
-    if (data.length > MAX_FRAME_BYTES) {
-        throw new Error(`Frame too large: ${data.length} > ${MAX_FRAME_BYTES}`);
-    }
-    const header = Buffer.alloc(HEADER_SIZE);
-    header.writeUInt8(formatByte, 0);
-    header.writeUInt32BE(data.length, 1);
-    return Buffer.concat([header, data]);
-}
-/**
- * Encode a frame in legacy format (no format byte, JSON only).
- * Used for backwards compatibility with older clients.
- */
-export function encodeFrameLegacy(envelope) {
-    const json = JSON.stringify(envelope);
-    const data = Buffer.from(json, 'utf-8');
-    if (data.length > MAX_FRAME_BYTES) {
-        throw new Error(`Frame too large: ${data.length} > ${MAX_FRAME_BYTES}`);
-    }
-    const header = Buffer.alloc(LEGACY_HEADER_SIZE);
-    header.writeUInt32BE(data.length, 0);
-    return Buffer.concat([header, data]);
-}
-/**
- * Ring buffer-based frame parser for streaming data.
- */
-export class FrameParser {
-    ring;
-    head = 0;
-    tail = 0;
-    capacity;
-    maxFrameBytes;
-    format = 'json';
-    legacyMode = false;
-    constructor(maxFrameBytes = MAX_FRAME_BYTES) {
-        this.maxFrameBytes = maxFrameBytes;
-        this.capacity = maxFrameBytes * 2 + HEADER_SIZE;
-        this.ring = Buffer.allocUnsafe(this.capacity);
-    }
-    /**
-     * Set the expected wire format for parsing.
-     */
-    setFormat(format) {
-        this.format = format;
-    }
-    /**
-     * Enable legacy mode (4-byte header, JSON only).
-     */
-    setLegacyMode(legacy) {
-        this.legacyMode = legacy;
-    }
-    /**
-     * Get current unread bytes in buffer.
-     */
-    get pendingBytes() {
-        return this.tail - this.head;
-    }
-    /**
-     * Push data into the parser and extract complete frames.
-     *
-     * @param data - Incoming data buffer
-     * @returns Array of parsed envelope frames
-     */
-    push(data) {
-        const spaceAtEnd = this.capacity - this.tail;
-        if (data.length > spaceAtEnd) {
-            this.compact();
-            if (data.length > this.capacity - this.tail) {
-                throw new Error(`Buffer overflow: data ${data.length} exceeds capacity`);
-            }
-        }
-        data.copy(this.ring, this.tail);
-        this.tail += data.length;
-        return this.extractFrames();
-    }
-    extractFrames() {
-        const frames = [];
-        const headerSize = this.legacyMode ? LEGACY_HEADER_SIZE : HEADER_SIZE;
-        while (this.pendingBytes >= headerSize) {
-            let formatByte = FORMAT_JSON;
-            let frameLength;
-            if (this.legacyMode) {
-                frameLength = this.ring.readUInt32BE(this.head);
-            }
-            else {
-                formatByte = this.ring.readUInt8(this.head);
-                frameLength = this.ring.readUInt32BE(this.head + 1);
-            }
-            if (frameLength > this.maxFrameBytes) {
-                throw new Error(`Frame too large: ${frameLength} > ${this.maxFrameBytes}`);
-            }
-            const totalLength = headerSize + frameLength;
-            if (this.pendingBytes < totalLength) {
-                break;
-            }
-            const payloadStart = this.head + headerSize;
-            const payloadEnd = this.head + totalLength;
-            let envelope;
-            try {
-                envelope = this.decodePayload(formatByte, payloadStart, payloadEnd);
-            }
-            catch (err) {
-                throw new Error(`Invalid frame payload: ${err}`);
-            }
-            this.head += totalLength;
-            frames.push(envelope);
-        }
-        if (this.head > this.capacity / 2 && this.pendingBytes < this.capacity / 4) {
-            this.compact();
-        }
-        return frames;
-    }
-    decodePayload(formatByte, start, end) {
-        if (formatByte === FORMAT_MSGPACK && msgpack) {
-            return msgpack.decode(this.ring.subarray(start, end));
-        }
-        else {
-            return JSON.parse(this.ring.toString('utf-8', start, end));
-        }
-    }
-    compact() {
-        if (this.head === 0)
-            return;
-        const unread = this.pendingBytes;
-        if (unread > 0) {
-            this.ring.copy(this.ring, 0, this.head, this.tail);
-        }
-        this.head = 0;
-        this.tail = unread;
-    }
-    /**
-     * Reset parser state.
-     */
-    reset() {
-        this.head = 0;
-        this.tail = 0;
-    }
-}
-//# sourceMappingURL=framing.js.map