Skip to content

Crate Map

The Animus workspace is a Cargo workspace of 18 crates organized by runtime responsibility. Cargo.toml is the source of truth for membership.

Foundation

CrateResponsibility
protocolShared protocol, config, repository-scope, and CLI JSON envelope types
orchestrator-storeAtomic persistence helpers and repo-scoped state directory support
orchestrator-loggingShared tracing, log path, and runtime log plumbing

Runtime

CrateResponsibility
orchestrator-daemon-runtimeDaemon queue, scheduling, subject dispatch, trigger handling, and runtime supervision
workflow-runner-v2Workflow phase execution, checkpoint persistence, and runtime contracts
agent-runnerRunner process that launches and supervises provider sessions
oai-runnerOpenAI-compatible runner binary

CLI and Services

CrateResponsibility
orchestrator-cliMain animus binary, clap surface, MCP server, output formatting, and operations
orchestrator-coreDomain services, bootstrap, state mutation APIs, plugin registry, and preflight
orchestrator-configWorkflow YAML loading, pack loading, scaffolding, and phase plan resolution
orchestrator-git-opsBranch, worktree, merge, and PR helper operations
orchestrator-notificationsNotification/runtime integration support
orchestrator-providersProvider-facing adapter glue and compatibility helpers

Plugin Runtime

CrateResponsibility
orchestrator-plugin-hostPlugin discovery, install lockfiles, manifest probes, stdio host, router, and signature verification
orchestrator-session-hostProvider plugin session bridge used by agent-runner
animus-plugin-protocolIn-tree copy of the stdio plugin protocol types
animus-subject-protocolNormalized subject schema, subject backend trait, and subject errors
animus-plugin-runtimeRuntime helper crate for plugin implementations

The workspace also depends on external launchapp-dev/animus-protocol crates for provider/session contracts, currently through animus-provider-protocol and animus-session-backend in Cargo.toml.

Repo-Local Fixtures

CrateResponsibility
animus-provider-mockMock provider plugin for contract and e2e tests
animus-plugin-smokeSmoke-test plugin for host and protocol behavior
orchestrator-web-serverLegacy in-repo web server directory retained outside the current Cargo workspace

Web

The active web stack is not part of the current Cargo workspace. animus web discovers and spawns external plugins, normally installed through:

bash
animus plugin install-defaults --include-transports

The curated transport set is currently animus-transport-http, animus-transport-graphql, and animus-web-ui. The exact tags live in orchestrator-core::plugin_registry.

Released under the Elastic License 2.0 (ELv2).