Skip to content
reaatechREAATECH

@reaatech/agent-chaos-adapters

pending npm

Injects fault-testing logic into agent frameworks like LangChain, LlamaIndex, and Vercel AI SDK by wrapping tool calls through a transparent interceptor pattern. It requires `@reaatech/agent-chaos-core` to execute the underlying fault injection engine.

@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