Crate organism_runtime 

Organism Runtime

The formation guru. Given an intent, assembles teams of heterogeneous agents and runs them in Converge Engine instances.

There is ONE model: everything is a Suggestor. Adversarial review, simulation, planning, policy, optimization — all participate in the same convergence loop. No side-car pipelines.

Intent → Admit → Form (pick Suggestors) → Engine.run() → Evaluate → Learn
                   ↑                                          ↓
                   └──── reform if needed ────────────────────┘

Re-exports

pub use classifier::ProblemClassifierSuggestor;

pub use classifier::extract_classification;

pub use collaboration::CollaborationParticipant;

pub use collaboration::CollaborationRunner;

pub use collaboration::CollaborationRunnerError;

pub use collaboration::TransitionRecord;

pub use compiler::CandidateConsideration;

pub use compiler::CandidateDisposition;

pub use compiler::CatalogCompileFailure;

pub use compiler::CompiledFormationPlan;

pub use compiler::CompiledSuggestorRole;

pub use compiler::FormationCompileError;

pub use compiler::FormationCompileRequest;

pub use compiler::FormationCompiler;

pub use compiler::FormationCompilerCatalogs;

pub use compiler::RejectionReason;

pub use compiler::RoleDecision;

pub use compiler::RoleProviderAssignment;

pub use compiler::SelectionReason;

pub use execution::ExecutableSuggestorCatalog;

pub use execution::FormationExecutionRecord;

pub use execution::FormationInstantiationError;

pub use experience::ExperienceEnvelopeSink;

pub use experience::FormationExperienceObserver;

pub use factories::register_default_factories;

pub use formation::Formation;

pub use formation::FormationError;

pub use formation::FormationResult;

pub use formation::Seed;

pub use guru::CandidateScore;

pub use guru::FormationGuru;

pub use guru::GuruError;

pub use guru::GuruSelection;

pub use guru::SelectionTrace;

pub use huddle::ConsensusEvaluator;

pub use huddle::DisagreementMap;

pub use huddle::DisagreementMapper;

pub use huddle::RoundConventions;

pub use huddle::RoundStarter;

pub use huddle::RoundSynthesizer;

pub use huddle::SynthesisProducer;

pub use huddle::TerminalPredicate;

pub use outcome::BusinessQualitySignal;

pub use outcome::FormationOutcomeRecord;

pub use outcome::FormationOutcomeStatus;

pub use outcome::FormationRunScope;

pub use outcome::OutcomeProviderAssignment;

pub use outcome::OutcomeRosterMember;

pub use outcome::QualityScoreBps;

pub use outcome::QualityScoreError;

pub use readiness::BudgetProbe;

pub use readiness::CredentialProbe;

pub use readiness::GapSeverity;

pub use readiness::PackProbe;

pub use readiness::ReadinessConfirmation;

pub use readiness::ReadinessGap;

pub use readiness::ReadinessItem;

pub use readiness::ReadinessProbe;

pub use readiness::ReadinessReport;

pub use readiness::ResourceKind;

pub use readiness::check as check_readiness;

pub use registry::RegisteredCapability;

pub use registry::RegisteredPack;

pub use registry::Registry;

pub use registry::StructuralResolver;

pub use stall::RoleStallSuggestor;

pub use templates::CostHint;

pub use templates::cost_hint_for;

pub use templates::decision_formation;

pub use templates::diligence_formation;

pub use templates::evaluation_formation;

pub use templates::planning_formation;

pub use templates::research_formation;

pub use templates::standard_formation_catalog;

pub use templates::template_id_for;

pub use tournament::FormationScore;

pub use tournament::FormationTournament;

pub use tournament::TournamentError;

pub use tournament::TournamentResult;

pub use vendor_selection::VendorSelectionFlow;

pub use vendor_selection::VendorSelectionFlowSpec;

pub use vendor_selection::vendor_selection_formation_catalog;

pub use vendor_selection::vendor_selection_lifecycle;

Modules

classifier

Problem classifier Suggestor.

collaboration

Shared collaboration runtime helpers.

compiler

Formation compiler — Organism-owned selection before Converge execution.

execution

Execution bridge from compiled formation plans to runnable formations.

experience

Run-scoped experience plumbing owned by Organism.

factories

Default executable factories for the well-known catalog ids.

formation

Formations — teams of heterogeneous agents assembled to solve a problem.

guru

FormationGuru — picks formation templates from a catalog given an IntentPacket and the host’s available capabilities.

huddle

Huddle primitives — platform-level deliberation patterns.

outcome

Formation outcome records for learning and audit.

provenance

Organism runtime provenance marker.

readiness

Readiness check — validates that a resolved intent binding can actually execute.

registry

Registry — the runtime’s catalog of available packs, capabilities, and invariants.

stall

Role stall detection — Suggestor that watches one ContextKey and emits a Diagnostic recommendation when the role bound to that key is failing to contribute while convergence is otherwise progressing.

templates

Five named formation templates keyed by ProblemClass.

tournament

Formation tournament — run competing formations and learn from the comparison.

vendor_selection

Vendor-selection lifecycle fixtures for the first compiler proof wedge.

Structs

CapabilityRequirement

A capability needed by the intent.

CatalogTournamentOutcome

Result of Runtime::compile_k_and_run_tournament. Pairs each candidate’s selection rationale (decisions) with its tournament score so the audit trail can show why each roster was chosen alongside how it performed. Pair-by-index is the join key — the tournament’s FormationScore.label is {template_id}#{index} for candidate at that index.

DataContract

Named, versioned data contract carried alongside descriptor inputs and outputs. Used by the compiler to verify input/output shape compatibility between adjacent roles.

DeclarativeBinding

Builder for declaring an intent’s resource needs explicitly. This is what apps use today.

IntentBinding

The output of intent resolution. Tells the runtime what to wire up.

OrganismResult

Outcome of the full organism pipeline.

PackRequirement

A domain pack needed by the intent.

ProviderDescriptor

Descriptor of a provider candidate (LLM backend, policy engine, etc.). Carries the backend requirements it satisfies plus affinity hints used by the compiler when matching providers to Suggestor roles.

ProviderDescriptorCatalog

Registry of Provider descriptors. Append-only, ordered, serializable.

ResolutionTrace

How the resolution was performed — for traceability.

Runtime

The formation guru.

ScoredCatalogCandidate

A single scored catalog-sourced candidate. Pairs the per-role decision trace (why this roster was chosen) with the tournament score (how it performed). Indexed-paired entries are how callers join “selection rationale” to “score outcome” without parsing labels.

SuggestorDescriptor

Descriptor of a Suggestor candidate. Carries the profile snapshot plus the operating-envelope metadata the compiler needs to assemble a roster (reads, domain tags, contracts, replay, governance, backend).

SuggestorDescriptorCatalog

Registry of Suggestor descriptors. Append-only, ordered, serializable.

Enums

GovernanceClass

The governance posture of facts produced by a Suggestor.

IntentAdmissionError

Why an IntentPacket failed organism’s structural gate or Converge’s typed admission boundary.

PipelineError

Why the pipeline rejected an intent or formation.

ReplayMode

How strictly a Suggestor must be replayed under audit.

ResolutionLevel

Which resolution level produced the binding.

Traits

IntentResolver

Resolves an intent to its resource binding.