Skip to content

Introduce Java API to allow using Koog from pure Java projects #1185

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
Ololoshechkin wants to merge 32 commits into
base: develop
Choose a base branch
from
Open

Introduce Java API to allow using Koog from pure Java projects #1185

Ololoshechkin wants to merge 32 commits into from
+18,690 −3,415

Conversation

@Ololoshechkin
Copy link
Collaborator

@Ololoshechkin Ololoshechkin commented Nov 26, 2025 •
edited
Loading

Motivation and Context

Breaking Changes

Type of the changes

  • New feature (non-breaking change which adds functionality)
  • Bug fix (non-breaking change which fixes an issue)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update
  • Tests improvement
  • Refactoring

Checklist

  • The pull request has a description of the proposed change
  • I read the Contributing Guidelines before opening the pull request
  • The pull request uses develop as the base branch
  • Tests for the changes have been added
  • All new and existing tests passed
Additional steps for pull requests adding a new feature
  • An issue describing the proposed change exists
  • The pull request includes a link to the issue
  • The change was discussed and approved in the issue
  • Docs have been added / updated

@Ololoshechkin Ololoshechkin changed the title [Work In Progress, Don't Review] Java [Work In Progress, Don't Review] Java API Nov 26, 2025
@Ololoshechkin Ololoshechkin changed the title [Work In Progress, Don't Review] Java API [Work In Progress] Java API Nov 26, 2025
kpavlov
kpavlov reviewed Nov 26, 2025
View reviewed changes
agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/AIAgentFunctionalStrategy.kt
*/
public fun <Input, Output> functionalStrategy(
public fun <Input, Output> graphStrategy(
name: String = "funStrategy",
Copy link
Contributor

@kpavlov kpavlov Nov 26, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should the name be changed as well? Should it be unique, use UUID then?

kpavlov
kpavlov reviewed Nov 28, 2025
View reviewed changes
Copy link
Contributor

@kpavlov kpavlov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about we divide up the PR? The first thing that jumps out is adding @JvmOverloads.

antoniibelyshev
antoniibelyshev requested changes Jan 7, 2026
View reviewed changes
@antoniibelyshev antoniibelyshev self-requested a review January 7, 2026 23:29
antoniibelyshev
antoniibelyshev approved these changes Jan 7, 2026
View reviewed changes
Copy link
Contributor

@antoniibelyshev antoniibelyshev left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Saw a few minor issues, but overall looks good

@Ololoshechkin Ololoshechkin force-pushed the vbr/java branch 2 times, most recently from 53cf548 to 75fcb10 Compare January 8, 2026 22:30
@Ololoshechkin
Add Java API
b4f97d5 
# Conflicts:
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/AIAgent.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/AIAgentFunctionalStrategy.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/AIAgentService.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/StatefulSingleUseAIAgent.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/config/AIAgentConfig.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/context/AIAgentFunctionalContext.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/context/AIAgentLLMContext.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/context/AgentExecutionInfo.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/entity/AIAgentGraphStrategy.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/session/AIAgentLLMReadSession.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/session/AIAgentLLMSession.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/agent/session/AIAgentLLMWriteSession.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/dsl/extension/AIAgentFunctionalContextExt.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/environment/GenericAgentEnvironmentProxy.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/PromptExecutorProxy.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/handler/agent/AgentEventContext.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/handler/llm/LLMCallEventContext.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/handler/streaming/LLMStreamingEventContext.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/handler/tool/ToolCallEventContext.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/pipeline/AIAgentGraphPipeline.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/feature/pipeline/AIAgentPipeline.kt
#	agents/agents-core/src/commonMain/kotlin/ai/koog/agents/ext/agent/AIAgentSubgraphExt.kt
#	agents/agents-core/src/commonTest/kotlin/ai/koog/agents/core/agent/context/AgentTestBase.kt
#	agents/agents-ext/src/commonMain/kotlin/ai/koog/agents/ext/agent/AIAgentSubtaskExt.kt
#	agents/agents-ext/src/jvmTest/kotlin/ai/koog/agents/ext/agent/LLMAsJudgeNodeTest.kt
#	agents/agents-features/agents-features-snapshot/src/commonMain/kotlin/ai/koog/agents/snapshot/feature/AgentCheckpointData.kt
#	agents/agents-test/src/commonMain/kotlin/ai/koog/agents/testing/feature/TestingFeature.kt
#	prompt/prompt-executor/prompt-executor-clients/prompt-executor-bedrock-client/src/jvmMain/kotlin/ai/koog/prompt/executor/clients/bedrock/BedrockLLMClient.kt
#	prompt/prompt-model/src/commonMain/kotlin/ai/koog/prompt/dsl/PromptBuilder.kt
@Ololoshechkin
Fix rebase issues
a68c844
@Ololoshechkin
fix write session delegation
3f811bc
@Ololoshechkin
fixup ToolRegistry target native -> appleMain
6a2399d
@Ololoshechkin
remove printlns
4013528
@Ololoshechkin
Fix AIAgentGraphPipeline and EventHandlerTests
2ad68fd
@Ololoshechkin
Fix AIAgentLLMContext delegation and Persistence tests
84682df
@Ololoshechkin
run ktlint and fix models list
d4457a7
@Ololoshechkin
Change version to 0.7.0
f7fdd2e
@Ololoshechkin
Change version to 0.7.0 in gradle.properties
6b9e944
@Ololoshechkin
fix from review
213cb9e
@Ololoshechkin
Mark missing models with JvmField
502a2df
@Ololoshechkin
Fix LLMAsJudgeNodeTest compillation
7aac8a3
@Ololoshechkin Ololoshechkin changed the title [Work In Progress] Java API Java API Jan 9, 2026
@Ololoshechkin Ololoshechkin changed the title Java API Introduce Java API to allow using Koog from pure Java projects Jan 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@Rizzen Rizzen Rizzen approved these changes

@antoniibelyshev antoniibelyshev antoniibelyshev approved these changes

@kpavlov kpavlov Awaiting requested review from kpavlov

@sdubov sdubov Awaiting requested review from sdubov

@EugeneTheDev EugeneTheDev Awaiting requested review from EugeneTheDev

@tiginamaria tiginamaria Awaiting requested review from tiginamaria

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@Ololoshechkin @kpavlov @Rizzen @antoniibelyshev