Crate meerkat_mob 

Meerkat Mob - Multi-agent orchestration runtime.

This crate provides the runtime for orchestrating multiple Meerkat agents (meerkats) as a collaborative mob. It handles spawning, wiring, lifecycle management, and shared task coordination.

Architecture

meerkat-mob is a plugin crate with a one-way dependency on the Meerkat platform. No core Meerkat crate depends on this crate.

Key types:

• MobDefinition - Describes mob structure (profiles, wiring, skills)
• MobEvent / MobEventKind - Structural state changes
• Roster - Projected view of active meerkats
• TaskBoard - Projected view of shared tasks
• MobEventStore - Persistence trait for mob events
• MobStorage - Storage bundle for a mob

Re-exports

pub use backend::MobBackendKind;

pub use backend::RuntimeBinding;

pub use definition::MobDefinition;

pub use error::MobError;

pub use event::AttributedEvent;

pub use event::MemberRef;

pub use event::MobEvent;

pub use event::MobEventKind;

pub use event::NewMobEvent;

pub use ids::BranchId;

pub use ids::FlowId;

pub use ids::FlowNodeId;

pub use ids::FrameId;

pub use ids::LoopId;

pub use ids::LoopInstanceId;

pub use ids::MeerkatId;

pub use ids::MobId;

pub use ids::ProfileName;

pub use ids::RunId;

pub use ids::StepId;

pub use ids::TaskId;

pub use launch::BudgetSplitPolicy;

pub use launch::ForkContext;

pub use launch::MemberLaunchMode;

pub use profile::Profile;

pub use profile::ProfileBinding;

pub use profile::ProfileSource;

pub use profile::SpawnTooling;

pub use profile::ToolConfig;

pub use roster::MemberState;

pub use roster::MobMemberKickoffPhase;

pub use roster::MobMemberKickoffSnapshot;

pub use roster::Roster;

pub use roster::RosterAddEntry;

pub use roster::RosterEntry;

pub use run::FailureLedgerEntry;

pub use run::FlowContext;

pub use run::FlowRunConfig;

pub use run::FrameSnapshot;

pub use run::LoopContextHistory;

pub use run::LoopIterationLedgerEntry;

pub use run::LoopSnapshot;

pub use run::MobRun;

pub use run::MobRunStatus;

pub use run::StepLedgerEntry;

pub use run::StepRunStatus;

pub use runtime::RestoreIncompatible;

pub use runtime::FlowFrameKernel;

pub use runtime::FlowFrameMutator;

pub use runtime::FlowTurnExecutor;

pub use runtime::FlowTurnOutcome;

pub use runtime::FlowTurnTicket;

pub use runtime::TimeoutDisposition;

pub use runtime::HelperOptions;

pub use runtime::HelperResult;

pub use runtime::MemberDeliveryReceipt;

pub use runtime::MemberHandle;

pub use runtime::MemberRespawnReceipt;

pub use runtime::MemberSessionRef;

pub use runtime::MobBuilder;

pub use runtime::MobEventRouterConfig;

pub use runtime::MobEventRouterHandle;

pub use runtime::MobHandle;

pub use runtime::MobMemberSnapshot;

pub use runtime::MobMemberStatus;

pub use runtime::MobPeerConnectivitySnapshot;

pub use runtime::MobRespawnError;

pub use runtime::MobSessionService;

pub use runtime::MobState;

pub use runtime::MobUnreachablePeer;

pub use runtime::PeerTarget;

pub use runtime::SpawnMemberSpec;

pub use runtime::SpawnPolicy;

pub use runtime::SpawnSpec;

pub use runtime::SchedulerGrant;

pub use runtime::pump_schedulers_to_exhaustion;

pub use runtime_mode::MobRuntimeMode;

pub use snapshot::ParentToolScopeSnapshot;

pub use spec::SpecValidator;

pub use storage::MobStorage;

pub use store::InMemoryMobEventStore;

pub use store::InMemoryMobRunStore;

pub use store::InMemoryMobSpecStore;

pub use store::InMemoryRealmProfileStore;

pub use store::MobEventStore;

pub use store::MobRunStore;

pub use store::MobSpecStore;

pub use store::MobStoreError;

pub use store::RealmProfileStore;

pub use store::StoredRealmProfile;

pub use store::SqliteMobEventStore;

pub use store::SqliteMobRunStore;

pub use store::SqliteMobSpecStore;

pub use store::SqliteMobStores;

pub use store::SqliteRealmProfileStore;

pub use tasks::MobTask;

pub use tasks::TaskBoard;

pub use tasks::TaskStatus;

pub use validate::Diagnostic;

pub use validate::DiagnosticCode;

pub use validate::DiagnosticSeverity;

pub use validate::partition_diagnostics;

pub use validate::validate_definition;

Modules

backend

build

Profile to AgentBuildConfig compilation.

definition

Mob definition types and TOML parsing.

error

Error types for mob operations.

event

Mob events for structural state changes.

ids

Newtype identifiers for mob entities.

launch

Launch mode and fork context for mob member provisioning.

profile

Profile and tool configuration for mob meerkats.

roster

Roster tracking for active meerkats in a mob.

run

Flow run data model.

runtime

Mob runtime: actor, builder, handle, and primitives.

runtime_mode

snapshot

Parent tool scope snapshot for inheriting tool visibility into mob children.

spec

Flow specification validation.

storage

MobStorage bundle.

store

Mob store traits and implementations.

tasks

Shared task board for mob coordination.

validate

Definition validation for mob definitions.

Type Aliases

ExternalToolsProvider

Closure called at each member spawn to get a fresh snapshot of external tools.