Koog follows Semantic Versioning with the format X.Y.Z (e.g., 1.0.0).
The framework is API-stable: once a public API is released, it will not be broken without a major version bump.
| Component | Name | Format | Meaning |
|---|---|---|---|
X |
Major | X.y.z |
Breaking changes to existing APIs |
Y |
Minor | x.Y.z |
New API additions and deprecations; all existing APIs continue to work |
Z |
Bugfix | x.y.Z |
Bug fixes only; no API changes |
- May introduce breaking changes to existing APIs.
- Old APIs may be removed.
- A migration guide will be provided.
- Released at most once per year.
- May add new APIs.
- May deprecate existing APIs (with replacements provided), but deprecated APIs remain functional.
- No breaking changes — all code that compiled against the previous minor version continues to compile and work.
- Released at most once per month.
- Contains bug fixes only.
- No API additions, removals, or deprecations.
- Released at most once per week.
APIs deprecated in a minor release (Y) will remain available until at least the next major release (X).
Deprecation warnings will indicate the recommended replacement.
Some modules are considered experimental and published with a -beta version suffix (e.g., 1.0.0-beta) rather than the standard X.Y.Z. A module may be beta for one of several reasons:
- External integrations — the underlying LLM provider API or external framework (e.g., Spring AI) may itself be unstable or subject to frequent or expected change.
- Experimental functionality — the feature area is still being explored and the API shape may evolve (e.g., GOAP planning strategies).
- Experimental protocols — the module implements a protocol that is not yet stable itself (e.g., A2A, Kotlin MCP).
While every effort is made to keep beta modules stable, some API changes may occur across minor releases. Beta changes will not affect any stable module.
A stable module at version X.Y.Z is always compatible with a beta module at version X.Y.Z-beta (and vice versa). All modules can be updated in sync.
| Module | Version | Contents |
|---|---|---|
koog-agents |
1.0.0 |
All stable modules (transitive) — recommended starting point |
koog-agents-additions |
1.0.0-beta |
Most beta/experimental modules (except standalone external integrations) |
| Module | Version |
|---|---|
agents |
1.0.0 |
agents-core |
1.0.0 |
agents-features |
1.0.0 |
agents-features-chat-history-jdbc |
1.0.0 |
agents-features-chat-memory-sql |
1.0.0 |
agents-features-event-handler |
1.0.0 |
agents-features-memory |
1.0.0 |
agents-features-opentelemetry |
1.0.0 |
agents-features-persistence-jdbc |
1.0.0 |
agents-features-snapshot |
1.0.0 |
agents-features-sql |
1.0.0 |
agents-features-tokenizer |
1.0.0 |
agents-features-trace |
1.0.0 |
agents-mcp-metadata |
1.0.0 |
agents-test |
1.0.0 |
agents-tools |
1.0.0 |
agents-utils |
1.0.0 |
embeddings |
1.0.0 |
embeddings-base |
1.0.0 |
embeddings-llm |
1.0.0 |
http-client |
1.0.0 |
http-client-core |
1.0.0 |
http-client-java |
1.0.0 |
http-client-ktor |
1.0.0 |
http-client-okhttp |
1.0.0 |
http-client-test |
1.0.0 |
koog-agents |
1.0.0 |
koog-spring-ai |
1.0.0 |
prompt |
1.0.0 |
prompt-cache |
1.0.0 |
prompt-cache-files |
1.0.0 |
prompt-cache-model |
1.0.0 |
prompt-executor |
1.0.0 |
prompt-executor-anthropic-client |
1.0.0 |
prompt-executor-bedrock-client |
1.0.0 |
prompt-executor-cached |
1.0.0 |
prompt-executor-clients |
1.0.0 |
prompt-executor-model |
1.0.0 |
prompt-executor-ollama-client |
1.0.0 |
prompt-executor-openai-client |
1.0.0 |
prompt-executor-openai-client-base |
1.0.0 |
prompt-executor-openrouter-client |
1.0.0 |
prompt-llm |
1.0.0 |
prompt-markdown |
1.0.0 |
prompt-model |
1.0.0 |
prompt-processor |
1.0.0 |
prompt-structure |
1.0.0 |
prompt-tokenizer |
1.0.0 |
prompt-xml |
1.0.0 |
rag-base |
1.0.0 |
serialization |
1.0.0 |
serialization-core |
1.0.0 |
serialization-jackson |
1.0.0 |
serialization-test |
1.0.0 |
test-tck |
1.0.0 |
test-utils |
1.0.0 |
utils |
1.0.0 |
| Module | Version |
|---|---|
a2a-client |
1.0.0-beta |
a2a-core |
1.0.0-beta |
a2a-server |
1.0.0-beta |
a2a-test |
1.0.0-beta |
a2a-test-server-tck |
1.0.0-beta |
a2a-transport-client-jsonrpc-http |
1.0.0-beta |
a2a-transport-core-jsonrpc |
1.0.0-beta |
a2a-transport-server-jsonrpc-http |
1.0.0-beta |
agents-ext |
1.0.0-beta |
agents-features-a2a-client |
1.0.0-beta |
agents-features-a2a-core |
1.0.0-beta |
agents-features-a2a-server |
1.0.0-beta |
agents-features-acp |
1.0.0-beta |
agents-features-chat-history-aws |
1.0.0-beta |
agents-features-longterm-memory |
1.0.0-beta |
agents-features-longterm-memory-aws |
1.0.0-beta |
agents-mcp |
1.0.0-beta |
agents-mcp-server |
1.0.0-beta |
agents-planner |
1.0.0-beta |
koog-agents-additions |
1.0.0-beta |
koog-ktor |
1.0.0-beta |
koog-spring-ai-common |
1.0.0-beta |
koog-spring-ai-starter-chat-memory |
1.0.0-beta |
koog-spring-ai-starter-model-chat |
1.0.0-beta |
koog-spring-ai-starter-model-embedding |
1.0.0-beta |
koog-spring-ai-starter-vector-store |
1.0.0-beta |
koog-spring-boot-starter |
1.0.0-beta |
prompt-cache-redis |
1.0.0-beta |
prompt-executor-dashscope-client |
1.0.0-beta |
prompt-executor-deepseek-client |
1.0.0-beta |
prompt-executor-google-client |
1.0.0-beta |
prompt-executor-litert-client |
1.0.0-beta |
prompt-executor-llms-all |
1.0.0-beta |
prompt-executor-mistralai-client |
1.0.0-beta |
rag-vector |
1.0.0-beta |