tool-journal: SQLite-based execution journal makes agent tool-call crashes deterministically recoverable
JeremyCMorgan · x · 2026-09-25
tool-journal is a new open-source TypeScript library (SQLite-backed, zero runtime deps, requires Node.js 24.15+) targeting the hardest failure mode in agent tooling: a tool completes its external action but the process dies before the response arrives, so checkpoints can't tell whether the action happened.
Its approach:
- Writes intent to a SQLite journal before execution
- Coordinates leases with fencing to prevent duplicate execution on concurrent retries
- Returns an explicit indeterminate result when the outcome is unknowable
- Automatic recovery requires a downstream idempotency contract and a bounded retry admission window
The repo ships reproducible crash tests — the demo literally kills a real child process mid-flight to demonstrate the failure. It already has 311 stars, includes a LangGraph integration and benchmarks.
More from coding & agent
- My AI agent only became useful after I defined where it had to stop — Inner-Town-5609 · 2026-09-25
- Theo: $200 Claude Code plan now clearly beats Codex, weeks after trailing it — ssh4net · 2026-09-25
- Containers Aren't a Real Security Boundary: Kata Containers and Firecracker Urged for Sandboxes — andreamichi · 2026-09-25
- Reddit asks: what's the real advantage of routing smaller model jev into LLM prompts — sogo00 · 2026-09-25
- Dev ditches Amp over subscription limits, tries Claude Desktop cloud sessions — iannuttall · 2026-09-25
- One prompt, 62 seconds, under 5 cents: Xiaomi MiMo V2.6 Pro builds a full habit tracker in Claude Code — socialwithaayan · 2026-09-25