feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 30
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-fb56935a194e69348fecd985f7cf8b249795b46af2fb32f6c5c8ef648cf10c15.yml
-openapi_spec_hash: 7260a560474283b7ad6ac5d426058ac9
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-98c2abed2e726f7e5006cd4ef2ce9a56e84470d1fead500f7f3d46ed47f5af8b.yml
+openapi_spec_hash: 921fc4db282f59e416e3c95d14d534f2
 config_hash: daabb160675d86b354711da1e77e5129

pkg/cmd/ai.go

@@ -31,6 +31,11 @@ var aiExtractProduct = cli.Command{
 			Default:  604800000,
 			BodyPath: "maxAgeMs",
 		},
+		&requestflag.Flag[[]string]{
+			Name:     "tag",
+			Usage:    "Optional caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.",
+			BodyPath: "tags",
+		},
 		&requestflag.Flag[int64]{
 			Name:     "timeout-ms",
 			Usage:    "Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).",
@@ -62,6 +67,11 @@ var aiExtractProducts = cli.Command{
 			Usage:    "Maximum number of products to extract.",
 			BodyPath: "maxProducts",
 		},
+		&requestflag.Flag[[]string]{
+			Name:     "tag",
+			Usage:    "Optional caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.",
+			BodyPath: "tags",
+		},
 		&requestflag.Flag[int64]{
 			Name:     "timeout-ms",
 			Usage:    "Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).",

pkg/cmd/ai_test.go

@@ -17,6 +17,8 @@ func TestAIExtractProduct(t *testing.T) {
 			"ai", "extract-product",
 			"--url", "https://example.com",
 			"--max-age-ms", "0",
+			"--tag", "production",
+			"--tag", "team-alpha",
 			"--timeout-ms", "1000",
 		)
 	})
@@ -26,6 +28,9 @@ func TestAIExtractProduct(t *testing.T) {
 		pipeData := []byte("" +
 			"url: https://example.com\n" +
 			"maxAgeMs: 0\n" +
+			"tags:\n" +
+			"  - production\n" +
+			"  - team-alpha\n" +
 			"timeoutMS: 1000\n")
 		mocktest.TestRunMockTestWithPipeAndFlags(
 			t, pipeData,
@@ -45,6 +50,8 @@ func TestAIExtractProducts(t *testing.T) {
 			"--domain", "domain",
 			"--max-age-ms", "0",
 			"--max-products", "1",
+			"--tag", "production",
+			"--tag", "team-alpha",
 			"--timeout-ms", "1000",
 		)
 	})
@@ -55,6 +62,9 @@ func TestAIExtractProducts(t *testing.T) {
 			"domain: domain\n" +
 			"maxAgeMs: 0\n" +
 			"maxProducts: 1\n" +
+			"tags:\n" +
+			"  - production\n" +
+			"  - team-alpha\n" +
 			"timeoutMS: 1000\n")
 		mocktest.TestRunMockTestWithPipeAndFlags(
 			t, pipeData,

pkg/cmd/brand.go

@@ -45,6 +45,11 @@ var brandRetrieve = cli.Command{
 			Usage:    "Optional parameter to optimize the API call for maximum speed. When set to true, the API will skip time-consuming operations for faster response at the cost of less comprehensive data.",
 			BodyPath: "maxSpeed",
 		},
+		&requestflag.Flag[[]string]{
+			Name:     "tag",
+			Usage:    "Optional caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.",
+			BodyPath: "tags",
+		},
 		&requestflag.Flag[int64]{
 			Name:     "timeout-ms",
 			Usage:    "Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).",
@@ -127,6 +132,11 @@ var brandRetrieveSimplified = cli.Command{
 			Default:   7776000000,
 			QueryPath: "maxAgeMs",
 		},
+		&requestflag.Flag[[]string]{
+			Name:      "tag",
+			Usage:     "Optional comma-separated caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.",
+			QueryPath: "tags",
+		},
 		&requestflag.Flag[int64]{
 			Name:      "timeout-ms",
 			Usage:     "Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).",

pkg/cmd/brand_test.go

@@ -20,6 +20,8 @@ func TestBrandRetrieve(t *testing.T) {
 			"--force-language", "afrikaans",
 			"--max-age-ms", "0",
 			"--max-speed=true",
+			"--tag", "production",
+			"--tag", "team-alpha",
 			"--timeout-ms", "1000",
 		)
 	})
@@ -32,6 +34,9 @@ func TestBrandRetrieve(t *testing.T) {
 			"force_language: afrikaans\n" +
 			"maxAgeMs: 0\n" +
 			"maxSpeed: true\n" +
+			"tags:\n" +
+			"  - production\n" +
+			"  - team-alpha\n" +
 			"timeoutMS: 1000\n")
 		mocktest.TestRunMockTestWithPipeAndFlags(
 			t, pipeData,
@@ -50,6 +55,8 @@ func TestBrandRetrieveSimplified(t *testing.T) {
 			"brand", "retrieve-simplified",
 			"--domain", "domain",
 			"--max-age-ms", "86400000",
+			"--tag", "production",
+			"--tag", "team-alpha",
 			"--timeout-ms", "1000",
 		)
 	})

