Node.js SDK

npm install rcp-protocol

import * as rcp from "rcp-protocol";

const s = new rcp.Server();
s.setInfo("my-engine", "1.0");
s.advertise(rcp.Capability.Retrieve, { maxK: 200, modes: ["dense", "hybrid"] });
s.advertise(rcp.Capability.Embed, { dimension: 384, identity: "bge-small-en" });

s.on(rcp.Method.RETRIEVE, async (params) => {
  const hits = await myIndex.search(params.query, params.k ?? 10);
  return { hits: hits.map((h) => ({ id: h.id, score: h.score, text: h.text })) };
});

s.on(rcp.Method.EMBED, (params) => {
  const items = params.inputs || params.texts || [];   // inputs preferred
  return { vectors: items.map(embedOne) };
});

await s.serveStdio();          // or: await s.serveHttp(8000)

import * as rcp from "rcp-protocol";

const c = await rcp.connectStdio(["node", "my_engine.js"]);
// or: const c = await rcp.connectHttp("http://127.0.0.1:8000/rcp");

console.log(c.server, "RCP/" + c.protocolVersion);

if (c.supports(rcp.Capability.Retrieve))
  for (const h of await c.retrieve("eiffel tower", 3))
    console.log(h.id, h.score, h.text);

if (c.supports(rcp.Capability.Embed)) {
  const [vec] = await c.embed(["hello world"]);
  console.log("dim", vec.length);
}

await c.shutdown();

try {
  await c.rerank("q", ["a", "b"]);
} catch (e) {
  // e instanceof rcp.RcpError, e.code === -32003
  // e.message === "[RCP -32003] server does not advertise 'rerank'"
}

const sel = rcp.Selector.load("rcp.json");
const c = await sel.selectCapable(rcp.Capability.Retrieve);

// Merge per-engine ranked lists; deterministic tie-break, origin tags.
const fused = rcp.rrfFuse(
  { dense: denseHits, sparse: sparseHits },
  { k: 10, weights: { dense: 1.0, sparse: 0.7 } },
);
// rcp.weightedFuse(lists, { k, weights }) when scores are comparable.

// Compact embeddings for the wire (~4× smaller than JSON numbers).
const { payload, meta } = rcp.encodeVectors(vectors, rcp.F32_BASE64);
const back = rcp.decodeVectors(payload, meta.encoding, meta.dimension);

cd sdk/node
node test.js     # zero dependencies — nothing to build