genesis-deterministic-replay-mini
Offline tool-call trajectory recorder and replay drift verifier
| Size | Folder | Inside |
|---|---|---|
| 4.8 kB | genesis_replay_mini/ | 3 scripts |
| 2.1 kB | tests/ | 2 test files |
| 213 B | bin/ | 1 script |
| 4.7 kB | (root) | 5 docs · 1 asset |
| Size | Path |
|---|---|
| 103 B | .gitignore |
| 535 B | CHANGELOG.md |
| 1.1 kB | LICENSE |
| 366 B | QUICKSTART.md |
| 1.7 kB | README.md |
| 282 B | SECURITY.md |
| 6 B | VERSION · binary |
| 213 B | bin/genesis-replay-mini · binary |
| 160 B | genesis_replay_mini/__init__.py |
| 2.2 kB | genesis_replay_mini/__main__.py |
| 2.4 kB | genesis_replay_mini/replay.py |
| 642 B | pyproject.toml |
| 449 B | tests/fixtures/sample_trajectory.json |
| 1.7 kB | tests/test_replay.py |
Already bought this?
View your purchasesREADME
genesis-deterministic-replay-mini
Lightweight offline tool-call recording and deterministic replay engine for AI agents.
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
DriftErrorif 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
- v1.0.02026-09-17
Production-ready release. Compact deterministic replay engine for reproducing and debugging agent session behavior.