feat(interactions): Add Interactions API support for Java SDK

[prasadskarmarkar]

Implements the Interactions API for the Java SDK, addressing feature request #749.
Based on the OpenAPI spec at ai.google.dev/static/api/interactions.openapi.json
and API documentation at ai.google.dev/api/interactions-api.

Core Clients

• Synchronous Client (Interactions.java) - create, get, cancel, delete operations
• Async Client (AsyncInteractions.java) - CompletableFuture-based operations
• Integration - Seamless integration with existing Client.java

Streaming Support (SSE)

• Real-time Streaming - createStream() and getStream() methods for live interaction updates
• 6 Event Types - InteractionEvent, ContentStart, ContentDelta, ContentStop, InteractionStatusUpdate, ErrorEvent
• 19 Delta Types - Text, Image, Audio, Video, Document, Thought, FunctionCall, and 12 tool-specific deltas
• Stream Resumption - Support for interrupted streams via lastEventId
• Type-Safe Deserialization - Jackson polymorphic deserializer with @JsonTypeInfo discriminator
• Auto-Closeable - try-with-resources support for proper resource management

Type System

Core Types

• Interaction - Response type with status, outputs, usage metadata
• CreateInteractionConfig - Rich configuration with model/agent selection, tools, generation config
• GenerationConfig - Thinking level, speech/image config, response modality

Content Types (17)

TextContent, ImageContent, AudioContent, VideoContent, DocumentContent, ThoughtContent,
ThoughtSummaryContent, FunctionCallContent, FunctionResultContent, CodeExecutionCallContent,
CodeExecutionResultContent, GoogleSearchCallContent, GoogleSearchResultContent,
UrlContextCallContent, UrlContextResultContent, FileSearchCallContent, McpServerToolCallContent

Tool Types (7)

Function, GoogleSearch, CodeExecution, FileSearch, UrlContext, ComputerUse, McpServer

Key Features

✓ Multi-turn conversations via previousInteractionId
✓ Manual function calling workflow (application-side execution required)
✓ Background operation support with cancel capability
✓ Rich media support (text, images, audio, video, documents)
✓ Comprehensive tool ecosystem with 7 built-in tools
✓ SSE streaming with resumption support
✓ Agent configuration (Deep Research, Dynamic agents)

Testing

• Unit Tests - Validation, type serialization, builders
• Integration Tests - Mock-based client interaction tests
• Streaming Tests - Event parsing, polymorphic deserialization, status transitions
• Comprehensive Coverage - 25+ test classes covering all features

Examples (43 files)

Non-Streaming (19)

• Basic operations (create, get, cancel, delete)
• Content types (text, image, audio, video, document)
• Tools (function calling, Google Search, URL context, code execution, file search, MCP server)
• Multi-turn conversations
• Agent configurations

Streaming (23)

• Basic streaming iteration
• Media streaming (image, audio, video, document)
• Tool call streaming (functions, Google Search, URL context)
• Thought/reasoning streaming
• Multi-turn streaming conversations
• Stream resumption
• Async streaming with CompletableFuture

Pending Work

• Replay tests (setup complete, working on generating replay JSON files)

Fixes: #749

[prasadskarmarkar]

Hi @hemasekhar-p ,

This PR implements full Interactions API support for the Java SDK (including SSE streaming) and addresses #749.
Could you help route this to the appropriate reviewer, or let me know if there’s an internal plan I should align with?

Tagging @jaycee-li for visibility, as this PR adds Interactions API support and integrates with the existing client and streaming infrastructure.

[prasadskarmarkar]

@google-genai-bot review

[jaycee-li]

Hi @prasadskarmarkar, thanks for your work on the interactions API! Our internal team has actually been developing this feature in a private repo and we plan to launch it soon. Since our implementations overlap, we'll be moving forward with the internal version. We appreciate the contribution!

[prasadskarmarkar]

Hi @jaycee-li,

Thanks for the update!

I’ve completed an initial implementation of Interactions API support in adk-java (google/adk-java#796) and am currently testing it. This work builds on the Interactions API support in java-genai.

I also noticed the issue was recently labeled as an enhancement — just wanted to confirm whether this is something the team is planning to implement internally, or if external contributions would be welcome.

Before I proceed further, I’d appreciate any guidance on how best to align.