Complete module and API index

Inspect the package

Use the workload guide to compare algorithms and this index to find their implementation definitions, supporting values, and public methods.

python -c "import mari_kit; print(mari_kit.__file__)"

This source-derived index covers 169 public implementation modules, 1009 top-level class/function definitions, and 193 public method declarations. It includes algorithms, supporting records, protocols, adapters, and validators. These counts describe definitions rather than independent algorithms.

The algorithm choices guide compares workloads and tradeoffs. Use this index to locate every public implementation family and inspect exact source definitions. Imported aliases, constants, private helpers, and dunder methods are outside the definition counts. Package facades appear separately below.

Source reference: Mari Kit at 327926b. Each declaration links to its implementation. Research citations and adaptation boundaries appear in the algorithm guide and feature pages.

Areas

• Agent activity and experience

• Agent events and evaluation

• Conformance utilities

• Conversations and topics

• Documents and source structure

• Evaluation and statistics

• Governance policies

• Graph algorithms and interchange

• Incremental maintenance

• Knowledge and memory

• Platform composition and reference storage

• Retrieval and context

• Selectable algorithm additions

• Shared values and contracts

• Source connectors and event handling

• Source synchronization

• Verification and evidence decisions

Agent activity and experience

mari_kit.trajectories.adapters

Small adapters from common trace exports into normalized trajectory steps.

Module source

Public definition	Kind	Public methods declared here
TrajectoryAdapterIssue	class	—
TrajectoryAdapterResult	class	—
normalize_openai_trajectory	function	—
normalize_anthropic_trajectory	function	—
normalize_otel_trajectory	function	—

mari_kit.trajectories.episodes

Evidence-bound turn, episode, and cross-episode reflection values.

Module source

Public definition	Kind	Public methods declared here
AssessmentStatus	class	—
TurnAssessment	class	—
Episode	class	—
EpisodeReflection	class	—
parse_turn_assessments	function	—
segment_episodes	function	—
parse_episode_reflection	function	—

mari_kit.trajectories.experience

Contrastive trajectory associations and evidence-bound reasoning memories.

Module source

Public definition	Kind	Public methods declared here
OutcomeAssociation	class	support
mine_outcome_associations	function	—
ReasoningMemoryKind	class	—
ReasoningMemoryCandidate	class	—
ReasoningMemoryComparison	class	—
parse_reasoning_memories	function	—
compare_reasoning_memories	function	—

mari_kit.trajectories.intent_analysis

Caller-embedded intent clustering, novelty detection, and temporal drift.

Module source

Public definition	Kind	Public methods declared here
IntentCluster	class	support
IntentClustering	class	—
NovelIntent	class	—
IntentClusterChange	class	—
IntentDriftReport	class	—
cluster_intents	function	—
detect_novel_intents	function	—
compare_intent_windows	function	—

mari_kit.trajectories.intents

Evidence-bound intent proposals and corpus-level intent aggregation.

Module source

Public definition	Kind	Public methods declared here
IntentKind	class	—
normalize_intent	function	—
IntentEvidence	class	—
IntentCandidate	class	—
IntentAggregate	class	support
IntentReview	class	—
IntentReviewSummary	class	agreement
parse_intent_candidates	function	—
aggregate_intents	function	—
summarize_intent_reviews	function	—

mari_kit.trajectories.invariants

Evidence-bearing invariant mining from successful agent trajectories.

Module source

Public definition	Kind	Public methods declared here
TrajectoryInvariantKind	class	—
TrajectoryInvariant	class	support_ratio
TrajectoryInvariantViolation	class	—
mine_trajectory_invariants	function	—
check_trajectory_invariant	function	—

mari_kit.trajectories.matching

Reference-trajectory comparison without framework message types.

Module source

Public definition	Kind	Public methods declared here
TrajectoryMatchMode	class	—
TrajectoryMatch	class	—
trajectory_edit_distance	function	—
compare_trajectories	function	—
tool_histogram	function	—

mari_kit.trajectories.mine

Grounded trajectory analysis using one caller-supplied model invocation.

Module source

Public definition	Kind	Public methods declared here
TrajectoryPhase	class	steps
TrajectoryAnalysis	class	—
parse_trajectory_analysis	function	—

mari_kit.trajectories.normalize

Privacy-bounded normalization of observable tool telemetry.

Module source

Public definition	Kind	Public methods declared here
TrajectoryStep	class	duration, tokens
normalize_steps	function	—

mari_kit.trajectories.procedures

Versioned procedural candidates learned from successful tool traces.

Module source

Public definition	Kind	Public methods declared here
ProcedureStep	class	—
ProcedureCandidate	class	—
learn_procedure	function	—

mari_kit.trajectories.process

Deterministic process-mining summaries over caller-owned trajectories.

Module source

Public definition	Kind	Public methods declared here
canonicalize_activity	function	—
TrajectoryRun	class	—
ActivityStatistics	class	—
TransitionStatistics	class	—
TrajectoryVariant	class	occurrences
TrajectoryProcess	class	rework_rate, variant_reuse
mine_trajectory_process	function	—

mari_kit.trajectories.rubrics

Task-adaptive rubric values and confidence-visible trajectory scoring.

Module source

Public definition	Kind	Public methods declared here
RubricDimension	class	—
TrajectoryRubric	class	—
RubricAssessment	class	—
RubricScore	class	—
parse_trajectory_rubric	function	—
parse_rubric_assessments	function	—
score_trajectory_rubric	function	—

mari_kit.trajectories.sampling

Diversity-aware sampling for inspecting large trajectory corpora.

Module source

Public definition	Kind	Public methods declared here
TrajectorySample	class	—
TrajectorySamplingResult	class	—
select_diverse_trajectories	function	—

mari_kit.trajectories.traces

Loss-bounded GenAI trace normalization and structural integrity checks.

Module source

Public definition	Kind	Public methods declared here
TraceEventKind	class	—
TraceLink	class	—
TraceEvent	class	duration
NormalizedTrace	class	—
TraceIntegrityCode	class	—
TraceIntegrityIssue	class	—
TraceIntegrityReport	class	valid
normalize_genai_trace	function	—
inspect_trace_integrity	function	—
project_tool_trajectory	function	—

mari_kit.trajectories.workflows

Match reviewed intents and safely reuse their knowledge dependencies.

Module source

Public definition	Kind	Public methods declared here
ReviewedWorkflow	class	—
ReviewedWorkflowMatch	class	—
ReviewedWorkflowIndex	class	—
CacheDecisionReason	class	—
WorkflowAction	class	—
WorkflowDecisionReason	class	—
WorkflowPolicy	class	—
WorkflowDecision	class	cached_answer
CacheDecision	class	reusable
build_reviewed_workflow_index	function	—
match_reviewed_workflow	function	—
workflow_freshness	function	—
match_cached_response	function	—
decide_reviewed_workflow	function	—
start_speculative_retrieval	function	—

Agent events and evaluation

mari_kit.agents.evaluation

Small, framework-neutral checks over normalized agent events.

Module source

Public definition	Kind	Public methods declared here
EvalResult	class	—
evaluate_tools	function	—
evaluate_outcome	function	—

mari_kit.agents.events

Small event values for evaluating runs produced by an agent framework.

Module source

Public definition	Kind	Public methods declared here
EventKind	class	—
AgentEvent	class	—

Conformance utilities

mari_kit.testing.connectors

Storage-independent connector contract checks.

Module source

