mentra 0.27.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
84
85
86
87
88
89
90
91
92

#![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;
/// Host-owned process hygiene for running other programs with explicit bounds.
pub mod process;
/// 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, ProviderSessionScope};

pub use agent::{
    Agent, AgentConfig, AgentWaitFuture, AgentWaitHandle, FinalOutput, QueueMode, ReasoningChange,
    RoundAdjustment, RoundBoundary, RoundContext, RoundDecision, RoundStrategy, RoundToolResult,
    SpawnedAgentStatus, SpawnedAgentSummary, SteeringHandle, TerminalOutputDecision,
    TerminalOutputReservation, TerminalOutputSpec, ToolResultPagingConfig,
};
pub use background::{BackgroundNotification, BackgroundTaskStatus, BackgroundTaskSummary};
pub use compaction::{
    CompactionBounds, CompactionEngine, CompactionMode, StandardCompactionEngine,
};
pub use mcp::{
    McpClientError, McpManager, McpServerConfig, McpServerStatus, McpServerSummary, McpSseClient,
    McpSseConfigError, McpSseError, McpSseLimits, McpSseServerConfig, McpStreamableHttpClient,
    McpStreamableHttpConfigError, McpStreamableHttpError, McpStreamableHttpLimits,
    McpStreamableHttpServerConfig,
};
#[cfg(feature = "store-sqlite")]
pub use runtime::HybridRuntimeStore;
pub use runtime::{
    AgentStore, AuditStore, FileRuntimeStore, LeaseStore, NewTask, PermissionRuleContext,
    PermissionRuleStore, RunStore, Runtime, RuntimeBuilder, RuntimePolicy, ShellValidationMode,
    SkillInfo, SkillLoadError, TaskBoard, TaskBoardError, TaskPatch, TaskStore, skill_root_key,
};
pub use session::{
    PermissionDecision, PermissionRequest, PermissionRuleAddress, RememberedRule, RuleKey,
    RuleStore, Session, SessionEvent, SessionEventReceiver, SessionId, SessionMetadata,
    SessionPermissionHandle, SessionStatus, SubagentHandle,
};
pub use team::{
    TeamDispatch, TeamMemberStatus, TeamMemberSummary, TeamMessage, TeamMessageKind,
    TeamProtocolRequestSummary, TeamProtocolStatus,
};
pub use tool::{AudienceToolRegistration, FileToolProfile, PreparedTool, ToolAudience};
pub use transcript::{
    AgentTranscript, BranchError, CompactionSummary, DelegationArtifact, DelegationEdge,
    DelegationKind, DelegationStatus, EntryId, TranscriptItem, TranscriptKind,
};

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