pkg/cmd/industry.go

@@ -37,6 +37,11 @@ var industryRetrieveNaics = cli.Command{
 			Default:   1,
 			QueryPath: "minResults",
 		},
+		&requestflag.Flag[[]string]{
+			Name:      "tag",
+			Usage:     "Optional comma-separated caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.",
+			QueryPath: "tags",
+		},
 		&requestflag.Flag[int64]{
 			Name:      "timeout-ms",
 			Usage:     "Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).",
@@ -70,6 +75,11 @@ var industryRetrieveSic = cli.Command{
 			Default:   1,
 			QueryPath: "minResults",
 		},
+		&requestflag.Flag[[]string]{
+			Name:      "tag",
+			Usage:     "Optional comma-separated caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.",
+			QueryPath: "tags",
+		},
 		&requestflag.Flag[int64]{
 			Name:      "timeout-ms",
 			Usage:     "Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).",

pkg/cmd/industry_test.go

@@ -18,6 +18,8 @@ func TestIndustryRetrieveNaics(t *testing.T) {
 			"--input", "input",
 			"--max-results", "1",
 			"--min-results", "1",
+			"--tag", "production",
+			"--tag", "team-alpha",
 			"--timeout-ms", "1000",
 		)
 	})
@@ -33,6 +35,8 @@ func TestIndustryRetrieveSic(t *testing.T) {
 			"--input", "input",
 			"--max-results", "1",
 			"--min-results", "1",
+			"--tag", "production",
+			"--tag", "team-alpha",
 			"--timeout-ms", "1000",
 			"--type", "original_sic",
 		)

pkg/cmd/parse.go

@@ -62,6 +62,11 @@ var parseHandle = requestflag.WithInnerFlags(cli.Command{
 			Default:   true,
 			QueryPath: "shortenBase64Images",
 		},
+		&requestflag.Flag[[]string]{
+			Name:      "tag",
+			Usage:     "Optional comma-separated caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.",
+			QueryPath: "tags",
+		},
 		&requestflag.Flag[bool]{
 			Name:      "use-main-content-only",
 			Usage:     "Extract only the main content from HTML-like inputs",

pkg/cmd/parse_test.go

@@ -23,6 +23,8 @@ func TestParseHandle(t *testing.T) {
 			"--ocr=true",
 			"--pdf", "{end: 1, start: 1}",
 			"--shorten-base64-images=true",
+			"--tag", "production",
+			"--tag", "team-alpha",
 			"--use-main-content-only=true",
 		)
 	})
@@ -44,6 +46,8 @@ func TestParseHandle(t *testing.T) {
 			"--pdf.end", "1",
 			"--pdf.start", "1",
 			"--shorten-base64-images=true",
+			"--tag", "production",
+			"--tag", "team-alpha",
 			"--use-main-content-only=true",
 		)
 	})
@@ -61,6 +65,8 @@ func TestParseHandle(t *testing.T) {
 			"--ocr=true",
 			"--pdf", "{end: 1, start: 1}",
 			"--shorten-base64-images=true",
+			"--tag", "production",
+			"--tag", "team-alpha",
 			"--use-main-content-only=true",
 		)
 	})

pkg/cmd/utility.go

@@ -31,6 +31,11 @@ var utilityPrefetch = cli.Command{
 			Required: true,
 			BodyPath: "type",
 		},
+		&requestflag.Flag[[]string]{
+			Name:     "tag",
+			Usage:    "Optional caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.",
+			BodyPath: "tags",
+		},
 		&requestflag.Flag[int64]{
 			Name:     "timeout-ms",
 			Usage:    "Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).",