Public definition	Kind	Public methods declared here
ConnectorContractReport	class	—
check_connector_contract	function	—
check_streaming_connector_contract	function	—

mari_kit.testing.contracts

Behavioral checks for application-owned boundary implementations.

Module source

Public definition	Kind	Public methods declared here
assert_clock_conforms	function	—
assert_serializer_conforms	function	—
assert_authorizer_conforms	function	—
assert_index_authorization_conforms	function	—

mari_kit.testing.stores

Reusable conformance checks for artifact-store adapters.

Module source

Public definition	Kind	Public methods declared here
assert_artifact_store_conforms	function	—
assert_document_store_conforms	function	—

Conversations and topics

mari_kit.conversation_knowledge

Compile conversations and observable trajectories into searchable evidence.

Module source

Public definition	Kind	Public methods declared here
KnowledgeEvent	class	—
KnowledgeEpisode	class	—
segment_conversations	function	—
split_for_output	function	—
trajectory_events	function	—
EventEvidence	class	—
KnowledgeClaim	class	—
EpisodeKnowledge	class	cache_key, retrieval_units
merge_chunk_knowledge	function	—
extraction_request	function	—
parse_episode_knowledge	function	—
DroppedClaim	class	—
ResolvedOutput	class	—
resolve_evidence	function	—
EpisodeFailure	class	—
CompilationResult	class	—
compile_episodes	function	—
evidence_context	function	—
topic_history	function	—

mari_kit.conversation_topics

Semantic conversation grouping and incremental, evidence-bound topic briefs.

Module source

Public definition	Kind	Public methods declared here
event_vector_key	function	—
knowledge_vector_key	function	—
semantic_conversation_episodes	function	—
TopicGroup	class	scope, topic_id, revision
semantic_topic_groups	function	—
ClaimLink	class	—
topic_request	function	—
TopicBrief	class	cache_key, retrieval_units
parse_topic_brief	function	—
topic_dependencies	function	—
TopicCompilation	class	—
compile_topic_briefs	function	—
topic_evidence_context	function	—

Documents and source structure

mari_kit.documents

Canonical structured-document and code-graph values.

Module source

Public definition	Kind	Public methods declared here
ParsedBlock	class	—
ParsedDocument	class	—
ParsedField	class	—
ParsedRecord	class	—
BoundingBox	class	—
RegionKind	class	—
TableCell	class	—
DocumentRegion	class	searchable_text
RegionRepresentation	class	—
RegionEvidence	class	—
StructuredDocument	class	—
CodeSymbolKind	class	—
CodeEdgeKind	class	—
CodeSymbol	class	—
CodeEdge	class	—
CodeReference	class	—
impacted_symbols	function	—

mari_kit.documents.atoms

Stable semantic atoms, temporal versions, and incremental refresh plans.

Module source

Public definition	Kind	Public methods declared here
AtomKind	class	—
SemanticAtom	class	contextual_text, to_revision_ref, located_evidence
TemporalAtom	class	—
AtomDiffAlgorithm	class	—
AtomModification	class	—
AtomAlignment	class	—
AtomRefreshPlan	class	reuse_embeddings, embed_atom_ids
normalize_atom_text	function	—
semantic_atoms	function	—
content_defined_spans	function	—
align_atoms	function	—
plan_atom_refresh	function	—
active_atoms	function	—

mari_kit.documents.code

Concrete, dependency-free Python structure extraction.

Module source

Public definition	Kind	Public methods declared here
CodeParseResult	class	succeeded
parse_python	function	—

mari_kit.documents.coordinates

Explicit conversion between character and encoded-byte source offsets.

Module source

Public definition	Kind	Public methods declared here
SourceCoordinateMap	class	build, character_length, byte_length, to_byte, to_character, byte_span_to_characters
line_column	function	—

mari_kit.documents.dependencies

Semantic atoms as shared, scoped inputs to any Mari derivation.

Module source

Public definition	Kind	Public methods declared here
AtomDependencies	class	stamps
atom_dependencies	function	—
atom_collection_stamp	function	—

mari_kit.documents.docling

Adapt Docling’s exported document tree without importing its runtime.

Module source

Public definition	Kind	Public methods declared here
DoclingAdaptation	class	—
adapt_docling_json	function	—

mari_kit.documents.email

RFC 822 email parsing with quoted-reply segmentation.

Module source

Public definition	Kind	Public methods declared here
FragmentKind	class	—
Fragment	class	—
BulkSignal	class	is_bulk
EmailMessage	class	participants
subject_key	function	—
normalize_address	function	—
classify_lines	function	—
split_fragments	function	—
parse_email	function	—

mari_kit.documents.email_threads

Reconstruct email threads from headers, quoted text and subject evidence.

Module source

Public definition	Kind	Public methods declared here
LinkReason	class	—
ThreadLink	class	—
EmailThread	class	subject, participants
thread_emails	function	—
email_events	function	—

mari_kit.documents.html

Small HTML-to-block adapter with raw source spans and table topology.

Module source

Public definition	Kind	Public methods declared here
parse_html	function	—

mari_kit.documents.markdown

Dependency-free structural Markdown parsing with exact character spans.

Module source

Public definition	Kind	Public methods declared here
parse_markdown	function	—

mari_kit.documents.records

Delimited and JSON Lines records with exact source coordinates.

Module source

Public definition	Kind	Public methods declared here
parse_delimited	function	—
parse_json_lines	function	—
parse_json_array	function	—

mari_kit.documents.results

Parser-neutral results, issues, and stable source identities.

Module source

Public definition	Kind	Public methods declared here
ParseIssueSeverity	class	—
ParseIssue	class	—
ParseResult	class	succeeded
stable_source_id	function	—

mari_kit.documents.sequence_diff

Myers and patience sequence alignment with coalesced edit spans.

Module source

Public definition	Kind	Public methods declared here
DiffKind	class	—
DiffSpan	class	—
myers_diff	function	—
patience_diff	function	—

mari_kit.documents.tables

Table topology normalization without format or domain assumptions.

Module source

Public definition	Kind	Public methods declared here
NormalizedTable	class	—
normalize_table	function	—

mari_kit.documents.validation

Structural validation for parser-neutral document values.

Module source

Public definition	Kind	Public methods declared here
StructureViolation	class	—
StructureValidationReport	class	conforms
validate_parsed_document	function	—
validate_structured_document	function	—
RegionEvidenceResolution	class	valid
validate_region_evidence	function	—

Evaluation and statistics

mari_kit.evaluation.cases

Normalized cases and adapters for public knowledge-system corpora.

Module source

Public definition	Kind	Public methods declared here
RetrievalCase	class	—
EvidenceCase	class	—
MemoryCase	class	—
load_beir_cases	function	—
load_fever_cases	function	—
load_longmemeval_cases	function	—
group_memory_cases	function	—

mari_kit.evaluation.catalog

Read and validate Mari benchmark corpus catalogs.

Module source

Public definition	Kind	Public methods declared here
Corpus	class	—
CorpusCatalog	class	for_task
load_catalog	function	—
catalog_rows	function	—

mari_kit.evaluation.gates

Hard regression gates for benchmark reports.

Module source

Public definition	Kind	Public methods declared here
GateMode	class	—
MetricGate	class	—
GateCheck	class	—
GateReport	class	—
regression_gate	function	—

mari_kit.evaluation.graph

Component metrics for graph construction and selection.

Module source

