Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Expose turnComplete control for ADK Java live content sends

Open
  • Is something wrong?
#1,200 2 comments 0 reactions 1 assignee View on GitHub

Maintainers usually reply within 1 day

@hemasekhar-p is already working on this.

Since May 18, 2026.

  • #1381 by @YuqiGuo105 — open

Assessment

This issue has not been assessed yet.

Description

needs review

🔴 Required Information

Is your feature request related to a specific problem?

Yes. ADK Java live sessions currently expose LiveRequestQueue.content(Content), but there is no public way to control whether that content completes the current live turn.

For normal user input, completing the turn is correct. But some live applications need to append content to an already-open live session without immediately asking the model to
generate.

The lower-level GenAI Java live API supports turnComplete, but ADK Java does not currently surface it through LiveRequestQueue, LiveRequest, or BaseLlmConnection.

Describe the Solution You'd Like

Please expose an additive API for live content sends that allows callers to set turnComplete.

Example:

requestQueue.content(content, false);

Existing behavior should remain unchanged:

requestQueue.content(content); // defaults to current behavior

### Impact on your work

We are building long-running Gemini Live / ADK Java sessions where backend services may need to update live session context without treating the update as a normal user transcript turn.

Without this API, applications must work around the behavior by suppressing model output after certain content sends. That is less precise because the model may still be asked to
generate even when the caller only wanted to append content.

This is needed for current live-session work, but there is no hard public launch deadline.

### Willingness to contribute

Yes. I am willing to submit a PR if the maintainers agree with the API direction.

———

## 🟡 Recommended Information

### Describe Alternatives You've Considered

1. Application-level suppression

Track when special content is enqueued, suppress model output until the next turnComplete=true, and avoid transcript persistence for that output window.

This works as a workaround, but ADK still asks the model to generate.

2. Custom BaseLlmConnection

Implement a custom Gemini live connection that sends LiveSendClientContentParameters.turnComplete(false).

This would duplicate ADK internals and increase maintenance risk.

3. Reflection or private API access

Not recommended.

### Proposed API / Implementation

One possible additive API:

public final class LiveRequestQueue {
  public void content(Content content) {
    processor.onNext(LiveRequest.builder().content(content).build());
  }

  public void content(Content content, boolean turnComplete) {
    processor.onNext(
        LiveRequest.builder()
            .content(content)
            .turnComplete(turnComplete)
            .build());
  }
}

LiveRequest could carry:

public abstract Optional<Boolean> turnComplete();

The live send loop could dispatch:

connection.sendContent(
    request.content().get(),
    request.turnComplete().orElse(true));

BaseLlmConnection could preserve compatibility with a default method:

default Completable sendContent(Content content, boolean turnComplete) {
  return sendContent(content);
}

Then GeminiLlmConnection can pass the flag through:

LiveSendClientContentParameters.builder()
    .turns(ImmutableList.of(content))
    .turnComplete(turnComplete)
    .build();

### Additional Context

This should be backward compatible if LiveRequestQueue.content(Content) continues to behave exactly as it does today, and only callers using the new overload opt into explicit turn-
completion behavior.

The lower-level live API already supports the concept; this request is mainly about exposing that capability through ADK Java's live queue abstraction.
Dominant language
Java
Stars
1.7k
Forks
431
Avg merge
3d 2h
Merged PRs (30d)
46

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from google/adk-java

All issues in google/adk-java

Similar issues

More Java issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.