honcho-ai 0.2.1

Rust SDK for Honcho — AI agent memory and social cognition infrastructure
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

//! Common types shared across domain modules.

use serde::{Deserialize, Serialize};

/// JSON value alias for metadata and configuration fields.
pub type JsonValue = serde_json::Value;

/// Configuration for reasoning functionality.
///
/// # Examples
///
/// This type is `#[non_exhaustive]`, so it cannot be built with a struct
/// literal (and therefore not with functional-update `..Default::default()`
/// syntax) from outside the crate. Start from [`Default`] and set the fields
/// you need:
///
/// ```
/// use honcho_ai::types::common::ReasoningConfiguration;
///
/// let mut config = ReasoningConfiguration::default();
/// config.enabled = Some(true);
/// config.custom_instructions = Some("focus on the most recent turns".to_owned());
///
/// assert_eq!(config.enabled, Some(true));
/// ```
#[non_exhaustive]
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)]
pub struct ReasoningConfiguration {
    /// Whether to enable reasoning functionality.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub enabled: Option<bool>,
    /// Custom instructions for the reasoning system.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub custom_instructions: Option<String>,
}

/// Configuration for automatic session summarization.
#[non_exhaustive]
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)]
pub struct SummaryConfiguration {
    /// Whether to enable summary functionality.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub enabled: Option<bool>,
    /// Number of messages per short summary (minimum 10, server-validated).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub messages_per_short_summary: Option<u32>,
    /// Number of messages per long summary (minimum 20, server-validated).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub messages_per_long_summary: Option<u32>,
}

/// Configuration for dream functionality.
#[non_exhaustive]
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)]
pub struct DreamConfiguration {
    /// Whether to enable dream functionality.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub enabled: Option<bool>,
}

/// Configuration for peer card generation and usage.
#[non_exhaustive]
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)]
pub struct PeerCardConfiguration {
    /// Whether to use the peer card during the reasoning process.
    #[serde(rename = "use", skip_serializing_if = "Option::is_none")]
    pub use_peer_card: Option<bool>,
    /// Whether to generate a peer card based on content.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub create: Option<bool>,
}