Public definition	Kind	Public methods declared here
LinkPredictionMetrics	class	—
PathMetrics	class	—
evaluate_path	function	—
evaluate_link_prediction	function	—
evaluate_subgraph	function	—
ClusteringMetrics	class	—
GraphContextMetrics	class	—
GroupCoverage	class	—
GroupedCoverageMetrics	class	—
evaluate_grouped_coverage	function	—
evaluate_graph_context	function	—
evaluate_clustering	function	—

mari_kit.evaluation.metrics

Deterministic metrics for retrieval and labeled decisions.

Module source

Public definition	Kind	Public methods declared here
RetrievalMetrics	class	—
ClassificationMetrics	class	—
SetMetrics	class	—
TaskOutcome	class	—
TaskOutcomeComparison	class	—
compare_task_outcomes	function	—
set_metrics	function	—
boundary_metrics	function	—
reciprocal_rank	function	—
ndcg_at_k	function	—
evaluate_retrieval	function	—
classification_metrics	function	—

mari_kit.evaluation.runs

Reproducibility metadata for persisted evaluation outputs.

Module source

Public definition	Kind	Public methods declared here
EvaluationRun	class	—

mari_kit.evaluation.statistics

Paired uncertainty, slice summaries, reliability, and repeated-trial metrics.

Module source

Public definition	Kind	Public methods declared here
PairedMetric	class	—
PairedMetricComparison	class	—
SliceComparison	class	—
ReviewLabel	class	—
ReviewReliability	class	—
RepeatedTrialResult	class	—
PassKSummary	class	—
compare_paired_metrics	function	—
evaluate_slices	function	—
summarize_review_reliability	function	—
summarize_repeated_trials	function	—

mari_kit.evaluation.suites

Machine-readable mappings from papers and APIs to benchmark contracts.

Module source

Public definition	Kind	Public methods declared here
BenchmarkSuite	class	—
BenchmarkSuiteCatalog	class	get, for_paper
load_suite_catalog	function	—

Governance policies

mari_kit.governance

Trust, authority, scope, and retention policy primitives.

Module source

Public definition	Kind	Public methods declared here
TrustLevel	class	—
WriteChannel	class	—
ContentInterpretation	class	—
WriteDisposition	class	—
MemoryWrite	class	—
WriteDecision	class	—
evaluate_write	function	—
inherit_taints	function	—
SourceAssertion	class	—
AuthorityPolicy	class	—
AssertionResolution	class	—
resolve_assertions	function	—
ScopeGrant	class	—
ScopePolicy	class	allows
PromotionProposal	class	—
propose_promotion	function	—
RetentionRecord	class	—
RetentionPolicy	class	—
RetentionActionKind	class	—
RetentionAction	class	—
RetentionPlan	class	—
PurposeDecision	class	—
evaluate_purpose	function	—
plan_retention	function	—

Graph algorithms and interchange

mari_kit.graph.adjacency

Adjacency projections over caller-owned edge iterables.

Module source

Public definition	Kind	Public methods declared here
build_adjacency	function	—

mari_kit.graph.centrality

Reference centrality algorithms over neighbor callbacks.

Module source

Public definition	Kind	Public methods declared here
degree_centrality	function	—
closeness_centrality	function	—
betweenness_centrality	function	—
hits	function	—

mari_kit.graph.communities

Deterministic graph communities and model-injected corpus aggregation.

Module source

Public definition	Kind	Public methods declared here
CommunityPartition	class	—
CommunityReport	class	—
leiden_communities	function	—
build_community_reports	function	—
map_reduce_reports	function	—

mari_kit.graph.construction

Deterministic blocking and threshold clustering for caller-owned entities.

Module source

Public definition	Kind	Public methods declared here
BlockedPair	class	—
explain_candidate_pairs	function	—
candidate_pairs	function	—
MatchLink	class	—
ClusterResult	class	—
EvidenceBoundCandidate	class	—
EvidenceResolution	class	—
ClusterDiagnostic	class	—
resolve_relation_evidence	function	—
bind_relation_evidence	function	—
cluster_matches	function	—
inspect_clusters	function	—

mari_kit.graph.diagnostics

Exact graph diffs and policy-neutral structural observations.

Module source

Public definition	Kind	Public methods declared here
GraphDiff	class	—
graph_diff	function	—
RecordChange	class	—
RecordDiff	class	—
FieldChange	class	—
diff_record_fields	function	—
diff_records	function	—
GraphQualityReport	class	—
inspect_graph_quality	function	—

mari_kit.graph.evidence_projection

Many-to-many projections from graph values to evidence artifacts.

Module source

Public definition	Kind	Public methods declared here
GraphEvidenceAssociation	class	—
GraphEvidenceProjection	class	artifact_refs
project_graph_evidence	function	—

mari_kit.graph.interop

Transient graph projections and loss-visible interchange encoders.

Module source

Public definition	Kind	Public methods declared here
ProjectionEdge	class	—
GraphProjection	class	—
InterchangeReport	class	—
EncodedGraph	class	—
to_graphml	function	—
to_json_ld	function	—
to_networkx	function	—
from_networkx	function	—
to_rdflib	function	—
to_pyg_data	function	—

mari_kit.graph.provenance

Bounded lineage and taint traversal over arbitrary artifact IDs.

Module source

Public definition	Kind	Public methods declared here
LineageVisit	class	—
LineageTrace	class	—
LineageEdge	class	—
LineageEdgeTrace	class	—
trace_lineage_edges	function	—
trace_lineage	function	—
propagated_taints	function	—

mari_kit.graph.resolution

Fellegi–Sunter entity-resolution scoring with explicit review bands.

Module source

Public definition	Kind	Public methods declared here
FieldAgreement	class	—
ResolutionDecision	class	—
ResolutionResult	class	—
fellegi_sunter_score	function	—
resolve_entity	function	—

mari_kit.graph.similarity

Topology-only link-candidate scoring.

Module source

Public definition	Kind	Public methods declared here
LinkScore	class	—
score_link_candidates	function	—
simrank_scores	function	—

mari_kit.graph.subgraphs

Budgeted selection over caller-owned graph topology.

Module source

Public definition	Kind	Public methods declared here
SubgraphSelection	class	—
bounded_seed_expansion	function	—
prize_guided_subgraph	function	—

mari_kit.graph.temporal

Append-only bi-temporal fact operations.

Module source

Public definition	Kind	Public methods declared here
TemporalFact	class	—
close_transaction	function	—
query_temporal_facts	function	—

mari_kit.graph.temporal_tools

Half-open interval operations independent of graph representation.

Module source

Public definition	Kind	Public methods declared here
TimeInterval	class	—
interval_contains	function	—
intervals_overlap	function	—
close_interval	function	—
interval_intersection	function	—
TemporalJoinPair	class	—
IntervalOverlapPair	class	—
grouped_interval_overlaps	function	—
temporal_join	function	—

mari_kit.graph.traversal

Graph traversal over caller-owned node IDs and neighbor callbacks.

Module source

Public definition	Kind	Public methods declared here
TraversalVisit	class	—
TraversalResult	class	nodes
PathResult	class	found
CycleResult	class	—
PredecessorEntry	class	—
PredecessorDAG	class	—
EdgeTraversalVisit	class	—
RejectedTraversalEdge	class	—
EdgeTraversalResult	class	—
traverse_edges	function	—
predecessor_dag	function	—
breadth_first	function	—
k_hop_nodes	function	—
shortest_path	function	—
connected_components	function	—
directed_cycles	function	—

