feat(api): improve SearchRepositories pagination with next_page and total_count

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 160
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-f35d75f04023f8de20cc787ab5202c4853a79ea14fa8e639f598e034b312207f.yml
-openapi_spec_hash: 0b2bf8b46a5bb29402fb9ae08ce6314f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-b40906da1a429be933f59cd9c3b2f7197aef9b302033558e7cbb65579357240a.yml
+openapi_spec_hash: bc0aec8cac7bfb2a69792bb43cfe50d2
 config_hash: d3267594264bfb76d2ee7e881d5f8a5a

src/gitpod/types/runner_search_repositories_response.py

@@ -10,7 +10,12 @@
 
 
 class Pagination(BaseModel):
-    """Pagination information for the response"""
+    """
+    Pagination information for the response.
+     Token format: "NEXT_PAGE/TOTAL_PAGES/TOTAL_COUNT" (e.g., "2/40/1000").
+     Use -1 for unknown values (e.g., "2/-1/-1" when totals unavailable).
+     Empty token means no more pages.
+    """
 
     next_token: Optional[str] = FieldInfo(alias="nextToken", default=None)
     """Token passed for retrieving the next set of results.
@@ -29,10 +34,18 @@ class Repository(BaseModel):
 
 class RunnerSearchRepositoriesResponse(BaseModel):
     last_page: Optional[int] = FieldInfo(alias="lastPage", default=None)
-    """Last page in the responses"""
+    """Deprecated: Use pagination token instead.
+
+    Total pages can be extracted from token.
+    """
 
     pagination: Optional[Pagination] = None
-    """Pagination information for the response"""
+    """
+    Pagination information for the response. Token format:
+    "NEXT_PAGE/TOTAL_PAGES/TOTAL_COUNT" (e.g., "2/40/1000"). Use -1 for unknown
+    values (e.g., "2/-1/-1" when totals unavailable). Empty token means no more
+    pages.
+    """
 
     repositories: Optional[List[Repository]] = None
     """List of repositories matching the search criteria"""