feat!: default Gemini API version to v1 instead of v1beta across SDKs

USAGE.md

@@ -1,6 +1,6 @@
 <!-- Start SDK Example Usage [usage] -->
 ```bash
-gemini-api agent list --api-key test_api_key --api-version v1beta
+gemini-api agent list --api-key test_api_key --api-version v1
 
 ```
 <!-- End SDK Example Usage [usage] -->

internal/cli/custom/custom_test.go

@@ -1676,8 +1676,8 @@ func TestAttachInteractionInputsAndNormalizeFilesURIs(t *testing.T) {
 		}
 		inputs, _ := parsed["input"].([]any)
 		imgPart, _ := inputs[0].(map[string]any)
-		if imgPart["uri"] != "https://generativelanguage.googleapis.com/v1beta/files/abc123" {
-			t.Errorf("uri = %v, want full v1beta files URI", imgPart["uri"])
+		if imgPart["uri"] != "https://generativelanguage.googleapis.com/v1/files/abc123" {
+			t.Errorf("uri = %v, want full v1 files URI", imgPart["uri"])
 		}
 	})
 
@@ -1794,7 +1794,7 @@ func TestAttachInteractionInputsAndNormalizeFilesURIs(t *testing.T) {
 		if err := rootDry.Execute(); err != nil {
 			t.Fatalf("Execute custom server-url --dry-run failed: %v", err)
 		}
-		if !strings.Contains(gotBody, "https://generativelanguage.googleapis.com/v1beta/files/abc123") || strings.Contains(gotBody, "custom.example.com") {
+		if !strings.Contains(gotBody, "https://generativelanguage.googleapis.com/v1/files/abc123") || strings.Contains(gotBody, "custom.example.com") {
 			t.Errorf("dry-run body = %s, want canonical Files API expansion independent of --server-url", gotBody)
 		}
 
@@ -1807,7 +1807,7 @@ func TestAttachInteractionInputsAndNormalizeFilesURIs(t *testing.T) {
 		if filesGetCalls != 0 {
 			t.Errorf("filesGetCalls = %d, want 0 when mime_type is set", filesGetCalls)
 		}
-		if !strings.Contains(gotBody, `"uri":"https://generativelanguage.googleapis.com/v1beta/files/abc123"`) || strings.Contains(gotBody, srv.URL) {
+		if !strings.Contains(gotBody, `"uri":"https://generativelanguage.googleapis.com/v1/files/abc123"`) || strings.Contains(gotBody, srv.URL) {
 			t.Errorf("body = %s, want --server-url Files URI rewritten to the canonical Files API URI", gotBody)
 		}
 	})

internal/cli/custom/media.go

@@ -532,7 +532,7 @@ func resolveMediaSource(cmd *cobra.Command, s *sdk.GeminiAPI, arg, mimeOverride
 // its URI and MIME type. Under --dry-run the lookup is previewed and a
 // placeholder URI is used so the main request can still be previewed.
 func resolveRemoteFile(cmd *cobra.Command, s *sdk.GeminiAPI, name, id, mimeOverride, ref string, policy mediaPolicy) (*mediaSource, error) {
-	fileURI := "https://generativelanguage.googleapis.com/v1beta/" + name
+	fileURI := expandedFilesURI(cmd, name)
 	mimeType := strings.ToLower(strings.TrimSpace(mimeOverride))
 	if err := checkRemoteMIME(mimeType, ref, policy); err != nil {
 		return nil, err // a bad override fails before the lookup is sent
@@ -1029,7 +1029,7 @@ func normalizeInputValueFileURIs(cmd *cobra.Command, s **sdk.GeminiAPI, val any)
 // uri in a files.get response does.
 func expandedFilesURI(cmd *cobra.Command, name string) string {
 	base := "https://generativelanguage.googleapis.com"
-	ver := "v1beta"
+	ver := "v1"
 	if cmd != nil && flagutil.FlagChanged(cmd, "api-version") {
 		if v, ok := flagutil.GetStringFlag(cmd, "api-version"); ok && strings.TrimSpace(v) != "" {
 			ver = strings.Trim(strings.TrimSpace(v), "/")

internal/cli/custom/rawhttp.go

@@ -81,7 +81,7 @@ func newRawTransport(cmd *cobra.Command) (*rawTransport, error) {
 	}
 	t.baseURL = strings.TrimRight(t.baseURL, "/")
 
-	// API version: flag > env/config > flag default (v1beta). An explicitly
+	// API version: flag > env/config > flag default (v1). An explicitly
 	// empty flag is invalid; only an absent value may fall back to the default.
 	apiVersionExplicit := flagutil.FlagChanged(cmd, "api-version")
 	if apiVersionExplicit {
@@ -92,7 +92,7 @@ func newRawTransport(cmd *cobra.Command) (*rawTransport, error) {
 		t.apiVersion, _ = flagutil.GetStringFlag(cmd, "api-version")
 	}
 	if t.apiVersion == "" && !apiVersionExplicit {
-		t.apiVersion = "v1beta"
+		t.apiVersion = "v1"
 	}
 	// The generated client's request hook holds the version to one path
 	// segment; that hook does not run here, and the version is spliced into the