honcho/docs/v3
Vineeth Voruganti 07c79e20e3 fix(db): lazy retrying session + review fixes for connection backoff
Address Codex/CodeRabbit review on PR #758.

- Replace eager checkout with HonchoAsyncSession: a lazy AsyncSession that
  checks out its connection (with retry) on the first DB-touching call, not at
  construction. Request handlers doing non-DB work (embedding/file/LLM) before
  their first query no longer pin a connection across it, while the API path
  still gets checkout retry. Only the checkout is retried — the statement runs
  once via super(), so writes are never duplicated. Tracing's set_config moves
  into the same lazy acquire hook.
- Roll the session back on a retryable checkout failure before retrying, so a
  failed autobegin can't leave it pending-rollback.
- Lower default POOL_TIMEOUT to 5s and validate it stays under the retry budget
  for pooled (non-null) POOL_CLASS; update config.toml.example and v2/v3 docs.
- Clamp pool overflow gauge to >= 0 (was negative before the pool fills).
- Remove double-sleep in the deriver idle poll (true backoff cap, not 2x);
  make in-flight instrumentation registration idempotent.
- Tests: HonchoAsyncSession lazy/idempotent acquire, statement-runs-once,
  tracing, commit/rollback flag reset, get_db no-acquire-at-entry, polling-loop
  single-sleep, and the POOL_TIMEOUT/retry-budget validator.
2026-06-01 01:12:35 -04:00
..
api-reference v3.0.0 Release Candidate (#346) 2026-01-26 15:06:02 -05:00
contributing fix(db): lazy retrying session + review fixes for connection backoff 2026-06-01 01:12:35 -04:00
documentation Updating Design Patterns (#717) 2026-05-27 15:25:55 -04:00
guides Updating Design Patterns (#717) 2026-05-27 15:25:55 -04:00
migrations sdks: add set peer card function (#371) 2026-02-09 15:35:57 -05:00
README.md feat: honcho 3.0, sdks 2.0, excise stainless, update v3 docs, changelogs (#331) 2026-01-22 15:16:28 -05:00
openapi.json chore(docs): Update changelogs and increment version (#713) 2026-05-21 14:32:41 -04:00

README.md

This subdirectory contains the peer-paradigm documentation for Honcho (Honcho v2.0.0 onwards).