agenttrace-react
Advanced tools
+24
-2
| { | ||
| "name": "agenttrace-react", | ||
| "version": "0.1.0", | ||
| "description": "Headless React primitives for visualising AI agent execution traces.", | ||
| "version": "0.1.1", | ||
| "description": "Headless React primitives for AI agent execution traces, human-in-the-loop approval gates, and agent status UI. Works with LangGraph, AG-UI, and the Vercel AI SDK.", | ||
| "license": "MIT", | ||
@@ -10,2 +10,24 @@ "repository": { | ||
| }, | ||
| "keywords": [ | ||
| "react", | ||
| "typescript", | ||
| "ai-agents", | ||
| "agent-ui", | ||
| "human-in-the-loop", | ||
| "langgraph", | ||
| "ag-ui", | ||
| "headless", | ||
| "trace", | ||
| "llm", | ||
| "langchain", | ||
| "vercel-ai-sdk", | ||
| "mcp", | ||
| "approval-gate", | ||
| "workflow", | ||
| "ai", | ||
| "headless-ui", | ||
| "agent-trace", | ||
| "execution-trace", | ||
| "hitl" | ||
| ], | ||
| "main": "./dist/index.js", | ||
@@ -12,0 +34,0 @@ "module": "./dist/index.mjs", |
+33
-12
| # agenttrace-react | ||
| Headless React primitives for visualising AI agent execution traces. | ||
| Headless React primitives for building AI agent UIs — execution trace visualisation, human-in-the-loop approval gates, and agent status dashboards. Works with LangGraph, AG-UI protocol, and the Vercel AI SDK. Zero styling, full control. | ||
| [](https://www.npmjs.com/package/agenttrace-react) | ||
| [](https://www.npmjs.com/package/agenttrace-react) | ||
| [](./LICENSE) | ||
| ## Install | ||
@@ -13,11 +17,28 @@ | ||
| ## Use cases | ||
| - Visualising multi-step agent runs in real time | ||
| - Building human-in-the-loop (HITL) approval workflows | ||
| - Rendering tool call outputs in a structured UI | ||
| - Monitoring agent status and execution time | ||
| - Adding oversight UI to LangGraph or AG-UI agents | ||
| ## Works with | ||
| | Framework | Adapter | | ||
| |-----------|---------| | ||
| | LangGraph | `agenttrace-langgraph` | | ||
| | AG-UI protocol | `agenttrace-ag-ui` | | ||
| | Vercel AI SDK | coming soon | | ||
| | Any agent framework | bring your own events via `applyEvent()` | | ||
| ## What you get | ||
| - `TraceProvider` | ||
| - `TraceTree` | ||
| - `TraceNode` | ||
| - `ApprovalGate` | ||
| - `RunStatus` | ||
| - `useTrace()` | ||
| - `applyEvent()` and core trace types | ||
| - `TraceProvider` — context provider, owns trace state | ||
| - `TraceTree` — recursively renders the agent node tree | ||
| - `TraceNode` — renders a single node via render props | ||
| - `ApprovalGate` — renders only when a node needs human approval | ||
| - `RunStatus` — exposes run status and elapsed time | ||
| - `useTrace()` — hook for direct trace state access | ||
| - `applyEvent()` and full TypeScript types | ||
@@ -75,8 +96,8 @@ ## Quick start | ||
| `agenttrace-react` is intentionally unstyled. It manages trace state and rendering structure, while your app keeps full control over markup, layout, and design system integration. | ||
| `agenttrace-react` is intentionally unstyled. It manages trace state and rendering logic, while your app keeps full control over markup, layout, and design system integration. Bring Tailwind, shadcn/ui, or your own components — no overrides needed. | ||
| ## Companion packages | ||
| - `agenttrace-langgraph` | ||
| - `agenttrace-ag-ui` | ||
| - [`agenttrace-langgraph`](https://www.npmjs.com/package/agenttrace-langgraph) — adapter for LangGraph JS stream events | ||
| - [`agenttrace-ag-ui`](https://www.npmjs.com/package/agenttrace-ag-ui) — adapter for AG-UI protocol SSE events | ||
@@ -89,2 +110,2 @@ ## Repository | ||
| MIT | ||
| MIT |
Major refactor
Supply chain riskPackage has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.
Found 1 instance in 1 package
39293
5.19%108
22.73%0
-100%