Honcho

Run usage-bearing agentic search and reasoning over a peer's learned representation to answer a question. Higher reasoning levels generally cost more and take longer. Returns one non-streaming JSON response.

Store a batch of 1-100 explicit conclusions about peers, optionally tied to sessions.

Add a batch of 1-100 attributed messages to a Honcho session. Message-level reasoning settings can trigger usage-bearing processing.

Permanently delete one known session and its session-scoped data. Honcho marks the session inactive immediately and completes deletion asynchronously.

Return one message by its exact ID within a session.

Return a peer by ID within a workspace, creating it with the supplied metadata and configuration when absent. Existing peers are returned unchanged.

Return a session by ID, or create it with initial peers, metadata, and configuration when absent. Creation may create missing peers and start usage-bearing processing when reasoning features are enabled; existing sessions remain unchanged.

Return a workspace by ID, or create it with metadata and configuration when absent. Enabling reasoning features during creation may start usage-bearing background processing.

Return a curated subset of conclusions representing a peer. Supplying search_query performs semantic retrieval and may consume paid search capacity; omit it for the existing default representation.

Return one page of stored conclusions in a workspace; use Search Conclusions for semantic retrieval.

Return one page of messages in a session; use Get Message for exact-ID retrieval.

Return one page of peers in a workspace.

Return one page of sessions in a workspace.

Return one page of Honcho workspaces visible to the connected admin key.

Semantically search stored conclusions in a workspace. This operation may consume paid search or embedding capacity; use List Conclusions to browse stored conclusions without semantic retrieval.

Semantically search messages at workspace, peer, or session scope. WARNING: this operation may consume paid search or embedding capacity; use list or get message tools for exact or chronological retrieval.