@hackage / shikumi-trace

Hierarchical tracing, observability, and deterministic replay for shikumi (EP-7)

Latest0.1.0.0

About

Metadata

  • Last updated , by shinzui
  • License BSD-3-Clause
  • Maintained by: nadeem@gmail.com

  • Lottery factor: 1

Links

Installation

Readme

Hierarchical (nested) tracing and deterministic offline replay for shikumi. Running a program inside the Trace effect produces a tree of spans (program module combinator / LM-call), captured by interposing on EP-1's LLM effect — so each provider call becomes a leaf span carrying model, latency, tokens, cost, and the EP-6 content-addressed cache key. The tree pretty-prints to the terminal and serializes to a stable JSON trace file; runLLMReplay then re-runs the same program with the network disabled, serving every call from the recording (and raising a precise ReplayDivergence for any unrecorded call).