tracebility — JS / TypeScript SDKs

Open-source JS / TypeScript SDKs for tracebility, the self-hosted LLM observability + eval-rigor + agent-replay platform.

What's in here

Package	Install	What it is
tracebility	npm install tracebility	Native SDK. TracebilityClient with ingest + control namespaces, trace + span AsyncLocalStorage-threaded, zero runtime deps. Use this for new code.
tracebility-langsmith	npm install tracebility-langsmith	Drop-in compat shim for the langsmith package. One-line import migration; ships Client, traceable, wrapOpenAI, wrapAnthropic.
tracebility-feedback-browser	npm install tracebility-feedback-browser	Browser-targeted public-key feedback SDK. Use a tbf_pub_* key to collect end-user thumbs / scores / comments without exposing your server credentials. ~2KB minified.

All three are independent: install only what you need.

Quick start (native)

npm install tracebility

import { TracebilityClient, trace } from "tracebility";

const client = new TracebilityClient({
  endpoint: "https://your-tracebility.example.com",
  apiKey: "tb_...",
});

const myAgent = trace(async (prompt: string) => {
  // your agent logic
  return await llmCall(prompt);
});

OpenTelemetry / non-JS

Java, Go, Rust, .NET, etc. should send traces via OpenTelemetry directly:

OTEL_EXPORTER_OTLP_ENDPOINT=https://your-tracebility.example.com/v1/traces

The tracebility ingest accepts OTLP HTTP/JSON and translates OpenInference + OTel GenAI semantic conventions to native runs/spans automatically. No SDK required in those languages.

Compatibility matrix

Source	What to install
New code	tracebility
Existing LangSmith code	tracebility-langsmith (one-line import change)
Browser end-user feedback	tracebility-feedback-browser
Other JS frameworks	tracebility + manual instrumentation

License

Apache-2.0. See LICENSE.

Contributing

Each package is independent; develop locally with:

cd tracebility           # or tracebility-langsmith / tracebility-feedback-browser
npm install
npm run build
npm test