Welcome to the Honcho changelog! This section documents all notable changes to the Honcho API and SDKs.

​
Honcho API and SDK Changelogs

​
v2.3.0 (Current)

​
Added

  • getSummaries endpoint to get all available summaries for a session directly
  • Peer Card feature to improve context for deriver and dialectic

​
Changed

  • Session Peer limit to be based on observers instead, renamed config value to SESSION_OBSERVERS_LIMIT
  • Messages can take a custom timestamp for the created_at field, defaulting to the current time
  • get_context endpoint returns detailed Summary object rather than just summary content
  • Working representations use a FIFO queue structure to maintain facts rather than a full rewrite
  • Optimized deriver enqueue by prefetching message sequence numbers (eliminates N+1 queries)

​
Fixed

  • Deriver uses get_context internally to prevent context window limit errors
  • Embedding store will truncate context when querying documents to prevent embedding token limit errors
  • Queue manager to schedule work based on available works rather than total number of workers
  • Queue manager to use atomic db transactions rather than long lived transaction for the worker lifecycle
  • Timestamp formats unified to ISO 8601 across the codebase
  • Internal get_context method’s cutoff value is exclusive now
​
v2.2.0

​
Added

  • Arbitrary filters now available on all search endpoints
  • Search combines full-text and semantic using reciprocal rank fusion
  • Webhook support (currently only supports queue_empty and test events, more to come)
  • Small test harness and custom test format for evaluating Honcho output quality
  • Added MCP server and documentation for it

​
Changed

  • Search has 10 results by default, max 100 results
  • Queue structure generalized to handle more event types
  • Summarizer now exhaustive by default and tuned for performance

​
Fixed

  • Resolve race condition for peers that leave a session while sending messages
  • Added explicit rollback to solve integrity error in queue
  • Re-introduced Sentry tracing to deriver
  • Better integrity logic in get_or_create API methods
​
v2.1.2

​
Fixed

  • Summarizer module to ignore empty summaries and pass appropriate one to get_context
  • Structured Outputs calls with OpenAI provider to pass strict=True to Pydantic Schema
​
v2.1.1

​
Added

  • Test harness for custom Honcho evaluations
  • Better support for session and peer aware dialectic queries
  • Langfuse settings
  • Added recent history to dialectic prompt, dynamic based on new context window size setting

​
Fixed

  • Summary queue logic
  • Formatting of logs
  • Filtering by session
  • Peer targeting in queries

​
Changed

  • Made query expansion in dialectic off by default
  • Overhauled logging
  • Refactor summarization for performance and code clarity
  • Refactor queue payloads for clarity
​
v2.1.0

​
Added

  • File uploads
  • Brand new “ROTE” deriver system
  • Updated dialectic system
  • Local working representations
  • Better logging for deriver/dialectic
  • Deriver Queue Status no longer has redundant data

​
Fixed

  • Document insertion
  • Session-scoped and peer-targeted dialectic queries work now
  • Minor bugs

​
Removed

  • Peer-level messages

​
Changed

  • Dialectic chat endpoint takes a single query
  • Rearranged configuration values (LLM, Deriver, Dialectic, History->Summary)
​
v2.0.5

​
Fixed

  • Groq API client to use the Async library
​
v2.0.4

​
Fixed

  • Migration/provision scripts did not have correct database connection arguments, causing timeouts
​
v2.0.3

​
Fixed

  • Bug that causes runtime error when Sentry flags are enabled
​
v2.0.2

​
Fixed

  • Database initialization was misconfigured and led to provision_db script failing: switch to consistent working configuration with transaction pooler
​
v2.0.1

​
Added

  • Ergonomic SDKs for Python and TypeScript (uses Stainless underneath)
  • Deriver Queue Status endpoint
  • Complex arbitrary filters on workspace/session/peer/message
  • Message embedding table for full semantic search

​
Changed

  • Overhauled documentation
  • BasedPyright typing for entire project
  • Resource filtering expanded to include logical operators

​
Fixed

  • Various bugs
  • Use new config arrangement everywhere
  • Remove hardcoded responses
​
v2.0.0

​
Added

  • Ability to get a peer’s working representation
  • Metadata to all data primitives (Workspaces, Peers, Sessions, Messages)
  • Internal metadata to store Honcho’s state no longer exposed in API
  • Batch message operations and enhanced message querying with token and message count limits
  • Search and summary functionalities scoped by workspace, peer, and session
  • Session context retrieval with summaries and token allocatio
  • HNSW Index for Documents Table
  • Centralized Configuration via Environment Variables or config.toml file

​
Changed

  • New architecture centered around the concept of a “peer” replaces the former “app”/“user”/“session” paradigm
  • Workspaces replace “apps” as top-level namespace
  • Peers replace “users”
  • Sessions no longer nested beneath peers and no longer limited to a single user-assistant model. A session exists independently of any one peer and peers can be added to and removed from sessions.
  • Dialectic API is now part of the Peer, not the Session
  • Dialectic API now allows queries to be scoped to a session or “targeted” to a fellow peer
  • Database schema migrated to adopt workspace/peer/session naming and structure
  • Authentication and JWT scopes updated to workspace/peer/session hierarchy
  • Queue processing now works on ‘work units’ instead of sessions
  • Message token counting updated with tiktoken integration and fallback heuristic
  • Queue and message processing updated to handle sender/target and task types for multi-peer scenarios

​
Fixed

  • Improved error handling and validation for batch message operations and metadata
  • Database Sessions to be more atomic to reduce idle in transaction time

​
Removed

  • Metamessages removed in favor of metadata
  • Collections and Documents no longer exposed in the API, solely internal
  • Obsolete tests for apps, users, collections, documents, and metamessages
​
v1.1.0

​
Added

  • Normalize resources to remove joins and increase query performance
  • Query tracing for debugging

​
Changed

  • /list endpoints to not require a request body
  • metamessage_type to label with backwards compatability
  • Database Provisioning to rely on alembic
  • Database Session Manager to explicitly rollback transactions before closing the connection

​
Fixed

  • Alembic Migrations to include initial database migrations
  • Sentry Middleware to not report Honcho Exceptions
​
v1.0.0

​
Added

  • JWT based API authentication
  • Configurable logging
  • Consolidated LLM Inference via ModelClient class
  • Dynamic logging configurable via environment variables

​
Changed

  • Deriver & Dialectic API to use Hybrid Memory Architecture
  • Metamessages are not strictly tied to a message
  • Database provisioning is a separate script instead of happening on startup
  • Consolidated session/chat and session/chat/stream endpoints

​
Previous Releases

For a complete history of all releases, see our GitHub Releases page.

​
Getting Help

If you encounter issues using the Honcho API or its SDKs:
  1. Open an issue on GitHub
  2. Join our Discord community for support