Removal of partial tool call streaming

agents/agents-core/src/commonMain/kotlin/ai/koog/agents/core/dsl/extension/AIAgentNodes.kt

@@ -231,7 +231,6 @@ public inline fun <reified T> AIAgentSubgraphBuilderBase<*, *>.nodeLLMRequestStr
         }
     }
 
-
 /**
  * A node that appends a user message to the LLM prompt, streams LLM response and transforms the stream data.
  *

agents/agents-core/src/commonTest/kotlin/ai/koog/agents/core/agent/session/AIAgentLLMWriteSessionTest.kt

@@ -125,7 +125,7 @@ class AIAgentLLMWriteSessionTest {
             user("I have some text that needs processing.")
             assistant("I'll use the test-tool to process your text.")
             tool {
-                call("call_1", 0, "test-tool", """{"input":"sample data"}""")
+                call("call_1", "test-tool", """{"input":"sample data"}""")
                 result("call_1", "test-tool", "Processed: sample data")
             }
             assistant(
@@ -134,7 +134,7 @@ class AIAgentLLMWriteSessionTest {
             user("Can you also use the custom tool to process this data?")
             assistant("Sure, I'll use the custom tool for additional processing.")
             tool {
-                call("call_2", 0, "custom-tool", """{"input":"additional processing"}""")
+                call("call_2", "custom-tool", """{"input":"additional processing"}""")
                 result("call_2", "custom-tool", """{"output":"Custom processed: additional processing"}""")
             }
             assistant(

agents/agents-ext/src/commonTest/kotlin/ai/koog/agents/ext/llm/choice/ChoiceSelectionStrategyTest.kt

@@ -11,8 +11,8 @@ import ai.koog.prompt.llm.OllamaModels
 import ai.koog.prompt.message.Message
 import ai.koog.prompt.message.ResponseMetaInfo
 import ai.koog.prompt.streaming.StreamFrame
+import ai.koog.prompt.streaming.streamFrameFlowOf
 import kotlinx.coroutines.flow.Flow
-import kotlinx.coroutines.flow.flowOf
 import kotlinx.coroutines.test.runTest
 import kotlinx.datetime.Clock
 import kotlinx.datetime.Instant
@@ -70,7 +70,7 @@ class ChoiceSelectionStrategyTest {
                 model: LLModel,
                 tools: List<ToolDescriptor>
             ): Flow<StreamFrame> =
-                flowOf(StreamFrame.Append("Default streaming response"))
+                streamFrameFlowOf("Default streaming response")
 
             override suspend fun executeMultipleChoices(
                 prompt: Prompt,

examples/src/main/kotlin/ai/koog/agents/example/structuredoutput/markdown/MarkdownStreamingDataExample.kt

@@ -4,10 +4,10 @@ import ai.koog.agents.core.agent.AIAgent
 import ai.koog.agents.core.agent.config.AIAgentConfig
 import ai.koog.agents.core.dsl.builder.forwardTo
 import ai.koog.agents.core.dsl.builder.strategy
-import ai.koog.agents.core.utils.filterTextOnly
 import ai.koog.agents.example.ApiKeyService
 import ai.koog.prompt.executor.llms.all.simpleOpenAIExecutor
 import ai.koog.prompt.executor.model.PromptExecutor
+import ai.koog.prompt.streaming.filterTextOnly
 import kotlinx.coroutines.runBlocking
 
 fun main(): Unit = runBlocking {

examples/src/main/kotlin/ai/koog/agents/example/structuredoutput/markdown/MarkdownStreamingWithToolsExample.kt

@@ -5,10 +5,10 @@ import ai.koog.agents.core.agent.config.AIAgentConfig
 import ai.koog.agents.core.dsl.builder.forwardTo
 import ai.koog.agents.core.dsl.builder.strategy
 import ai.koog.agents.core.tools.ToolRegistry
-import ai.koog.agents.core.utils.filterTextOnly
 import ai.koog.agents.example.ApiKeyService
 import ai.koog.prompt.executor.llms.all.simpleOpenAIExecutor
 import ai.koog.prompt.executor.model.PromptExecutor
+import ai.koog.prompt.streaming.filterTextOnly
 import kotlinx.coroutines.flow.collect
 import kotlinx.coroutines.runBlocking
 

integration-tests/src/jvmTest/kotlin/ai/koog/integration/tests/executor/MultipleLLMPromptExecutorIntegrationTest.kt

@@ -3,7 +3,6 @@ package ai.koog.integration.tests.executor
 import ai.koog.agents.core.tools.ToolDescriptor
 import ai.koog.agents.core.tools.ToolParameterDescriptor
 import ai.koog.agents.core.tools.ToolParameterType
-import ai.koog.agents.core.utils.filterTextOnly
 import ai.koog.integration.tests.utils.MediaTestScenarios
 import ai.koog.integration.tests.utils.MediaTestScenarios.AudioTestScenario
 import ai.koog.integration.tests.utils.MediaTestScenarios.ImageTestScenario
@@ -45,6 +44,7 @@ import ai.koog.prompt.message.AttachmentContent
 import ai.koog.prompt.message.Message
 import ai.koog.prompt.params.LLMParams.ToolChoice
 import ai.koog.prompt.streaming.StreamFrame
+import ai.koog.prompt.streaming.filterTextOnly
 import ai.koog.prompt.structure.executeStructured
 import kotlinx.coroutines.flow.toList
 import kotlinx.coroutines.runBlocking

integration-tests/src/jvmTest/kotlin/ai/koog/integration/tests/executor/OllamaExecutorIntegrationTest.kt

@@ -3,7 +3,6 @@ package ai.koog.integration.tests.executor
 import ai.koog.agents.core.tools.ToolDescriptor
 import ai.koog.agents.core.tools.ToolParameterDescriptor
 import ai.koog.agents.core.tools.ToolParameterType
-import ai.koog.agents.core.utils.filterTextOnly
 import ai.koog.integration.tests.InjectOllamaTestFixture
 import ai.koog.integration.tests.OllamaTestFixture
 import ai.koog.integration.tests.OllamaTestFixtureExtension
@@ -21,6 +20,7 @@ import ai.koog.prompt.llm.LLMCapability.Tools
 import ai.koog.prompt.llm.LLMCapability.Vision
 import ai.koog.prompt.markdown.markdown
 import ai.koog.prompt.streaming.StreamFrame
+import ai.koog.prompt.streaming.filterTextOnly
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.flow
 import kotlinx.coroutines.test.runTest

integration-tests/src/jvmTest/kotlin/ai/koog/integration/tests/executor/SingleLLMPromptExecutorIntegrationTest.kt

@@ -3,7 +3,6 @@ package ai.koog.integration.tests.executor
 import ai.koog.agents.core.tools.ToolDescriptor
 import ai.koog.agents.core.tools.ToolParameterDescriptor
 import ai.koog.agents.core.tools.ToolParameterType
-import ai.koog.agents.core.utils.filterTextOnly
 import ai.koog.integration.tests.utils.MediaTestScenarios
 import ai.koog.integration.tests.utils.MediaTestScenarios.AudioTestScenario
 import ai.koog.integration.tests.utils.MediaTestScenarios.ImageTestScenario
@@ -52,6 +51,7 @@ import ai.koog.prompt.message.AttachmentContent
 import ai.koog.prompt.message.Message
 import ai.koog.prompt.params.LLMParams.ToolChoice
 import ai.koog.prompt.streaming.StreamFrame
+import ai.koog.prompt.streaming.filterTextOnly
 import ai.koog.prompt.structure.executeStructured
 import kotlinx.coroutines.flow.toList
 import kotlinx.coroutines.test.runTest

integration-tests/src/jvmTest/kotlin/ai/koog/integration/tests/utils/TestUtils.kt

@@ -6,11 +6,11 @@ import ai.koog.agents.core.tools.ToolDescriptor
 import ai.koog.agents.core.tools.ToolParameterDescriptor
 import ai.koog.agents.core.tools.ToolParameterType
 import ai.koog.agents.core.tools.annotations.LLMDescription
-import ai.koog.agents.core.utils.filterTextOnly
 import ai.koog.prompt.dsl.Prompt
 import ai.koog.prompt.llm.LLMProvider
 import ai.koog.prompt.llm.LLModel
 import ai.koog.prompt.streaming.StreamFrame
+import ai.koog.prompt.streaming.filterTextOnly
 import ai.koog.prompt.structure.RegisteredStandardJsonSchemaGenerators
 import ai.koog.prompt.structure.StructureFixingParser
 import ai.koog.prompt.structure.StructuredOutput

prompt/prompt-executor/prompt-executor-cached/src/commonMain/kotlin/ai/koog/prompt/executor/cached/CachedPromptExecutor.kt

@@ -44,7 +44,7 @@ public class CachedPromptExecutor(
             getOrPut(prompt, tools, model).forEach {
                 emit(it.toStreamFrame())
             }
-         }
+        }
 
     private suspend fun getOrPut(prompt: Prompt, model: LLModel): Message.Assistant {
         return cache.get(prompt, emptyList(), clock)

prompt/prompt-executor/prompt-executor-cached/src/jvmTest/kotlin/ai/koog/prompt/executor/cached/CachedPromptExecutorTest.kt

@@ -12,8 +12,8 @@ import ai.koog.prompt.message.Message
 import ai.koog.prompt.message.RequestMetaInfo
 import ai.koog.prompt.message.ResponseMetaInfo
 import ai.koog.prompt.streaming.StreamFrame
+import ai.koog.prompt.streaming.streamFrameFlowOf
 import kotlinx.coroutines.flow.Flow
-import kotlinx.coroutines.flow.flowOf
 import kotlinx.coroutines.test.runTest
 import kotlinx.datetime.Clock
 import kotlin.test.Test
@@ -73,7 +73,7 @@ class CachedPromptExecutorTest {
             tools: List<ToolDescriptor>
         ): Flow<StreamFrame> {
             executeStreamingCalled = true
-            return flowOf(StreamFrame.Append("Streaming response from executor"))
+            return streamFrameFlowOf("Streaming response from executor")
         }
 
         override suspend fun moderate(

prompt/prompt-executor/prompt-executor-clients/prompt-executor-anthropic-client/src/commonMain/kotlin/ai/koog/prompt/executor/clients/anthropic/AnthropicLLMClient.kt

@@ -15,6 +15,10 @@ import ai.koog.prompt.message.Message
 import ai.koog.prompt.message.ResponseMetaInfo
 import ai.koog.prompt.params.LLMParams
 import ai.koog.prompt.streaming.StreamFrame
+import ai.koog.prompt.streaming.emitAppend
+import ai.koog.prompt.streaming.emitEnd
+import ai.koog.prompt.streaming.emitToolCall
+import ai.koog.prompt.streaming.streamFrameFlow
 import io.github.oshai.kotlinlogging.KotlinLogging
 import io.ktor.client.HttpClient
 import io.ktor.client.call.body
@@ -38,7 +42,6 @@ import io.ktor.http.isSuccess
 import io.ktor.serialization.kotlinx.json.json
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.flow.Flow
-import kotlinx.coroutines.flow.flow
 import kotlinx.coroutines.withContext
 import kotlinx.datetime.Clock
 import kotlinx.serialization.json.Json
@@ -149,7 +152,7 @@ public open class AnthropicLLMClient(
         prompt: Prompt,
         model: LLModel,
         tools: List<ToolDescriptor>
-    ): Flow<StreamFrame> = flow {
+    ): Flow<StreamFrame> = streamFrameFlow {
         logger.debug { "Executing streaming prompt: $prompt with model: $model without tools" }
         require(model.capabilities.contains(LLMCapability.Completion)) {
             "Model ${model.id} does not support chat completions"
@@ -175,14 +178,15 @@ public open class AnthropicLLMClient(
                         .takeIf { it.event == "content_block_delta" }
                         ?.data?.trim()?.let { json.decodeFromString<AnthropicStreamResponse>(it) }
                         ?.let { response ->
-                            response.delta?.text?.let { emit(StreamFrame.Append(it)) }
-                            response.message?.stopReason?.let { emit(StreamFrame.End(it)) }
-                            response.delta?.toolUse?.let { emit(StreamFrame.ToolCall(
+                            response.delta?.text?.let { emitAppend(it) }
+                            response.delta?.toolUse?.let {
+                                emitToolCall(
                                     id = it.id,
                                     name = it.name,
-                                    content = it.input.toString())
+                                    content = it.input.toString()
                                 )
                             }
+                            response.message?.stopReason?.let { emitEnd(it) }
                         }
                 }
             }

prompt/prompt-executor/prompt-executor-clients/prompt-executor-bedrock-client/src/jvmMain/kotlin/ai/koog/prompt/executor/clients/bedrock/modelfamilies/ai21/BedrockAI21JambaSerialization.kt

@@ -195,6 +195,6 @@ internal object BedrockAI21JambaSerialization {
                     )
                 }?.let(::addAll)
             }
-        }?:emptyList()
+        } ?: emptyList()
     }
 }

prompt/prompt-executor/prompt-executor-clients/prompt-executor-bedrock-client/src/jvmMain/kotlin/ai/koog/prompt/executor/clients/bedrock/modelfamilies/amazon/BedrockAmazonNovaSerialization.kt

@@ -156,6 +156,6 @@ internal object BedrockAmazonNovaSerialization {
             buildList {
                 it.text?.let(StreamFrame::Append)?.let(::add)
             }
-        }?:emptyList()
+        } ?: emptyList()
     }
 }

prompt/prompt-executor/prompt-executor-clients/prompt-executor-bedrock-client/src/jvmMain/kotlin/ai/koog/prompt/executor/clients/bedrock/modelfamilies/anthropic/BedrockAnthropicClaudeSerialization.kt

@@ -89,6 +89,7 @@ internal object BedrockAnthropicClaudeSerialization {
                                     }
                                     contentParts.add(AnthropicContent.Image(source = imageSource))
                                 }
+
                                 else -> throw IllegalArgumentException(
                                     "Unsupported attachment type: ${attachment::class.simpleName}"
                                 )
@@ -238,14 +239,15 @@ internal object BedrockAnthropicClaudeSerialization {
                             )
                         }?.let(::add)
                     }
-                }?:emptyList()
+                } ?: emptyList()
             }
 
             "message_delta" -> {
                 streamResponse.message?.content?.map { content ->
                     when (content) {
                         is AnthropicResponseContent.Text ->
                             StreamFrame.Append(content.text)
+
                         is AnthropicResponseContent.ToolUse ->
                             StreamFrame.ToolCall(
                                 id = content.id,
@@ -268,7 +270,7 @@ internal object BedrockAnthropicClaudeSerialization {
                 emptyList()
             }
 
-            else ->  emptyList()
+            else -> emptyList()
         }
     }
 }

prompt/prompt-executor/prompt-executor-clients/prompt-executor-deepseek-client/src/commonMain/kotlin/ai/koog/prompt/executor/clients/deepseek/DeepSeekLLMClient.kt

@@ -1,4 +1,5 @@
 package ai.koog.prompt.executor.clients.deepseek
+
 import ai.koog.prompt.dsl.ModerationResult
 import ai.koog.prompt.dsl.Prompt
 import ai.koog.prompt.executor.clients.ConnectionTimeoutConfig
@@ -14,7 +15,7 @@ import ai.koog.prompt.executor.clients.openai.base.models.OpenAIToolChoice
 import ai.koog.prompt.executor.model.LLMChoice
 import ai.koog.prompt.llm.LLModel
 import ai.koog.prompt.params.LLMParams
-import ai.koog.prompt.streaming.StreamFrame
+import ai.koog.prompt.streaming.StreamFrameFlowBuilder
 import io.github.oshai.kotlinlogging.KotlinLogging
 import io.ktor.client.HttpClient
 import kotlinx.datetime.Clock
@@ -98,19 +99,19 @@ public class DeepSeekLLMClient(
     override fun decodeResponse(data: String): DeepSeekChatCompletionResponse =
         json.decodeFromString(data)
 
-    override fun processStreamingChunk(chunk: DeepSeekChatCompletionStreamResponse): List<StreamFrame> =
-        chunk.choices.firstOrNull()?.delta?.let {
-            buildList {
-                it.content?.let(StreamFrame::Append)?.let(::add)
-                it.toolCalls?.map { toolCall ->
-                    StreamFrame.ToolCall(
-                        id = toolCall.id,
-                        name = toolCall.function?.name,
-                        content = toolCall.function?.arguments
-                    )
-                }?.let(::addAll)
+    override suspend fun StreamFrameFlowBuilder.processStreamingChunk(chunk: DeepSeekChatCompletionStreamResponse) {
+        chunk.choices.firstOrNull()?.let { choice ->
+            choice.delta.content?.let { emitAppend(it) }
+            choice.delta.toolCalls?.forEach { toolCall ->
+                val index = toolCall.index
+                val id = toolCall.id
+                val name = toolCall.function?.name
+                val arguments = toolCall.function?.arguments
+                appendToolCall(index, id, name, arguments)
             }
-        }?:emptyList()
+            choice.finishReason?.let { emitEnd(it) }
+        }
+    }
 
     public override suspend fun moderate(prompt: Prompt, model: LLModel): ModerationResult {
         logger.warn { "Moderation is not supported by DeepSeek API" }

prompt/prompt-executor/prompt-executor-clients/prompt-executor-google-client/src/commonMain/kotlin/ai/koog/prompt/executor/clients/google/GoogleLLMClient.kt

@@ -21,6 +21,10 @@ import ai.koog.prompt.message.Message
 import ai.koog.prompt.message.ResponseMetaInfo
 import ai.koog.prompt.params.LLMParams
 import ai.koog.prompt.streaming.StreamFrame
+import ai.koog.prompt.streaming.emitAppend
+import ai.koog.prompt.streaming.emitEnd
+import ai.koog.prompt.streaming.emitToolCall
+import ai.koog.prompt.streaming.streamFrameFlow
 import ai.koog.prompt.structure.RegisteredBasicJsonSchemaGenerators
 import ai.koog.prompt.structure.RegisteredStandardJsonSchemaGenerators
 import ai.koog.prompt.structure.annotations.InternalStructuredOutputApi
@@ -47,7 +51,6 @@ import io.ktor.http.isSuccess
 import io.ktor.serialization.kotlinx.json.json
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.flow.Flow
-import kotlinx.coroutines.flow.flow
 import kotlinx.coroutines.withContext
 import kotlinx.datetime.Clock
 import kotlinx.serialization.json.Json
@@ -146,7 +149,7 @@ public open class GoogleLLMClient(
         prompt: Prompt,
         model: LLModel,
         tools: List<ToolDescriptor>
-    ): Flow<StreamFrame> = flow {
+    ): Flow<StreamFrame> = streamFrameFlow {
         logger.debug { "Executing streaming prompt: $prompt with model: $model" }
         require(model.capabilities.contains(LLMCapability.Completion)) {
             "Model ${model.id} does not support chat completions"
@@ -172,17 +175,20 @@ public open class GoogleLLMClient(
                     event
                         .takeIf { it.data != "[DONE]" }
                         ?.data?.trim()?.let { json.decodeFromString<GoogleResponse>(it) }
-                        ?.candidates?.firstOrNull()?.content
-                        ?.parts?.forEach { part ->
-                            when(part) {
-                                is GooglePart.FunctionCall -> emit(StreamFrame.ToolCall(
-                                    id = part.functionCall.id,
-                                    name = part.functionCall.name,
-                                    content = part.functionCall.args?.toString()?:"{}")
-                                )
-                                is GooglePart.Text -> emit(StreamFrame.Append(part.text))
-                                else -> Unit
+                        ?.candidates?.firstOrNull()?.let { candidate ->
+                            candidate.content?.parts?.forEach { part ->
+                                when (part) {
+                                    is GooglePart.FunctionCall -> emitToolCall(
+                                        id = part.functionCall.id,
+                                        name = part.functionCall.name,
+                                        content = part.functionCall.args?.toString() ?: "{}"
+                                    )
+
+                                    is GooglePart.Text -> emitAppend(part.text)
+                                    else -> Unit
+                                }
                             }
+                            candidate.finishReason?.let { emitEnd(it) }
                         }
                 }
             }