feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 40
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-1c93116e47cab52ea63490f5bca186ed3acda8bbd7f0ce5a320effb9f5b72b1f.yml
-openapi_spec_hash: f56204d55bd4bffb6e4d50d6a5d9471a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-7f75f39699c1298d16691b5a58b1312a229b78288fba6e2de4040ba1422e530f.yml
+openapi_spec_hash: b3ad781596e4c52fde918cfaae54a5d4
 config_hash: 920678668dd2da6f8966fbf1b8fde4e2

pkg/cmd/batch_test.go

@@ -82,7 +82,7 @@ func TestBatchSubmit(t *testing.T) {
 			t,
 			"--api-key", "string",
 			"batch", "submit",
-			"--input", "{data: {format: markdown, urls: [{url: https://example.com/products/anvil, itemId: sku-1, meta: {category: bar}}, {url: https://example.com/products/hammer, itemId: sku-2, meta: {foo: bar}}], options: {country: de, excludeSelectors: [x], includeImages: true, includeLinks: true, includeSelectors: [x], maxAgeMs: 0, pdf: {end: 1, ocr: 'true', shouldParse: 'true', start: 1}, settleAnimations: true, shortenBase64Images: true, useMainContentOnly: true, waitForMs: 0}}, mode: scrape}",
+			"--input", "{data: {format: markdown, urls: [{url: https://example.com/products/anvil, itemId: sku-1, meta: {category: bar}}, {url: https://example.com/products/hammer, itemId: sku-2, meta: {foo: bar}}], options: {country: de, excludeSelectors: [x], includeHTML: true, includeImages: true, includeLinks: true, includeSelectors: [x], maxAgeMs: 0, pdf: {end: 1, ocr: 'true', shouldParse: 'true', start: 1}, settleAnimations: true, shortenBase64Images: true, useMainContentOnly: true, waitForMs: 0}}, mode: scrape}",
 			"--tag", "docs",
 			"--tag", "competitor",
 			"--webhook-url", "webhookUrl",
@@ -109,6 +109,7 @@ func TestBatchSubmit(t *testing.T) {
 			"      country: de\n" +
 			"      excludeSelectors:\n" +
 			"        - x\n" +
+			"      includeHTML: true\n" +
 			"      includeImages: true\n" +
 			"      includeLinks: true\n" +
 			"      includeSelectors:\n" +

pkg/cmd/utility.go

@@ -16,18 +16,18 @@ import (
 
 var utilityPrefetch = cli.Command{
 	Name:    "prefetch",
-	Usage:   "Signal that you may fetch brand data soon to improve latency. The type field\nselects what to prefetch (currently only 'brand') and identifier carries exactly\none lookup key: a domain, or an email whose domain is extracted and validated\n(free email providers and disposable email addresses are not allowed).",
+	Usage:   "Signal that you may fetch data soon to improve latency. The type field selects\nwhat to prefetch ('brand' queues a brand data fetch, 'styleguide' queues a\nstyleguide extraction) and identifier carries exactly one lookup key: a domain,\nor an email whose domain is extracted and validated (free email providers and\ndisposable email addresses are not allowed).",
 	Suggest: true,
 	Flags: []cli.Flag{
 		&requestflag.Flag[map[string]any]{
 			Name:     "identifier",
-			Usage:    "Identifier of the brand to prefetch. Provide exactly one of domain or email.",
+			Usage:    "Identifier of the target to prefetch. Provide exactly one of domain or email.",
 			Required: true,
 			BodyPath: "identifier",
 		},
 		&requestflag.Flag[string]{
 			Name:     "type",
-			Usage:    "What to prefetch. Currently only 'brand' is supported.",
+			Usage:    "What to prefetch: 'brand' warms the brand data cache, 'styleguide' warms the styleguide cache.",
 			Required: true,
 			BodyPath: "type",
 		},

pkg/cmd/web.go

@@ -832,6 +832,12 @@ var webWebScrapeMd = requestflag.WithInnerFlags(cli.Command{
 			Default:   false,
 			QueryPath: "includeFrames",
 		},
+		&requestflag.Flag[any]{
+			Name:      "include-html",
+			Usage:     "When true, the response also includes an `html` field with the page HTML the Markdown was converted from — the same body the Scrape HTML endpoint returns for the equivalent request.",
+			Default:   false,
+			QueryPath: "includeHTML",
+		},
 		&requestflag.Flag[any]{
 			Name:      "include-images",
 			Usage:     "Include image references in Markdown output",

pkg/cmd/web_test.go

@@ -522,6 +522,7 @@ func TestWebWebScrapeMd(t *testing.T) {
 			"--exclude-selector", "[x]",
 			"--headers", "{foo: J!}",
 			"--include-frames", "'true'",
+			"--include-html", "'true'",
 			"--include-images", "'true'",
 			"--include-links", "'true'",
 			"--include-selector", "[x]",
@@ -553,6 +554,7 @@ func TestWebWebScrapeMd(t *testing.T) {
 			"--exclude-selector", "[x]",
 			"--headers", "{foo: J!}",
 			"--include-frames", "'true'",
+			"--include-html", "'true'",
 			"--include-images", "'true'",
 			"--include-links", "'true'",
 			"--include-selector", "[x]",