@opviva/recorder 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Opviva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# @opviva/recorder
+
+**Opviva Flight Recorder SDK** — capture what your AI agents do, in a tamper-evident timeline.
+
+Record every tool call, model response, and decision your agents make into a signed, verifiable
+event stream — so you can prove what happened, debug failures, and pass security/compliance review.
+
+## Install
+
+```bash
+npm i @opviva/recorder
+```
+
+## Quick start
+
+```ts
+import { createRecorder } from "@opviva/recorder";
+
+const recorder = createRecorder({ apiKey: process.env.OPVIVA_API_KEY });
+const session = recorder.session({ agent: "support-bot" });
+
+session.record({ type: "tool_call", name: "search", input: { q: "refund policy" } });
+await session.flush();
+```
+
+## Adapters
+
+Instrument popular agent stacks with one line:
+
+```ts
+// Vercel AI SDK
+import { instrumentTools, recorderMiddleware } from "@opviva/recorder";
+
+// LangChain
+import { opvivaLangChainHandler } from "@opviva/recorder";
+
+// Raw LLM chat calls
+import { instrumentChat } from "@opviva/recorder";
+```
+
+## Redaction
+
+Sensitive fields (secrets, PII) are redactable before anything leaves your process — configure via
+`RedactConfig`. See the full guide at **https://opviva.com/docs/recorder**.
+
+## License
+
+MIT

package/dist/adapters/ai-sdk.d.ts