Incremental maintenance

mari_kit.aggregates

Reversible, keyed delta aggregates with exact arithmetic for numeric sums.

Module source

Public definition	Kind	Public methods declared here
DeltaReducer	class	zero, change, finish
DeltaAggregate	class	apply, value, contributions, stamp
CountReducer	class	zero, change, finish
VectorTotals	class	—
WeightedVectorReducer	class	zero, change, finish
LexicalTotals	class	—
LexicalStatisticsReducer	class	zero, change, finish
MembershipReducer	class	zero, change, finish

mari_kit.dependencies

Shared dependency receipts and incremental planning for derived material.

Module source

Public definition	Kind	Public methods declared here
dependency_fingerprint	function	—
DependencyKey	class	key, from_revision
DependencyStamp	class	from_revision
DerivationSpec	class	fingerprint
MaterializationReceipt	class	—
materialization_receipt	function	—
UpdateAction	class	—
DependencyUpdate	class	—
DependencyUpdatePlan	class	ready, reusable
plan_dependency_updates	function	—

mari_kit.grouping

Deterministic overlap lineage across episode/topic/community regrouping.

Module source

Public definition	Kind	Public methods declared here
GroupIdentity	class	—
GroupAssignment	class	—
GroupReconciliation	class	—
reconcile_groups	function	—

mari_kit.incremental

Indexed, process-local dependency planning. Persistence remains host-owned.

Module source

Public definition	Kind	Public methods declared here
DependencyIndex	class	apply, plan

mari_kit.selections

Conservative selection dependencies, including previously unseen members.

Module source

Public definition	Kind	Public methods declared here
SelectionSpec	class	output
SelectionPlan	class	—
SelectionReceipt	class	consumer_inputs
plan_selection	function	—
complete_selection	function	—

Knowledge and memory

mari_kit.knowledge.admission

Evidence and safety admission before memory reconciliation.

Module source

Public definition	Kind	Public methods declared here
AdmissionDisposition	class	—
AdmissionSignals	class	—
AdmissionThresholds	class	—
AdmissionDecision	class	—
admit_candidate	function	—

mari_kit.knowledge.aggregation

Policy-neutral scalar uncertainty and weighted aggregation utilities.

Module source

Public definition	Kind	Public methods declared here
ScalarEstimate	class	—
WeightedObservation	class	—
WeightedContribution	class	—
WeightedMean	class	—
weighted_mean	function	—
wilson_proportion	function	—

mari_kit.knowledge.answers

Grounded answer generation and reusable FAQ candidate mining.

Module source

Public definition	Kind	Public methods declared here
AnswerDisposition	class	—
GroundedAnswer	class	knowledge_dependencies
parse_answer	function	—
parse_answer_candidates	function	—

mari_kit.knowledge.artifacts

Generic immutable envelopes for governed knowledge artifacts.

Module source

Public definition	Kind	Public methods declared here
ArtifactRef	class	key, to_revision_ref
ReviewState	class	—
Activity	class	—
KnowledgeArtifact	class	ref, derivation_spec

mari_kit.knowledge.assertions

Evidence-bearing temporal assertions and caller-selected update plans.

Module source

Public definition	Kind	Public methods declared here
Assertion	class	—
group_assertions	function	—
AssertionUpdateKind	class	—
AssertionUpdatePlan	class	—
plan_assertion_update	function	—
valid_at	function	—
all_of	function	—
any_of	function	—

mari_kit.knowledge.changesets

Cross-document edit validation with previews and inverse operations.

Module source

Public definition	Kind	Public methods declared here
PositionedKnowledgeEdit	class	—
KnowledgeChangeEntry	class	—
ChangesetIssueKind	class	—
ChangesetIssue	class	—
KnowledgeChangeset	class	valid
validate_knowledge_changeset	function	—

mari_kit.knowledge.citations

Inspect citation declarations against explicit evidence event ordering.

Module source

Public definition	Kind	Public methods declared here
OwnedEvidenceRef	class	—
CitationEventKind	class	—
CitationEvent	class	—
CitationDeclarationStatus	class	—
CitationDeclarationReport	class	—
inspect_citation_declarations	function	—

mari_kit.knowledge.compaction

Plan conversation evidence retention without rewriting stored history.

Module source

Public definition	Kind	Public methods declared here
CompactionEvidence	class	key
CompactionExclusion	class	—
CompactionTrace	class	—
EvidenceGroup	class	—
EvidenceCompactionPlan	class	—
plan_evidence_compaction	function	—

mari_kit.knowledge.consolidation

Budgeted, model-neutral consolidation and promotion planning.

Module source

Public definition	Kind	Public methods declared here
PromotionSignal	class	—
ConsolidationBudget	class	—
ConsolidationPlan	class	—
plan_consolidation	function	—

mari_kit.knowledge.decisions

Product decision extraction with source evidence.

Module source

Public definition	Kind	Public methods declared here
parse_decisions	function	—

mari_kit.knowledge.derivations

Provenance checks that keep derived knowledge from becoming fresh evidence.

Module source

Public definition	Kind	Public methods declared here
KnowledgeOrigin	class	—
DerivationInput	class	—
KnowledgeDerivation	class	—
DerivationIssueKind	class	—
DerivationIssue	class	—
DerivationReport	class	valid
inspect_knowledge_derivations	function	—

mari_kit.knowledge.evidence

Artifact-neutral evidence resolution and exact-material validation.

Module source

Public definition	Kind	Public methods declared here
ArtifactEvidence	class	—
LocatedEvidenceIssue	class	—
LocatedEvidenceReport	class	accepted
document_evidence_ref	function	—
EvidenceIssueKind	class	—
EvidenceIssue	class	—
EvidenceValidationReport	class	accepted
validate_artifact_evidence	function	—
validate_located_evidence	function	—

mari_kit.knowledge.excerpt

Extract a clean prose preview from Markdown or HTML knowledge content.

Module source

Public definition	Kind	Public methods declared here
excerpt	function	—

mari_kit.knowledge.experience

Turn trajectory evidence and expert feedback into reviewable knowledge changes.

Module source

Public definition	Kind	Public methods declared here
TrajectoryEvidence	class	—
KnowledgeUse	class	—
KnowledgeUseManifest	class	—
ExpertFeedback	class	—
FeedbackRootCause	class	—
FeedbackDiagnosis	class	—
ExperienceKnowledgeKind	class	—
ExperienceKnowledgeCandidate	class	—
KnowledgeFile	class	—
KnowledgeStructureIssueKind	class	—
KnowledgeStructureIssue	class	—
KnowledgeStructureReport	class	valid
KnowledgeEdit	class	—
KnowledgeChangeProposal	class	—
ChangeEvaluation	class	targeted_delta, regression_delta
build_knowledge_use_manifest	function	—
parse_feedback_diagnoses	function	—
parse_experience_knowledge	function	—
inspect_knowledge_structure	function	—
parse_knowledge_change	function	—

mari_kit.knowledge.fact_scans

Content-addressed, passage-level planning for incremental fact extraction.

Module source

Public definition	Kind	Public methods declared here
pending_fact_sections	function	—
fact_scan_revisions	function	—

mari_kit.knowledge.facts

Fact extraction and evidence-based claim assessment.

Module source

Public definition	Kind	Public methods declared here
normalize_claim	function	—
parse_facts	function	—
FactAssessment	class	—
parse_claim_assessments	function	—
deduplicate_fact_candidates	function	—

