Changelog

​

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

​

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

​

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

​

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

​

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)

​

Fixed

• Groq API client to use the Async library

​

Fixed

• Migration/provision scripts did not have correct database connection arguments, causing timeouts

​

Fixed

• Bug that causes runtime error when Sentry flags are enabled

​

Fixed

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

​

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

​

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

​

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

​

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