feat!: Make some numeric fields to pointer type and bool fields to value type, and rename ControlReferenceTypeControlType* constants

PiperOrigin-RevId: 718535424

Author: qiaodev

client.go

@@ -40,8 +40,8 @@ type Backend int
 const (
 	// BackendUnspecified causes the backend determined automatically. If the
 	// GOOGLE_GENAI_USE_VERTEXAI environment variable is set to "1" or "true", then
-	// the backend is `BackendVertexAI`. Otherwise, if GOOGLE_GENAI_USE_VERTEXAI
-	// is unset or set to any other value, then `BackendGeminiAPI` is used.  Explicitly
+	// the backend is BackendVertexAI. Otherwise, if GOOGLE_GENAI_USE_VERTEXAI
+	// is unset or set to any other value, then BackendGeminiAPI is used.  Explicitly
 	// setting the backend in ClientConfig overrides the environment variable.
 	BackendUnspecified Backend = iota
 	// BackendGeminiAPI is the Gemini API backend.

example_test.go

@@ -617,7 +617,7 @@ func ExampleModels_GenerateContent_config_vertexai() {
 			TopK:             genai.Ptr(2.0),
 			ResponseMIMEType: "application/json",
 			StopSequences:    []string{"\n"},
-			CandidateCount:   2,
+			CandidateCount:   genai.Ptr(int64(2)),
 			Seed:             genai.Ptr[int64](42),
 			MaxOutputTokens:  genai.Ptr[int64](128),
 			PresencePenalty:  genai.Ptr(0.5),
@@ -651,7 +651,7 @@ func ExampleModels_GenerateContent_config_geminiapi() {
 			TopK:             genai.Ptr(2.0),
 			ResponseMIMEType: "application/json",
 			StopSequences:    []string{"\n"},
-			CandidateCount:   2,
+			CandidateCount:   genai.Ptr(int64(2)),
 			Seed:             genai.Ptr(int64(42)),
 			MaxOutputTokens:  genai.Ptr(int64(128)),
 			PresencePenalty:  genai.Ptr(0.5),

live.go

@@ -23,12 +23,16 @@ import (
 	"github.com/gorilla/websocket"
 )
 
-// Live struct encapsulates the configuration for realtime interaction with the Generative Language API.
+// Live can be used to create a realtime connection to the API.
+// It is initiated when creating a client. You don't need to create a new Live object.
+//
+//	client, _ := genai.NewClient(ctx, &genai.ClientConfig{})
+//	session, _ := client.Live.Connect(model, &genai.LiveConnectConfig{}).
 type Live struct {
 	apiClient *apiClient
 }
 
-// Session struct represents a realtime connection to the API.
+// Session is a realtime connection to the API.
 type Session struct {
 	conn      *websocket.Conn
 	apiClient *apiClient
@@ -116,7 +120,7 @@ func (r *Live) Connect(model string, config *LiveConnectConfig) (*Session, error
 	return s, nil
 }
 
-// Send transmits a LiveClientMessage over the established websocket connection.
+// Send transmits a LiveClientMessage over the established connection.
 // It returns an error if sending the message fails.
 func (s *Session) Send(input *LiveClientMessage) error {
 	if input.Setup != nil {
@@ -146,7 +150,7 @@ func (s *Session) Send(input *LiveClientMessage) error {
 	return s.conn.WriteMessage(websocket.TextMessage, []byte(data))
 }
 
-// Receive reads a LiveServerMessage from the websocket connection.
+// Receive reads a LiveServerMessage from the connection.
 // It returns the received message or an error if reading or unmarshalling fails.
 func (s *Session) Receive() (*LiveServerMessage, error) {
 	messageType, msgBytes, err := s.conn.ReadMessage()
@@ -181,7 +185,7 @@ func (s *Session) Receive() (*LiveServerMessage, error) {
 	return message, err
 }
 
-// Close terminates the websocket connection.
+// Close terminates the connection.
 func (s *Session) Close() {
 	s.conn.Close()
 }

models_helpers.go

@@ -30,9 +30,6 @@ func (c *GenerateContentConfig) setDefaults() {
 	if c == nil {
 		return
 	}
-	if c.CandidateCount == 0 {
-		c.CandidateCount = 1
-	}
 	if c.SystemInstruction != nil && c.SystemInstruction.Role == "" {
 		c.SystemInstruction.setDefaults()
 	}

models_helpers_test.go

@@ -43,7 +43,7 @@ func TestContentHelpers(t *testing.T) {
 	})
 
 	t.Run("GenerateContentConfig_setDefaults", func(t *testing.T) {
-		expected := &GenerateContentConfig{SystemInstruction: &Content{Parts: []*Part{{Text: "Hello"}}, Role: roleUser}, CandidateCount: 1}
+		expected := &GenerateContentConfig{SystemInstruction: &Content{Parts: []*Part{{Text: "Hello"}}, Role: roleUser}}
 		got := &GenerateContentConfig{SystemInstruction: &Content{Parts: []*Part{{Text: "Hello"}}}}
 		got.setDefaults()
 		if diff := cmp.Diff(got, expected); diff != "" {