feat(search): add languages filter to web search (#1833)

Stainless-Generated-From: 13105888483fa150eaf7eb68006c78a7bc4776cb

Author: stlc-bot

pkg/cmd/news_test.go

@@ -18,7 +18,7 @@ func TestNewsSearch(t *testing.T) {
 			"news", "search",
 			"--search-by", "{entity: {domain: stripe.com, type: domain}, type: entity}",
 			"--cursor", "cursor",
-			"--filter-by", "{articleLanguage: [ar], articleType: [editorial], date: {from: 0, to: 0}, sourceCountry: [ae], sourceDomain: [x]}",
+			"--filter-by", "{articleLanguage: [am], articleType: [editorial], date: {from: 0, to: 0}, sourceCountry: [ae], sourceDomain: [x]}",
 			"--limit", "1",
 			"--sort-by", "{type: relevance}",
 			"--tag", "production",
@@ -38,7 +38,7 @@ func TestNewsSearch(t *testing.T) {
 			"--search-by.entity", "{domain: stripe.com, type: domain}",
 			"--search-by.type", "entity",
 			"--cursor", "cursor",
-			"--filter-by.article-language", "[ar]",
+			"--filter-by.article-language", "[am]",
 			"--filter-by.article-type", "[editorial]",
 			"--filter-by.date", "{from: 0, to: 0}",
 			"--filter-by.source-country", "[ae]",
@@ -61,7 +61,7 @@ func TestNewsSearch(t *testing.T) {
 			"cursor: cursor\n" +
 			"filterBy:\n" +
 			"  articleLanguage:\n" +
-			"    - ar\n" +
+			"    - am\n" +
 			"  articleType:\n" +
 			"    - editorial\n" +
 			"  date:\n" +

pkg/cmd/web.go

@@ -342,6 +342,12 @@ var webSearch = requestflag.WithInnerFlags(cli.Command{
 			Usage:    `Allowlist — only return results from these domains. Up to 100 domains. Example: ["arxiv.org", "github.com"].`,
 			BodyPath: "includeDomains",
 		},
+		&requestflag.Flag[any]{
+			Name:     "languages",
+			Usage:    "Languages to return results in, as BCP 47 language codes such as `en` or `de`, or \"all\" for any language. Defaults to \"all\". Example: [\"en\", \"de\"].",
+			Default:  "all",
+			BodyPath: "languages",
+		},
 		&requestflag.Flag[map[string]any]{
 			Name:     "markdown-options",
 			Usage:    "Inline Markdown scraping for each result. Set `enabled: true` to activate.",

pkg/cmd/web_test.go

@@ -218,6 +218,7 @@ func TestWebSearch(t *testing.T) {
 			"--freshness", "last_24_hours",
 			"--highlights-options", "{enabled: true, maxCharacters: 100}",
 			"--include-domain", "xxx",
+			"--languages", "all",
 			"--markdown-options", "{enabled: true, includeFrames: true, includeImages: true, includeLinks: true, maxAgeMs: 0, pdf: {end: 1, shouldParse: true, start: 1}, shortenBase64Images: true, timeoutOpts: {milliseconds: 1, behavior: fail}, useMainContentOnly: true, waitForMs: 0}",
 			"--num-results", "10",
 			"--query-fanout=true",
@@ -245,6 +246,7 @@ func TestWebSearch(t *testing.T) {
 			"--highlights-options.enabled=true",
 			"--highlights-options.max-characters", "100",
 			"--include-domain", "xxx",
+			"--languages", "all",
 			"--markdown-options.enabled=true",
 			"--markdown-options.include-frames=true",
 			"--markdown-options.include-images=true",
@@ -279,6 +281,7 @@ func TestWebSearch(t *testing.T) {
 			"  maxCharacters: 100\n" +
 			"includeDomains:\n" +
 			"  - xxx\n" +
+			"languages: all\n" +
 			"markdownOptions:\n" +
 			"  enabled: true\n" +
 			"  includeFrames: true\n" +