262 lines
8.4 KiB
Plaintext
262 lines
8.4 KiB
Plaintext
---
|
|
title: "Changelog"
|
|
icon: "clock-rotate-left"
|
|
---
|
|
|
|
Welcome to the Honcho changelog! This section documents all notable changes to the Honcho API and SDKs.
|
|
|
|
|
|
<Accordion title="How to Read This Changelog">
|
|
Each release is documented with:
|
|
|
|
- **Added**: New features and capabilities
|
|
- **Changed**: Modifications to existing functionality
|
|
- **Deprecated**: Features that will be removed in future versions
|
|
- **Removed**: Features that have been removed
|
|
- **Fixed**: Bug fixes and corrections
|
|
- **Security**: Security-related improvements
|
|
|
|
## Version Format
|
|
|
|
Honcho follows [Semantic Versioning](https://semver.org/):
|
|
- **MAJOR** version for incompatible API changes
|
|
- **MINOR** version for backwards-compatible functionality additions
|
|
- **PATCH** version for backwards-compatible bug fixes
|
|
</Accordion>
|
|
|
|
### Honcho API and SDK Changelogs
|
|
<Tabs>
|
|
<Tab title="Honcho API">
|
|
<Update label="v2.1.0 (Current)">
|
|
### 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)
|
|
</Update>
|
|
|
|
<Update label="v2.0.5 (Current)">
|
|
### Fixed
|
|
|
|
- Groq API client to use the Async library
|
|
</Update>
|
|
|
|
<Update label="v2.0.4">
|
|
### Fixed
|
|
|
|
- Migration/provision scripts did not have correct database connection arguments, causing timeouts
|
|
</Update>
|
|
|
|
<Update label="v2.0.3">
|
|
### Fixed
|
|
|
|
- Bug that causes runtime error when Sentry flags are enabled
|
|
</Update>
|
|
|
|
<Update label="v2.0.2">
|
|
### Fixed
|
|
|
|
- Database initialization was misconfigured and led to provision_db script failing: switch to consistent working configuration with transaction pooler
|
|
</Update>
|
|
|
|
<Update label="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
|
|
</Update>
|
|
|
|
<Update label="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
|
|
---
|
|
</Update>
|
|
|
|
<Update label="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
|
|
</Update>
|
|
|
|
<Update label="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
|
|
</Update>
|
|
|
|
## Previous Releases
|
|
|
|
For a complete history of all releases, see our [GitHub Releases](https://github.com/plastic-labs/honcho/tags) page.
|
|
</Tab>
|
|
|
|
<Tab title="Python SDK">
|
|
[Python SDK](https://pypi.org/project/honcho-ai/)
|
|
<Update label="v1.2.2 (Current)">
|
|
### Added
|
|
|
|
- Filter parameter to various endpoints
|
|
|
|
</Update>
|
|
<Update label="v1.2.1">
|
|
### Fixed
|
|
|
|
- Honcho util import paths
|
|
|
|
</Update>
|
|
<Update label="v1.2.0">
|
|
### Added
|
|
|
|
- Get/poll deriver queue status endpoints added to workspace
|
|
- Added endpoint to upload files as messages
|
|
|
|
### Removed
|
|
|
|
- Removed peer messages in accordance with Honcho 2.1.0
|
|
|
|
### Changed
|
|
|
|
- Updated chat endpoint to use singular `query` in accordance with Honcho 2.1.0
|
|
|
|
</Update>
|
|
<Update label="v1.1.0">
|
|
### Fixed
|
|
|
|
- Properly handle AsyncClient
|
|
</Update>
|
|
</Tab>
|
|
|
|
<Tab title="TypeScript SDK">
|
|
[TypeScript SDK](https://www.npmjs.com/package/@honcho-ai/sdk)
|
|
<Update label="v1.2.1 (Current)">
|
|
### Added
|
|
|
|
- linting via Biome
|
|
- Adding filter parameter to various endpoints
|
|
|
|
### Fixed
|
|
|
|
- Order of parameters in `getSessions` endpoint
|
|
</Update>
|
|
<Update label="v1.2.0">
|
|
### Added
|
|
|
|
- Get/poll deriver queue status endpoints added to workspace
|
|
- Added endpoint to upload files as messages
|
|
|
|
### Removed
|
|
|
|
- Removed peer messages in accordance with Honcho 2.1.0
|
|
|
|
### Changed
|
|
|
|
- Updated chat endpoint to use singular `query` in accordance with Honcho 2.1.0
|
|
</Update>
|
|
<Update label="v1.1.0">
|
|
### Fixed
|
|
|
|
- Create default workspace on Honcho client instantiation
|
|
- Simplified Honcho client import path
|
|
</Update>
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
## Getting Help
|
|
|
|
If you encounter issues using the Honcho API or its SDKs:
|
|
|
|
1. Open an issue on [GitHub](https://github.com/plastic-labs/honcho/issues)
|
|
2. Join our [Discord community](http://discord.gg/plasticlabs) for support
|