feat: add types for Live API

PiperOrigin-RevId: 734211894

Author: jaycee-li

src/main/java/com/google/genai/types/LiveClientContent.java

@@ -0,0 +1,87 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Auto-generated code. Do not edit.
+
+package com.google.genai.types;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import com.google.auto.value.AutoValue;
+import com.google.genai.JsonSerializable;
+import java.util.List;
+import java.util.Optional;
+
+/**
+ * Incremental update of the current conversation delivered from the client.
+ *
+ * <p>All the content here will unconditionally be appended to the conversation history and used as
+ * part of the prompt to the model to generate content.
+ *
+ * <p>A message here will interrupt any current model generation.
+ */
+@AutoValue
+@JsonDeserialize(builder = LiveClientContent.Builder.class)
+public abstract class LiveClientContent extends JsonSerializable {
+  /**
+   * The content appended to the current conversation with the model.
+   *
+   * <p>For single-turn queries, this is a single instance. For multi-turn queries, this is a
+   * repeated field that contains conversation history and latest request.
+   */
+  @JsonProperty("turns")
+  public abstract Optional<List<Content>> turns();
+
+  /**
+   * If true, indicates that the server content generation should start with the currently
+   * accumulated prompt. Otherwise, the server will await additional messages before starting
+   * generation.
+   */
+  @JsonProperty("turnComplete")
+  public abstract Optional<Boolean> turnComplete();
+
+  /** Instantiates a builder for LiveClientContent. */
+  public static Builder builder() {
+    return new AutoValue_LiveClientContent.Builder();
+  }
+
+  /** Creates a builder with the same values as this instance. */
+  public abstract Builder toBuilder();
+
+  /** Builder for LiveClientContent. */
+  @AutoValue.Builder
+  public abstract static class Builder {
+    /** For internal usage. Please use `LiveClientContent.builder()` for instantiation. */
+    @JsonCreator
+    private static Builder create() {
+      return new AutoValue_LiveClientContent.Builder();
+    }
+
+    @JsonProperty("turns")
+    public abstract Builder turns(List<Content> turns);
+
+    @JsonProperty("turnComplete")
+    public abstract Builder turnComplete(boolean turnComplete);
+
+    public abstract LiveClientContent build();
+  }
+
+  /** Deserializes a JSON string to a LiveClientContent object. */
+  public static LiveClientContent fromJson(String jsonString) {
+    return JsonSerializable.fromJsonString(jsonString, LiveClientContent.class);
+  }
+}

src/main/java/com/google/genai/types/LiveClientMessage.java

@@ -0,0 +1,87 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Auto-generated code. Do not edit.
+
+package com.google.genai.types;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import com.google.auto.value.AutoValue;
+import com.google.genai.JsonSerializable;
+import java.util.Optional;
+
+/** Messages sent by the client in the API call. */
+@AutoValue
+@JsonDeserialize(builder = LiveClientMessage.Builder.class)
+public abstract class LiveClientMessage extends JsonSerializable {
+  /**
+   * Message to be sent by the system when connecting to the API. SDK users should not send this
+   * message.
+   */
+  @JsonProperty("setup")
+  public abstract Optional<LiveClientSetup> setup();
+
+  /** Incremental update of the current conversation delivered from the client. */
+  @JsonProperty("clientContent")
+  public abstract Optional<LiveClientContent> clientContent();
+
+  /** User input that is sent in real time. */
+  @JsonProperty("realtimeInput")
+  public abstract Optional<LiveClientRealtimeInput> realtimeInput();
+
+  /** Response to a `ToolCallMessage` received from the server. */
+  @JsonProperty("toolResponse")
+  public abstract Optional<LiveClientToolResponse> toolResponse();
+
+  /** Instantiates a builder for LiveClientMessage. */
+  public static Builder builder() {
+    return new AutoValue_LiveClientMessage.Builder();
+  }
+
+  /** Creates a builder with the same values as this instance. */
+  public abstract Builder toBuilder();
+
+  /** Builder for LiveClientMessage. */
+  @AutoValue.Builder
+  public abstract static class Builder {
+    /** For internal usage. Please use `LiveClientMessage.builder()` for instantiation. */
+    @JsonCreator
+    private static Builder create() {
+      return new AutoValue_LiveClientMessage.Builder();
+    }
+
+    @JsonProperty("setup")
+    public abstract Builder setup(LiveClientSetup setup);
+
+    @JsonProperty("clientContent")
+    public abstract Builder clientContent(LiveClientContent clientContent);
+
+    @JsonProperty("realtimeInput")
+    public abstract Builder realtimeInput(LiveClientRealtimeInput realtimeInput);
+
+    @JsonProperty("toolResponse")
+    public abstract Builder toolResponse(LiveClientToolResponse toolResponse);
+
+    public abstract LiveClientMessage build();
+  }
+
+  /** Deserializes a JSON string to a LiveClientMessage object. */
+  public static LiveClientMessage fromJson(String jsonString) {
+    return JsonSerializable.fromJsonString(jsonString, LiveClientMessage.class);
+  }
+}

src/main/java/com/google/genai/types/LiveClientRealtimeInput.java

