# Changelog

## Score

- CAI 59 → 68 (+8.9)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

## Lenses

- Code Health 79 → 78 (-0.9)
- Architecture 88 → 88 (+0.0)
- Maturity 72 → 77 (+5.1)
- Readiness 43 → 63 (+19.1)
- Security 75 → 67 (-8.1)
- Performance 71 → 85 (+13.7)

## Resolved (164)

- Ambiguous extension function names in different modules. Both Jackson and Kotlinx serialization modules expose `toKoogJSONElement()` as an extension function on their respective JSON types. While technically distinct due to receiver types, this creates a confusing API where users must know which module's extension is in scope to convert to the common `JSONElement`.
- Change coupling: AIAgentPipeline.kt ↔ Tracing.kt (agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/pipeline/AIAgentPipeline.kt)
- Dependency hygiene PARTLY measured — Maven/Gradle declarations read, no dependency graph resolved
- Documentation: no architecture or design documentation (README.md)
- Duplicate conversion utilities with inconsistent naming and placement. `TimeUtils` provides static methods for Java/Kotlin Instant conversion, while `TimeUtilsKt` provides extension functions that do the same thing. The naming `toJavaInstant` vs `toKotlinInstant` is also inconsistent with the static method names `fromJavaInstant`/`toJavaInstant`.
- Duplicated block (10 lines × 2) (agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/debugger/Debugger.kt)
- Duplicated block (10 lines × 2) (agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/debugger/Debugger.kt)
- Duplicated block (10 lines × 2) (agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/debugger/Debugger.kt)
- Duplicated block (10 lines × 2) (examples/demo-compose-app/commonApp/src/commonMain/kotlin/com/jetbrains/example/koog/compose/agents/weather/OpenMeteoClient.kt)
- Duplicated block (10 lines × 2) (http-client/http-client-spring-webclient/src/main/kotlin/ai/koog/http/client/spring/SpringWebClientKoogHttpClient.kt)
- Duplicated block (10 lines × 2) (koog-spring-ai-v2/koog-spring-ai-v2-starter-chat-memory/src/main/kotlin/ai/koog/spring/ai/memory/SpringAiChatHistoryProvider.kt)
- Duplicated block (10 lines × 2) (prompt/prompt-executor/prompt-executor-clients/prompt-executor-bedrock-client/src/jvmMain/kotlin/ai/koog/prompt/executor/clients/bedrock/converse/BedrockConverseConverters.kt)
- Duplicated block (10 lines × 2) (prompt/prompt-executor/prompt-executor-model/src/commonMain/kotlin/ai/koog/prompt/executor/llms/MultiLLMPromptExecutor.kt)
- Duplicated block (10–11 lines × 2) (prompt/prompt-executor/prompt-executor-clients/prompt-executor-deepseek-client/src/commonMain/kotlin/ai/koog/prompt/executor/clients/deepseek/DeepSeekParams.kt)
- Duplicated block (11 lines × 2) (agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/debugger/Debugger.kt)
- Duplicated block (11 lines × 2) (agents/agents-features/agents-features-opentelemetry/src/commonMain/kotlin/ai/koog/agents/features/opentelemetry/metric/events/histogramMetricEvents.kt)
- Duplicated block (11 lines × 2) (http-client/http-client-java/src/main/kotlin/ai/koog/http/client/java/JavaKoogHttpClient.kt)
- Duplicated block (11 lines × 2) (koog-spring-ai-v2/koog-spring-ai-v2-starter-model-chat/src/main/kotlin/ai/koog/spring/ai/chat/SpringAiLLMClient.kt)
- Duplicated block (11 lines × 2) (koog-spring-ai-v2/koog-spring-ai-v2-starter-model-chat/src/main/kotlin/ai/koog/spring/ai/chat/SpringAiToolCallAssembler.kt)
- Duplicated block (11 lines × 2) (prompt/prompt-executor/prompt-executor-clients/prompt-executor-deepseek-client/src/commonMain/kotlin/ai/koog/prompt/executor/clients/deepseek/DeepSeekLLMClient.kt)
- …and 144 more

## New (748)

