Skip to main content

tracesweep

Reads your agent traces. Tells you what's broken. Doesn't touch your code.

An open-source alternative to LangSmith Engine: point it at a corpus of production agent traces, and it screens them, groups failures into named issues, and puts them on a board for a human to rule on.

A sweep is the unit of work — one pass over the corpus. Sweeps are scheduled, compared to each other, and cost a printed number of dollars.

pip install tracesweep          # not yet published

tracesweep ingest ./traces
tracesweep run --budget 5.00    # one sweep
tracesweep issues

Status: pre-alpha. Nothing is built yet. This repo currently holds the name, the design, and the decisions behind it. The blueprint is complete and adversarially reviewed; the code is not written.

Why

LangSmith Engine bills against LangChain-managed inference, and BYOK is explicitly not supported — roughly $750/month at the default org cap. You are paying a vendor's LLM to read your LLM's output, continuously, at exactly the trace volume where it is most useful.

That pricing is structural, and it is the opening. Aggressive representation tiering plus a cheap model at the wide end gets the same job done for single-digit dollars a month on your own keys.

Design in one page

Screening Gemini 2.5 Flash-Lite over a bounded ~1,200-token excerpt view, not the full trace. ~95% of spend, ~$3.40 per 50k-trace pass
Investigation Claude Agent SDK — subagents, hooks, per-subagent model override. ~4% of spend
Grounding Every finding must quote an exact substring from a cited turn, checked by a Python in comparison. A model that fabricates a quote is discarded by code, not by another model's opinion
Free detectors drain3 error templating and a SQL rule bank run before any model does, at $0
Fixes None. It finds and reports. It does not open PRs

No auto-PR is a security decision, not a scoping shortcut. The system ingests production traces — attacker-controllable end-user text and tool output — into an agent that reads a private repo. Untrusted input, private data, and external write capability in one loop is the dominant threat for this product class. Human review breaks the loop.

What's actually unknown

Nobody publishes precision or false-positive rates for trace issue detection — not LangSmith Engine, not any competitor. That is the one piece of genuine white space, and it is the point of building this in the open.

The base-rate arithmetic is unforgiving: at an implied yield of ~1 issue per 3,000 traces, even 99.9% per-trace specificity produces roughly three false issues for every true one. That is structural, not a tuning problem, and it is what the design is organised around.

Roadmap

  • Phase 1 — ingest, compaction, free detectors, screener, a measured recall number on the TRAIL benchmark's 841 annotations, with a cost receipt
  • Screener bake-off: Flash-Lite vs Haiku vs GPT-5-nano over TRAIL, recall plotted against cost
  • Phase 2 — investigator, verifier, issue board, scheduled sweeps
  • Publish precision with a confidence interval — the number nobody else has

License

TBD — see #license.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tracesweep-0.0.1.tar.gz (3.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tracesweep-0.0.1-py3-none-any.whl (3.2 kB view details)

Uploaded Python 3

File details

Details for the file tracesweep-0.0.1.tar.gz.

File metadata

  • Download URL: tracesweep-0.0.1.tar.gz
  • Upload date:
  • Size: 3.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.11

File hashes

Hashes for tracesweep-0.0.1.tar.gz
Algorithm Hash digest
SHA256 6bb3021a688bb1b2a012cbb11aa6992d69d55dac166a4ec621ddb3d56fb2b1ce
MD5 e28f88ec178160b164dd7aa6df10630f
BLAKE2b-256 72f6d822f1dce122da3d64b96711f99eeb0c298d8ef59bf9887e77ea7e8a2579

See more details on using hashes here.

File details

Details for the file tracesweep-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: tracesweep-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 3.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.11

File hashes

Hashes for tracesweep-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a9f06c1c4e541a36786def6526487f9cce26df535a3bca8a69537ff87eeb8334
MD5 281f513719b0ce663dab227b1242744f
BLAKE2b-256 44eb580c92f6d604d7d5ac06e2cb8dfc88b0fe78ac19e5fa9fabc72deb238c98

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.0.1 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page