@sisu-ai/mw-trace-viewer

v11.0.0

Published

7 days ago

Generate interactive HTML and JSON traces to inspect every model call, tool action, and error.

Downloads

401

0High
0Medium
0Low

lejahmie

sisu ai ai-agent agentic middleware trace-viewer

@sisu-ai/mw-trace-viewer

Generate interactive HTML and JSON traces to inspect every model call, tool action, and error.

Setup

npm i @sisu-ai/mw-trace-viewer

Usage

import { traceViewer } from '@sisu-ai/mw-trace-viewer';

const app = new Agent()
  .use(traceViewer({ style: 'dark' }))
  // ...rest of your pipeline

Options

enable?: boolean — force on/off (default: enabled when --trace or TRACE_JSON=1/TRACE_HTML=1 present)
path?: string — output target; .html writes HTML only, .json writes JSON + HTML sidecar (default: trace.json)
html?: boolean — write HTML (default true, or controlled by TRACE_HTML=1 env var)
json?: boolean — write JSON (default true, or controlled by TRACE_JSON=1 env var)
style?: 'light'|'dark' — built‑in themes (default light)
template?: (doc, style) => string — custom HTML renderer
dir?: string — directory for traces when no explicit path given (default: traces)

CLI / Env

--trace or --trace=run.json|run.html — enable tracing with optional output path
--trace-style=light|dark — set theme via CLI
TRACE_JSON=1 — enable tracing and control JSON output (only JSON if set alone)
TRACE_HTML=1 — enable tracing and control HTML output (only HTML if set alone)
TRACE_STYLE=dark — set theme via env var

Priority: Options passed to traceViewer() always take precedence over env vars. If neither are set, both HTML and JSON are written by default.

What’s captured

input, final message text
Full messages array
events from the tracing logger (wraps ctx.log under the hood)

Community & Support

Discover what you can do through examples or documentation. Check it out at https://github.com/finger-gun/sisu. Example projects live under examples/ in the repo.