mentra 0.12.0

An agent runtime for tool-using LLM applications
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
72
73
74
75
76
77
78
79
80
81
82
83

#![doc = include_str!("../README.md")]

mod default_paths;

pub use mentra_provider as provider_core;

/// Agent configuration, lifecycle, and event handling.
pub mod agent;
/// Optional OAuth helpers for provider authentication.
#[cfg(feature = "openai-oauth")]
pub mod auth;
/// Background task coordination types and services.
pub mod background;
/// Transcript compaction engine and related types.
pub mod compaction;
/// Model Context Protocol (MCP) client and tool bridge.
pub mod mcp;
/// Working-memory journal and long-term memory services.
pub mod memory;
/// Provider integrations and transport-neutral request/response types.
pub mod provider;
/// Runtime orchestration, persistence, policies, and agent APIs.
pub mod runtime;
/// Session types, metadata, and event stream primitives.
pub mod session;
/// Team coordination types and collaboration services.
pub mod team;
/// Optional test helpers for deterministic scripted runtimes.
#[cfg(any(test, feature = "test-utils"))]
pub mod test;
/// Tool traits, metadata, and builtin tools.
pub mod tool;
/// Canonical runtime transcript primitives.
pub mod transcript;

pub use mentra_provider::{
    AnthropicRequestOptions, BuiltinProvider, ContentBlock, ContentBlockDelta, ContentBlockStart,
    GeminiRequestOptions, ImageSource, Message, ModelInfo, ModelSelector, OpenAIRequestOptions,
    ProviderCapabilities, ProviderCredentials, ProviderDefinition, ProviderDescriptor,
    ProviderError, ProviderEvent, ProviderEventStream, ProviderId, ProviderRequestOptions,
    ReasoningEffort, ReasoningFormat, ReasoningOptions, ReasoningProvenance, Request,
    ResponsesRequestOptions, ResponsesStateMode, ResponsesTransport, RetryPolicy, Role, TokenUsage,
    ToolChoice, ToolSearchMode, WireApi, collect_response_from_stream,
    provider_event_stream_from_response,
};

pub use provider::{Provider, ProviderRegistry};

pub use agent::{
    Agent, AgentConfig, AgentWaitFuture, AgentWaitHandle, FinalOutput, QueueMode, ReasoningChange,
    RoundAdjustment, RoundBoundary, RoundContext, RoundDecision, RoundStrategy, RoundToolResult,
    SpawnedAgentStatus, SpawnedAgentSummary, SteeringHandle, TerminalOutputSpec,
    ToolResultPagingConfig,
};
pub use background::{BackgroundNotification, BackgroundTaskStatus, BackgroundTaskSummary};
pub use compaction::{CompactionEngine, CompactionMode, StandardCompactionEngine};
pub use mcp::{
    McpClientError, McpManager, McpServerConfig, McpServerStatus, McpServerSummary, McpSseClient,
    McpSseConfigError, McpSseError, McpSseLimits, McpSseServerConfig,
};
pub use runtime::{
    AgentStore, AuditStore, HybridRuntimeStore, LeaseStore, NewTask, PermissionRuleStore, RunStore,
    Runtime, RuntimePolicy, ShellValidationMode, TaskBoard, TaskBoardError, TaskPatch, TaskStore,
};
pub use session::{
    PermissionDecision, PermissionRequest, RememberedRule, RuleKey, RuleStore, Session,
    SessionEvent, SessionEventReceiver, SessionId, SessionMetadata, SessionPermissionHandle,
    SessionStatus, SubagentHandle,
};
pub use team::{
    TeamDispatch, TeamMemberStatus, TeamMemberSummary, TeamMessage, TeamMessageKind,
    TeamProtocolRequestSummary, TeamProtocolStatus,
};
pub use tool::FileToolProfile;
pub use transcript::{
    AgentTranscript, CompactionSummary, DelegationArtifact, DelegationEdge, DelegationKind,
    DelegationStatus, TranscriptItem, TranscriptKind,
};

pub mod error {
    pub use crate::provider::ProviderError;
    pub use crate::runtime::{ErrorCategory, RuntimeError};
}