SPECTRA TRACE RUNTIME v2.4

BUFFER: 16MB ACTIVE

OVERHEAD <0.02ms

PROTOCOL JSON-RPC / MCP

Deterministic Observability for AI Tool Execution.

Inspect causal execution graphs, detect token runaway anomalies, and step backwards through tool decisions with zero instrumentation overhead.

$ npx spectra-trace COPY

TELEMETRY SCENARIO 4 SPANS

TIME-TRAVEL TIMELINE FRAME 4 / 4

SESSION LEDGER REAL-TIME

Total Latency 412ms

Prompt Tokens 1,750

Completion Tokens 1,090

Memory Allocated 1.42 MB

Causal Depth 4 Levels

WORKSPACE / /

CLICK NODE TO EXPAND PAYLOAD

SPAN / TOOL NAME LATENCY TIMELINE GANTT TOKEN BURN

EVENT INJECTOR:

[00:00.00] INIT Spectra in-memory ring buffer tracing session initialized (capacity: 65,536 spans)

INPUT PAYLOAD

{}

RESULT OUTPUT

{}

SYSTEM ARCHITECTURE

Engineering Specifications & Performance Benchmarks

Zero-Allocation Ring Buffer

Pre-allocates a fixed 16MB cyclic memory block. Never pauses the JavaScript event loop or creates V8 garbage collection spikes during high-throughput tool chaining.

< 0.02ms SPAN OVERHEAD

Lock-free atomics No heap churn

Causal DAG Edge Attribution

Tracks exact parent-child causality links across recursive subagent loops. Unpacks which specific reasoning step spawned secondary tool invocations.

100% DETERMINISTIC EDGES

JSON-RPC Span IDs Causal Ring Graph

Granular Token Burn Waterfall

Attributes token consumption down to the individual tool invocation. Detects runaway context growth before it hits LLM provider quota limits.

1-Token RESOLUTION PRECISION

Prompt vs Completion Context Delta Tracking

Protocol Agnostic Interoperability

Drop-in compatibility with Model Context Protocol (MCP) clients, Claude Desktop, Cursor IDE, LangChain, and standalone Node.js agent loops.

Stdio / SSE / WS TRANSPORTS

MCP 1.0 Compliant OpenTelemetry Bridge

DEPLOYMENT & INTEGRATION

Attach Telemetry to Any Tool Server in 5 Seconds.

Wrap existing stdio or SSE server instances without rewriting business logic.

CLI Quickstart

# Launch telemetry proxy directly
npx spectra-trace

# Wrap a running MCP server on port 4567
npx spectra-trace --port 4567 --wrap "npx @modelcontextprotocol/server-postgres"