Integrations
Framework adapters, managed runtime integrations, and shared primitives for capturing agent evidence and enabling replay-aware analysis.
Integrations map framework-specific model, tool, state, and hook surfaces onto the isplay evidence model. Choose the integration that sees the earliest safe boundary in your runtime.
Adapter kit
Shared primitives for custom frameworks and explicit capture.
AI SDK
Model middleware, stream capture, and tool execute wrappers.
Mastra
Explicit workflow snapshots, agent events, and tool lifecycle helpers.
LangGraph
Node wrappers, state checkpoints, model wrappers, streams, and tools.
Runtime primitives
Capability manifests, fixture decisions, run registry, and JSON helpers.
Managed runtimes
How to reason about Codex and Claude Code limitations.
Codex
Hook handling, JSONL ingestion, plugin files, and app-server helpers.
Claude Code
Hook handling, stream-json ingestion, and settings generation.
OpenClaw
Native plugin hooks with synthetic tool fixture support.
Integration Selection
| If your runtime... | Prefer |
|---|---|
| Is custom and you own the model/tool calls | @isplay/adapter-kit |
| Uses Vercel AI SDK | @isplay/adapter-ai-sdk |
| Uses Mastra agents or workflows | @isplay/adapter-mastra plus explicit SDK calls |
| Uses LangGraph nodes or streams | @isplay/adapter-langgraph |
| Runs inside Codex | @isplay/adapter-codex |
| Runs inside Claude Code | @isplay/adapter-claude-code |
| Runs inside OpenClaw plugin hooks | @isplay/adapter-openclaw |
Capability Matrix
| Integration | Context inventory | Model capture | Tool capture | Fixture replay | Checkpoints |
|---|---|---|---|---|---|
| Kit | explicit | explicit | explicit | app-owned | explicit |
| AI SDK | request-derived plus annotations | middleware | tool execute wrappers | app-owned | SDK checkpoints |
| Mastra | annotations and snapshots | manual | helper methods | app-owned | workflow snapshots |
| LangGraph | node state, messages, stream updates | model wrapper | stream/tool wrapper | app-owned | before/after nodes |
| Codex | hooks and JSONL | JSONL/proxy-dependent | hooks and JSONL | managed, often post-result | app/worktree-dependent |
| Claude Code | hooks and stream-json | observability-oriented | hooks | managed, post-tool context | app/worktree-dependent |
| OpenClaw | native hooks | native input/output hooks | native before/after tool hooks | native synthetic when supported | session/checkpoint hooks |
Shared Advice
- Pass
clientorprojectIdinto adapters explicitly. - Put capture inside a run context unless the adapter uses
RuntimeRunRegistry. - Capture tool schemas and side-effect classes, not just tool outputs.
- Drain streams so capture can finish model calls.
- Do not claim deterministic replay for an adapter that only observes events after execution.