Skip to content
reaatech

@reaatech/agent-chaos-adapters

pending npm

Framework adapters for injecting fault-tolerance testing into LangChain, LlamaIndex, Vercel AI SDK, or any custom agent with a tool-call interface, using a shared interceptor pattern that wraps tools without modifying agent code. Each adapter exports a framework-specific wrapper (e.g., a tool wrapper for LangChain, a tool spec wrapper for LlamaIndex) that pairs with the `@reaatech/agent-chaos-core` engine at runtime.

@reaatech/agent-chaos-adapters

License: MIT

Status: Planned — v0.2.0. Not yet published. APIs subject to change.

Framework adapters for integrating agent-chaos with popular agent frameworks through a transparent interceptor pattern — no changes to your agent code required.

Installation

terminal
npm install @reaatech/agent-chaos-adapters
# or
pnpm add @reaatech/agent-chaos-adapters

This package is under active development and not included in the v0.1.0 release.

Feature Overview

  • LangChain adapter — tool wrapper and callback handler integration
  • LlamaIndex adapter — tool spec wrapping and query engine integration
  • Vercel AI SDK adapter — tool registration wrapping and stream handling
  • Generic/REST adapter — any custom agent with a tool-call interface
  • Single interceptor pattern — all adapters share a common Adapter interface
  • Transparent injection — fault injection runs between your agent and its tools without modifying agent code

Planned Architecture

code
Agent Code
    │
    ▼
┌─────────────────────┐
│   Chaos Adapter     │  ← Framework-specific interceptor (LangChain, LlamaIndex, Vercel AI SDK, etc.)
│   • wraps tools     │
│   • intercepts calls│
└─────────┬───────────┘
          ▼
┌─────────────────────┐
│   Chaos Engine      │
│   • fault selection │
│   • injector chain  │
└─────────────────────┘

Planned Adapters

AdapterFrameworkMaturity
LangChainTool wrapper + callback handlerPlanned
LlamaIndexTool spec wrapping + query enginePlanned
Vercel AI SDKTool registration wrapping + stream handlingPlanned
Generic / RESTCustom agent with a tool-call interfacePlanned

License

MIT