feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 29
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-adab8df19dce27396e4a0e698287f083e1f932e63b85fd8dd4d54f80f0e0b5a8.yml
-openapi_spec_hash: 717fea46f446ff97bad627f200963fd7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-ecf38e27f0c2544a8965f6cee827927343a926e1ab511aa7b34e8aa7d1866c8e.yml
+openapi_spec_hash: c5767791a19b95c52ef073902fa5da77
 config_hash: ff35e224e809656528c44163aa41bebd

pkg/cmd/monitor.go

@@ -80,9 +80,14 @@ var monitorsCreate = requestflag.WithInnerFlags(cli.Command{
 	"webhook": {
 		&requestflag.InnerFlag[string]{
 			Name:       "webhook.url",
-			Usage:      "Webhook URL called when a change is detected.",
+			Usage:      "Webhook URL events are delivered to.",
 			InnerField: "url",
 		},
+		&requestflag.InnerFlag[[]string]{
+			Name:       "webhook.events",
+			Usage:      "Events delivered to this endpoint. `change.detected` fires only when a run detects a change; `run.completed` fires on every completed run — including runs that detected no change — and embeds the change when one was detected. Defaults to `[\"change.detected\"]` when omitted.",
+			InnerField: "events",
+		},
 		&requestflag.InnerFlag[string]{
 			Name:       "webhook.secret",
 			Usage:      "Signing secret used to verify webhook authenticity. Each delivery includes an `X-Context-Signature: t=<unix>,v1=<hmac>` header, where the HMAC is SHA-256 over `\"{t}.{rawRequestBody}\"` keyed by this secret. Recompute it with a constant-time compare and reject stale timestamps to prevent replay. Generated by the API; cannot be set by clients.",
@@ -174,9 +179,14 @@ var monitorsUpdate = requestflag.WithInnerFlags(cli.Command{
 	"webhook": {
 		&requestflag.InnerFlag[string]{
 			Name:       "webhook.url",
-			Usage:      "Webhook URL called when a change is detected.",
+			Usage:      "Webhook URL events are delivered to.",
 			InnerField: "url",
 		},
+		&requestflag.InnerFlag[[]string]{
+			Name:       "webhook.events",
+			Usage:      "Events delivered to this endpoint. `change.detected` fires only when a run detects a change; `run.completed` fires on every completed run — including runs that detected no change — and embeds the change when one was detected. Defaults to `[\"change.detected\"]` when omitted.",
+			InnerField: "events",
+		},
 		&requestflag.InnerFlag[string]{
 			Name:       "webhook.secret",
 			Usage:      "Signing secret used to verify webhook authenticity. Each delivery includes an `X-Context-Signature: t=<unix>,v1=<hmac>` header, where the HMAC is SHA-256 over `\"{t}.{rawRequestBody}\"` keyed by this secret. Recompute it with a constant-time compare and reject stale timestamps to prevent replay. Generated by the API; cannot be set by clients.",

pkg/cmd/monitor_test.go

@@ -23,7 +23,7 @@ func TestMonitorsCreate(t *testing.T) {
 			"--mode", "web",
 			"--tag", "pricing",
 			"--tag", "competitor",
-			"--webhook", "{url: https://example.com/webhook}",
+			"--webhook", "{url: https://example.com/webhook, events: [change.detected, run.completed]}",
 		)
 	})
 
@@ -46,6 +46,7 @@ func TestMonitorsCreate(t *testing.T) {
 			"--tag", "pricing",
 			"--tag", "competitor",
 			"--webhook.url", "https://example.com/webhook",
+			"--webhook.events", "[change.detected, run.completed]",
 		)
 	})
 
@@ -68,7 +69,10 @@ func TestMonitorsCreate(t *testing.T) {
 			"  - pricing\n" +
 			"  - competitor\n" +
 			"webhook:\n" +
-			"  url: https://example.com/webhook\n")
+			"  url: https://example.com/webhook\n" +
+			"  events:\n" +
+			"    - change.detected\n" +
+			"    - run.completed\n")
 		mocktest.TestRunMockTestWithPipeAndFlags(
 			t, pipeData,
 			"--api-key", "string",
@@ -104,7 +108,7 @@ func TestMonitorsUpdate(t *testing.T) {
 			"--tag", "pricing",
 			"--tag", "competitor",
 			"--target", "{type: page, url: https://acme.com/pricing, normalize_whitespace: true}",
-			"--webhook", "{url: https://example.com/webhook}",
+			"--webhook", "{url: https://example.com/webhook, events: [change.detected, run.completed]}",
 		)
 	})
 
@@ -128,6 +132,7 @@ func TestMonitorsUpdate(t *testing.T) {
 			"--tag", "competitor",
 			"--target", "{type: page, url: https://acme.com/pricing, normalize_whitespace: true}",
 			"--webhook.url", "https://example.com/webhook",
+			"--webhook.events", "[change.detected, run.completed]",
 		)
 	})
 
@@ -150,7 +155,10 @@ func TestMonitorsUpdate(t *testing.T) {
 			"  url: https://acme.com/pricing\n" +
 			"  normalize_whitespace: true\n" +
 			"webhook:\n" +
-			"  url: https://example.com/webhook\n")
+			"  url: https://example.com/webhook\n" +
+			"  events:\n" +
+			"    - change.detected\n" +
+			"    - run.completed\n")
 		mocktest.TestRunMockTestWithPipeAndFlags(
 			t, pipeData,
 			"--api-key", "string",