feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 25
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-00c5b8f1ebfe212bc8fb46204f5c05507630afa55b10f77e3a43c66d21edbb77.yml
-openapi_spec_hash: 8bf4489b9bce0e52a89480109ffc5257
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-d3da262409c68576e457536f6c0e7ecc538219e0af19df415111c18f8fe92cfd.yml
+openapi_spec_hash: 25009575202702d24bc6672472eb8506
 config_hash: c7b0cdaba3b9797b77efd89e1754d803

pkg/cmd/web.go

@@ -293,10 +293,15 @@ var webSearch = requestflag.WithInnerFlags(cli.Command{
 	Flags: []cli.Flag{
 		&requestflag.Flag[string]{
 			Name:     "query",
-			Usage:    "Natural-language search query.",
+			Usage:    "Search query. Accepts natural language as well as Google-style search operators such as `site:`, `-site:`, `inurl:`, `intitle:`, quoted phrases, and `OR`.",
 			Required: true,
 			BodyPath: "query",
 		},
+		&requestflag.Flag[string]{
+			Name:     "country",
+			Usage:    "Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific country (maps to Google's `gl` parameter). Example: \"us\", \"gb\", \"de\".",
+			BodyPath: "country",
+		},
 		&requestflag.Flag[[]string]{
 			Name:     "exclude-domain",
 			Usage:    `Blocklist — drop results from these domains. Example: ["pinterest.com", "reddit.com"].`,
@@ -317,6 +322,12 @@ var webSearch = requestflag.WithInnerFlags(cli.Command{
 			Usage:    "Inline Markdown scraping for each result. Set `enabled: true` to activate.",
 			BodyPath: "markdownOptions",
 		},
+		&requestflag.Flag[int64]{
+			Name:     "num-results",
+			Usage:    "Number of results to request and return (10–100). Defaults to 10.",
+			Default:  10,
+			BodyPath: "numResults",
+		},
 		&requestflag.Flag[bool]{
 			Name:     "query-fanout",
 			Usage:    "Expand the query into multiple parallel variants for broader recall.",

pkg/cmd/web_test.go

@@ -188,10 +188,12 @@ func TestWebSearch(t *testing.T) {
 			"--api-key", "string",
 			"web", "search",
 			"--query", "x",
+			"--country", "af",
 			"--exclude-domain", "string",
 			"--freshness", "last_24_hours",
 			"--include-domain", "string",
 			"--markdown-options", "{enabled: true, includeFrames: true, includeImages: true, includeLinks: true, maxAgeMs: 0, pdf: {end: 1, shouldParse: true, start: 1}, shortenBase64Images: true, timeoutMS: 1000, useMainContentOnly: true, waitForMs: 0}",
+			"--num-results", "10",
 			"--query-fanout=true",
 			"--timeout-ms", "1000",
 		)
@@ -207,6 +209,7 @@ func TestWebSearch(t *testing.T) {
 			"--api-key", "string",
 			"web", "search",
 			"--query", "x",
+			"--country", "af",
 			"--exclude-domain", "string",
 			"--freshness", "last_24_hours",
 			"--include-domain", "string",
@@ -220,6 +223,7 @@ func TestWebSearch(t *testing.T) {
 			"--markdown-options.timeout-ms", "1000",
 			"--markdown-options.use-main-content-only=true",
 			"--markdown-options.wait-for-ms", "0",
+			"--num-results", "10",
 			"--query-fanout=true",
 			"--timeout-ms", "1000",
 		)
@@ -229,6 +233,7 @@ func TestWebSearch(t *testing.T) {
 		// Test piping YAML data over stdin
 		pipeData := []byte("" +
 			"query: x\n" +
+			"country: af\n" +
 			"excludeDomains:\n" +
 			"  - string\n" +
 			"freshness: last_24_hours\n" +
@@ -248,6 +253,7 @@ func TestWebSearch(t *testing.T) {
 			"  timeoutMS: 1000\n" +
 			"  useMainContentOnly: true\n" +
 			"  waitForMs: 0\n" +
+			"numResults: 10\n" +
 			"queryFanout: true\n" +
 			"timeoutMS: 1000\n")
 		mocktest.TestRunMockTestWithPipeAndFlags(