- Banned license: com.mysql:mysql-connector-j
- Critical CVE: [GHSA redacted] (examples/spring-ai-java/pom.xml)
- Critical CVE: [GHSA redacted] (examples/spring-io-2026/java/pom.xml)
- Critical CVE: [GHSA redacted] (examples/spring-ai-java/pom.xml)
- Critical CVE: [GHSA redacted] (examples/spring-boot-java/pom.xml)
- Critical CVE: [GHSA redacted] (examples/spring-io-2026/java/pom.xml)
- Critical CVE: [GHSA redacted] (examples/spring-ai-java/pom.xml)
- Critical CVE: [GHSA redacted] (examples/spring-boot-java/pom.xml)
- Critical CVE: [GHSA redacted] (examples/spring-io-2026/java/pom.xml)
- Critical CVE: [GHSA redacted] (examples/spring-ai-java/pom.xml)
- Critical CVE: [GHSA redacted] (examples/spring-io-2026/java/pom.xml)
- Duplicated block (10 lines × 2) (agents/agents-features/agents-features-chat-history-jdbc/src/main/kotlin/ai/koog/agents/features/chathistory/jdbc/JdbcChatHistoryProvider.kt)
- Duplicated block (10 lines × 2) (examples/demo-compose-app/commonApp/src/commonMain/kotlin/com/jetbrains/example/koog/compose/agents/weather/OpenMeteoClient.kt)
- Duplicated block (10 lines × 2) (http-client/http-client-spring-webclient/src/main/kotlin/ai/koog/http/client/spring/SpringWebClientKoogHttpClient.kt)
- Duplicated block (10 lines × 2) (prompt/prompt-executor/prompt-executor-clients/prompt-executor-bedrock-client/src/jvmMain/kotlin/ai/koog/prompt/executor/clients/bedrock/converse/BedrockConverseConverters.kt)
- Duplicated block (10 lines × 2) (prompt/prompt-executor/prompt-executor-model/src/commonMain/kotlin/ai/koog/prompt/executor/llms/MultiLLMPromptExecutor.kt)
- Duplicated block (10 lines × 3) (agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/debugger/Debugger.kt)
- Duplicated block (10–11 lines × 2) (prompt/prompt-executor/prompt-executor-clients/prompt-executor-deepseek-client/src/commonMain/kotlin/ai/koog/prompt/executor/clients/deepseek/DeepSeekParams.kt)
- Duplicated block (11 lines × 2) (agents/agents-features/agents-features-chat-memory-sql/src/jvmMain/kotlin/ai/koog/agents/features/chatmemory/sql/H2ChatHistoryProvider.kt)
- Duplicated block (11 lines × 2) (agents/agents-features/agents-features-opentelemetry/src/commonMain/kotlin/ai/koog/agents/features/opentelemetry/metric/events/histogramMetricEvents.kt)
- …and 728 more

## Changes since last survey

- 2 commits — 2 feature/other, 0 fixes

## By area

- agents/agents-features — 2 commits

## Notable commits

- change: build(agents)!: upgrade Exposed to 1.6.0 (#2321)
- change: feat(agents): report Gemini cached and thinking tokens to Langfuse (#2303)

## Architecture

- Containers 0 added · 0 removed · contexts 3 added · 3 removed · edges 7 added · 8 removed

## Added bounded contexts (3)

- examples/javaone-2026
- examples/koog-java-api-example
- examples/spring-io-2026/java

## Removed bounded contexts (3)

- examples/javaone-2026
- examples/koog-java-api-example
- examples/spring-io-2026/java

## Added dependency edges (7)

- examples/koog-java-api-example → examples/javaone-2026
- koog-spring-ai-starter-model-chat → prompt-llm
- koog-spring-ai-starter-model-chat → prompt-model
- koog-spring-ai-starter-vector-store → rag-base
- koog-spring-ai-v2-starter-model-chat → prompt-llm (coupling)
- koog-spring-ai-v2-starter-model-chat → prompt-model (coupling)
- koog-spring-ai-v2-starter-vector-store → rag-base (coupling)

## Removed dependency edges (was a dependency, now gone) (8)

- examples/javaone-2026 → examples/koog-java-api-example
- examples/koog-java-api-example → examples/javaone-2026
- koog-spring-ai-starter-model-chat → prompt-llm (coupling)
- koog-spring-ai-starter-model-chat → prompt-model (coupling)
- koog-spring-ai-starter-vector-store → rag-base (coupling)
- koog-spring-ai-v2-starter-model-chat → prompt-llm
- koog-spring-ai-v2-starter-model-chat → prompt-model
- koog-spring-ai-v2-starter-vector-store → rag-base
