cognis

The umbrella crate. Most apps depend on this and write use cognis::prelude::*;. It re-exports the four sibling capability crates and adds the agent layer (builder, multi-agent orchestration, memory, middleware, built-in tools, observers, eval).

Crate metadata

Field	Value
Latest version	`0.3`
docs.rs	docs.rs/cognis
Repo path	`crates/cognis`
Default features	`openai`, `ollama`

What’s exported

Re-exported from	Path
`cognis-core`	`cognis::cognis_core::*` (the crate) plus flat top-level (e.g. `cognis::Message`, `cognis::Runnable`, `cognis::RunnableConfig`, `cognis::Event`, `cognis::Observer`).
`cognis-graph`	`cognis::cognis_graph::*` plus `cognis::Graph`, `cognis::node_fn`, `cognis::Goto`, `cognis::NodeOut`, `cognis::GraphState`, `cognis::Checkpointer`, `cognis::InMemoryCheckpointer`, `cognis::CompiledGraph`.
`cognis-llm`	`cognis::cognis_llm::*` plus `cognis::Client`, `cognis::Tool`, `cognis::ToolDefinition`, `cognis::ToolInput`, `cognis::ToolOutput`, `cognis::ToolRegistry`.
`cognis-rag`	`cognis::cognis_rag::*` plus `cognis::Document`, `cognis::Embeddings`, `cognis::InMemoryVectorStore`, `cognis::VectorStore`, `cognis::SearchResult`, retrievers, transformers.

What lives in the umbrella itself

Module	What
`agent`	`AgentBuilder`, `Agent`, `AgentResponse`, `AgentState`, `default_react_graph`, lifecycle, plugins.
`agent_bus`	`AgentBus`, `Subscription`, `SubscribeError`.
`agent_events`	`AgentEvent`, `AgentEventBus`, `EventSubscription`, `DEFAULT_EVENTS_TOPIC`.
`backend`	`Backend`, `InMemoryStorageBackend`, `LocalFsStorageBackend`, `SandboxedFsBackend`, `MemoryBackend`.
`eval`	`EvalRunner`, `EvalCase`, `EvalRow`, `EvalReport`, `Evaluator` trait, plus built-in `ExactMatch`, `Contains`, `LlmJudge`.
`history`	Conversation persistence helpers.
`middleware`	The full middleware catalog (see Middleware).
`multi_agent`	`MultiAgentOrchestrator`, `Sequential`, `Supervisor`, `ParallelVote`, `RoundRobin`, `HandoffStrategy`.
`observers`	`TracingObserver` — stdout-friendly observer for local debugging.
`presets`	Out-of-the-box agent recipes.
`retrievers`	LLM-driven retrievers (multi-query expansion, contextual compression).
`session`	`Session`, `SessionStore`, `InMemorySessionStore`.
`skills`	Reusable agent skills.
`telemetry`	Lightweight metrics.
`tools`	Built-in tools — `Calculator`, file tools (`FileReadTool`/`FileWriteTool`/`FileEditTool`/`FileListTool`/`FileGlobTool`/`FileGrepTool`/`FileExistsTool`), `JsonQueryTool`, `PythonReplTool`, `HumanTool`, `ShellTool`, `SubAgentTool`, `RetrieverTool`. Plus `ToolOrchestrator`, `ExecutionPlan`, `ToolStep`, and the approval primitives (`Approver`, `Decision`, `AllowList`, `AutoApprove`, `RejectAll`, `ApprovalGatedTool`). HTTP / OpenAPI / web-search / Wikipedia tools (`HttpRequest`, `OpenApiToolset`, `WebSearchTool`, `TavilyProvider*`, `WikipediaTool`) are gated behind the `tools-http` feature.

prelude

use cognis::prelude::*; brings in:

The umbrella’s flat top-level re-exports.
Distance, Embeddings, InMemoryVectorStore, SearchResult, VectorStore.
async_trait::async_trait.
The RunnableExt trait so pipe, with_max_retries, with_timeout, etc. are in scope.
Common memory variants and their constructors.

If something feels like it should be importable, try cognis::prelude first.

Feature flags

Feature	Pulls in
`openai`	OpenAI provider in `cognis-llm`, OpenAI embeddings in `cognis-rag`.
`anthropic`	Anthropic provider.
`google`	Google provider + embeddings.
`ollama`	Ollama provider + embeddings (default).
`azure`	Azure OpenAI provider.
`voyage`	Voyage embeddings.
`all-providers`	All of the above.
`tools-http`	HTTP tool primitives.
`cache-sqlite`	SQLite-backed cache.

See Feature flags for the full table.

cognis-core

Foundation crate.

cognis-llm

LLM clients & providers.

cognis-rag

RAG building blocks.

cognis-graph

Graph engine.

cognis-trace

Observability.

cognis-macros

Proc macros.

API per crate

Reference

Crate metadata

What’s exported

What lives in the umbrella itself

prelude

Feature flags

See also

cognis-core

cognis-llm

cognis-rag

cognis-graph

cognis-trace

cognis-macros

​Crate metadata

​What’s exported

​What lives in the umbrella itself

​prelude

​Feature flags

​See also

cognis-core

cognis-llm

cognis-rag

cognis-graph

cognis-trace

cognis-macros

Crate metadata

What’s exported

What lives in the umbrella itself

prelude

Feature flags

See also