mari_kit.knowledge.freshness

Fine-grained dependency and change-impact decisions for governed knowledge.

Module source

Public definition	Kind	Public methods declared here
FreshnessStatus	class	—
KnowledgeDependency	class	dependency_id
RevisionChange	class	dependency_id
FreshnessReport	class	reusable
ReferenceRevisionChange	class	—
ReferenceFreshnessReport	class	reusable
assess_revision_refs	function	—
evidence_dependencies	function	—
assess_dependencies	function	—
assess_freshness	function	—
impacted_artifacts	function	—

mari_kit.knowledge.glossary

Evidence-backed glossary harvesting.

Module source

Public definition	Kind	Public methods declared here
parse_glossary	function	—

mari_kit.knowledge.links

Explicit-reference parsing and caller-scored semantic link selection.

Module source

Public definition	Kind	Public methods declared here
LinkCandidate	class	—
extract_explicit_links	function	—
derive_links	function	—

mari_kit.knowledge.multimodal

Revision-bound asset selection; byte loading and message rendering stay external.

Module source

Public definition	Kind	Public methods declared here
EvidenceAsset	class	—
AssetBinding	class	—
RetainedAsset	class	—
AssetSelection	class	—
select_evidence_assets	function	—

mari_kit.knowledge.mutations

Validated, storage-neutral memory mutation plans.

Module source

Public definition	Kind	Public methods declared here
MemoryOperation	class	—
MemoryDecision	class	—
MemoryMutation	class	—
MemoryMutationPlan	class	writes, deletes, noops
plan_memory_mutations	function	—
apply_memory_mutations	function	—

mari_kit.knowledge.observations

Immutable records of how knowledge moved through one observed task.

Module source

Public definition	Kind	Public methods declared here
KnowledgeObservationStage	class	—
KnowledgeObservation	class	—
ObservationIssueKind	class	—
ObservationIssue	class	—
KnowledgeObservationReport	class	valid
inspect_knowledge_observations	function	—

mari_kit.knowledge.refinement

Bounded, exact-substring document refinement proposals.

Module source

Public definition	Kind	Public methods declared here
RefinementEdit	class	—
parse_refinement	function	—

mari_kit.knowledge.research

Deterministic memory organization and retrieval policies from research.

Module source

Public definition	Kind	Public methods declared here
NoteEvolutionPlan	class	—
plan_note_evolution	function	—
MemorySignal	class	—
SalientMemory	class	—
rank_salient_memories	function	—

mari_kit.knowledge.scoring

Deterministic scores derived from validated evidence, never model opinion.

Module source

Public definition	Kind	Public methods declared here
grounding_coverage	function	—

mari_kit.knowledge.sections

Deterministic Markdown sections for fine-grained knowledge dependencies.

Module source

Public definition	Kind	Public methods declared here
document_sections	function	—
section_revisions	function	—

mari_kit.knowledge.segmentation

Topic-aware segmentation for bounded memory consolidation.

Module source

Public definition	Kind	Public methods declared here
TopicSegment	class	—
hybrid_topic_segments	function	—

mari_kit.knowledge.summaries

Digest summarization and evidence-linked impact assessment.

Module source

Public definition	Kind	Public methods declared here
DigestTopic	class	—
DigestSummary	class	—
ImpactAssessment	class	—
parse_digest	function	—
parse_impact	function	—

mari_kit.knowledge.tags

Workspace-defined document tags and retrieval behavior.

Module source

Public definition	Kind	Public methods declared here
normalize_tag	function	—
TagDefinition	class	—
TagAssignments	class	tags_for
assign_tags	function	—
search_weight	function	—

mari_kit.knowledge.versions

Grouping and representative proposals for immutable manifestations.

Module source

Public definition	Kind	Public methods declared here
VersionFamily	class	—
resolve_version_families	function	—

Platform composition and reference storage

mari_kit.platform.compiler

Constraint-first search over externally evaluated knowledge configurations.

Module source

Public definition	Kind	Public methods declared here
ObjectiveDirection	class	—
MetricObjective	class	—
CompileCandidate	class	—
CompileResult	class	—
compile_configurations	function	—

mari_kit.platform.pipeline

Small deterministic pipeline runner with visible stage failures.

Module source

Public definition	Kind	Public methods declared here
Stage	class	fingerprint
StageTrace	class	—
PipelineResult	class	succeeded
Pipeline	class	run

mari_kit.platform.projections

Ordered event replay into disposable deterministic projections.

Module source

Public definition	Kind	Public methods declared here
KnowledgeEvent	class	—
ProjectionBuild	class	—
replay_projection	function	—

mari_kit.platform.stores

Reference in-memory store for revision and point-in-time conformance.

Module source

Public definition	Kind	Public methods declared here
RevisionConflict	class	—
StoreCapabilities	class	—
ArtifactStore	class	capabilities, commit, get, at_time, history
DocumentStore	class	capabilities, commit, get, resolve, history
InMemoryDocumentStore	class	capabilities, commit, get, resolve, history
InMemoryArtifactStore	class	capabilities, commit, get, at_time, history

mari_kit.platform.views

Dependency-aware materialized-view refresh planning.

Module source

Public definition	Kind	Public methods declared here
MaterializedView	class	—
ViewMaterialization	class	—
ViewRefreshTask	class	—
ViewRefreshPlan	class	—
plan_view_refresh	function	—

mari_kit.portability

Deterministic in-memory knowledge bundles and import planning.

Module source

Public definition	Kind	Public methods declared here
KnowledgeBundle	class	—
BundleVerification	class	—
BundleImportPlan	class	—
export_bundle	function	—
verify_bundle	function	—
plan_bundle_import	function	—

Retrieval and context

mari_kit.lifecycle

Framework-neutral context lifecycle contracts.

Module source

Public definition	Kind	Public methods declared here
LifecyclePhase	class	—
InterventionDisposition	class	—
ContextRequest	class	—
LifecycleEvent	class	—
ContextIntervention	class	text
select_intervention	function	—
ContextProvider	class	before_model, after_model, after_tool, end_session

mari_kit.retrieval.atoms

Atom-hit aggregation and retrieval-time context assembly.

Module source

Public definition	Kind	Public methods declared here
AtomVectorHit	class	—
ParentVectorHit	class	—
aggregate_atom_hits	function	—
MultiVectorSection	class	matrix
maxsim_section_score	function	—
DynamicContextChunk	class	—
DynamicContextResult	class	—
assemble_atom_context	function	—

mari_kit.retrieval.composition

Typed handoffs from ranked IDs to artifact-neutral context material.

Module source

Public definition	Kind	Public methods declared here
RetrievalUnit	class	from_atom
HydratedHit	class	—
hydrate_hits	function	—
ContextItem	class	—
ContextSelectionTrace	class	—
ContextSelection	class	visible_refs, render
DiverseSelectionTrace	class	—
DiverseCandidateEvaluation	class	—
DiverseSelectionRound	class	—
DiverseContextSelection	class	visible_refs, render
select_context	function	—
select_context_diverse	function	—

mari_kit.retrieval.context

Auditable whole-excerpt context packing under explicit budgets.

Module source

Public definition	Kind	Public methods declared here
ContextCandidate	class	—
ContextBudget	class	—
ContextExclusion	class	—
ContextTrace	class	—
ContextEnvelope	class	—
assemble_context	function	—

mari_kit.retrieval.contextual

