@reaatech/agent-replay

Status: Pre-1.0 — APIs may change in minor versions. Pin to a specific version in production.

One package, everything you need. The convenience entry point for the Agent Replay ecosystem — re-exports the complete public API of the core engine, LLM interceptors, and shared types from a single import.

Installation

npm install @reaatech/agent-replay
# or
pnpm add @reaatech/agent-replay

Feature Overview

• Single dependency — install one package and get the full Agent Replay API
• Re-exports from three packages — @reaatech/agent-replay-core, @reaatech/agent-replay-interceptors, and @reaatech/agent-replay-shared
• Full type safety — all types, interfaces, and error classes included
• Tree-shakeable — only the exports you import end up in your bundle

Quick Start

import {
  RecordingEngine,
  ReplayEngine,
  LocalFileStorage,
  OpenAIInterceptor,
  type Trace,
  type RecordingConfig,
} from "@reaatech/agent-replay";

// Recording
const engine = new RecordingEngine();
const session = engine.startRecording({ name: "hello-world" });

// Intercept OpenAI calls
const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
const interceptor = new OpenAIInterceptor(engine);
await interceptor.install(openai);

// ... run your agent ...

// Stop and save
const trace = engine.stopRecording(session);
await new LocalFileStorage("./traces").save(trace);

// Replay (zero tokens)
const replay = new ReplayEngine();
const result = replay.replay(trace, { mode: "stubbed" });
console.log(result.outputs);

What's Included

This package re-exports the complete public API of:

| Package | Contents | |---------|----------| | @reaatech/agent-replay-core | RecordingEngine, ReplayEngine, PartialReplayOrchestrator, ReplayDebugger, DiffEngine, SemanticDiffEngine, RegressionDetector, DivergenceDetector, AnomalyDetector, LocalFileStorage, TraceSerializer, TraceComparer, TraceSummarizer, AnnotationManager, StreamingRecorder, StreamingStubEngine, StructuredCloneStrategy, SnapshotterRegistry, FrameworkAdapterRegistry, DeterminismController, TraceBuilder, migrateTrace, validateTraceVersion, runCICDCheck, and all formatters | | @reaatech/agent-replay-interceptors | OpenAIInterceptor, AnthropicInterceptor, BaseInterceptor, InterceptorRegistry, OpenAIAdapter, AnthropicAdapter, LLMProviderAdapter | | @reaatech/agent-replay-shared | Trace, Span, Event, Checkpoint, SerializedState, LLMRequest, LLMResponse, StreamChunk, RecordedStream, RecordingConfig, ReplayConfig, AgentReplayError, RecordingFailedError, ReplayFailedError, TraceNotFoundError, StateCaptureError, DivergenceError, InterceptorError, and all types and interfaces |

See each sub-package's README for detailed API documentation:

• @reaatech/agent-replay-core
• @reaatech/agent-replay-interceptors
• @reaatech/agent-replay-shared

Granular Imports

If you prefer smaller installs, you can install only the packages you need:

npm install @reaatech/agent-replay-core        # Engine only
npm install @reaatech/agent-replay-interceptors # Provider interceptors
npm install @reaatech/agent-replay-shared       # Types only
npm install @reaatech/agent-replay-cli          # CLI tool (install globally)
npm install @reaatech/agent-replay-integrations # Framework integrations

Related Packages

• @reaatech/agent-replay-core — Recording and replay engine
• @reaatech/agent-replay-interceptors — LLM provider interceptors
• @reaatech/agent-replay-shared — Types, errors, and configuration
• @reaatech/agent-replay-cli — Command-line interface
• @reaatech/agent-replay-integrations — Framework integrations

License

MIT