feat(batch): accept lightweight submissions and queue pending work (#2683)

Stainless-Generated-From: 1945e81b700fd8a7fc7bdfcd537dfab03de3e5c8

Author: stlc-bot

pkg/cmd/batch.go

@@ -138,7 +138,7 @@ var batchGetResults = cli.Command{
 
 var batchSubmit = requestflag.WithInnerFlags(cli.Command{
 	Name:    "submit",
-	Usage:   "Scrape up to 100,000 URLs, or crawl a site, asynchronously using the same\nformats and scrape parameters as POST /web/scrape. Choose Markdown, HTML,\nscreenshots, images, bytes, parsed fields, products, highlights, and JSON. Poll\nthe batch ID or receive a webhook when it finishes.",
+	Usage:   "Scrape up to 100,000 URLs, or crawl a site, asynchronously using the same\nformats and scrape parameters as POST /web/scrape. Choose Markdown, HTML,\nscreenshots, images, bytes, parsed fields, products, highlights, and JSON.\nSubmission persists the input and returns immediately with status pending.\nOrganizations with fewer than 10 available credits and no overage are rejected\nwith 402 up front. Each organization can submit up to 1,000 batches per minute,\nindependently of its polling budget. Batches wait pending when execution\ncapacity is full. Validation, sitemap discovery, the full credit quote, and\nshard scheduling happen afterward. Poll the batch ID or receive a webhook when\nit finishes. Deferred rejections appear as status failed with a failure code and\nmessage.",
 	Suggest: true,
 	Flags: []cli.Flag{
 		&requestflag.Flag[map[string]any]{

pkg/cmd/batch_test.go

@@ -33,7 +33,7 @@ func TestBatchList(t *testing.T) {
 			"--q", "batch_1a2b",
 			"--search-type", "exact",
 			"--should-include-unified=true",
-			"--status", "queued",
+			"--status", "pending",
 			"--tags", "docs,competitor",
 		)
 	})