Skip to content

Latest commit

 

History

History
271 lines (155 loc) · 13.8 KB

CHANGELOG.md

File metadata and controls

271 lines (155 loc) · 13.8 KB

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.9.0] - 2026-11-05

Added

  • honcho.dreams() and honcho.get_dream() (sync and async) read Representation History: the dream runs over a workspace's representations, newest first and filterable by observed and observer, and one run's created conclusions with their sources, removed conclusions, and peer-card change. pruned_at marks a run that retention cut down to the created conclusions that still exist. New response types DreamRunResponse and DreamRunDetailResponse. Requires Honcho v3.6.0+ (#1542)

[2.8.0] - 2026-10-29

Added

  • honcho.sessions() takes scope, in_no_scope and include_scopes (sync and async). scope lists only that scope's sessions, in_no_scope=True only sessions in no scope, and include_scopes=True sets Session.scopes (and SessionResponse.scopes) to the names of the scopes each listed session is in. Requires Honcho v3.5.0+ (#1477)
  • honcho.scopes() takes filters (e.g. {"id": {"icontains": "sup"}}, matching the scope name) and include_session_count (sync and async). With include_session_count=True, Scope.session_count (and ScopeResponse.session_count) holds each listed scope's member session count. Requires Honcho v3.5.0+ (#1478)
  • Scope.remove_sessions() (sync and async) removes up to 100 sessions from a scope in one request. All-or-nothing if any session doesn't exist; sessions that aren't members are ignored. Requires Honcho v3.5.0+ (#1480)
  • Conclusion.source_message_ids: the messages the deriver cited as evidence for an explicit conclusion (Honcho v3.5.0+). None for derived levels, and for conclusions recorded before citations existed until a later derivation of the same conclusion merges citations into them. Filter with {"source_message_ids": {"contains": "<message_id>"}} to find the conclusions that cite a message as evidence (#935)

Changed

  • set_configuration() on the client replaces the whole workspace configuration (Honcho v3.5.0+), so set_configuration(WorkspaceConfiguration()) clears explicit settings and uses system defaults; settings left out are removed. refresh() on the client reloads its typed configuration along with metadata (#1458)

Security

  • Requires certifi 2026.10.19 or newer, the first CA bundle without the emSign root behind the compromised eMudhra intermediates. The client verifies TLS with httpx's default, which reads certifi, so upgrading the SDK now upgrades the bundle in the app's environment too. An app that pins an older certifi must raise that pin to upgrade (#1453)

[2.7.0] - 2026-10-20

Added

  • uid on Peer, Session and the Honcho client (the workspace), plus on PeerResponse, SessionResponse and WorkspaceResponse: the immutable identifier the server assigns, next to the client-chosen id. Set from any API response that returns the object, and None before the first fetch or against servers that don't return it (#1394)

Fixed

  • The async client (.aio) builds a new httpx.AsyncClient when the running event loop changes, instead of reusing the first loop's client on every later loop. A Honcho kept across asyncio.run() calls (a module-level client in a Lambda handler, a sync view or a CLI) no longer fails its first request on a new loop with ConnectionError: Event loop is closed when the previous loop left a pooled connection, sometimes after the write had been stored. A client set directly on _async_http is still used as is, and each thread running its own loop should use its own Honcho (#1357)

[2.6.0] - 2026-10-07

Added

  • custom_instructions on WorkspaceConfiguration and SessionConfiguration (the shared fallback) and on SummaryConfiguration, DreamConfiguration, and PeerCardConfiguration, plus a new DialecticConfiguration type under the dialectic key. Requires Honcho v3.3.0+ (#1303)

[2.5.1] - 2026-09-22

Added

  • observer_id and observed_id on EvidenceObservation, so evidence from workspace chat says which peer pair each conclusion belongs to. Previously the SDK dropped these fields. Requires Honcho v3.2.1+ (#1220)

Changed

  • Conclusion.source_ids is [] rather than None for explicit conclusions when talking to Honcho v3.2.1+. The type still admits None for older servers (#1193)

[2.5.0] - 2026-09-15

Added

  • honcho.get_scope(id) (sync and async) fetches an existing scope by ID and raises NotFoundError when it does not exist. Unlike honcho.scope(), it never creates the scope, so lookups cannot provision a recall boundary by accident (#1163)
  • Optional per-call timeout on synchronous and asynchronous Peer.chat(). It overrides the timeout for each HTTP attempt; when omitted or set to None, the client-wide timeout configured on Honcho remains in effect (#1098)
  • include_evidence on peer and workspace chat (sync, async, and streaming). Opting in returns a ChatResponse carrying the answer plus the conclusions, messages, and tool calls the dialectic read; leaving it out returns the answer on its own, so existing callers are unaffected. Streaming exposes .evidence once the stream is drained. Requires a Honcho server with the matching API support (Honcho v3.2.0+) (#1130)
  • source_ids and times_derived on Conclusion. ConclusionsView.get(id) / get_many(ids) / derived(id) and the workspace-level honcho.conclusions.get / get_many fetch a conclusion with attribution or walk the reasoning tree upward (source → derived). Requires a Honcho server with the matching API support (Honcho v3.2.0+) (#952)
  • SDK requests send X-Honcho-Host: honcho-python/<version> (platform) so CloudEvents can split harness vs direct SDK vs raw REST traffic. A caller-supplied X-Honcho-Host still wins (#1182)

[2.4.0] - 2026-08-25

Added

  • Scopes: Honcho.scope() / HonchoAio.scope() get-or-create a named visibility boundary, Honcho.scopes() lists them, and a Scope object adds/removes sessions, lists membership, and reads backfill status(). Honcho.session(..., scopes=[...]) joins a new session to scopes at creation. Requires a Honcho server with the matching API support (Honcho v3.1.0+).
  • scope option on Peer.chat() / chat_stream(), representation, session context, and workspace search. A single scope answers from that scope's collection and card; a list of scopes restricts recall to the union of their member sessions (explicit-only). Mutually exclusive with session / sessions / filters.
  • Workspace-level chat: Honcho.chat() / HonchoAio.chat() and chat_stream() ask a question across every peer in the workspace, with the same session, scope, reasoning_level, and response_format options as Peer.chat(). Requires a Honcho server with the matching API support (Honcho v3.1.0+).

Changed

  • ConclusionScope is renamed to ConclusionsView. The old name remains as a deprecated alias for one more minor version. "Scope" now means a named set of sessions (Scope); these objects are views over one observer/observed pair.

[2.3.0] - 2026-08-10

Added

  • response_format on Peer.chat() / PeerAio.chat() and Peer.chat_stream() / PeerAio.chat_stream(), for constraining a dialectic answer to a schema. Pass a Pydantic model class to get a validated instance back (parsed via model_validate_json), or a raw JSON Schema dict to get the JSON string as-is. Overloads type the return precisely, so a model class narrows to that model and a dict narrows to str. On the streaming variants, chunks stay raw text that accumulates to a JSON string — parse it after the stream completes. Requires a Honcho server with the matching API support (Honcho v3.0.12+).
  • response_format field on DialecticParams.

[2.2.0] - 2026-07-02

Added

  • ConclusionLevel type (explicit, deductive, inductive, contradiction) and a level field on Conclusion, exposing the reasoning level the server already tracked but previously stripped from responses.
  • filters parameter on ConclusionScope.list() and ConclusionScope.query() (sync and async), passed through to the same dynamic server-side filter logic as peers()/sessions()/messages(). Filter explicit-only conclusions with filters={"level": "explicit"}, or by any other supported field/operator. Requires a Honcho server with the matching API support (Honcho v3.0.11+).

Fixed

  • Scope-managed filter keys (observer, observed, session) are now rejected with a clear ValueError if passed in filters, instead of silently overriding the scope and returning conclusions from a different peer pair. Use peer.conclusions / conclusions_of(target) and the session= parameter instead. session_id remains a valid filter on query().

[2.1.2] - 2026-05-21

Added

  • page, size, and reverse pagination parameters on Honcho.workspaces() and HonchoAio.workspaces(), closing the gap from 2.1.0 which added these to peers(), sessions(), messages(), and conclusions.list() but not to workspaces(). Honoring reverse on the workspace/peer/session list routes also requires a Honcho server with the matching API fix; older servers silently ignore the parameter.
  • peers parameter on Honcho.session() and HonchoAio.session() — attach peers to a session at creation time instead of needing a follow-up session.add_peers() call. Accepts the same shapes as Session.add_peers (peer ID string, Peer object, list of either, or tuples with SessionPeerConfig).

Changed

  • WorkspaceCreateParams, PeerCreateParams, and SessionCreateParams now accept IDs up to 512 characters (was 100), matching the server-side schema change in Honcho v3.0.7.

[2.1.1] - 2026-04-01

Fixed

  • Broadened HTTP retry logic to cover httpx.NetworkError and httpx.RemoteProtocolError in addition to httpx.TimeoutException and httpx.ConnectError, improving resilience against transient network failures

[2.1.0] - 2026-03-25

Added

  • created_at property on Peer and Session objects
  • is_active property on Session objects
  • get_message(message_id) method on Session (sync and async) to fetch a single message by ID
  • page, size, and reverse pagination parameters on all list methods: peers(), sessions(), messages(), and conclusions.list()

Changed

  • 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 created_at populated immediately.
  • Response configuration models (WorkspaceConfigurationResponse, SessionConfigurationResponse) now tolerate unknown fields from newer servers for forward compatibility

Fixed

  • Sync and async Session.get_metadata(), get_configuration(), and refresh() now refresh cached created_at and is_active values along with metadata and configuration.
  • honcho.__version__ now derives from package metadata, with a pyproject.toml fallback in source checkouts, so it stays aligned with SDK releases.

[2.0.2] - 2026-03-10

Changed

  • All input models now reject unknown fields via extra="forbid" Pydantic validation. Previously, misspelled or extraneous fields were silently ignored. Now a ValidationError is raised with the unrecognized field name.

[2.0.1] - 2026-02-09

Added

  • set_peer_card method

Changed

  • card is now get_card 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

Removed

  • Standalone types module (now uses honcho-core types)
  • Representation object

[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

  • Added get_peer_config to sessions module

Changed

  • Summaries are now included in toOpenAI and toAnthropic functions
  • SessionContext.__len__ now counts the summary in its total
  • filter keyword changed to filters

Fixed

  • Added missing metadata inputs in many places
  • Better documentation all over

[1.2.2] - 2025-07-21

Added

  • Filter parameter to various endpoints

[1.2.1] - 2025-07-17

Fixed

  • honcho utils import path

[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

  • Properly handle AsyncClient