feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 41
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-7e6b2353ee8631f506bd8ef7657f1684cddf84805c01d89c691d7f98c42127f7.yml
-openapi_spec_hash: b63b980d90fc9c2b896b2739a8e15a59
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-bf7ffa610bd4a02ea5bcb157521d17a041a48f78d87bf8fe8d812d3cbb87b489.yml
+openapi_spec_hash: 90142d96969dea44c46a01abb683c426
 config_hash: 0fb0ceca5946298c416cec0cca5260c7

pkg/cmd/web.go

@@ -21,7 +21,7 @@ var webExtract = requestflag.WithInnerFlags(cli.Command{
 	Flags: []cli.Flag{
 		&requestflag.Flag[map[string]any]{
 			Name:     "schema",
-			Usage:    "JSON Schema for the returned data object. TypeScript Zod users can pass a JSON Schema generated from a Zod object; Python users can pass the equivalent JSON Schema object.",
+			Usage:    "JSON Schema for the returned data object. Image fields such as `image_urls` or `product_photos` automatically make page image references available to extraction, so product data and photos can be returned in one call. TypeScript Zod users can pass a JSON Schema generated from a Zod object; Python users can pass the equivalent JSON Schema object.",
 			Required: true,
 			BodyPath: "schema",
 		},
@@ -31,6 +31,11 @@ var webExtract = requestflag.WithInnerFlags(cli.Command{
 			Required: true,
 			BodyPath: "url",
 		},
+		&requestflag.Flag[[]map[string]any]{
+			Name:     "action",
+			Usage:    "Optional browser actions executed in order on the requested page after it loads and before extraction. Requires a paid plan. When actions are provided and stopAfterMs is omitted, the crawl budget defaults to 110000 ms.",
+			BodyPath: "actions",
+		},
 		&requestflag.Flag[bool]{
 			Name:     "fact-check",
 			Usage:    "When true, every returned value must be grounded in facts stated on the page; fields that cannot be supported by the page are returned as null/empty. When false (default), the model may make reasonable inferences and derivations from the page content (e.g. ideal customer, competitor analysis, recommendations) while keeping verifiable specifics (names, quotes, URLs, dates, metrics) faithful to the source.",
@@ -84,7 +89,7 @@ var webExtract = requestflag.WithInnerFlags(cli.Command{
 		},
 		&requestflag.Flag[int64]{
 			Name:     "stop-after-ms",
-			Usage:    "Soft time budget for the crawl in milliseconds. Min: 10000 (10s). Max: 110000 (110s). Default: 80000 (80s).",
+			Usage:    "Soft time budget for the crawl in milliseconds. Min: 10000 (10s). Max: 110000 (110s). Defaults to 80000 (80s), or 110000 (110s) when browser actions are provided.",
 			Default:  80000,
 			BodyPath: "stopAfterMs",
 		},

pkg/cmd/web_test.go

@@ -18,6 +18,7 @@ func TestWebExtract(t *testing.T) {
 			"web", "extract",
 			"--schema", "{type: bar, properties: bar, required: bar, additionalProperties: bar}",
 			"--url", "https://example.com",
+			"--action", "{do: wait, timeMs: 0}",
 			"--fact-check=true",
 			"--follow-subdomains=true",
 			"--include-frames=true",
@@ -46,6 +47,7 @@ func TestWebExtract(t *testing.T) {
 			"web", "extract",
 			"--schema", "{type: bar, properties: bar, required: bar, additionalProperties: bar}",
 			"--url", "https://example.com",
+			"--action", "{do: wait, timeMs: 0}",
 			"--fact-check=true",
 			"--follow-subdomains=true",
 			"--include-frames=true",
@@ -74,6 +76,9 @@ func TestWebExtract(t *testing.T) {
 			"  required: bar\n" +
 			"  additionalProperties: bar\n" +
 			"url: https://example.com\n" +
+			"actions:\n" +
+			"  - do: wait\n" +
+			"    timeMs: 0\n" +
 			"factCheck: true\n" +
 			"followSubdomains: true\n" +
 			"includeFrames: true\n" +