Revision-bound contextual representations that preserve original source text.

Module source

Public definition	Kind	Public methods declared here
ContextualRepresentation	class	—
parse_chunk_context	function	—
contextual_representation	function	—
pool_token_spans	function	—

mari_kit.retrieval.contradiction

Sparse embedding operations for efficient contradiction retrieval.

Module source

Public definition	Kind	Public methods declared here
hoyer_difference_sparsity	function	—
SparseContradictionScore	class	—
sparse_contradiction_score	function	—
SparseContradictionCandidate	class	—
SparseContradictionHit	class	—
rank_sparse_contradictions	function	—
sparse_contrastive_losses	function	—

mari_kit.retrieval.decisions

Composable filtering and cross-stage candidate decision traces.

Module source

Public definition	Kind	Public methods declared here
FilterPredicate	class	—
FilterDecision	class	—
FilterResult	class	—
filter_with_reasons	function	—
CandidateDecision	class	—
CandidateHistory	class	append, for_candidate
CandidateHistoryDiagnostics	class	—
diagnose_candidate_history	function	—
decisions_from_filter	function	—
decisions_from_context	function	—

mari_kit.retrieval.disclosure

Conditional and progressive disclosure over caller-owned knowledge.

Module source

Public definition	Kind	Public methods declared here
DisclosureOperator	class	—
DisclosureCondition	class	—
DisclosureRule	class	—
DisclosureDecision	class	—
evaluate_disclosure	function	—
DisclosureLevel	class	—
DisclosureUnit	class	—
DisclosureManifestIssueKind	class	—
DisclosureManifestIssue	class	—
ProgressiveDisclosureManifest	class	—
DisclosureManifestReport	class	valid
DisclosureSelection	class	—
inspect_disclosure_manifest	function	—
expand_disclosure	function	—

mari_kit.retrieval.fusion

Storage-neutral rank fusion and diversity-aware selection.

Module source

Public definition	Kind	Public methods declared here
RankContribution	class	—
FusedHit	class	—
DiversifiedHit	class	—
reciprocal_rank_fusion	function	—
maximal_marginal_relevance	function	—

mari_kit.retrieval.graph

Deterministic graph propagation and passage projection for retrieval.

Module source

Public definition	Kind	Public methods declared here
GraphHit	class	—
PageRankResult	class	—
personalized_pagerank	function	—
project_graph_scores	function	—

mari_kit.retrieval.index

Immutable in-memory MUVERA index built from arbitrary embedding vectors.

Module source

Public definition	Kind	Public methods declared here
MuveraIndex	class	—
RetrievalHit	class	—
build_index	function	—
search_index	function	—

mari_kit.retrieval.indexes

Dependency-light reference indexes with authorization-aware search.

Module source

Public definition	Kind	Public methods declared here
IndexHit	class	—
IndexOperation	class	—
IndexDelta	class	—
BM25TermContribution	class	—
BM25Explanation	class	—
ArtifactIndexHit	class	—
ArtifactBM25Explanation	class	—
RevisionIndexHit	class	—
RevisionBM25Explanation	class	—
ArtifactIndexDelta	class	—
RevisionIndexDelta	class	—
DenseFlatIndex	class	search
SparseVectorIndex	class	search
BM25Index	class	search, explain, with_deltas
ArtifactBM25Index	class	search, explain, with_deltas
RevisionBM25Index	class	search, explain, with_deltas
HNSWIndex	class	search
IVFPQIndex	class	search

mari_kit.retrieval.maxsim

Exact late-interaction MaxSim scoring.

Module source

Public definition	Kind	Public methods declared here
exact_maxsim	function	—

mari_kit.retrieval.muvera

Data-oblivious MUVERA fixed-dimensional encodings.

Module source

Public definition	Kind	Public methods declared here
FDEConfig	class	partitions, dimension
projection_parameters	function	—
encode_fde	function	—

mari_kit.retrieval.polarquant

Deterministic 0.5-bit block-2 PolarQuant encoding for MUVERA FDEs.

Module source

Public definition	Kind	Public methods declared here
PolarCodec	class	—
train_polar	function	—
encode_polar	function	—
polar_scores	function	—

mari_kit.retrieval.research

Model-neutral execution boundaries derived from retrieval research.

Module source

Public definition	Kind	Public methods declared here
hypothetical_document_embedding	function	—
SummaryTreeNode	class	—
SummaryTree	class	—
build_summary_tree	function	—
CorrectiveAction	class	—
CorrectiveRetrievalPlan	class	—
plan_corrective_retrieval	function	—
ActiveRetrievalQuery	class	—
plan_active_retrieval	function	—
TreeWalk	class	—
walk_summary_tree	function	—
CompressionSentence	class	—
CompressionResult	class	—
selective_compression	function	—

mari_kit.retrieval.serialization

Provisional storage-neutral byte serialization for immutable indexes.

Module source

Public definition	Kind	Public methods declared here
serialize_index	function	—
deserialize_index	function	—

mari_kit.retrieval.structure

Section-aware context windows with exact retained spans and provenance.

Module source

Public definition	Kind	Public methods declared here
StructuredContextItem	class	—
ContextHit	class	—
ContextExpansionPolicy	class	—
ContextFragment	class	—
ExpandedContext	class	page_numbers
ContextExpansionResult	class	—
context_items_from_atoms	function	—
context_items_from_document	function	—
expand_structured_context	function	—

mari_kit.retrieval.sufficiency

Evidence requirements, context sufficiency, and retrieval-gap proposals.

Module source

Public definition	Kind	Public methods declared here
InformationRequirement	class	—
RequirementStatus	class	—
RequirementAssessment	class	—
SufficiencyReport	class	sufficient
RetrievalGapQuery	class	—
ContextUse	class	—
ContextContribution	class	—
parse_information_requirements	function	—
assess_context_sufficiency	function	—
parse_retrieval_gap_queries	function	—
evaluate_context_contribution	function	—

Selectable algorithm additions

mari_kit.algorithms.compression

Source-preserving surprisal selection and byte-stream FastCDC.

Module source

Public definition	Kind	Public methods declared here
TextSpan	class	—
SurprisalSelection	class	—
select_surprising_words	function	—
ByteChunk	class	—
fastcdc_chunks	function	—

mari_kit.algorithms.graph_retrieval

Selectable graph retrieval computations from HippoRAG 2, LightRAG, Hindsight, Graphiti, and haiku.rag. See docs/algorithm-choices.md for adaptations.

Module source

Public definition	Kind	Public methods declared here
SeedWeight	class	weight
hipporag_seed_weights	function	—
ChunkAllocation	class	—
weighted_chunk_polling	function	—
TypedLink	class	—
LinkExpansionScore	class	score
expand_typed_links	function	—
GraphRerankScore	class	—
rank_graph_distances	function	—
rank_episode_mentions	function	—
UnionCandidate	class	key
UnionScore	class	—
rank_candidate_union	function	—

mari_kit.algorithms.graphs

Optional solver-backed graph choices over caller-owned IDs and edges.

Module source

Public definition	Kind	Public methods declared here
PrizeForest	class	—
prize_collecting_forest	function	—
louvain_partition	function	—
HierarchicalCommunity	class	—
hierarchical_leiden_partition	function	—
Condensation	class	—
condense_graph	function	—
transitive_reduction_edges	function	—
cohesive_subgraph	function	—

mari_kit.algorithms.lexical

