API Reference
Everything below is importable from the top-level mmar_carl package
(from mmar_carl import ...). This page groups the public surface; follow the
links for full guides.
ReasoningChain · ChainBuilder · ReasoningContext · ReasoningResult ·
StepExecutionResult · DAGExecutor · ContextSnapshot · PromptTemplate ·
Language · StepType · MemoryOperation · ChainFormatNewerError ·
ExecutionCancelledError → chains · concepts
Typed: LLMStepDescription · ToolStepDescription · MemoryStepDescription ·
TransformStepDescription · ConditionalStepDescription ·
StructuredOutputStepDescription · MCPStepDescription ·
MCPResourceStepDescription · AgentSkillStepDescription ·
AgentHandoffStepDescription · SupervisorStepDescription ·
DebateStepDescription · ParallelSamplingStepDescription ·
HumanInputStepDescription · ToolDiscoveryStepDescription ·
EvaluationStepDescription. Base/legacy: StepDescriptionBase ·
StepDescription · AnyStepDescription · create_step → steps
Step configs
Section titled “Step configs”ToolStepConfig · ToolErrorRecovery · ToolParameter · MemoryStepConfig ·
TransformStepConfig · ConditionalStepConfig · ConditionalBranch ·
StructuredOutputStepConfig · LLMStepConfig · ExecutionMode · LoopConfig ·
StepCache · StepGroup · MCPStepConfig · MCPServerConfig ·
MCPResourceStepConfig · AgentHandoffStepConfig · SupervisorStepConfig ·
DebateStepConfig · ParallelSamplingStepConfig · ParallelSamplingAggregation ·
HumanInputStepConfig · ToolDiscoveryStepConfig · AgentSkillStepConfig ·
AgentSkillExecutionMode · AgentSkillSource · EvaluationStepConfig ·
EvalFailAction
Context extraction
Section titled “Context extraction”ContextSearchConfig · ContextQuery · SubstringSearchStrategy ·
VectorSearchStrategy · SearchStrategy → context & search
Memory
Section titled “Memory”LTMBase · InMemoryLTM · JsonFileLTM · LazyMemoryValue · unwrap_lazy ·
MemorySchemaError → memory
LLM clients
Section titled “LLM clients”OpenAICompatibleClient · OpenAIClientConfig · create_openai_client ·
AnthropicClient · AnthropicClientConfig · RetryPolicy · LLMClientBase ·
ChatMessage · RecordingLLMClient · PlayingLLMClient · CassetteMissError →
LLM clients
Evaluation
Section titled “Evaluation”MetricBase · call_metric_async · MetricOutput · ExactMatchMetric ·
CaseInsensitiveMatchMetric · ContainsMetric · RegexMatchMetric ·
DatasetEvaluator · DataCase · SimpleDataset · DataFrameDataset ·
AbstractDataset · DatasetEvaluationReport · ThresholdStrategy ·
TopKWorstStrategy · EvalSuite · EvalSuiteReport · EvalSuiteDiff ·
ReflectionOptions → evaluation
Evolution
Section titled “Evolution”ChainEvolver · ChainMutator · MutationKind · EvolutionResult ·
IndividualMetrics · EvolutionCostEstimate · GenerationStats ·
format_runs_pareto → evolution
Tracing, cost & visualization
Section titled “Tracing, cost & visualization”ExecutionTrace · TraceEvent · TraceAggregator · ChainVisualizer ·
CostEstimate · StepCostEstimate · StreamingBuffer · logging:
set_log_level / get_logger / log_* · langfuse_flush ·
is_langfuse_enabled → tracing
RE-PLAN
Section titled “RE-PLAN”ReplanPolicy · RuleBasedReplanCheckerConfig · LLMReplanCheckerConfig ·
RegisteredReplanCheckerConfig · RuleBasedReplanChecker · LLMReplanChecker ·
ReplanAction · ReplanAggregationStrategy · ReplanAggregationConfig ·
ReplanTriggerConfig · ReplanBudgetConfig · ReplanRollbackTarget ·
ReplanVerdict → RE-PLAN
Orchestration outputs
Section titled “Orchestration outputs”DebateTranscript · DebateTurn · ParallelSamples · SupervisorDecision ·
ReplanEvent → orchestration
Skills
Section titled “Skills”resolve_skill · GithubResolver · LocalResolver · HttpsTarballResolver ·
ModuleResolver · SkillResolverRegistry · ResolvedSkill ·
SkillIntegrityError · SkillLoader · SkillManifest · skill runtimes
(LocalSkillRuntime / DockerSkillRuntime / E2BSkillRuntime /
FirejailSkillRuntime) · list_cached_skills → AgentSkills
Tools & extensibility
Section titled “Tools & extensibility”carl_tool · ToolDefinition · ModuleToolSource · CallableToolSource ·
DictToolSource · get_executor · register_executor · StepExecutorBase ·
the per-type *StepExecutor classes → tool steps
Testing & MCP infra
Section titled “Testing & MCP infra”ChainTestHarness · MCPSessionPool → MCP