Repository navigation
Releases: ronitgupta138/Agent-2PC
Releases · ronitgupta138/Agent-2PC
Release list
agent-2pc v2.0.0: Flagship 2.0 Release - Git Pre-Commit Hook Bridge & Daemon TTL Reaper
🚀 Welcome to agent-2pc v2.0.0 (Flagship Release)
agent-2pc v2.0.0 delivers enterprise-grade repository integrity, automated lifecycle management, and seamless Git sync.
- Git Pre-Commit Hook & Integrity Gate (
src/git.rs):agent-2pc hook install [--repo-dir <dir>]: Injects an automated repository integrity hook into.git/hooks/pre-commit.agent-2pc hook check: Validates that no uncommitted, half-baked 2PC transactions are pending in.agent-tx, preventing dirty agent edits from corrupting Git history.agent-2pc git-commit --tid <TID> -m <msg>: Atomically commits a 2PC transaction and creates a corresponding Git commit for touched files in a single unified step.
- Daemon Background TTL Reaper & Auto-Compaction (
src/daemon.rs):- In-memory background thread continuously sweeps active transactions exceeding their
timeout_msTTL. - Automatically compensates and aborts orphaned transactions, wiping scratch storage without manual developer intervention.
- Automatically triggers zero-downtime WAL compaction when
wal.binexceeds 2MB. - Added
agent-2pc daemon reapand telemetry counters (reaped_transactions,auto_compactions).
- In-memory background thread continuously sweeps active transactions exceeding their
- MCP Tool Surface (21 Tools):
- Added
agent_2pc_hook_checkandagent_2pc_git_commitwith full M8ven / OpenAI dual-location behavioral hints.
- Added
- Client SDKs Synchronized:
- Python (
sdk/python):session.git_commit(message). - TypeScript (
sdk/typescript):session.gitCommit(message).
- Python (
- Quality & Registry Standards:
- 53/53 passing tests across 13 test suites.
- Zero warnings under
cargo clippy --all-targets -- -D warningson Rust 2024 edition. - Published to Crates.io:
cargo install agent-2pc(v2.0.0).
agent-2pc v1.9.0: Unified Diff Preview Engine & Portable .a2pc Transaction Bundles
⚡ What's New in v1.9.0
- Transaction Unified Diff & Diffstat Engine (
src/diff.rs):- Added
agent-2pc diff --tid <TID> [--stat]and MCP toolagent_2pc_diff. - Generates git-style unified diffs and file change statistics across all staged mutations in Phase 1 before calling commit.
- Added
- Portable Swarm Transaction Bundles (
src/bundle.rs):- Added
agent-2pc export --tid <TID> [--output <file>]andagent-2pc import --file <bundle.a2pc>. - Serializes an active 2PC transaction into a portable
.a2pcbundle with full scratch filesystem payloads and CRC32 tamper verification. - Allows cross-agent handoffs, multi-agent code review, and swarm coordination.
- Added
- MCP Surface Expansion (19 Tools):
- Registered
agent_2pc_diff,agent_2pc_export, andagent_2pc_importwith full M8ven/OpenAI dual-location behavioral annotations.
- Registered
- Client SDKs Updated:
- Python SDK: added
session.diff(stat=...)andsession.export_bundle(output=...). - TypeScript SDK: added
session.diff(stat?: boolean)andsession.exportBundle(output?: string).
- Python SDK: added
- Registry & Verification:
- 49/49 passing tests across 12 test suites.
- Clippy clean on Rust 2024 edition.
- Live on Crates.io:
cargo install agent-2pc(v1.9.0).
agent-2pc v1.8.0: Auto-Detect UDS Daemon Acceleration & Targeted Substring Replace Staging
⚡ What's New in v1.8.0
- Auto-Detect UDS Daemon Acceleration (
ClientMode::Auto):- CLI subcommands (
begin,stage-write,commit,abort,status,savepoint,rollback-to,stage-replace) and MCP tools automatically probe.agent-tx/agent-2pc.sock. - When the background daemon is active, requests route through in-memory IPC in < 0.2ms with zero disk lock contention.
- Automatically falls back to direct-disk WAL coordinator when the daemon is offline.
- CLI subcommands (
- Targeted Substring Replace Staging (
agent-2pc stage-replace/agent_2pc_stage_diff):- Direct exact string find-and-replace (
ResourceIntent::FsReplace). - Asserts match count == 1 before voting
PREPARED, preventing ambiguous edits. - Pre-snapshots destination file to
.bakin scratch storage.
- Direct exact string find-and-replace (
- Benchmark Expansion & Throughput Verification:
- Added in-memory UDS daemon IPC throughput test suite (
tests/benchmark.rs). - Verified 104.5 tx/sec roundtrip throughput over socket streams.
- Added in-memory UDS daemon IPC throughput test suite (
- Client SDKs Updated:
- Python: added
session.stage_replace(path, old_string, new_string). - TypeScript: added
session.stageReplace(path, oldString, newString).
- Python: added
- Live on Crates.io:
cargo install agent-2pc(v1.8.0 live on registry).
agent-2pc v1.7.2: Dual-Location Tool Annotations for M8ven & OpenAI Compliance
⚡ What's New in v1.7.2
- Dual-Location MCP Tool Annotations (
src/mcp.rs):- Declared all four behavioral hints (
readOnlyHint,destructiveHint,idempotentHint,openWorldHint) inside the standard MCPannotations: { ... }sub-object as well as at the tool root level. - Fixes strict schema validation for MCP indexers (M8ven, OpenAI Directory, Anthropic MCP client).
- Declared all four behavioral hints (
- 100% Tool Coverage Verification:
- Automated integration test
tests/mcp_test.rsasserts that every declared tool exposes all 4 hints in both locations.
- Automated integration test
- Published to Crates.io & GitHub Releases:
- Live on Crates.io (
agent-2pc v1.7.2). - Pre-compiled binary artifacts built for Linux x86_64 and macOS Darwin.
- Live on Crates.io (
agent-2pc v1.7.1: M8ven Trust Index Optimizations & Full MCP Tool Annotations
⚡ What's New in v1.7.1
- Full M8ven / OpenAI Tool Annotations (
src/mcp.rs):- Declared all four behavioral hints (
readOnlyHint,destructiveHint,idempotentHint,openWorldHint) as explicit booleans across all 15 declared MCP tools. - Satisfies strict registry requirements for Claude, OpenAI, and M8ven Trust Index.
- Declared all four behavioral hints (
- 100% MCP Tool Test Reference Coverage (
tests/mcp_test.rs):- Every single declared MCP tool (
agent_2pc_begin,agent_2pc_record_read,agent_2pc_stage_write,agent_2pc_savepoint,agent_2pc_stage_patch,agent_2pc_stage_cmd,agent_2pc_stage_api,agent_2pc_rollback_to,agent_2pc_status,agent_2pc_daemon_status,agent_2pc_commit,agent_2pc_compact,agent_2pc_abort,agent_2pc_exec,agent_2pc_overlay_exec) is invoked and verified by name in integration testing.
- Every single declared MCP tool (
- Dynamic
serverInfoVersion Sync:- MCP initialization handshake dynamically returns active SemVer (
1.7.1).
- MCP initialization handshake dynamically returns active SemVer (
- Live on Crates.io:
- Published to Crates.io:
cargo install agent-2pc.
- Published to Crates.io:
agent-2pc v1.7.0: WASI Sandboxing & Full MCP Tool Surface Expansion
🚀 agent-2pc v1.7.0 Production Release
Database-grade Two-Phase Commit with cross-platform WASI memory caging and complete Model Context Protocol tool coverage for AI agent workflows.
🌟 What's New in v1.7.0
- WASI / WebAssembly Sandboxed Tool Adapter (
src/wasi.rs):- Cross-platform hardware-independent plugin execution with strict memory caps (
max_memory_mb) and execution timeouts. - Zero-dirty-state rollbacks on any operating system, container, or rootless sandbox.
- Cross-platform hardware-independent plugin execution with strict memory caps (
- Full Model Context Protocol (MCP) Tool Surface (
src/mcp.rs):agent_2pc_exec: Run build tools and auto-stage mutations directly via MCP.agent_2pc_overlay_exec: In-kernel OverlayFS sandboxing over stdio JSON-RPC.agent_2pc_daemon_status: Check active UDS daemon status and socket health.
- Published to Crates.io (
agent-2pc v1.7.0):- Live on the official Rust package registry:
cargo install agent-2pc.
- Live on the official Rust package registry:
🧪 Verification
- 43/43 Passing Tests across 11 test suites.
- Clean Clippy (
cargo clippy --all-targets -- -D warnings).
agent-2pc v1.6.0: Kernel OverlayFS Zero-Copy Staging & Live Web Hypervisor HUD
🚀 agent-2pc v1.6.0 Production Release
Zero-copy kernel sandboxing, sub-50µs rollbacks, and real-time visual hypervisor monitoring for autonomous AI agent tool execution.
🌟 What's New in v1.6.0
- Linux Kernel OverlayFS Driver (
src/overlay.rs):- Spawns arbitrary compiler, migration, or test commands inside unprivileged user + mount namespaces (
unshare -m -U). - Mutations are isolated directly into an ephemeral in-kernel upperdir, avoiding full workspace scans and disk thrashing.
- Sub-50µs abort cleanup: unmounts and discards upperdir instantly on failure.
- Spawns arbitrary compiler, migration, or test commands inside unprivileged user + mount namespaces (
- Embedded Real-Time Web Hypervisor HUD (
src/web_hud.rs):- Zero-dependency vanilla HTML5/CSS/JS dashboard served on
localhost:9222(agent-2pc web). - Live auto-refreshing polling endpoints (
/api/status) rendering in-flight transaction DAGs, active savepoints, and WAL disk consumption.
- Zero-dependency vanilla HTML5/CSS/JS dashboard served on
- Client SDKs Synchronized:
- Python and TypeScript SDKs updated with savepoints, rollback-to, and exec staging helpers.
📦 Installation
# Direct binary (Linux x86_64)
curl -fsSL https://github.com/ronitgupta138/agent-2pc/releases/download/v1.6.0/agent-2pc-v1.6.0-x86_64-unknown-linux-gnu.tar.gz | tar -xz
sudo mv agent-2pc /usr/local/bin/
# Direct binary (macOS Apple Silicon)
curl -fsSL https://github.com/ronitgupta138/agent-2pc/releases/download/v1.6.0/agent-2pc-v1.6.0-aarch64-apple-darwin.tar.gz | tar -xz
sudo mv agent-2pc /usr/local/bin/
# Cargo
cargo install agent-2pc🧪 Verification
- 41/41 Passing Tests across 10 test suites.
- Zero clippy warnings (
cargo clippy --all-targets -- -D warnings).
agent-2pc v1.5.0: Multi-Node Cluster Network Transport & Distributed 2PC TCP Protocol
🚀 agent-2pc v1.5.0 Production Release
Bring database ACID transactional finality to autonomous AI agents, tool orchestrators, and MCP execution pipelines with zero dirty state, sub-2ms transaction latency, and deterministic crash recovery.
🌟 What's New in v1.5.0
-
Multi-Node Cluster Network Transport (
src/transport.rs):- High-performance, zero-dependency TCP network transport for cross-container and multi-host distributed 2PC agent swarms.
-
ClusterNodeServer: Non-blocking multi-threaded TCP listener handling remote 2PC coordinator requests. -
ClusterTransportClient: Direct socket client dispatching wire packets with timeout containment.
-
Wire-Level 2PC Protocol Handshake:
- Implements full network serialization for
PrepareRequest,PrepareResponse,CommitRequest,CommitResponse,AbortRequest, andAbortResponse. - Integrates with
ClusterCoordinatorconsensus evaluation across heterogeneous physical nodes.
- Implements full network serialization for
-
Transparent Command Side-Effect Staging (
agent-2pc exec):- Run arbitrary compilers, linters, migration scripts, or test harnesses directly against the workspace (
ExecRunner::execute_and_stage). - Automatic directory-wide file fingerprinting (CRC32) before and after process execution.
- Automatically identifies all newly created and modified files, creates clean
.baksnapshots, and auto-stages mutations into Phase 1 2PC receipts with zero manual effort.
- Run arbitrary compilers, linters, migration scripts, or test harnesses directly against the workspace (
-
In-Memory UDS Daemon & IPC Connection Pooling (
agent-2pc daemon):- Persistent background service managing transaction state in memory over
.agent-tx/agent-2pc.sock. - Eliminates filesystem lock contention across concurrent multi-agent tool loops.
- Persistent background service managing transaction state in memory over
-
Nested Savepoints & Speculative Execution (
agent-2pc savepoint/rollback-to):- Branch into speculative refactors and selectively unwind failed steps back to named checkpoints without aborting verified preceding stages.
-
Zero-Downtime WAL Compaction & Checkpoint Engine (
agent-2pc compact):- Purges historical committed/aborted records into clean snapshot barriers (
0x4132534E), dropping cold-boot recovery from$O(N)$ to$O(1)$ .
- Purges historical committed/aborted records into clean snapshot barriers (
📦 Installation & Quickstart
Direct Binary Download (Linux x86_64)
curl -fsSL https://github.com/ronitgupta138/agent-2pc/releases/download/v1.5.0/agent-2pc-v1.5.0-x86_64-unknown-linux-gnu.tar.gz | tar -xz
sudo mv agent-2pc /usr/local/bin/Cargo Install
cargo install agent-2pcDrop-in MCP Setup (claude_desktop_config.json)
{
"mcpServers": {
"agent-2pc": {
"command": "agent-2pc",
"args": ["mcp"]
}
}
}🧪 Verification & Benchmarks
- 39/39 Tests Passing across 9 integration test suites.
- 114.4 tx/sec verified 2PC round throughput with physical disk fsync.
- p50 = 1.72ms hardware-accelerated CRC32 Write-Ahead Log durability.
- Zero clippy warnings on Rust 2024 edition (
cargo clippy --all-targets -- -D warnings).
agent-2pc v1.4.0: Transparent Command Execution Side-Effect Staging Runner
⚡ What's New in v1.4.0
- Transparent Command Side-Effect Staging (
src/exec.rs):- Run arbitrary compilers, linters, migration scripts, or test harnesses directly against the workspace (
ExecRunner::execute_and_stage). - Automatic directory-wide file fingerprinting (CRC32) before and after process execution.
- Automatically identifies all newly created and modified files, creates clean
.baksnapshots, and auto-stages mutations into Phase 1 2PC receipts with zero manual effort.
- Run arbitrary compilers, linters, migration scripts, or test harnesses directly against the workspace (
- Atomic Failure Neutralization:
- If a command fails (exit code != 0), all workspace modifications are immediately reverted to pre-execution state without dirty residue.
- Surfaces & CLI:
- CLI subcommand:
agent-2pc exec --tid <TID> [--dir <PATH>] -- <COMMAND...>.
- CLI subcommand:
- Verification:
- 37/37 passing tests including automated staging and failure rollback tests in
tests/exec_staging_test.rs.
- 37/37 passing tests including automated staging and failure rollback tests in
agent-2pc v1.3.0: Zero-Dependency UDS Daemon & IPC Connection Pooling
⚡ What's New in v1.3.0
- In-Memory Transaction Daemon (
src/daemon.rs):- High-performance, zero-disk-contention background daemon serving
Coordinatorrequests over local Unix Domain Sockets (.agent-tx/agent-2pc.sock). - Implemented with pure standard library (
std::os::unix::net::UnixListener) — zero external async runtime bloat.
- High-performance, zero-disk-contention background daemon serving
- IPC Protocol & Client (
src/ipc.rs):- Bidirectional line-delimited JSON-RPC framing supporting
ping,begin,stage_write,stage_patch,stage_cmd,stage_api,savepoint,rollback_to,commit,abort,status,record_read, andcompact. - Concrete adapter reconstruction (
reconstruct_adaptersinsrc/adapters.rs) allowing stateless IPC client invocations to commit/rollback across heterogeneous resources.
- Bidirectional line-delimited JSON-RPC framing supporting
- Surfaces & CLI:
- CLI subcommand:
agent-2pc daemon start [--foreground],agent-2pc daemon stop,agent-2pc daemon status.
- CLI subcommand:
- Verification:
- 35/35 passing tests including concurrent multi-client stress tests in
tests/daemon_ipc_test.rs.
- 35/35 passing tests including concurrent multi-client stress tests in