@@ -0,0 +1,31 @@
+import type { Session } from "../recorder.js";
+/** A Vercel-AI-SDK-style tool: an object that may carry an `execute` function. Structurally typed so the
+ *  adapter never depends on the `ai` package. */
+export interface InstrumentableTool {
+    execute?: (...args: unknown[]) => unknown;
+    [key: string]: unknown;
+}
+/**
+ * Instrument a Vercel AI SDK `tools` map: every tool with an `execute` gets it wrapped by the recorder so
+ * each call is captured (args, result, errors, timing) into the session timeline. Tools without an
+ * `execute` pass through untouched. Use the returned map in `generateText`/`streamText`.
+ */
+export declare function instrumentTools<T extends Record<string, InstrumentableTool>>(session: Session, tools: T): T;
+/** Structural shape of the Vercel AI SDK `wrapGenerate` middleware argument (no `ai` import). */
+export interface GenerateMiddlewareArgs {
+    doGenerate: () => Promise<unknown>;
+    params: {
+        prompt?: unknown;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * A Vercel AI SDK `LanguageModelV1Middleware` that records the prompt + generation for every model call.
+ * Use it with `wrapLanguageModel`:
+ *   const model = wrapLanguageModel({ model: openai("gpt-4o"), middleware: recorderMiddleware(session) });
+ * Captures prompts/generations (pair this with `instrumentTools` for the agent's tool actions).
+ */
+export declare function recorderMiddleware(session: Session): {
+    wrapGenerate: (args: GenerateMiddlewareArgs) => Promise<unknown>;
+};

package/dist/adapters/ai-sdk.js

@@ -0,0 +1,36 @@
+/**
+ * Instrument a Vercel AI SDK `tools` map: every tool with an `execute` gets it wrapped by the recorder so
+ * each call is captured (args, result, errors, timing) into the session timeline. Tools without an
+ * `execute` pass through untouched. Use the returned map in `generateText`/`streamText`.
+ */
+export function instrumentTools(session, tools) {
+    const out = {};
+    for (const [name, tool] of Object.entries(tools)) {
+        out[name] = typeof tool.execute === "function" ? { ...tool, execute: session.wrapTool(name, tool.execute) } : tool;
+    }
+    return out;
+}
+/**
+ * A Vercel AI SDK `LanguageModelV1Middleware` that records the prompt + generation for every model call.
+ * Use it with `wrapLanguageModel`:
+ *   const model = wrapLanguageModel({ model: openai("gpt-4o"), middleware: recorderMiddleware(session) });
+ * Captures prompts/generations (pair this with `instrumentTools` for the agent's tool actions).
+ */
+export function recorderMiddleware(session) {
+    return {
+        async wrapGenerate({ doGenerate, params }) {
+            session.logPrompt({ prompt: params?.prompt });
+            try {
+                const result = await doGenerate();
+                const r = result;
+                session.logDecision({ output: r?.text, toolArgs: r?.toolCalls });
+                return result;
+            }
+            catch (err) {
+                session.recordError(err);
+                throw err; // re-raise the host's own error
+            }
+        },
+    };
+}
+//# sourceMappingURL=ai-sdk.js.map

package/dist/adapters/ai-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.js","sourceRoot":"","sources":["../../src/adapters/ai-sdk.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAA+C,OAAgB,EAAE,KAAQ;IACtG,MAAM,GAAG,GAAuC,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACrH,CAAC;IACD,OAAO,GAAQ,CAAC;AAClB,CAAC;AASD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;QACL,KAAK,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,MAAM,EAA0B;YAC/D,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,MAA6D,CAAC;gBACxE,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;gBACjE,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBACzB,MAAM,GAAG,CAAC,CAAC,gCAAgC;YAC7C,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/langchain.d.ts

@@ -0,0 +1,17 @@
+import type { Session } from "../recorder.js";
+/** The handler shape LangChain JS accepts in `callbacks: [...]`. Loosely typed so we never import langchain. */
+export interface LangChainCallbackHandler {
+    readonly name: string;
+    handleLLMStart(llm: unknown, prompts: unknown, runId?: string): void;
+    handleChatModelStart(llm: unknown, messages: unknown, runId?: string): void;
+    handleToolStart(tool: unknown, input: unknown, runId?: string): void;
+    handleToolEnd(output: unknown, runId?: string): void;
+    handleToolError(err: unknown, runId?: string): void;
+}
+/**
+ * A LangChain JS callback handler that records LLM/chat starts (as prompts) and tool start/end/error
+ * (as tool_call/tool_result) into an Opviva session. Pass it in `callbacks`:
+ *   chain.invoke(input, { callbacks: [opvivaLangChainHandler(session)] })
+ * Never throws into the LangChain run.
+ */
+export declare function opvivaLangChainHandler(session: Session): LangChainCallbackHandler;

package/dist/adapters/langchain.js

@@ -0,0 +1,68 @@
+function nameOf(serialized) {
+    const s = serialized;
+    if (s?.id && s.id.length > 0)
+        return s.id[s.id.length - 1];
+    return s?.name;
+}
+/**
+ * A LangChain JS callback handler that records LLM/chat starts (as prompts) and tool start/end/error
+ * (as tool_call/tool_result) into an Opviva session. Pass it in `callbacks`:
+ *   chain.invoke(input, { callbacks: [opvivaLangChainHandler(session)] })
+ * Never throws into the LangChain run.
+ */
+export function opvivaLangChainHandler(session) {
+    const toolNames = new Map();
+    return {
+        name: "opviva_recorder",
+        handleLLMStart(llm, prompts, _runId) {
+            try {
+                session.logPrompt({ prompts, model: nameOf(llm) });
+            }
+            catch {
+                /* never break the chain */
+            }
+        },
+        handleChatModelStart(llm, messages, _runId) {
+            try {
+                session.logPrompt({ messages: JSON.stringify(messages), model: nameOf(llm) });
+            }
+            catch {
+                /* never break the chain */
+            }
+        },
+        handleToolStart(tool, input, runId) {
+            try {
+                const name = tool?.name ?? "tool";
+                if (runId)
+                    toolNames.set(runId, name);
+                session.logToolCall(name, { input });
+            }
+            catch {
+                /* never break the chain */
+            }
+        },
+        handleToolEnd(output, runId) {
+            try {
+                const name = (runId && toolNames.get(runId)) || "tool";
+                if (runId)
+                    toolNames.delete(runId);
+                session.logToolResult(name, { result: output });
+            }
+            catch {
+                /* never break the chain */
+            }
+        },
+        handleToolError(err, runId) {
+            try {
+                const name = (runId && toolNames.get(runId)) || "tool";
+                if (runId)
+                    toolNames.delete(runId);
+                session.logToolResult(name, { error: err });
+            }
+            catch {
+                /* never break the chain */
+            }
+        },
+    };
+}
+//# sourceMappingURL=langchain.js.map

package/dist/adapters/langchain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.js","sourceRoot":"","sources":["../../src/adapters/langchain.ts"],"names":[],"mappings":"AAkBA,SAAS,MAAM,CAAC,UAAmB;IACjC,MAAM,CAAC,GAAG,UAAoC,CAAC;IAC/C,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,IAAI,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM;YACjC,IAAI,CAAC;gBACH,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC;QACD,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM;YACxC,IAAI,CAAC;gBACH,OAAO,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChF,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC;QACD,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK;YAChC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAI,IAA+B,EAAE,IAAI,IAAI,MAAM,CAAC;gBAC9D,IAAI,KAAK;oBAAE,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBACtC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC;QACD,aAAa,CAAC,MAAM,EAAE,KAAK;YACzB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC;gBACvD,IAAI,KAAK;oBAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACnC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC;QACD,eAAe,CAAC,GAAG,EAAE,KAAK;YACxB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC;gBACvD,IAAI,KAAK;oBAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACnC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAC9C,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/llm.d.ts

@@ -0,0 +1,15 @@
+import type { Session } from "../recorder.js";
+/** OpenAI/Anthropic-style chat request (provider-agnostic; only the common fields are read). */
+export interface ChatCreateArgs {
+    model?: string;
+    messages?: unknown;
+    system?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Wrap an OpenAI/Anthropic-style chat-create call so each request's prompt and the model's response are
+ * recorded. Works with `openai.chat.completions.create` and `anthropic.messages.create`:
+ *   const create = instrumentChat(session, (args) => openai.chat.completions.create(args));
+ * Records the prompt + decision; on failure records the error and re-raises the host's error.
+ */
+export declare function instrumentChat<A extends ChatCreateArgs, R>(session: Session, create: (args: A) => Promise<R>): (args: A) => Promise<R>;

package/dist/adapters/llm.js

@@ -0,0 +1,21 @@
+/**
+ * Wrap an OpenAI/Anthropic-style chat-create call so each request's prompt and the model's response are
+ * recorded. Works with `openai.chat.completions.create` and `anthropic.messages.create`:
+ *   const create = instrumentChat(session, (args) => openai.chat.completions.create(args));
+ * Records the prompt + decision; on failure records the error and re-raises the host's error.
+ */
+export function instrumentChat(session, create) {
+    return async (args) => {
+        session.logPrompt({ model: args.model, messages: args.messages, system: args.system });
+        try {
+            const result = await create(args);
+            session.logDecision({ model: args.model, output: result });
+            return result;
+        }
+        catch (err) {
+            session.recordError(err);
+            throw err; // re-raise the host's own error
+        }
+    };
+}
+//# sourceMappingURL=llm.js.map

package/dist/adapters/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/adapters/llm.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,MAA+B;IAE/B,OAAO,KAAK,EAAE,IAAO,EAAc,EAAE;QACnC,OAAO,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAClC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3D,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACzB,MAAM,GAAG,CAAC,CAAC,gCAAgC;QAC7C,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { AgentEventType, RecorderEvent, SessionDescriptor, RedactConfig, RecorderConfig, } from "./types.js";
+export { EVENT_TYPES } from "./types.js";
+export { redact } from "./redact.js";
+export { createRecorder } from "./recorder.js";
+export type { Recorder, Session, SessionOptions } from "./recorder.js";
+export { instrumentTools, recorderMiddleware } from "./adapters/ai-sdk.js";
+export type { InstrumentableTool, GenerateMiddlewareArgs } from "./adapters/ai-sdk.js";
+export { opvivaLangChainHandler } from "./adapters/langchain.js";
+export type { LangChainCallbackHandler } from "./adapters/langchain.js";
+export { instrumentChat } from "./adapters/llm.js";
+export type { ChatCreateArgs } from "./adapters/llm.js";

package/dist/index.js

@@ -0,0 +1,7 @@
+export { EVENT_TYPES } from "./types.js";
+export { redact } from "./redact.js";
+export { createRecorder } from "./recorder.js";
+export { instrumentTools, recorderMiddleware } from "./adapters/ai-sdk.js";
+export { opvivaLangChainHandler } from "./adapters/langchain.js";
+export { instrumentChat } from "./adapters/llm.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/recorder.d.ts

@@ -0,0 +1,40 @@
+import type { RecorderConfig } from "./types.js";
+export interface SessionOptions {
+    readonly id?: string;
+    readonly actor?: string | null;
+    readonly externalSessionId?: string | null;
+}
+export interface Session {
+    readonly id: string;
+    logPrompt(p: Record<string, unknown>): void;
+    logDecision(d: {
+        model?: string;
+        output?: unknown;
+        toolSelected?: string;
+        toolArgs?: unknown;
+    }): void;
+    wrapTool<A extends unknown[], R>(name: string, fn: (...args: A) => R | Promise<R>): (...args: A) => Promise<R>;
+    logToolCall(name: string, fields?: Record<string, unknown>): void;
+    logToolResult(name: string, opts?: {
+        result?: unknown;
+        error?: unknown;
+    } & Record<string, unknown>): void;
+    logDataAccess(d: {
+        resource: string;
+        operation: string;
+        rowsAffected?: number;
+        destination?: string;
+    }): void;
+    outcome(o: {
+        status: string;
+        summary?: string;
+    }): void;
+    recordError(err: unknown): void;
+    close(): Promise<void>;
+}
+export interface Recorder {
+    session(opts?: SessionOptions): Session;
+    flush(): Promise<void>;
+    stop(): void;
+}
+export declare function createRecorder(config: RecorderConfig): Recorder;

package/dist/recorder.js

@@ -0,0 +1,112 @@
+import { redact } from "./redact.js";
+import { createTransport } from "./transport.js";
+const DEFAULT_ENDPOINT = "https://api.opviva.com";
+const DEFAULT_FLUSH_MS = 5_000;
+const DEFAULT_MAX_BATCH = 50;
+const DEFAULT_TIMEOUT_MS = 10_000;
+export function createRecorder(config) {
+    const endpoint = config.endpoint ?? DEFAULT_ENDPOINT;
+    const fetchImpl = config.fetch ?? globalThis.fetch;
+    const maxBatch = config.maxBatch ?? DEFAULT_MAX_BATCH;
+    const flushIntervalMs = config.flushIntervalMs ?? DEFAULT_FLUSH_MS;
+    const onError = config.onError ?? ((err) => {
+        try {
+            console.warn("[opviva-recorder]", err);
+        }
+        catch { /* noop */ }
+    });
+    const redactCfg = config.redact;
+    const transport = createTransport({
+        endpoint,
+        apiKey: config.apiKey,
+        timeoutMs: config.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+        fetchImpl,
+        onError,
+    });
+    const timer = setInterval(() => void transport.flush(), flushIntervalMs);
+    if (typeof timer.unref === "function") {
+        timer.unref();
+    }
+    const onExit = () => void transport.flush();
+    if (typeof process !== "undefined" && typeof process.on === "function") {
+        process.on("beforeExit", onExit);
+    }
+    function makeSession(opts = {}) {
+        const descriptor = {
+            id: opts.id ?? globalThis.crypto.randomUUID(),
+            app: config.app,
+            actor: opts.actor ?? null,
+            externalSessionId: opts.externalSessionId ?? null,
+        };
+        let seq = 0;
+        function record(type, payload, dataTouched = []) {
+            try {
+                seq += 1;
+                const event = {
+                    seq,
+                    type,
+                    payload: redactCfg ? redact(payload, redactCfg) : payload,
+                    dataTouched: redactCfg ? redact(dataTouched, redactCfg) : dataTouched,
+                    occurredAt: new Date().toISOString(),
+                };
+                // Probe serializability now so a bad payload fails here (caught) — never inside flush().
+                JSON.stringify(event);
+                transport.enqueue(descriptor, event);
+                if (transport.pending() >= maxBatch)
+                    void transport.flush();
+            }
+            catch (err) {
+                onError(err); // never throw into the host
+            }
+        }
+        return {
+            id: descriptor.id,
+            logPrompt: (p) => record("prompt", p),
+            logDecision: (d) => record("decision", d),
+            logDataAccess: (d) => record("data_access", d, [{ resource: d.resource, operation: d.operation }]),
+            outcome: (o) => record("outcome", o),
+            recordError: (err) => record("error", { message: err instanceof Error ? err.message : String(err) }),
+            wrapTool(name, fn) {
+                return async (...args) => {
+                    const start = Date.now();
+                    record("tool_call", { name, args });
+                    try {
+                        const result = await fn(...args);
+                        record("tool_result", { name, result, durationMs: Date.now() - start });
+                        return result;
+                    }
+                    catch (err) {
+                        record("tool_result", {
+                            name,
+                            error: err instanceof Error ? err.message : String(err),
+                            durationMs: Date.now() - start,
+                        });
+                        throw err; // re-throw: never swallow the host's tool error
+                    }
+                };
+            },
+            logToolCall: (name, fields = {}) => record("tool_call", { name, ...fields }),
+            logToolResult: (name, opts = {}) => {
+                const { result, error, ...rest } = opts;
+                const payload = { name, ...rest };
+                if (result !== undefined)
+                    payload.result = result;
+                if (error !== undefined)
+                    payload.error = error instanceof Error ? error.message : String(error);
+                record("tool_result", payload);
+            },
+            close: () => transport.closeSession(descriptor),
+        };
+    }
+    return {
+        session: makeSession,
+        flush: () => transport.flush(),
+        stop: () => {
+            clearInterval(timer);
+            if (typeof process !== "undefined" && typeof process.off === "function") {
+                process.off("beforeExit", onExit);
+            }
+        },
+    };
+}
+//# sourceMappingURL=recorder.js.map

package/dist/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"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"}

package/dist/redact.d.ts

@@ -0,0 +1,3 @@
+import type { RedactConfig } from "./types.js";
+/** Recursively redact a value: drop configured object keys and scrub strings. Pure; never mutates input. */
+export declare function redact(value: unknown, cfg: RedactConfig): unknown;

package/dist/redact.js

@@ -0,0 +1,25 @@
+/** Recursively redact a value: drop configured object keys and scrub strings. Pure; never mutates input. */
+export function redact(value, cfg) {
+    const dropKeys = new Set(cfg.dropKeys ?? []);
+    const scrubbers = cfg.scrubbers ?? [];
+    function walk(v) {
+        if (typeof v === "string") {
+            let s = v;
+            for (const re of scrubbers)
+                s = s.replace(re, "[redacted]");
+            return s;
+        }
+        if (Array.isArray(v))
+            return v.map(walk);
+        if (v && typeof v === "object") {
+            const out = {};
+            for (const [k, val] of Object.entries(v)) {
+                out[k] = dropKeys.has(k) ? "[redacted]" : walk(val);
+            }
+            return out;
+        }
+        return v;
+    }
+    return walk(value);
+}
+//# sourceMappingURL=redact.js.map

package/dist/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAEA,4GAA4G;AAC5G,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,GAAiB;IACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;IAEtC,SAAS,IAAI,CAAC,CAAU;QACtB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,KAAK,MAAM,EAAE,IAAI,SAAS;gBAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;YAC5D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,GAAG,GAA4B,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAA4B,CAAC,EAAE,CAAC;gBACpE,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtD,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,15 @@
+import type { RecorderEvent, SessionDescriptor } from "./types.js";
+export interface TransportConfig {
+    readonly endpoint: string;
+    readonly apiKey: string;
+    readonly timeoutMs: number;
+    readonly fetchImpl: typeof fetch;
+    readonly onError: (err: unknown) => void;
+}
+export interface Transport {
+    enqueue(session: SessionDescriptor, event: RecorderEvent): void;
+    flush(): Promise<void>;
+    closeSession(session: SessionDescriptor): Promise<void>;
+    pending(): number;
+}
+export declare function createTransport(cfg: TransportConfig): Transport;

package/dist/transport.js

@@ -0,0 +1,62 @@
+export function createTransport(cfg) {
+    const buffers = new Map();
+    function safeOnError(err) {
+        try {
+            cfg.onError(err);
+        }
+        catch { /* an onError that throws must not break flush */ }
+    }
+    function enqueue(session, event) {
+        const existing = buffers.get(session.id);
+        if (existing)
+            existing.events.push(event);
+        else
+            buffers.set(session.id, { session, events: [event] });
+    }
+    async function post(path, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), cfg.timeoutMs);
+        try {
+            const response = await cfg.fetchImpl(`${cfg.endpoint}${path}`, {
+                method: "POST",
+                headers: { "content-type": "application/json", "x-api-key": cfg.apiKey },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (!response.ok)
+                throw new Error(`opviva ingest failed: ${response.status}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async function flush() {
+        const batches = [...buffers.values()].filter((b) => b.events.length > 0);
+        buffers.clear();
+        for (const b of batches) {
+            try {
+                await post("/recorder/events", { session: b.session, events: b.events });
+            }
+            catch (err) {
+                safeOnError(err); // at-most-once: events already cleared, never re-thrown
+            }
+        }
+    }
+    async function closeSession(session) {
+        await flush();
+        try {
+            await post(`/recorder/sessions/${session.id}/close`, {});
+        }
+        catch (err) {
+            safeOnError(err);
+        }
+    }
+    function pending() {
+        let n = 0;
+        for (const b of buffers.values())
+            n += b.events.length;
+        return n;
+    }
+    return { enqueue, flush, closeSession, pending };
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+export type AgentEventType = "prompt" | "decision" | "tool_call" | "tool_result" | "data_access" | "outcome" | "error";
+export declare const EVENT_TYPES: readonly AgentEventType[];
+export interface RecorderEvent {
+    readonly seq: number;
+    readonly type: AgentEventType;
+    readonly payload: unknown;
+    readonly dataTouched: unknown;
+    readonly occurredAt: string;
+}
+export interface SessionDescriptor {
+    readonly id: string;
+    readonly app: string;
+    readonly actor?: string | null;
+    readonly externalSessionId?: string | null;
+}
+export interface RedactConfig {
+    readonly dropKeys?: readonly string[];
+    readonly scrubbers?: readonly RegExp[];
+}
+export interface RecorderConfig {
+    readonly apiKey: string;
+    readonly app: string;
+    readonly endpoint?: string;
+    readonly fetch?: typeof fetch;
+    readonly flushIntervalMs?: number;
+    readonly maxBatch?: number;
+    readonly timeoutMs?: number;
+    readonly redact?: RedactConfig;
+    readonly onError?: (err: unknown) => void;
+}

package/dist/types.js

@@ -0,0 +1,10 @@
+export const EVENT_TYPES = [
+    "prompt",
+    "decision",
+    "tool_call",
+    "tool_result",
+    "data_access",
+    "outcome",
+    "error",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,QAAQ;IACR,UAAU;IACV,WAAW;IACX,aAAa;IACb,aAAa;IACb,SAAS;IACT,OAAO;CACR,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@opviva/recorder",
+  "version": "0.1.0",
+  "license": "MIT",
+  "description": "Opviva Flight Recorder SDK — capture what your AI agents do, in a tamper-evident timeline.",
+  "keywords": ["opviva", "ai-agent", "observability", "forensics", "llm", "vercel-ai-sdk"],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Varun369A/vibe-ops.git",
+    "directory": "packages/recorder"
+  },
+  "homepage": "https://opviva.com/docs/recorder",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  }
+}