File size: 2,433 Bytes
91a1b02 5dacd43 91a1b02 5dacd43 91a1b02 d9c4263 91a1b02 d9c4263 5dacd43 d9c4263 5dacd43 d9c4263 5dacd43 d9c4263 5dacd43 d9c4263 e82bdbb d9c4263 5dacd43 d9c4263 5dacd43 d9c4263 5dacd43 d9c4263 5dacd43 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 |
---
title: TimelineDiff Differential Reproducibility
emoji: 🐠
colorFrom: indigo
colorTo: pink
sdk: gradio
sdk_version: 6.2.0
app_file: app.py
pinned: false
license: other
short_description: Diff agent timelines. Find first divergence. Export forensic
thumbnail: >-
https://cdn-uploads.huggingface.co/production/uploads/685edcb04796127b024b4805/cc2glLOtiZJWxbbDoELfT.jpeg
---
TimelineDiff — Differential Reproducibility Protocol (DRP)
Production agents diverge: sampling variance, flaky tools, drifting data, timing/race effects.
Benchmarks tell you *whether* you failed. Logs tell you *what happened once*.
TimelineDiff tells you **why two runs diverged**.
## What this Space does
- Upload **two DRP trace bundles (.zip)**
- Computes:
- **Timeline alignment** (same / diff / missing)
- **First divergence index**
- Divergence class (sampling / tool / memory / control-flow / governance / state)
- Per-event structured diffs (JSON)
- Exports:
- `report.md` (human-readable)
- `report.pdf` (stakeholder-ready)
- `diff.json` (machine-readable)
- `drp-diff-report.zip` (all of the above)
## DRP bundle format (v0)
A bundle is a `.zip` containing:
- `manifest.json`
- `events.jsonl`
Each event is hash-chained:
- `prev` is the previous event hash
- `hash` is SHA-256 of canonical event JSON
This makes the timeline tamper-evident.
## Optional ReplayProof deep-linking
If you include either of the following in `manifest.json`, TimelineDiff will generate per-event links:
### Option A (recommended)
```json
"replay": {
"base_url": "https://your-space-or-site",
"pattern": "/?run_id={run_id}&i={i}"
}
### Option B
"run_url": "https://your-viewer/run/demo-123"
Links will appear in the report and in the diff JSON.
Suggested event kinds
• llm_sample
• tool_call
• tool_result
• memory_write
• plan_step
• guardrail
• state_snapshot
Optional reward delta
If your state_snapshot.payload includes:
• reward_total, or
• metrics.reward_total
…TimelineDiff will compute final_reward_delta.
---
## `drp/__init__.py`
```python
__all__ = [
"canon",
"sha256_hex",
"now_utc_iso",
"load_bundle",
"verify_bundle",
"write_bundle_zip",
"diff_bundles",
"render_report_markdown",
"write_pdf_report",
"make_demo_bundle_zip",
"fork_patch_bundle",
]
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference |