honcho/sdks/typescript/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[2.1.1] - 2026-04-01

Fixed

• Broadened fetch error retry logic to catch all TypeError network failures (connection resets, DNS errors, etc.) instead of only those with 'fetch' in the message, improving resilience across runtimes (Node, Bun, browsers)

[2.1.0] - 2026-03-25

Added

• createdAt property on Peer and Session wrapper objects
• isActive property on Session wrapper objects
• getMessage(messageId) method on Session to fetch a single message by ID
• Peer.representation(), Session.representation(), and Session.context() now accept Message objects for searchQuery (extracts .content automatically)
• page, size, and reverse pagination controls on all list methods: peers(), sessions(), messages(), workspaces(), and conclusions.list()

Changed

• Breaking: searchQuery removed from top-level context() options. Use representationOptions.searchQuery instead — this eliminates the duplicate parameter and is consistent with the API structure.
• List methods (peers(), sessions(), messages(), workspaces()) support both the new options object and the legacy raw-filter form: peers({ filters, page, size, reverse }) and peers(filters).
• Representation search options now accept strings and content-like objects (including Message instances) while rejecting whitespace-only or invalid runtime inputs.
• Breaking: peer() and session() now always make a get-or-create API call. Previously, calling without metadata/configuration returned a lazy object with no API call. All Peer/Session objects now have createdAt populated immediately.
• Response configuration models (WorkspaceConfigurationResponse, SessionConfigurationResponse) now tolerate unknown fields from newer servers for forward compatibility
• Reusable PeerIdObjectSchema and SessionIdObjectSchema helpers for union validation
• Moved @types/node from dependencies to devDependencies

Fixed

• uploadFile() now rejects unsupported top-level binary/object inputs and only validates inputs the serializer can actually upload.
• uploadFile() now serializes message configuration using API field names, matching addMessages().
• Session fetch methods now refresh cached createdAt and isActive values alongside metadata and configuration.

[2.0.2] - 2026-03-10

Changed

• Breaking: Client constructor now rejects unknown options via .strict() Zod validation. Previously, misspelled options (e.g., baseUrl instead of baseURL) were silently ignored, causing the SDK to fall back to defaults. Now a ZodError is thrown with the unrecognized key name.

[2.0.1] - 2026-02-09

Added

• setPeerCard method

Changed

• card is now getCard with card kept for backwards compatibility and marked as deprecated

[2.0.0] - 2026-01-13

Added

• ConclusionScope object for CRUD operations on conclusions (renamed from observations)
• Representation configuration support

Changed

• Observations renamed to Conclusions across the SDK
• Major SDK refactoring and cleanup
• Simplified method signatures throughout
• Representation endpoints now return string instead of old Representation object

Fixed

• Pagination this binding issue

Removed

• Representation object
• Stainless "core" SDK -- this SDK is now standalone

[1.6.0] - 2025-12-03

Added

• metadata and configuration fields to Workspace, Peer, Session, and Message objects
• Session Clone methods
• Peer level get_context method
• ObservationScope object to perform CRUD operations on observations
• Representation object for WorkingRepresentations

Changed

• methods that take IDs, can all optionally take an object of the same type

[1.5.0] - 2025-10-09

Added

• Delete workspace method

Changed

• message_id of Summary model is a string nanoid
• Get Context can return Peer Card & Peer Representation

[1.4.1] — 2025-10-01

Added

• Get Peer Card method
• Update Message metadata method
• Session level deriver status methods
• Delete session message

Fixed

• Dialectic Stream returns Iterators
• Type warnings

Changed

• Pagination class to match core implementation

[1.4.0] - 2025-08-12

Added

• getSummaries API returning structured summaries
• Webhook support

Changed

• Messages can take an optional created_at value, defaulting to the current time (UTC ISO 8601)

[1.3.0] - 2025-08-04

Added

• Zod validation
• Added getPeerConfig to Session object

Changed

• Moved parameters out of random opts dictionaries in many places
• Peer and Session objects now use inner client like python SDK

Fixed

• Enabled missing metadata options in many places
• Proper default behavior for SessionPeerConfig

[1.2.1] - 2025-07-21

Fixed

• Order of parameters in getSessions endpoint

Added

• Linting via Biome
• Adding filter parameter to various endpoints

[1.2.0] - 2025-07-16

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

[1.1.0] - 2025-07-08

Fixed

• Create default workspace on Honcho client instantiation
• Simplified Honcho client import path