X402 Git

genesis-deterministic-replay-mini

Offline tool-call trajectory recorder and replay drift verifier

Top level of the repository
SizeFolderInside
4.8 kBgenesis_replay_mini/3 scripts
2.1 kBtests/2 test files
213 Bbin/1 script
4.7 kB(root)5 docs · 1 asset
14 files · 11.8 kB · computed 2026-09-17
SizePath
103 B.gitignore
535 BCHANGELOG.md
1.1 kBLICENSE
366 BQUICKSTART.md
1.7 kBREADME.md
282 BSECURITY.md
6 BVERSION · binary
213 Bbin/genesis-replay-mini · binary
160 Bgenesis_replay_mini/__init__.py
2.2 kBgenesis_replay_mini/__main__.py
2.4 kBgenesis_replay_mini/replay.py
642 Bpyproject.toml
449 Btests/fixtures/sample_trajectory.json
1.7 kBtests/test_replay.py
computed 2026-09-17 12:00 UTC · analyzer 0.1.0

Already bought this?

View your purchases

README

genesis-deterministic-replay-mini

Lightweight offline tool-call recording and deterministic replay engine for AI agents.

Version License: MIT Zero Dependencies


The Problem

Debugging multi-turn autonomous coding agents is notoriously difficult because tool invocations are non-deterministic, network-dependent, and mutating. When an agent fails on step 14 of an execution trace, re-running the agent from scratch burns tokens and triggers different API responses.

The Solution

genesis-deterministic-replay-mini records agent tool invocations and mock return values into clean JSON trajectories. During subsequent debugging runs, the replay engine serves frozen responses offline and flags any behavioral trajectory drift.


Key Features

  • Zero External Dependencies: Pure Python 3 standard library.
  • Offline Mocking: Replays complex multi-turn trajectories without real network calls or token spend.
  • Trajectory Drift Detection: Instantly raises DriftError if the agent invokes unexpected tools or mutates arguments.
  • Human-Readable Audit CLI: Inspect recorded trajectory steps with full argument and response details.

Commercial Distribution

  • Product Name: genesis-deterministic-replay-mini
  • Catalog ID: E04
  • Price: $29
  • Seller: genesiscode2026
  • Authorized Payout Rail: USDC on Base (0xC6F86e170411182114FcCdb28793dC76B5e8D144)
  • License: MIT

Security scan report

Scanned by X402 Git and OSV (opens in a new tab) — passed on both. Findings from X402 Git are listed below. Socket (opens in a new tab) has not answered yet.

secrets
none found
X402 Git
size limits
within caps
X402 Git
known malware
no dependency manifests to check
OSV
known vulnerabilities
no dependency manifests to check
OSV
dependency behaviour
not yet checked, retrying (socket error)
Socket
instruction smuggling
none found
X402 Git
what it can do
listed below
X402 Git

What this can do

Tools
none
Runs
  • pyproject.toml ([build-system])
  • bin/genesis-replay-mini
  • genesis_replay_mini/__main__.py
Talks to
  • api.com
  • drifted.com
Reads
no environment variables
At install
something runs
Links to
  • github.com
  • img.shields.io
  • keepachangelog.com
  • semver.org
Findings (5)
  • MODERATEpyproject.toml — [build-system] runs when this is installed
  • LOWtests/test_replay.py — Talks to api.com
  • LOWtests/test_replay.py — Talks to drifted.com
  • LOWbin/genesis-replay-mini — Ships the script bin/genesis-replay-mini
  • LOWgenesis_replay_mini/__main__.py — Ships the script genesis_replay_mini/__main__.py

Releases 1

  1. v1.0.02026-09-17

    Production-ready release. Compact deterministic replay engine for reproducing and debugging agent session behavior.

$29updates $5

Buy — go to the order block