@@ -0,0 +1,76 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Auto-generated code. Do not edit.
+
+package com.google.genai.types;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import com.google.auto.value.AutoValue;
+import com.google.genai.JsonSerializable;
+import java.util.List;
+import java.util.Optional;
+
+/**
+ * User input that is sent in real time.
+ *
+ * <p>This is different from `ClientContentUpdate` in a few ways:
+ *
+ * <p>- Can be sent continuously without interruption to model generation. - If there is a need to
+ * mix data interleaved across the `ClientContentUpdate` and the `RealtimeUpdate`, server attempts
+ * to optimize for best response, but there are no guarantees. - End of turn is not explicitly
+ * specified, but is rather derived from user activity (for example, end of speech). - Even before
+ * the end of turn, the data is processed incrementally to optimize for a fast start of the response
+ * from the model. - Is always assumed to be the user's input (cannot be used to populate
+ * conversation history).
+ */
+@AutoValue
+@JsonDeserialize(builder = LiveClientRealtimeInput.Builder.class)
+public abstract class LiveClientRealtimeInput extends JsonSerializable {
+  /** Inlined bytes data for media input. */
+  @JsonProperty("mediaChunks")
+  public abstract Optional<List<Blob>> mediaChunks();
+
+  /** Instantiates a builder for LiveClientRealtimeInput. */
+  public static Builder builder() {
+    return new AutoValue_LiveClientRealtimeInput.Builder();
+  }
+
+  /** Creates a builder with the same values as this instance. */
+  public abstract Builder toBuilder();
+
+  /** Builder for LiveClientRealtimeInput. */
+  @AutoValue.Builder
+  public abstract static class Builder {
+    /** For internal usage. Please use `LiveClientRealtimeInput.builder()` for instantiation. */
+    @JsonCreator
+    private static Builder create() {
+      return new AutoValue_LiveClientRealtimeInput.Builder();
+    }
+
+    @JsonProperty("mediaChunks")
+    public abstract Builder mediaChunks(List<Blob> mediaChunks);
+
+    public abstract LiveClientRealtimeInput build();
+  }
+
+  /** Deserializes a JSON string to a LiveClientRealtimeInput object. */
+  public static LiveClientRealtimeInput fromJson(String jsonString) {
+    return JsonSerializable.fromJsonString(jsonString, LiveClientRealtimeInput.class);
+  }
+}

src/main/java/com/google/genai/types/LiveClientSetup.java

@@ -0,0 +1,98 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Auto-generated code. Do not edit.
+
+package com.google.genai.types;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import com.google.auto.value.AutoValue;
+import com.google.genai.JsonSerializable;
+import java.util.List;
+import java.util.Optional;
+
+/** Message contains configuration that will apply for the duration of the streaming session. */
+@AutoValue
+@JsonDeserialize(builder = LiveClientSetup.Builder.class)
+public abstract class LiveClientSetup extends JsonSerializable {
+  /** The fully qualified name of the publisher model or tuned model endpoint to use. */
+  @JsonProperty("model")
+  public abstract Optional<String> model();
+
+  /**
+   * The generation configuration for the session.
+   *
+   * <p>The following fields are supported: - `response_logprobs` - `response_mime_type` -
+   * `logprobs` - `response_schema` - `stop_sequence` - `routing_config` - `audio_timestamp`
+   */
+  @JsonProperty("generationConfig")
+  public abstract Optional<GenerationConfig> generationConfig();
+
+  /**
+   * The user provided system instructions for the model. Note: only text should be used in parts
+   * and content in each part will be in a separate paragraph.
+   */
+  @JsonProperty("systemInstruction")
+  public abstract Optional<Content> systemInstruction();
+
+  /**
+   * A list of `Tools` the model may use to generate the next response.
+   *
+   * <p>A `Tool` is a piece of code that enables the system to interact with external systems to
+   * perform an action, or set of actions, outside of knowledge and scope of the model.
+   */
+  @JsonProperty("tools")
+  public abstract Optional<List<Tool>> tools();
+
+  /** Instantiates a builder for LiveClientSetup. */
+  public static Builder builder() {
+    return new AutoValue_LiveClientSetup.Builder();
+  }
+
+  /** Creates a builder with the same values as this instance. */
+  public abstract Builder toBuilder();
+
+  /** Builder for LiveClientSetup. */
+  @AutoValue.Builder
+  public abstract static class Builder {
+    /** For internal usage. Please use `LiveClientSetup.builder()` for instantiation. */
+    @JsonCreator
+    private static Builder create() {
+      return new AutoValue_LiveClientSetup.Builder();
+    }
+
+    @JsonProperty("model")
+    public abstract Builder model(String model);
+
+    @JsonProperty("generationConfig")
+    public abstract Builder generationConfig(GenerationConfig generationConfig);
+
+    @JsonProperty("systemInstruction")
+    public abstract Builder systemInstruction(Content systemInstruction);
+
+    @JsonProperty("tools")
+    public abstract Builder tools(List<Tool> tools);
+
+    public abstract LiveClientSetup build();
+  }
+
+  /** Deserializes a JSON string to a LiveClientSetup object. */
+  public static LiveClientSetup fromJson(String jsonString) {
+    return JsonSerializable.fromJsonString(jsonString, LiveClientSetup.class);
+  }
+}