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, OSV (opens in a new tab) and Socket (opens in a new tab) — passed on all three. Findings from all three are listed below.

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
1 direct package declares shell access, filesystem access, environment variables and more · 1 more in transitive packages · 9 packages flagged for review
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 (28)
  • MODERATEpyproject.toml — [build-system] runs when this is installed
  • MODERATEsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — ships compiled native code
  • MODERATEsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — ships compiled native code
  • MODERATEsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — runs shell commands
  • MODERATEsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — runs shell commands
  • MODERATEsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — evaluates code at runtime
  • MODERATEsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — evaluates code at runtime
  • LOWsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — reads environment variables
  • LOWsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — reads environment variables
  • LOWsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — reads or writes files
  • LOWsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — reads or writes files
  • flagged for reviewsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — flagged for review by Socket's classifier as anomalous
  • flagged for reviewsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — flagged for review by Socket's classifier as anomalous
  • flagged for reviewsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — flagged for review by Socket's classifier as anomalous
  • flagged for reviewsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — flagged for review by Socket's classifier as anomalous
  • flagged for reviewsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — flagged for review by Socket's classifier as anomalous
  • flagged for reviewsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — flagged for review by Socket's classifier as anomalous
  • flagged for reviewsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — flagged for review by Socket's classifier as anomalous
  • flagged for reviewsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — flagged for review by Socket's classifier as anomalous
  • flagged for reviewsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — flagged for review by Socket's classifier as anomalous
  • LOWtests/test_replay.py — Talks to api.com
  • LOWtests/test_replay.py — Talks to drifted.com
  • LOWSocket SBOM Resolver — Socket SBOM Resolver (transitive) — no lockfile, so installs are not reproducible
  • LOWbin/genesis-replay-mini — Ships the script bin/genesis-replay-mini
  • LOWgenesis_replay_mini/__main__.py — Ships the script genesis_replay_mini/__main__.py
  • LOWsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — contains hard-coded URLs
  • LOWsetuptools 84.2.1 (dev only) — setuptools 84.2.1 (direct, dev only) — contains hard-coded URLs
  • noticeNo dependency manifest the scanner reads (package.json, package-lock.json, requirements.txt, go.mod, Cargo.toml) is in this release; nothing it ships was checked against OSV.

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