honcho/docs/v3
Eugene Eisenstein 7b3d331846 feat(dialectic): return the evidence a chat answer was built from
Add an opt-in `include_evidence` to both chat endpoints. The response then
carries the conclusions and messages the agent read while answering, plus the
tools it called.

Evidence is collated from what the agent accessed rather than reported by the
model. That over-reports -- a conclusion appears because the agent saw it, not
as proof the answer used it -- but it is deterministic, costs no model tokens,
and behaves the same at every reasoning level. Asking the model to cite its
sources fails quietly instead: weaker models produce incomplete or invented
citations, and a sparse citation list is indistinguishable from a sparse
answer. The prefetch already makes the point, feeding explicit conclusions
into the prompt without their IDs, so the model could not cite them if asked.

An accumulator is threaded from the router through the agent into ToolContext,
and read handlers hand it the rows they already loaded. Nothing is re-queried
when the response is built, so evidence inherits the scoping of the reads that
produced it and cannot become a way around a session allowlist.

Three details worth knowing:

- Prefetched conclusions never pass through the tool executor, so they are
  captured via a new `documents_out` sink on `search_memory`. On a query that
  answers without a tool call they are the whole of what was read.
- Conclusions dedupe by ID. `Representation`'s own deduplication keys on
  content and timestamp and ignores IDs, which would collapse distinct
  conclusions that happen to read alike.
- Conclusion timestamps are re-stamped UTC. `Representation` strips tzinfo so
  observations render compactly into prompts, which would otherwise put naive
  timestamps in the API beside timezone-aware message ones.

The two chat routes had byte-identical nested SSE formatters; they now share
one helper, so the terminal event carries evidence on both.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-03 13:19:10 -04:00
..
api-reference chore(docs): Add explanation on deleting data and cloud vs local differences (#1114) 2026-09-01 23:03:44 -04:00
contributing feat(docker): make API worker count configurable (#1088) 2026-09-02 17:05:02 -04:00
documentation feat(dialectic): return the evidence a chat answer was built from 2026-09-03 13:19:10 -04:00
guides chore(docs): Add section about harness integrations and deepseek harn… (#1116) 2026-09-02 11:19:42 -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: add changelog and version updates (#1117) 2026-09-02 12:37:17 -04:00

README.md

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