BM25 family with reference-compatible term formulas and explicit matching.

Module source

Public definition	Kind	Public methods declared here
BM25Variant	class	—
LexicalTerm	class	—
LexicalScore	class	—
BM25VariantIndex	class	explain, search

mari_kit.algorithms.linkage

Dedupe-inspired blocking, active acquisition, clustering and matching choices.

Module source

Public definition	Kind	Public methods declared here
BlockingPredicate	class	—
BlockingSelection	class	—
learn_blocking	function	—
acquire_disagreement	function	—
PairScore	class	—
LinkageCluster	class	—
greedy_matching	function	—
gazette_matching	function	—
centroid_clusters	function	—

mari_kit.algorithms.memory

Selectable MemoryOS, A-MEM and ACE-inspired pure memory policies.

Module source

Public definition	Kind	Public methods declared here
memory_heat	function	—
lfu_evictions	function	—
heat_promotions	function	—
MemoryNote	class	—
NoteUpdate	class	—
NoteChange	class	—
evolve_neighborhood	function	—
SkillRecord	class	—
SkillFeedback	class	—
SkillDecision	class	—
SkillReduction	class	—
reduce_skill_feedback	function	—

mari_kit.algorithms.search

Bounded DRIFT action search and LightRAG-inspired extraction refinement.

Module source

Public definition	Kind	Public methods declared here
DriftQuery	class	—
DriftResponse	class	—
DriftAction	class	—
DriftResult	class	—
drift_search	function	—
RefinementResult	class	—
refine_extraction	function	—

mari_kit.algorithms.subsets

Set objectives and independently selectable greedy optimizers.

Module source

Public definition	Kind	Public methods declared here
FacilityLocation	class	evaluate, marginal_gain
ProbabilisticSetCover	class	evaluate, marginal_gain
SetCover	class	—
LogDeterminant	class	evaluate, marginal_gain
GreedyMethod	class	—
SelectionStep	class	—
SubsetSelection	class	—
maximize_subset	function	—

mari_kit.algorithms.temporal

Hindsight-inspired temporal ranking, with caller-supplied dates and scores.

Module source

Public definition	Kind	Public methods declared here
recency_decay	function	—
dated_recency	function	—
temporal_proof_score	function	—

Shared values and contracts

mari_kit.contracts

Backend-neutral boundaries used to compose Mari algorithms.

Module source

Public definition	Kind	Public methods declared here
Clock	class	—
Authorizer	class	—
Serializer	class	encode, decode
KnowledgeIndex	class	search
RevisionResolver	class	—

mari_kit.errors

Typed failures which hosts can retry, display, or reject explicitly.

Module source

Public definition	Kind	Public methods declared here
ComponentError	class	—
AuthenticationFailure	class	—
TransientFailure	class	—
PermanentFailure	class	—
MalformedModelOutput	class	—
IncompleteSnapshot	class	—

mari_kit.http

Minimal injected HTTP boundary shared by connector functions.

Module source

Public definition	Kind	Public methods declared here
HttpRequest	class	—
HttpResponse	class	—

mari_kit.json

Provider-neutral JSON generation contracts and validation.

Module source

Public definition	Kind	Public methods declared here
freeze_json_value	function	—
freeze_json_mapping	function	—
canonical_json_bytes	function	—
to_json_value	function	—
require_object	function	—
require_list	function	—

mari_kit.references

Structural identities and locators shared across knowledge subsystems.

Module source

Public definition	Kind	Public methods declared here
ScopeRef	class	key
ObjectRef	class	key
RevisionRef	class	key
TextSpan	class	—
JsonPointer	class	—
RecordField	class	—
TableCell	class	—
PageRegion	class	—
MediaTimeRange	class	—
LocatedEvidence	class	—

mari_kit.schema

Small backend-neutral semantic-schema kernel.

Module source

Public definition	Kind	Public methods declared here
ConceptType	class	—
PropertyConstraint	class	constraint_id
RelationConstraint	class	constraint_id
KnowledgeSchema	class	—
SemanticRecord	class	—
SemanticRelation	class	—
SchemaViolation	class	—
ValidationReport	class	—
validate_records	function	—

mari_kit.types

Canonical immutable values shared by Mari Kit.

Module source

Public definition	Kind	Public methods declared here
canonical_document_id	function	—
parse_document_id	function	—
content_revision	function	—
SyncMode	class	—
Principal	class	—
DocumentACL	class	—
KnowledgeDocument	class	document_id, ref, ref_in
KnowledgeSection	class	—
Tombstone	class	document_id
PollRequest	class	—
PollPage	class	—
ChangeHint	class	—
Evidence	class	—
FactCandidate	class	—
DecisionCandidate	class	—
GlossaryCandidate	class	—
AnswerCandidate	class	—

Source connectors and event handling

mari_kit.connectors.airtable

Airtable base/table snapshot ingestion.

Module source

Public definition	Kind	Public methods declared here
AirtableConfig	class	—
validate_airtable	function	—
poll_airtable	function	—

mari_kit.connectors.asana

Asana project/task ingestion with offset checkpoints.

Module source

Public definition	Kind	Public methods declared here
AsanaConfig	class	—
validate_asana	function	—
poll_asana	function	—

mari_kit.connectors.box

Box folder batch ingestion with marker checkpoints.

Module source

Public definition	Kind	Public methods declared here
BoxConfig	class	—
validate_box	function	—
poll_box	function	—

mari_kit.connectors.catalog

Declarative connector catalog and raw-configuration adapters.

Module source

Public definition	Kind	Public methods declared here
ConnectorField	class	—
ConnectorDefinition	class	modes, supports, stream, config, validate, poll
connector_definition	function	—
connector_definitions	function	—

mari_kit.connectors.confluence

Confluence Cloud validation, canonical page fetch, and ordered polling.

Module source

Public definition	Kind	Public methods declared here
ConfluenceConfig	class	—
storage_to_text	function	—
validate_confluence	function	—
fetch_confluence_page	function	—
poll_confluence	function	—

mari_kit.connectors.dropbox

Dropbox native delta-cursor ingestion with explicit deleted entries.

Module source

Public definition	Kind	Public methods declared here
DropboxConfig	class	—
validate_dropbox	function	—
poll_dropbox	function	—

mari_kit.connectors.events

Pure verification and bounded change-hint parsing for provider events.

Module source

Public definition	Kind	Public methods declared here
parse_json_object	function	—
verify_hmac_sha256	function	—
verify_slack_signature	function	—
github_change_hint	function	—
confluence_change_hint	function	—
gdrive_change_hint	function	—
slack_change_hint	function	—
gitlab_change_hint	function	—
box_change_hint	function	—
microsoft_graph_change_hint	function	—
object_storage_change_hint	function	—
cloudevent_change_hint	function	—
coalesce_hints	function	—
HintCoalescingReport	class	—
coalesce_hints_ordered	function	—

mari_kit.connectors.filesystem

Stable, bounded local-filesystem batch ingestion.

Module source

Public definition	Kind	Public methods declared here
FilesystemConfig	class	—
validate_filesystem	function	—
poll_filesystem	function	—

mari_kit.connectors.github

GitHub repository, issue/PR, commit, and deletion ingestion.

Module source

Public definition	Kind	Public methods declared here
GitHubConfig	class	—
GitHubCursor	class	encode, decode
github_source_id	function	—
validate_github	function	—
list_github_repositories	function	—
github_repository	function	—
validate_github_team	function	—
github_head	function	—
github_tree	function	—
github_blob	function	—
github_issues	function	—
github_issue_comments	function	—
github_pull_request	function	—
github_pull_files	function	—
github_commits	function	—
poll_github	function	—

