@vascend/talos 0.1.0 → 0.1.1

package/dist/vendor/computer-use/rac/parser.js

@@ -1,185 +1,185 @@
-'use strict';
-
-// Parser incrementale MCP-RAC. L'unica uscita eseguibile e' `chunk`, prodotta
-// esclusivamente dopo `;`. END chiude l'azione ma non rende eseguibile il testo
-// che lo precede: un ultimo segmento senza `;` viene rifiutato.
-
-const G = require('./grammatica.js');
-
-const PENSIERO_INIZIO = '<|thought_start|>';
-const PENSIERO_FINE = '<|thought_end|>';
-const CODA_MINIMA = Math.max(PENSIERO_INIZIO.length, PENSIERO_FINE.length, 'ACTION'.length);
-
-function creaParser(options = {}) {
-  const bufferMassimo = Number.isInteger(options.bufferMassimo)
-    ? Math.max(256, options.bufferMassimo) : G.LIMITI.BUFFER_MASSIMO;
-  let buffer = '';
-  let stato = 'fuori';
-  let azione = null;
-  let sequenza = 0;
-
-  const scartoCorrente = () => azione ? {
-    observationId: azione.observationId,
-    chunkEmessi: azione.mouseVisto + azione.keysetEmessi,
-    ultimaSequenza: sequenza,
-  } : null;
-
-  function errore(motivo) {
-    const scarto = scartoCorrente();
-    azione = null;
-    stato = 'avvelenato';
-    return { tipo: 'errore', motivo, scarto };
-  }
-
-  function commitSegmento(grezzo) {
-    if (!azione) return errore('segmento fuori da ACTION');
-    const testo = grezzo.trim();
-    let parsed;
-    let indice;
-    if (!azione.mouseVisto) {
-      parsed = G.analizzaMouse(testo);
-      indice = 0;
-      if (!parsed.errore) azione.mouseVisto = 1;
-    } else {
-      if (azione.keysetEmessi >= G.LIMITI.CHUNK_PER_AZIONE) {
-        return errore(`piu' di ${G.LIMITI.CHUNK_PER_AZIONE} keyset in un'azione`);
-      }
-      parsed = G.analizzaKeyset(testo);
-      indice = azione.keysetEmessi;
-      if (!parsed.errore) azione.keysetEmessi += 1;
-    }
-    if (parsed.errore) return errore(parsed.errore);
-    sequenza += 1;
-    return {
-      tipo: 'chunk',
-      chunk: {
-        ...parsed,
-        observationId: azione.observationId,
-        ttlMs: azione.ttlMs,
-        sequenza,
-        indice,
-      },
-    };
-  }
-
-  function trovaAction() {
-    const match = /(?:^|\n)ACTION(?=\s)/.exec(buffer);
-    if (!match) return -1;
-    return match.index + (buffer[match.index] === '\n' ? 1 : 0);
-  }
-
-  function passo(finale) {
-    if (stato === 'pensiero') {
-      const fine = buffer.indexOf(PENSIERO_FINE);
-      if (fine < 0) {
-        const sicuro = finale ? buffer.length : Math.max(0, buffer.length - CODA_MINIMA);
-        if (!sicuro) return null;
-        const testo = buffer.slice(0, sicuro);
-        buffer = buffer.slice(sicuro);
-        return { evento: { tipo: 'pensiero', testo } };
-      }
-      const testo = buffer.slice(0, fine);
-      buffer = buffer.slice(fine + PENSIERO_FINE.length);
-      stato = 'fuori';
-      return { evento: testo ? { tipo: 'pensiero', testo } : { tipo: 'pensiero_fine' } };
-    }
-
-    if (stato !== 'corpo' && buffer.startsWith(PENSIERO_INIZIO)) {
-      buffer = buffer.slice(PENSIERO_INIZIO.length);
-      stato = 'pensiero';
-      return { avanzato: true };
-    }
-
-    if (stato === 'fuori' || stato === 'avvelenato') {
-      const idx = trovaAction();
-      if (idx < 0) {
-        const tieni = finale ? 0 : CODA_MINIMA;
-        if (buffer.length > tieni) {
-          buffer = tieni ? buffer.slice(-tieni) : '';
-          return { avanzato: true };
-        }
-        return null;
-      }
-      if (idx > 0) {
-        buffer = buffer.slice(idx);
-        return { avanzato: true };
-      }
-      const aCapo = buffer.indexOf('\n');
-      if (aCapo < 0) return null;
-      const testa = G.analizzaIntestazione(buffer.slice(0, aCapo).replace(/\r$/, ''));
-      buffer = buffer.slice(aCapo + 1);
-      if (testa.errore) return { evento: errore(testa.errore) };
-      azione = {
-        observationId: testa.observationId,
-        ttlMs: testa.ttlMs,
-        mouseVisto: 0,
-        keysetEmessi: 0,
-      };
-      stato = 'corpo';
-      return { evento: { tipo: 'intestazione', ...testa } };
-    }
-
-    const punto = buffer.indexOf(';');
-    const endMatch = /(?:^|\n)\s*END(?=\s|$)/.exec(buffer);
-    const fine = endMatch ? endMatch.index : -1;
-    if (punto >= 0 && (fine < 0 || punto < fine)) {
-      const segmento = buffer.slice(0, punto);
-      buffer = buffer.slice(punto + 1);
-      return { evento: commitSegmento(segmento) };
-    }
-    if (fine >= 0) {
-      const prefisso = buffer.slice(0, fine).trim();
-      const conclusa = azione;
-      buffer = buffer.slice(fine + endMatch[0].length);
-      if (prefisso) return { evento: errore('segmento prima di END privo di delimitatore ;') };
-      if (!conclusa.mouseVisto || conclusa.keysetEmessi !== G.LIMITI.CHUNK_PER_AZIONE) {
-        return { evento: errore(`azione incompleta: attesi mouse + ${G.LIMITI.CHUNK_PER_AZIONE} keyset`) };
-      }
-      azione = null;
-      stato = 'fuori';
-      return { evento: { tipo: 'fine_azione', observationId: conclusa.observationId, ultimaSequenza: sequenza } };
-    }
-    return null;
-  }
-
-  function estrai(finale) {
-    const eventi = [];
-    for (;;) {
-      const r = passo(finale);
-      if (!r) break;
-      if (r.evento) eventi.push(r.evento);
-    }
-    return eventi;
-  }
-
-  return {
-    push(delta) {
-      buffer += String(delta == null ? '' : delta);
-      if (buffer.length > bufferMassimo) {
-        const event = errore(`buffer oltre ${bufferMassimo} byte`);
-        buffer = buffer.slice(-CODA_MINIMA);
-        return [event, ...estrai(false)];
-      }
-      return estrai(false);
-    },
-    fine() {
-      const eventi = estrai(true);
-      if (stato === 'corpo' && azione) eventi.push({ tipo: 'troncata', ...scartoCorrente() });
-      azione = null;
-      stato = 'fuori';
-      buffer = '';
-      return eventi;
-    },
-    reset() {
-      const scarto = scartoCorrente();
-      buffer = '';
-      stato = 'fuori';
-      azione = null;
-      return scarto;
-    },
-    stato: () => stato,
-    diagnostica: () => ({ stato, bytesInBuffer: buffer.length, sequenza }),
-  };
-}
-
-module.exports = { creaParser, PENSIERO_INIZIO, PENSIERO_FINE };
+'use strict';
+
+// Parser incrementale MCP-RAC. L'unica uscita eseguibile e' `chunk`, prodotta
+// esclusivamente dopo `;`. END chiude l'azione ma non rende eseguibile il testo
+// che lo precede: un ultimo segmento senza `;` viene rifiutato.
+
+const G = require('./grammatica.js');
+
+const PENSIERO_INIZIO = '<|thought_start|>';
+const PENSIERO_FINE = '<|thought_end|>';
+const CODA_MINIMA = Math.max(PENSIERO_INIZIO.length, PENSIERO_FINE.length, 'ACTION'.length);
+
+function creaParser(options = {}) {
+  const bufferMassimo = Number.isInteger(options.bufferMassimo)
+    ? Math.max(256, options.bufferMassimo) : G.LIMITI.BUFFER_MASSIMO;
+  let buffer = '';
+  let stato = 'fuori';
+  let azione = null;
+  let sequenza = 0;
+
+  const scartoCorrente = () => azione ? {
+    observationId: azione.observationId,
+    chunkEmessi: azione.mouseVisto + azione.keysetEmessi,
+    ultimaSequenza: sequenza,
+  } : null;
+
+  function errore(motivo) {
+    const scarto = scartoCorrente();
+    azione = null;
+    stato = 'avvelenato';
+    return { tipo: 'errore', motivo, scarto };
+  }
+
+  function commitSegmento(grezzo) {
+    if (!azione) return errore('segmento fuori da ACTION');
+    const testo = grezzo.trim();
+    let parsed;
+    let indice;
+    if (!azione.mouseVisto) {
+      parsed = G.analizzaMouse(testo);
+      indice = 0;
+      if (!parsed.errore) azione.mouseVisto = 1;
+    } else {
+      if (azione.keysetEmessi >= G.LIMITI.CHUNK_PER_AZIONE) {
+        return errore(`piu' di ${G.LIMITI.CHUNK_PER_AZIONE} keyset in un'azione`);
+      }
+      parsed = G.analizzaKeyset(testo);
+      indice = azione.keysetEmessi;
+      if (!parsed.errore) azione.keysetEmessi += 1;
+    }
+    if (parsed.errore) return errore(parsed.errore);
+    sequenza += 1;
+    return {
+      tipo: 'chunk',
+      chunk: {
+        ...parsed,
+        observationId: azione.observationId,
+        ttlMs: azione.ttlMs,
+        sequenza,
+        indice,
+      },
+    };
+  }
+
+  function trovaAction() {
+    const match = /(?:^|\n)ACTION(?=\s)/.exec(buffer);
+    if (!match) return -1;
+    return match.index + (buffer[match.index] === '\n' ? 1 : 0);
+  }
+
+  function passo(finale) {
+    if (stato === 'pensiero') {
+      const fine = buffer.indexOf(PENSIERO_FINE);
+      if (fine < 0) {
+        const sicuro = finale ? buffer.length : Math.max(0, buffer.length - CODA_MINIMA);
+        if (!sicuro) return null;
+        const testo = buffer.slice(0, sicuro);
+        buffer = buffer.slice(sicuro);
+        return { evento: { tipo: 'pensiero', testo } };
+      }
+      const testo = buffer.slice(0, fine);
+      buffer = buffer.slice(fine + PENSIERO_FINE.length);
+      stato = 'fuori';
+      return { evento: testo ? { tipo: 'pensiero', testo } : { tipo: 'pensiero_fine' } };
+    }
+
+    if (stato !== 'corpo' && buffer.startsWith(PENSIERO_INIZIO)) {
+      buffer = buffer.slice(PENSIERO_INIZIO.length);
+      stato = 'pensiero';
+      return { avanzato: true };
+    }
+
+    if (stato === 'fuori' || stato === 'avvelenato') {
+      const idx = trovaAction();
+      if (idx < 0) {
+        const tieni = finale ? 0 : CODA_MINIMA;
+        if (buffer.length > tieni) {
+          buffer = tieni ? buffer.slice(-tieni) : '';
+          return { avanzato: true };
+        }
+        return null;
+      }
+      if (idx > 0) {
+        buffer = buffer.slice(idx);
+        return { avanzato: true };
+      }
+      const aCapo = buffer.indexOf('\n');
+      if (aCapo < 0) return null;
+      const testa = G.analizzaIntestazione(buffer.slice(0, aCapo).replace(/\r$/, ''));
+      buffer = buffer.slice(aCapo + 1);
+      if (testa.errore) return { evento: errore(testa.errore) };
+      azione = {
+        observationId: testa.observationId,
+        ttlMs: testa.ttlMs,
+        mouseVisto: 0,
+        keysetEmessi: 0,
+      };
+      stato = 'corpo';
+      return { evento: { tipo: 'intestazione', ...testa } };
+    }
+
+    const punto = buffer.indexOf(';');
+    const endMatch = /(?:^|\n)\s*END(?=\s|$)/.exec(buffer);
+    const fine = endMatch ? endMatch.index : -1;
+    if (punto >= 0 && (fine < 0 || punto < fine)) {
+      const segmento = buffer.slice(0, punto);
+      buffer = buffer.slice(punto + 1);
+      return { evento: commitSegmento(segmento) };
+    }
+    if (fine >= 0) {
+      const prefisso = buffer.slice(0, fine).trim();
+      const conclusa = azione;
+      buffer = buffer.slice(fine + endMatch[0].length);
+      if (prefisso) return { evento: errore('segmento prima di END privo di delimitatore ;') };
+      if (!conclusa.mouseVisto || conclusa.keysetEmessi !== G.LIMITI.CHUNK_PER_AZIONE) {
+        return { evento: errore(`azione incompleta: attesi mouse + ${G.LIMITI.CHUNK_PER_AZIONE} keyset`) };
+      }
+      azione = null;
+      stato = 'fuori';
+      return { evento: { tipo: 'fine_azione', observationId: conclusa.observationId, ultimaSequenza: sequenza } };
+    }
+    return null;
+  }
+
+  function estrai(finale) {
+    const eventi = [];
+    for (;;) {
+      const r = passo(finale);
+      if (!r) break;
+      if (r.evento) eventi.push(r.evento);
+    }
+    return eventi;
+  }
+
+  return {
+    push(delta) {
+      buffer += String(delta == null ? '' : delta);
+      if (buffer.length > bufferMassimo) {
+        const event = errore(`buffer oltre ${bufferMassimo} byte`);
+        buffer = buffer.slice(-CODA_MINIMA);
+        return [event, ...estrai(false)];
+      }
+      return estrai(false);
+    },
+    fine() {
+      const eventi = estrai(true);
+      if (stato === 'corpo' && azione) eventi.push({ tipo: 'troncata', ...scartoCorrente() });
+      azione = null;
+      stato = 'fuori';
+      buffer = '';
+      return eventi;
+    },
+    reset() {
+      const scarto = scartoCorrente();
+      buffer = '';
+      stato = 'fuori';
+      azione = null;
+      return scarto;
+    },
+    stato: () => stato,
+    diagnostica: () => ({ stato, bytesInBuffer: buffer.length, sequenza }),
+  };
+}
+
+module.exports = { creaParser, PENSIERO_INIZIO, PENSIERO_FINE };

