JavaScript SDK

The JavaScript SDK is a lightweight, zero-dependency client for capturing RAG interactions and sending them to Quorum for evaluation.

Quick start

import { Quorum } from '@quorum/sdk';

const quorum = new Quorum({ endpoint: 'http://localhost:3000' });

quorum.capture({
  input: 'What is the capital of France?',
  actualOutput: 'The capital of France is Paris.',
  retrievalContext: ['Paris is the capital and largest city of France.'],
});

await quorum.close();

Integration patterns

Direct capture

Call capture() after each RAG interaction. It is designed to be non-blocking.

Express middleware

import { quorumMiddleware } from './middleware.js';

app.use(quorumMiddleware);

This pattern wraps res.json() and captures responses automatically when req.ragContext is available.

LangChain callback

Extend BaseCallbackHandler and call quorum.capture() in handleChainEnd.

Configuration

Option	Type	Default	Description
`endpoint`	`string`	required	Quorum backend URL
`apiKey`	`string`	none	Optional API key
`defaultStrategy`	`string`	`auto`	`auto`, `single`, `hybrid`, or `council`
`batchSize`	`number`	`10`	Flush when the buffer reaches this size
`flushInterval`	`number`	`5000`	Auto-flush interval in milliseconds
`onError`	`function`	`console.warn`	Error callback
`correlationId`	`string`	auto-generated	Propagated as `X-Correlation-ID`

Data flow

Your app -> capture() -> buffer -> flush() -> POST /api/ingest -> Quorum backend

Core methods

`new Quorum(config)`

Creates a new SDK instance.

`.capture(payload)`

Buffers a RAG interaction. Returns void.

`.flush()`

Sends buffered captures to the backend and returns a Promise.

`.close()`

Flushes remaining captures and stops the interval timer.

​JavaScript SDK

​Quick start

​Integration patterns

​Direct capture

​Express middleware

​LangChain callback

​Configuration

​Data flow

​Core methods

​new Quorum(config)

​.capture(payload)

​.flush()

​.close()