The umbrella crate. Most apps depend on this and writeDocumentation Index
Fetch the complete documentation index at: https://cognis.vasanth.xyz/llms.txt
Use this file to discover all available pages before exploring further.
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
RunnableExttrait sopipe,with_max_retries,with_timeout, etc. are in scope. - Common memory variants and their constructors.
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 also
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.