Skip to main content
Honcho logo
  • Category: artificial intelligence
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 16
  • Triggers: 0
  • Slug: HONCHO
  • Version: 20261101_00

Tools

Slug: HONCHO_CHAT_WITH_PEERRun 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.

Input Parameters

string
required
Question or reasoning prompt for the peer, from 1 to 10,000 characters.
string
Optional target peer to reason about from the selected peer’s perspective.
string
required
Peer whose learned representation should answer.
string
Optional session that scopes the representation used to answer.
string
required
Workspace containing the peer.
string ("minimal" | "low" | "medium" | "high" | "max")
Reasoning effort. Prefer minimal or low unless deeper synthesis is needed; higher levels may increase usage cost and latency.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_CREATE_CONCLUSIONSStore a batch of 1-100 explicit conclusions about peers, optionally tied to sessions.

Input Parameters

array
required
One to 100 explicit conclusions to store.
string
required
Workspace in which to store the conclusions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_CREATE_MESSAGESAdd a batch of 1-100 attributed messages to a Honcho session. Message-level reasoning settings can trigger usage-bearing processing.

Input Parameters

array
required
One to 100 attributed messages to add to the session.
string
required
Session receiving the messages.
string
required
Workspace containing the session.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_DELETE_SESSIONPermanently delete one known session and its session-scoped data. Honcho marks the session inactive immediately and completes deletion asynchronously.

Input Parameters

string
required
Session to delete permanently.
string
required
Workspace containing the session.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_GET_MESSAGEReturn one message by its exact ID within a session.

Input Parameters

string
required
Opaque message ID returned by create or list messages.
string
required
Session containing the message.
string
required
Workspace containing the session.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_GET_OR_CREATE_PEERReturn a peer by ID within a workspace, creating it with the supplied metadata and configuration when absent. Existing peers are returned unchanged.

Input Parameters

string
required
Stable peer ID containing only letters, digits, underscores, or hyphens.
object
Arbitrary JSON metadata applied only when the peer is created.
string
required
Workspace that owns the peer.
object
Optional peer configuration applied only when the peer is created.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_GET_OR_CREATE_SESSIONReturn 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.

Input Parameters

object
Initial membership keyed by peer ID. Missing peers may be created by Honcho.
object
Arbitrary JSON metadata applied only when the session is created.
string
required
Stable session ID containing only letters, digits, underscores, or hyphens.
string
required
Workspace that owns the session.
object
Optional creation-time reasoning, summary, dream, and peer-card settings. Enabling these features can start usage-bearing background processing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_GET_OR_CREATE_WORKSPACEReturn a workspace by ID, or create it with metadata and configuration when absent. Enabling reasoning features during creation may start usage-bearing background processing.

Input Parameters

object
Arbitrary JSON metadata applied only when the workspace is created.
string
required
Stable workspace ID containing only letters, digits, underscores, or hyphens.
object
Optional creation-time reasoning, summary, dream, and peer-card settings. Enabling these features can start usage-bearing background processing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_GET_PEER_REPRESENTATIONReturn 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.

Input Parameters

string
Optional target peer represented from the selected peer’s perspective.
string
required
Peer whose representation to retrieve.
string
Optional session within which to scope the representation.
string
Optional semantic query used to curate conclusions. Supplying it may consume paid search capacity.
integer
With search_query, retrieve up to this many semantic matches (1-100).
string
required
Workspace containing the peer.
integer
Maximum conclusions to include in the representation (1-100).
number
With search_query, use this maximum cosine distance from 0 to 1.
boolean
With search_query, also include frequently recurring conclusions.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_LIST_CONCLUSIONSReturn one page of stored conclusions in a workspace; use Search Conclusions for semantic retrieval.

Input Parameters

integer
Maximum conclusions in this page (1-100).
boolean
Return results in reverse provider order.
string
Continuation value from a previous call; omit for the first page.
string
required
Workspace whose conclusions to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_LIST_MESSAGESReturn one page of messages in a session; use Get Message for exact-ID retrieval.

Input Parameters

integer
Maximum messages in this page (1-100).
boolean
Return results in reverse provider order.
string
required
Session whose messages to list.
string
Continuation value from a previous call; omit for the first page.
string
required
Workspace containing the session.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_LIST_PEERSReturn one page of peers in a workspace.

Input Parameters

integer
Maximum peers in this page (1-100).
boolean
Return results in reverse provider order.
string
Continuation value from a previous call; omit for the first page.
string
required
Workspace whose peers to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_LIST_SESSIONSReturn one page of sessions in a workspace.

Input Parameters

integer
Maximum sessions in this page (1-100).
boolean
Return results in reverse provider order.
string
Continuation value from a previous call; omit for the first page.
string
required
Workspace whose sessions to list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_LIST_WORKSPACESReturn one page of Honcho workspaces visible to the connected admin key.

Input Parameters

integer
Maximum workspaces in this page (1-100).
boolean
Return results in reverse provider order.
string
Opaque continuation value returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_SEARCH_CONCLUSIONSSemantically search stored conclusions in a workspace from a specified observer peer’s perspective about a specified observed peer. This operation may consume paid search or embedding capacity.

Input Parameters

string
required
Natural-language semantic query.
integer
Maximum semantic matches to return (1-100).
string
required
ID of the peer the matching conclusions must be about.
string
required
ID of the peer whose perspective the conclusions were recorded from.
number
Optional maximum cosine distance from 0 to 1; lower values require closer matches.
string
required
Workspace whose conclusions to search.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HONCHO_SEARCH_MESSAGESSemantically 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.

Input Parameters

integer
Maximum matching messages to return (1-100).
string
required
Natural-language semantic search query.
string ("workspace" | "peer" | "session")
required
Boundary for the semantic search: workspace, peer, or session.
string
Peer to search. Required only when scope is peer; otherwise omit it.
string
Session to search. Required only when scope is session; otherwise omit it.
string
required
Workspace to search within.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not