Skip to content
Opviva.

Flight Recorder SDK

Capture every prompt, tool call, and outcome your AI agents produce into a tamper-evident timeline you can reconstruct and export. Non-blocking and never throws into your app — if recording fails, your agent keeps running.

Install

TypeScript / Node

npm i @opviva/recorder

Python

pip install opviva-recorder

Quickstart

TypeScript

import { createRecorder } from "@opviva/recorder";

const recorder = createRecorder({
  apiKey: process.env.OPVIVA_API_KEY!,   // Setup → API keys
  app: "checkout-agent",
  redact: { dropKeys: ["password", "token"] },
});

const session = recorder.session({ actor: "support-bot" });
const refund = session.wrapTool("refundOrder", refundOrder);
await refund(orderId);
session.logPrompt({ system, user, model: "claude-opus-4-8" });
await session.close();

Python

from opviva_recorder import create_recorder

recorder = create_recorder(api_key="...", app="checkout-agent")
session = recorder.session(actor="support-bot")

@session.wrap_tool("refund_order")
def refund_order(order_id): ...

session.log_prompt(system=..., user=..., model="claude-opus-4-8")
session.close()

Framework adapters

One line for the stack you already use — every call records automatically.

Vercel AI SDK

import { wrapLanguageModel } from "ai";
import { instrumentTools, recorderMiddleware } from "@opviva/recorder";

const model = wrapLanguageModel({ model: openai("gpt-4o"), middleware: recorderMiddleware(session) });
const tools = instrumentTools(session, { search, refundOrder });

LangChain (TypeScript)

import { opvivaLangChainHandler } from "@opviva/recorder";
await chain.invoke(input, { callbacks: [opvivaLangChainHandler(session)] });

LangChain (Python)

from opviva_recorder.langchain import OpvivaCallbackHandler
chain.invoke(input, config={"callbacks": [OpvivaCallbackHandler(session)]})

OpenAI / Anthropic

import { instrumentChat } from "@opviva/recorder";
const create = instrumentChat(session, (a) => openai.chat.completions.create(a));

Sessions then appear in your dashboard under Security → Flight Recorder — reconstruct the timeline, verify chain integrity, and export an auditor report.