package/dist/vendor/computer-use/rac/protocol.js

@@ -1,136 +1,136 @@
-'use strict';
-
-const crypto = require('node:crypto');
-
-const EXTENSION_ID = 'io.vascend.mcp.reactive-control/0.1';
-const MAGIC = Buffer.from('RAC1');
-const VERSION = 1;
-const HEADER_BYTES = 52;
-
-const MESSAGE_TYPES = Object.freeze({
-  OBS_KEYFRAME: 1,
-  OBS_DELTA: 2,
-  ACTION_START: 3,
-  ACTION_CHUNK: 4,
-  ACTION_REVOKE: 5,
-  ACK: 6,
-  SAFETY_STOP: 7,
-});
-const MESSAGE_NAMES = Object.freeze(Object.fromEntries(
-  Object.entries(MESSAGE_TYPES).map(([name, value]) => [value, name]),
-));
-
-const SERVER_CAPABILITIES = Object.freeze({
-  extension: EXTENSION_ID,
-  version: VERSION,
-  transport: ['node-ipc'],
-  framing: ['rac-binary-v1'],
-  observation: ['keyframe', 'delta', 'checkpoint', 'revoke'],
-  actionRateHz: 30,
-  observationRateHz: 5,
-  maxActionHorizonMs: 200,
-  maxLeaseMs: 250,
-  strictObservationMaxAgeMs: 450,
-  cumulativeAck: true,
-  checksum: 'crc32',
-  duplexObservations: false,
-});
-
-let crcTable = null;
-function tableCrc32() {
-  if (crcTable) return crcTable;
-  crcTable = Array.from({ length: 256 }, (_, index) => {
-    let value = index;
-    for (let bit = 0; bit < 8; bit += 1) {
-      value = (value >>> 1) ^ ((value & 1) ? 0xedb88320 : 0);
-    }
-    return value >>> 0;
-  });
-  return crcTable;
-}
-
-function crc32(value) {
-  const bytes = Buffer.isBuffer(value) ? value : Buffer.from(value || '');
-  const table = tableCrc32();
-  let crc = 0xffffffff;
-  for (const byte of bytes) crc = (crc >>> 8) ^ table[(crc ^ byte) & 0xff];
-  return (crc ^ 0xffffffff) >>> 0;
-}
-
-function sessionDigest(sessionId) {
-  return crypto.createHash('sha256').update(String(sessionId || '')).digest().subarray(0, 16);
-}
-
-function safeBigInt(value, name) {
-  try {
-    const parsed = BigInt(value || 0);
-    if (parsed < 0n || parsed > 0xffffffffffffffffn) throw new RangeError(name);
-    return parsed;
-  } catch (_) {
-    throw new TypeError(`${name || 'value'} non valido`);
-  }
-}
-
-function encodeFrame(input = {}) {
-  const type = typeof input.type === 'string' ? MESSAGE_TYPES[input.type] : Number(input.type);
-  if (!MESSAGE_NAMES[type]) throw new TypeError('RAC_MESSAGE_TYPE_INVALID');
-  const payload = Buffer.isBuffer(input.payload) ? input.payload : Buffer.from(String(input.payload || ''), 'utf8');
-  if (payload.length > 16 * 1024 * 1024) throw new RangeError('RAC_PAYLOAD_TOO_LARGE');
-  const header = Buffer.alloc(HEADER_BYTES);
-  MAGIC.copy(header, 0);
-  header.writeUInt8(VERSION, 4);
-  header.writeUInt8(type, 5);
-  header.writeUInt16BE(Number(input.flags || 0) & 0xffff, 6);
-  header.writeUInt32BE(Number(input.sequence || 0) >>> 0, 8);
-  header.writeBigUInt64BE(safeBigInt(input.monotonicUs, 'monotonicUs'), 12);
-  header.writeBigUInt64BE(safeBigInt(input.observationId, 'observationId'), 20);
-  header.writeUInt32BE(payload.length >>> 0, 28);
-  header.writeUInt32BE(crc32(payload), 32);
-  sessionDigest(input.sessionId).copy(header, 36);
-  return Buffer.concat([header, payload]);
-}
-
-function decodeFrame(value, expected = {}) {
-  const frame = Buffer.isBuffer(value) ? value : Buffer.from(value || '');
-  if (frame.length < HEADER_BYTES) return { ok: false, code: 'RAC_FRAME_TRUNCATED' };
-  if (!frame.subarray(0, 4).equals(MAGIC)) return { ok: false, code: 'RAC_FRAME_MAGIC' };
-  if (frame.readUInt8(4) !== VERSION) return { ok: false, code: 'RAC_FRAME_VERSION' };
-  const type = frame.readUInt8(5);
-  if (!MESSAGE_NAMES[type]) return { ok: false, code: 'RAC_FRAME_TYPE' };
-  const payloadLength = frame.readUInt32BE(28);
-  if (frame.length !== HEADER_BYTES + payloadLength) return { ok: false, code: 'RAC_FRAME_LENGTH' };
-  const payload = frame.subarray(HEADER_BYTES);
-  if (crc32(payload) !== frame.readUInt32BE(32)) return { ok: false, code: 'RAC_FRAME_CHECKSUM' };
-  if (expected.sessionId && !frame.subarray(36, 52).equals(sessionDigest(expected.sessionId))) {
-    return { ok: false, code: 'RAC_FRAME_SESSION' };
-  }
-  const observationId = frame.readBigUInt64BE(20).toString();
-  if (expected.observationId && String(expected.observationId) !== observationId) {
-    return { ok: false, code: 'STALE_OBSERVATION' };
-  }
-  return {
-    ok: true,
-    type: MESSAGE_NAMES[type],
-    typeId: type,
-    flags: frame.readUInt16BE(6),
-    sequence: frame.readUInt32BE(8),
-    monotonicUs: frame.readBigUInt64BE(12),
-    observationId,
-    payload,
-    checksum: frame.readUInt32BE(32),
-  };
-}
-
-function negotiateCapabilities(client = {}) {
-  const extension = String(client.extension || EXTENSION_ID);
-  if (extension !== EXTENSION_ID) return { ok: false, code: 'RAC_EXTENSION_UNSUPPORTED' };
-  const requestedTransports = Array.isArray(client.transport) ? client.transport : ['node-ipc'];
-  const transport = SERVER_CAPABILITIES.transport.find((item) => requestedTransports.includes(item));
-  if (!transport) return { ok: false, code: 'RAC_TRANSPORT_UNSUPPORTED' };
-  return { ok: true, ...SERVER_CAPABILITIES, transport };
-}
-
-module.exports = {
-  EXTENSION_ID, VERSION, HEADER_BYTES, MESSAGE_TYPES, SERVER_CAPABILITIES,
-  crc32, encodeFrame, decodeFrame, negotiateCapabilities,
-};
+'use strict';
+
+const crypto = require('node:crypto');
+
+const EXTENSION_ID = 'io.vascend.mcp.reactive-control/0.1';
+const MAGIC = Buffer.from('RAC1');
+const VERSION = 1;
+const HEADER_BYTES = 52;
+
+const MESSAGE_TYPES = Object.freeze({
+  OBS_KEYFRAME: 1,
+  OBS_DELTA: 2,
+  ACTION_START: 3,
+  ACTION_CHUNK: 4,
+  ACTION_REVOKE: 5,
+  ACK: 6,
+  SAFETY_STOP: 7,
+});
+const MESSAGE_NAMES = Object.freeze(Object.fromEntries(
+  Object.entries(MESSAGE_TYPES).map(([name, value]) => [value, name]),
+));
+
+const SERVER_CAPABILITIES = Object.freeze({
+  extension: EXTENSION_ID,
+  version: VERSION,
+  transport: ['node-ipc'],
+  framing: ['rac-binary-v1'],
+  observation: ['keyframe', 'delta', 'checkpoint', 'revoke'],
+  actionRateHz: 30,
+  observationRateHz: 5,
+  maxActionHorizonMs: 200,
+  maxLeaseMs: 250,
+  strictObservationMaxAgeMs: 450,
+  cumulativeAck: true,
+  checksum: 'crc32',
+  duplexObservations: false,
+});
+
+let crcTable = null;
+function tableCrc32() {
+  if (crcTable) return crcTable;
+  crcTable = Array.from({ length: 256 }, (_, index) => {
+    let value = index;
+    for (let bit = 0; bit < 8; bit += 1) {
+      value = (value >>> 1) ^ ((value & 1) ? 0xedb88320 : 0);
+    }
+    return value >>> 0;
+  });
+  return crcTable;
+}
+
+function crc32(value) {
+  const bytes = Buffer.isBuffer(value) ? value : Buffer.from(value || '');
+  const table = tableCrc32();
+  let crc = 0xffffffff;
+  for (const byte of bytes) crc = (crc >>> 8) ^ table[(crc ^ byte) & 0xff];
+  return (crc ^ 0xffffffff) >>> 0;
+}
+
+function sessionDigest(sessionId) {
+  return crypto.createHash('sha256').update(String(sessionId || '')).digest().subarray(0, 16);
+}
+
+function safeBigInt(value, name) {
+  try {
+    const parsed = BigInt(value || 0);
+    if (parsed < 0n || parsed > 0xffffffffffffffffn) throw new RangeError(name);
+    return parsed;
+  } catch (_) {
+    throw new TypeError(`${name || 'value'} non valido`);
+  }
+}
+
+function encodeFrame(input = {}) {
+  const type = typeof input.type === 'string' ? MESSAGE_TYPES[input.type] : Number(input.type);
+  if (!MESSAGE_NAMES[type]) throw new TypeError('RAC_MESSAGE_TYPE_INVALID');
+  const payload = Buffer.isBuffer(input.payload) ? input.payload : Buffer.from(String(input.payload || ''), 'utf8');
+  if (payload.length > 16 * 1024 * 1024) throw new RangeError('RAC_PAYLOAD_TOO_LARGE');
+  const header = Buffer.alloc(HEADER_BYTES);
+  MAGIC.copy(header, 0);
+  header.writeUInt8(VERSION, 4);
+  header.writeUInt8(type, 5);
+  header.writeUInt16BE(Number(input.flags || 0) & 0xffff, 6);
+  header.writeUInt32BE(Number(input.sequence || 0) >>> 0, 8);
+  header.writeBigUInt64BE(safeBigInt(input.monotonicUs, 'monotonicUs'), 12);
+  header.writeBigUInt64BE(safeBigInt(input.observationId, 'observationId'), 20);
+  header.writeUInt32BE(payload.length >>> 0, 28);
+  header.writeUInt32BE(crc32(payload), 32);
+  sessionDigest(input.sessionId).copy(header, 36);
+  return Buffer.concat([header, payload]);
+}
+
+function decodeFrame(value, expected = {}) {
+  const frame = Buffer.isBuffer(value) ? value : Buffer.from(value || '');
+  if (frame.length < HEADER_BYTES) return { ok: false, code: 'RAC_FRAME_TRUNCATED' };
+  if (!frame.subarray(0, 4).equals(MAGIC)) return { ok: false, code: 'RAC_FRAME_MAGIC' };
+  if (frame.readUInt8(4) !== VERSION) return { ok: false, code: 'RAC_FRAME_VERSION' };
+  const type = frame.readUInt8(5);
+  if (!MESSAGE_NAMES[type]) return { ok: false, code: 'RAC_FRAME_TYPE' };
+  const payloadLength = frame.readUInt32BE(28);
+  if (frame.length !== HEADER_BYTES + payloadLength) return { ok: false, code: 'RAC_FRAME_LENGTH' };
+  const payload = frame.subarray(HEADER_BYTES);
+  if (crc32(payload) !== frame.readUInt32BE(32)) return { ok: false, code: 'RAC_FRAME_CHECKSUM' };
+  if (expected.sessionId && !frame.subarray(36, 52).equals(sessionDigest(expected.sessionId))) {
+    return { ok: false, code: 'RAC_FRAME_SESSION' };
+  }
+  const observationId = frame.readBigUInt64BE(20).toString();
+  if (expected.observationId && String(expected.observationId) !== observationId) {
+    return { ok: false, code: 'STALE_OBSERVATION' };
+  }
+  return {
+    ok: true,
+    type: MESSAGE_NAMES[type],
+    typeId: type,
+    flags: frame.readUInt16BE(6),
+    sequence: frame.readUInt32BE(8),
+    monotonicUs: frame.readBigUInt64BE(12),
+    observationId,
+    payload,
+    checksum: frame.readUInt32BE(32),
+  };
+}
+
+function negotiateCapabilities(client = {}) {
+  const extension = String(client.extension || EXTENSION_ID);
+  if (extension !== EXTENSION_ID) return { ok: false, code: 'RAC_EXTENSION_UNSUPPORTED' };
+  const requestedTransports = Array.isArray(client.transport) ? client.transport : ['node-ipc'];
+  const transport = SERVER_CAPABILITIES.transport.find((item) => requestedTransports.includes(item));
+  if (!transport) return { ok: false, code: 'RAC_TRANSPORT_UNSUPPORTED' };
+  return { ok: true, ...SERVER_CAPABILITIES, transport };
+}
+
+module.exports = {
+  EXTENSION_ID, VERSION, HEADER_BYTES, MESSAGE_TYPES, SERVER_CAPABILITIES,
+  crc32, encodeFrame, decodeFrame, negotiateCapabilities,
+};