mari_kit.connectors.gitlab

GitLab repository batch ingestion and canonical webhook hints.

Module source

Public definition	Kind	Public methods declared here
GitLabConfig	class	—
gitlab_source_id	function	—
validate_gitlab	function	—
poll_gitlab	function	—

mari_kit.connectors.google_drive

Google Drive/Docs validation, OAuth refresh, snapshots, and Changes polling.

Module source

Public definition	Kind	Public methods declared here
GoogleDriveConfig	class	—
GoogleOAuthRefresh	class	—
GoogleDriveWatch	class	—
start_google_drive_watch	function	—
refresh_google_access_token	function	—
validate_google_drive	function	—
poll_google_drive_changes	function	—
poll_google_drive	function	—

mari_kit.connectors.jira

Jira Cloud issue ingestion with bounded ordered JQL paging.

Module source

Public definition	Kind	Public methods declared here
JiraConfig	class	—
validate_jira	function	—
poll_jira	function	—

mari_kit.connectors.json_api

Declarative, bounded batch ingestion for JSON REST collections.

Module source

Public definition	Kind	Public methods declared here
JSONAPIConfig	class	—
poll_json_api	function	—

mari_kit.connectors.linear

Linear issue/comment ingestion through its GraphQL API.

Module source

Public definition	Kind	Public methods declared here
LinearConfig	class	—
validate_linear	function	—
poll_linear	function	—

mari_kit.connectors.microsoft_drive

Microsoft Graph delta ingestion for OneDrive and SharePoint document libraries.

Module source

Public definition	Kind	Public methods declared here
MicrosoftDriveConfig	class	—
validate_microsoft_drive	function	—
poll_microsoft_drive	function	—

mari_kit.connectors.notion

Notion page search and bounded block-tree ingestion.

Module source

Public definition	Kind	Public methods declared here
NotionConfig	class	—
validate_notion	function	—
poll_notion	function	—

mari_kit.connectors.object_storage

SDK-neutral batch ingestion for S3, GCS, Azure Blob, and compatible stores.

Module source

Public definition	Kind	Public methods declared here
ObjectStoreConfig	class	—
SourceObject	class	—
ObjectListing	class	—
poll_object_store	function	—

mari_kit.connectors.protocol

Connector error and validation functions without runtime orchestration.

Module source

Public definition	Kind	Public methods declared here
ErrorKind	class	—
ConnectorMode	class	—
connector_configuration_fingerprint	function	—
configured_source_id	function	—
ValidationResult	class	—
classify_error	function	—
StreamEvent	class	—
PollingConnector	class	—
StreamingConnector	class	—
call_with_retry	function	—

mari_kit.connectors.rss

Bounded RSS and Atom feed ingestion with conditional batch polling.

Module source

Public definition	Kind	Public methods declared here
RSSConfig	class	—
validate_rss	function	—
poll_rss	function	—

mari_kit.connectors.singer

Singer/Meltano message adapter for batch connector interoperability.

Module source

Public definition	Kind	Public methods declared here
singer_pages	function	—

mari_kit.connectors.slack

Slack channel/DM history and canonical thread document ingestion.

Module source

Public definition	Kind	Public methods declared here
SlackConfig	class	—
validate_slack	function	—
fetch_slack_thread	function	—
fetch_slack_thread_by_id	function	—
poll_slack	function	—

mari_kit.connectors.streaming

Verified event ingestion and canonical refetch for streaming connectors.

Module source

Public definition	Kind	Public methods declared here
HintHydrationIssue	class	—
HintHydrationReport	class	valid
validate_hint_hydration	function	—
stream_change_hint	function	—
stream_hints	function	—
stream_pages	function	—
hydrate_hints	function	—

mari_kit.connectors.trello

Trello board/list/card snapshot ingestion.

Module source

Public definition	Kind	Public methods declared here
TrelloConfig	class	—
validate_trello	function	—
poll_trello	function	—

mari_kit.connectors.zendesk

Zendesk Guide article ingestion with bounded page checkpoints.

Module source

Public definition	Kind	Public methods declared here
ZendeskConfig	class	—
validate_zendesk	function	—
poll_zendesk	function	—

Source synchronization

mari_kit.sync.application

Transaction protocol and conformance helper for applying synchronization plans.

Module source

Public definition	Kind	Public methods declared here
SyncPlanTransaction	class	generation, upsert, delete, commit
apply_sync_plan	function	—

mari_kit.sync.planning

Side-effect-free synchronization planning with replay-safe invariants.

Module source

Public definition	Kind	Public methods declared here
ManifestEntry	class	—
SyncState	class	—
SyncPlan	class	—
document_fingerprint	function	—
plan_sync	function	—
stream_sync	function	—

Verification and evidence decisions

mari_kit.verification.consensus

Evidence-aware consensus for repeated fact assessments.

Module source

Public definition	Kind	Public methods declared here
verdict_consensus	function	—

mari_kit.verification.contradiction

Document-level self-contradiction validation and reward components.

Module source

Public definition	Kind	Public methods declared here
reasoning_sentence_references	function	—
DocumentContradictionAssessment	class	reference_coverage
validate_document_contradiction	function	—
DocumentContradictionRewards	class	—
document_contradiction_rewards	function	—

mari_kit.verification.models

Immutable results shared by verification algorithms.

Module source

Public definition	Kind	Public methods declared here
VerificationScore	class	—
ScoredAttempt	class	—
AttemptFailure	class	—
SelectionResult	class	selected_attempt
ConsensusResult	class	—

mari_kit.verification.portfolio

Bounded, auditable selection over repeated callable results.

Module source

Public definition	Kind	Public methods declared here
best_of_n	function	—

mari_kit.verification.research

Deterministic controls around model-produced RAG judgments.

Module source

Public definition	Kind	Public methods declared here
SelfRagScore	class	—
score_self_rag_candidate	function	—
AnswerSource	class	—
EvidenceNote	class	—
ChainOfNoteDecision	class	—
decide_from_evidence_notes	function	—

mari_kit.verification.scoring

Deterministic score breakdowns for grounded Mari values.

Module source

Public definition	Kind	Public methods declared here
harmonic_score	function	—
idea_completeness	function	—
score_grounded	function	—

mari_kit.verification.selection

Best-of-N selection over candidates produced by any runtime.

Module source

Public definition	Kind	Public methods declared here
numeric_score	function	—
select_best	function	—

Package facades

These modules expose imports or package metadata. Their implementation definitions are indexed at the owning module above.

• mari_kit

• mari_kit.agents

• mari_kit.algorithms

• mari_kit.connectors

• mari_kit.evaluation

• mari_kit.graph

• mari_kit.knowledge

• mari_kit.platform

• mari_kit.retrieval

• mari_kit.sync

• mari_kit.testing

• mari_kit.trajectories

• mari_kit.verification

Generation scope

The index scans every Python source file in src/mari_kit, including definitions housed in package initializers. Private modules are excluded from the public index: connectors/_shared.py, knowledge/_documents.py.

Maintainers regenerate the Markdown and machine-readable inventory together using mari-kit-landing/tools/generate_algorithm_inventory.py. The --check option reports stale outputs. Research provenance is maintained in the curated guide instead of inferred from function names.