context.dev 2.3.0 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (133) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +24 -0
  3. data/README.md +9 -9
  4. data/lib/context_dev/models/ai_extract_product_params.rb +9 -1
  5. data/lib/context_dev/models/ai_extract_products_params.rb +18 -2
  6. data/lib/context_dev/models/brand_retrieve_params.rb +109 -22
  7. data/lib/context_dev/models/brand_retrieve_response.rb +4 -6
  8. data/lib/context_dev/models/brand_retrieve_simplified_params.rb +32 -3
  9. data/lib/context_dev/models/industry_retrieve_naics_params.rb +11 -1
  10. data/lib/context_dev/models/industry_retrieve_sic_params.rb +11 -1
  11. data/lib/context_dev/models/monitor_create_params.rb +6 -5
  12. data/lib/context_dev/models/monitor_create_response.rb +6 -5
  13. data/lib/context_dev/models/monitor_get_credit_usage_params.rb +30 -0
  14. data/lib/context_dev/models/monitor_get_credit_usage_response.rb +59 -0
  15. data/lib/context_dev/models/monitor_get_limits_params.rb +14 -0
  16. data/lib/context_dev/models/monitor_get_limits_response.rb +52 -0
  17. data/lib/context_dev/models/monitor_list_account_changes_params.rb +16 -7
  18. data/lib/context_dev/models/monitor_list_account_changes_response.rb +2 -1
  19. data/lib/context_dev/models/monitor_list_account_runs_params.rb +7 -10
  20. data/lib/context_dev/models/monitor_list_changes_params.rb +8 -4
  21. data/lib/context_dev/models/monitor_list_changes_response.rb +2 -1
  22. data/lib/context_dev/models/monitor_list_params.rb +18 -19
  23. data/lib/context_dev/models/monitor_list_response.rb +6 -5
  24. data/lib/context_dev/models/monitor_list_runs_params.rb +7 -10
  25. data/lib/context_dev/models/monitor_retrieve_change_response.rb +2 -1
  26. data/lib/context_dev/models/monitor_retrieve_response.rb +6 -5
  27. data/lib/context_dev/models/monitor_update_params.rb +6 -5
  28. data/lib/context_dev/models/monitor_update_response.rb +6 -5
  29. data/lib/context_dev/models/parse_handle_params.rb +296 -46
  30. data/lib/context_dev/models/utility_prefetch_params.rb +9 -1
  31. data/lib/context_dev/models/web_extract_competitors_params.rb +11 -1
  32. data/lib/context_dev/models/web_extract_fonts_params.rb +14 -4
  33. data/lib/context_dev/models/web_extract_params.rb +19 -1
  34. data/lib/context_dev/models/web_extract_styleguide_params.rb +14 -4
  35. data/lib/context_dev/models/web_screenshot_params.rb +69 -18
  36. data/lib/context_dev/models/web_screenshot_response.rb +3 -2
  37. data/lib/context_dev/models/web_search_params.rb +9 -1
  38. data/lib/context_dev/models/web_web_crawl_md_params.rb +34 -1
  39. data/lib/context_dev/models/web_web_scrape_html_params.rb +268 -29
  40. data/lib/context_dev/models/web_web_scrape_images_params.rb +208 -19
  41. data/lib/context_dev/models/web_web_scrape_md_params.rb +352 -38
  42. data/lib/context_dev/models/web_web_scrape_sitemap_params.rb +45 -1
  43. data/lib/context_dev/models.rb +4 -0
  44. data/lib/context_dev/resources/ai.rb +3 -1
  45. data/lib/context_dev/resources/brand.rb +6 -2
  46. data/lib/context_dev/resources/industry.rb +6 -2
  47. data/lib/context_dev/resources/monitors.rb +70 -32
  48. data/lib/context_dev/resources/parse.rb +11 -11
  49. data/lib/context_dev/resources/utility.rb +3 -1
  50. data/lib/context_dev/resources/web.rb +104 -55
  51. data/lib/context_dev/version.rb +1 -1
  52. data/lib/context_dev.rb +4 -0
  53. data/rbi/context_dev/models/ai_extract_product_params.rbi +11 -0
  54. data/rbi/context_dev/models/ai_extract_products_params.rbi +22 -0
  55. data/rbi/context_dev/models/brand_retrieve_params.rbi +175 -64
  56. data/rbi/context_dev/models/brand_retrieve_response.rbi +8 -11
  57. data/rbi/context_dev/models/brand_retrieve_simplified_params.rbi +68 -5
  58. data/rbi/context_dev/models/industry_retrieve_naics_params.rbi +15 -0
  59. data/rbi/context_dev/models/industry_retrieve_sic_params.rbi +15 -0
  60. data/rbi/context_dev/models/monitor_create_params.rbi +6 -4
  61. data/rbi/context_dev/models/monitor_create_response.rbi +6 -4
  62. data/rbi/context_dev/models/monitor_get_credit_usage_params.rbi +60 -0
  63. data/rbi/context_dev/models/monitor_get_credit_usage_response.rbi +111 -0
  64. data/rbi/context_dev/models/monitor_get_limits_params.rbi +30 -0
  65. data/rbi/context_dev/models/monitor_get_limits_response.rbi +105 -0
  66. data/rbi/context_dev/models/monitor_list_account_changes_params.rbi +16 -0
  67. data/rbi/context_dev/models/monitor_list_account_changes_response.rbi +2 -0
  68. data/rbi/context_dev/models/monitor_list_account_runs_params.rbi +7 -6
  69. data/rbi/context_dev/models/monitor_list_changes_params.rbi +8 -0
  70. data/rbi/context_dev/models/monitor_list_changes_response.rbi +2 -0
  71. data/rbi/context_dev/models/monitor_list_params.rbi +23 -31
  72. data/rbi/context_dev/models/monitor_list_response.rbi +6 -4
  73. data/rbi/context_dev/models/monitor_list_runs_params.rbi +7 -6
  74. data/rbi/context_dev/models/monitor_retrieve_change_response.rbi +2 -0
  75. data/rbi/context_dev/models/monitor_retrieve_response.rbi +6 -4
  76. data/rbi/context_dev/models/monitor_update_params.rbi +6 -4
  77. data/rbi/context_dev/models/monitor_update_response.rbi +6 -4
  78. data/rbi/context_dev/models/parse_handle_params.rbi +601 -71
  79. data/rbi/context_dev/models/utility_prefetch_params.rbi +11 -0
  80. data/rbi/context_dev/models/web_extract_competitors_params.rbi +15 -0
  81. data/rbi/context_dev/models/web_extract_fonts_params.rbi +19 -7
  82. data/rbi/context_dev/models/web_extract_params.rbi +26 -0
  83. data/rbi/context_dev/models/web_extract_styleguide_params.rbi +19 -7
  84. data/rbi/context_dev/models/web_screenshot_params.rbi +108 -37
  85. data/rbi/context_dev/models/web_screenshot_response.rbi +4 -2
  86. data/rbi/context_dev/models/web_search_params.rbi +11 -0
  87. data/rbi/context_dev/models/web_web_crawl_md_params.rbi +53 -0
  88. data/rbi/context_dev/models/web_web_scrape_html_params.rbi +554 -49
  89. data/rbi/context_dev/models/web_web_scrape_images_params.rbi +426 -30
  90. data/rbi/context_dev/models/web_web_scrape_md_params.rbi +742 -61
  91. data/rbi/context_dev/models/web_web_scrape_sitemap_params.rbi +82 -0
  92. data/rbi/context_dev/models.rbi +4 -0
  93. data/rbi/context_dev/resources/ai.rbi +3 -0
  94. data/rbi/context_dev/resources/brand.rbi +9 -1
  95. data/rbi/context_dev/resources/industry.rbi +10 -0
  96. data/rbi/context_dev/resources/monitors.rbi +55 -11
  97. data/rbi/context_dev/resources/parse.rbi +44 -24
  98. data/rbi/context_dev/resources/utility.rbi +3 -0
  99. data/rbi/context_dev/resources/web.rbi +224 -48
  100. data/sig/context_dev/models/ai_extract_product_params.rbs +12 -1
  101. data/sig/context_dev/models/ai_extract_products_params.rbs +14 -0
  102. data/sig/context_dev/models/brand_retrieve_params.rbs +97 -51
  103. data/sig/context_dev/models/brand_retrieve_response.rbs +2 -2
  104. data/sig/context_dev/models/brand_retrieve_simplified_params.rbs +34 -5
  105. data/sig/context_dev/models/industry_retrieve_naics_params.rbs +7 -0
  106. data/sig/context_dev/models/industry_retrieve_sic_params.rbs +7 -0
  107. data/sig/context_dev/models/monitor_get_credit_usage_params.rbs +32 -0
  108. data/sig/context_dev/models/monitor_get_credit_usage_response.rbs +52 -0
  109. data/sig/context_dev/models/monitor_get_limits_params.rbs +15 -0
  110. data/sig/context_dev/models/monitor_get_limits_response.rbs +43 -0
  111. data/sig/context_dev/models/monitor_list_params.rbs +8 -14
  112. data/sig/context_dev/models/parse_handle_params.rbs +297 -50
  113. data/sig/context_dev/models/utility_prefetch_params.rbs +7 -0
  114. data/sig/context_dev/models/web_extract_competitors_params.rbs +12 -1
  115. data/sig/context_dev/models/web_extract_fonts_params.rbs +10 -5
  116. data/sig/context_dev/models/web_extract_params.rbs +14 -0
  117. data/sig/context_dev/models/web_extract_styleguide_params.rbs +10 -5
  118. data/sig/context_dev/models/web_screenshot_params.rbs +41 -20
  119. data/sig/context_dev/models/web_search_params.rbs +7 -0
  120. data/sig/context_dev/models/web_web_crawl_md_params.rbs +28 -1
  121. data/sig/context_dev/models/web_web_scrape_html_params.rbs +175 -47
  122. data/sig/context_dev/models/web_web_scrape_images_params.rbs +128 -38
  123. data/sig/context_dev/models/web_web_scrape_md_params.rbs +229 -62
  124. data/sig/context_dev/models/web_web_scrape_sitemap_params.rbs +35 -1
  125. data/sig/context_dev/models.rbs +4 -0
  126. data/sig/context_dev/resources/ai.rbs +1 -0
  127. data/sig/context_dev/resources/brand.rbs +3 -1
  128. data/sig/context_dev/resources/industry.rbs +2 -0
  129. data/sig/context_dev/resources/monitors.rbs +12 -2
  130. data/sig/context_dev/resources/parse.rbs +10 -10
  131. data/sig/context_dev/resources/utility.rbs +1 -0
  132. data/sig/context_dev/resources/web.rbs +47 -26
  133. metadata +14 -2
@@ -14,20 +14,21 @@ module ContextDev
14
14
  )
15
15
  end
16
16
 
17
+ # Opaque pagination cursor from a previous response.
17
18
  sig { returns(T.nilable(String)) }
18
19
  attr_reader :cursor
19
20
 
20
21
  sig { params(cursor: String).void }
21
22
  attr_writer :cursor
22
23
 
24
+ # Maximum number of items to return per page (1-100). Defaults to 25.
23
25
  sig { returns(T.nilable(Integer)) }
24
26
  attr_reader :limit
25
27
 
26
28
  sig { params(limit: Integer).void }
27
29
  attr_writer :limit
28
30
 
29
- # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
30
- # (insufficient credits, monitor paused, or superseded by a concurrent run).
31
+ # Filter runs by lifecycle status.
31
32
  sig do
32
33
  returns(
33
34
  T.nilable(ContextDev::MonitorListAccountRunsParams::Status::OrSymbol)
@@ -51,10 +52,11 @@ module ContextDev
51
52
  ).returns(T.attached_class)
52
53
  end
53
54
  def self.new(
55
+ # Opaque pagination cursor from a previous response.
54
56
  cursor: nil,
57
+ # Maximum number of items to return per page (1-100). Defaults to 25.
55
58
  limit: nil,
56
- # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
57
- # (insufficient credits, monitor paused, or superseded by a concurrent run).
59
+ # Filter runs by lifecycle status.
58
60
  status: nil,
59
61
  request_options: {}
60
62
  )
@@ -73,8 +75,7 @@ module ContextDev
73
75
  def to_hash
74
76
  end
75
77
 
76
- # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
77
- # (insufficient credits, monitor paused, or superseded by a concurrent run).
78
+ # Filter runs by lifecycle status.
78
79
  module Status
79
80
  extend ContextDev::Internal::Type::Enum
80
81
 
@@ -17,18 +17,21 @@ module ContextDev
17
17
  sig { returns(String) }
18
18
  attr_accessor :monitor_id
19
19
 
20
+ # Opaque pagination cursor from a previous response.
20
21
  sig { returns(T.nilable(String)) }
21
22
  attr_reader :cursor
22
23
 
23
24
  sig { params(cursor: String).void }
24
25
  attr_writer :cursor
25
26
 
27
+ # Maximum number of items to return per page (1-100). Defaults to 25.
26
28
  sig { returns(T.nilable(Integer)) }
27
29
  attr_reader :limit
28
30
 
29
31
  sig { params(limit: Integer).void }
30
32
  attr_writer :limit
31
33
 
34
+ # Only include items at or after this ISO 8601 timestamp.
32
35
  sig { returns(T.nilable(Time)) }
33
36
  attr_reader :since
34
37
 
@@ -42,6 +45,7 @@ module ContextDev
42
45
  sig { params(tag: String).void }
43
46
  attr_writer :tag
44
47
 
48
+ # Only include items before this ISO 8601 timestamp.
45
49
  sig { returns(T.nilable(Time)) }
46
50
  attr_reader :until_
47
51
 
@@ -61,11 +65,15 @@ module ContextDev
61
65
  end
62
66
  def self.new(
63
67
  monitor_id:,
68
+ # Opaque pagination cursor from a previous response.
64
69
  cursor: nil,
70
+ # Maximum number of items to return per page (1-100). Defaults to 25.
65
71
  limit: nil,
72
+ # Only include items at or after this ISO 8601 timestamp.
66
73
  since: nil,
67
74
  # Filter to items that have this tag.
68
75
  tag: nil,
76
+ # Only include items before this ISO 8601 timestamp.
69
77
  until_: nil,
70
78
  request_options: {}
71
79
  )
@@ -140,6 +140,7 @@ module ContextDev
140
140
  attr_writer :removed_url_count
141
141
 
142
142
  # User-defined tags for grouping and filtering monitors and their changes.
143
+ # Duplicates are removed.
143
144
  sig { returns(T.nilable(T::Array[String])) }
144
145
  attr_reader :tags
145
146
 
@@ -192,6 +193,7 @@ module ContextDev
192
193
  matched_url_count: nil,
193
194
  removed_url_count: nil,
194
195
  # User-defined tags for grouping and filtering monitors and their changes.
196
+ # Duplicates are removed.
195
197
  tags: nil
196
198
  )
197
199
  end
@@ -11,6 +11,7 @@ module ContextDev
11
11
  T.any(ContextDev::MonitorListParams, ContextDev::Internal::AnyHash)
12
12
  end
13
13
 
14
+ # Filter by change detection type.
14
15
  sig do
15
16
  returns(
16
17
  T.nilable(
@@ -28,12 +29,14 @@ module ContextDev
28
29
  end
29
30
  attr_writer :change_detection_type
30
31
 
32
+ # Opaque pagination cursor from a previous response.
31
33
  sig { returns(T.nilable(String)) }
32
34
  attr_reader :cursor
33
35
 
34
36
  sig { params(cursor: String).void }
35
37
  attr_writer :cursor
36
38
 
39
+ # Maximum number of items to return per page (1-100). Defaults to 25.
37
40
  sig { returns(T.nilable(Integer)) }
38
41
  attr_reader :limit
39
42
 
@@ -54,14 +57,7 @@ module ContextDev
54
57
  T.nilable(T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol])
55
58
  )
56
59
  end
57
- attr_reader :search_by
58
-
59
- sig do
60
- params(
61
- search_by: T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol]
62
- ).void
63
- end
64
- attr_writer :search_by
60
+ attr_accessor :search_by
65
61
 
66
62
  # `prefix` for as-you-type prefix matching (default), `exact` for full-token
67
63
  # matching.
@@ -77,11 +73,7 @@ module ContextDev
77
73
  end
78
74
  attr_writer :search_type
79
75
 
80
- # Monitor lifecycle status. `failed` means the most recent run failed (see the
81
- # monitor's `last_error`); failed monitors keep running on schedule and flip back
82
- # to `active` on the next successful run. Monitors are auto-`paused` after
83
- # repeated consecutive failures or insufficient-credit skips; resume by PATCHing
84
- # status to `active`.
76
+ # Filter monitors by lifecycle status.
85
77
  sig do
86
78
  returns(T.nilable(ContextDev::MonitorListParams::Status::OrSymbol))
87
79
  end
@@ -101,11 +93,9 @@ module ContextDev
101
93
 
102
94
  # Comma-separated list of tags to filter by (matches monitors having any of them).
103
95
  sig { returns(T.nilable(T::Array[String])) }
104
- attr_reader :tags
105
-
106
- sig { params(tags: T::Array[String]).void }
107
- attr_writer :tags
96
+ attr_accessor :tags
108
97
 
98
+ # Filter by target type.
109
99
  sig do
110
100
  returns(T.nilable(ContextDev::MonitorListParams::TargetType::OrSymbol))
111
101
  end
@@ -126,18 +116,23 @@ module ContextDev
126
116
  limit: Integer,
127
117
  q: String,
128
118
  search_by:
129
- T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol],
119
+ T.nilable(
120
+ T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol]
121
+ ),
130
122
  search_type: ContextDev::MonitorListParams::SearchType::OrSymbol,
131
123
  status: ContextDev::MonitorListParams::Status::OrSymbol,
132
124
  tag: String,
133
- tags: T::Array[String],
125
+ tags: T.nilable(T::Array[String]),
134
126
  target_type: ContextDev::MonitorListParams::TargetType::OrSymbol,
135
127
  request_options: ContextDev::RequestOptions::OrHash
136
128
  ).returns(T.attached_class)
137
129
  end
138
130
  def self.new(
131
+ # Filter by change detection type.
139
132
  change_detection_type: nil,
133
+ # Opaque pagination cursor from a previous response.
140
134
  cursor: nil,
135
+ # Maximum number of items to return per page (1-100). Defaults to 25.
141
136
  limit: nil,
142
137
  # Free-text search term, matched against the fields named in `search_by`.
143
138
  q: nil,
@@ -147,16 +142,13 @@ module ContextDev
147
142
  # `prefix` for as-you-type prefix matching (default), `exact` for full-token
148
143
  # matching.
149
144
  search_type: nil,
150
- # Monitor lifecycle status. `failed` means the most recent run failed (see the
151
- # monitor's `last_error`); failed monitors keep running on schedule and flip back
152
- # to `active` on the next successful run. Monitors are auto-`paused` after
153
- # repeated consecutive failures or insufficient-credit skips; resume by PATCHing
154
- # status to `active`.
145
+ # Filter monitors by lifecycle status.
155
146
  status: nil,
156
147
  # Filter to items that have this tag.
157
148
  tag: nil,
158
149
  # Comma-separated list of tags to filter by (matches monitors having any of them).
159
150
  tags: nil,
151
+ # Filter by target type.
160
152
  target_type: nil,
161
153
  request_options: {}
162
154
  )
@@ -171,11 +163,13 @@ module ContextDev
171
163
  limit: Integer,
172
164
  q: String,
173
165
  search_by:
174
- T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol],
166
+ T.nilable(
167
+ T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol]
168
+ ),
175
169
  search_type: ContextDev::MonitorListParams::SearchType::OrSymbol,
176
170
  status: ContextDev::MonitorListParams::Status::OrSymbol,
177
171
  tag: String,
178
- tags: T::Array[String],
172
+ tags: T.nilable(T::Array[String]),
179
173
  target_type: ContextDev::MonitorListParams::TargetType::OrSymbol,
180
174
  request_options: ContextDev::RequestOptions
181
175
  }
@@ -184,6 +178,7 @@ module ContextDev
184
178
  def to_hash
185
179
  end
186
180
 
181
+ # Filter by change detection type.
187
182
  module ChangeDetectionType
188
183
  extend ContextDev::Internal::Type::Enum
189
184
 
@@ -272,11 +267,7 @@ module ContextDev
272
267
  end
273
268
  end
274
269
 
275
- # Monitor lifecycle status. `failed` means the most recent run failed (see the
276
- # monitor's `last_error`); failed monitors keep running on schedule and flip back
277
- # to `active` on the next successful run. Monitors are auto-`paused` after
278
- # repeated consecutive failures or insufficient-credit skips; resume by PATCHing
279
- # status to `active`.
270
+ # Filter monitors by lifecycle status.
280
271
  module Status
281
272
  extend ContextDev::Internal::Type::Enum
282
273
 
@@ -300,6 +291,7 @@ module ContextDev
300
291
  end
301
292
  end
302
293
 
294
+ # Filter by target type.
303
295
  module TargetType
304
296
  extend ContextDev::Internal::Type::Enum
305
297
 
@@ -156,6 +156,7 @@ module ContextDev
156
156
  attr_accessor :next_run_at
157
157
 
158
158
  # User-defined tags for grouping and filtering monitors and their changes.
159
+ # Duplicates are removed.
159
160
  sig { returns(T.nilable(T::Array[String])) }
160
161
  attr_reader :tags
161
162
 
@@ -285,6 +286,7 @@ module ContextDev
285
286
  # When the next scheduled run is due.
286
287
  next_run_at: nil,
287
288
  # User-defined tags for grouping and filtering monitors and their changes.
289
+ # Duplicates are removed.
288
290
  tags: nil,
289
291
  webhook: nil,
290
292
  # Present while webhook deliveries are failing consecutively; null when deliveries
@@ -700,14 +702,14 @@ module ContextDev
700
702
  sig { returns(String) }
701
703
  attr_accessor :url
702
704
 
703
- # URL path patterns to exclude.
705
+ # URL path patterns to exclude (max 50).
704
706
  sig { returns(T.nilable(T::Array[String])) }
705
707
  attr_reader :exclude
706
708
 
707
709
  sig { params(exclude: T::Array[String]).void }
708
710
  attr_writer :exclude
709
711
 
710
- # URL path patterns to include.
712
+ # URL path patterns to include (max 50).
711
713
  sig { returns(T.nilable(T::Array[String])) }
712
714
  attr_reader :include
713
715
 
@@ -738,9 +740,9 @@ module ContextDev
738
740
  def self.new(
739
741
  # Sitemap URL to monitor.
740
742
  url:,
741
- # URL path patterns to exclude.
743
+ # URL path patterns to exclude (max 50).
742
744
  exclude: nil,
743
- # URL path patterns to include.
745
+ # URL path patterns to include (max 50).
744
746
  include: nil,
745
747
  # Maximum number of sitemap URLs to track (capped at 10,000).
746
748
  max_urls: nil,
@@ -17,20 +17,21 @@ module ContextDev
17
17
  sig { returns(String) }
18
18
  attr_accessor :monitor_id
19
19
 
20
+ # Opaque pagination cursor from a previous response.
20
21
  sig { returns(T.nilable(String)) }
21
22
  attr_reader :cursor
22
23
 
23
24
  sig { params(cursor: String).void }
24
25
  attr_writer :cursor
25
26
 
27
+ # Maximum number of items to return per page (1-100). Defaults to 25.
26
28
  sig { returns(T.nilable(Integer)) }
27
29
  attr_reader :limit
28
30
 
29
31
  sig { params(limit: Integer).void }
30
32
  attr_writer :limit
31
33
 
32
- # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
33
- # (insufficient credits, monitor paused, or superseded by a concurrent run).
34
+ # Filter runs by lifecycle status.
34
35
  sig do
35
36
  returns(T.nilable(ContextDev::MonitorListRunsParams::Status::OrSymbol))
36
37
  end
@@ -52,10 +53,11 @@ module ContextDev
52
53
  end
53
54
  def self.new(
54
55
  monitor_id:,
56
+ # Opaque pagination cursor from a previous response.
55
57
  cursor: nil,
58
+ # Maximum number of items to return per page (1-100). Defaults to 25.
56
59
  limit: nil,
57
- # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
58
- # (insufficient credits, monitor paused, or superseded by a concurrent run).
60
+ # Filter runs by lifecycle status.
59
61
  status: nil,
60
62
  request_options: {}
61
63
  )
@@ -75,8 +77,7 @@ module ContextDev
75
77
  def to_hash
76
78
  end
77
79
 
78
- # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
79
- # (insufficient credits, monitor paused, or superseded by a concurrent run).
80
+ # Filter runs by lifecycle status.
80
81
  module Status
81
82
  extend ContextDev::Internal::Type::Enum
82
83
 
@@ -44,6 +44,7 @@ module ContextDev
44
44
  attr_accessor :summary
45
45
 
46
46
  # User-defined tags for grouping and filtering monitors and their changes.
47
+ # Duplicates are removed.
47
48
  sig { returns(T::Array[String]) }
48
49
  attr_accessor :tags
49
50
 
@@ -213,6 +214,7 @@ module ContextDev
213
214
  run_id:,
214
215
  summary:,
215
216
  # User-defined tags for grouping and filtering monitors and their changes.
217
+ # Duplicates are removed.
216
218
  tags:,
217
219
  target_type:,
218
220
  title:,
@@ -112,6 +112,7 @@ module ContextDev
112
112
  attr_accessor :next_run_at
113
113
 
114
114
  # User-defined tags for grouping and filtering monitors and their changes.
115
+ # Duplicates are removed.
115
116
  sig { returns(T.nilable(T::Array[String])) }
116
117
  attr_reader :tags
117
118
 
@@ -236,6 +237,7 @@ module ContextDev
236
237
  # When the next scheduled run is due.
237
238
  next_run_at: nil,
238
239
  # User-defined tags for grouping and filtering monitors and their changes.
240
+ # Duplicates are removed.
239
241
  tags: nil,
240
242
  webhook: nil,
241
243
  # Present while webhook deliveries are failing consecutively; null when deliveries
@@ -644,14 +646,14 @@ module ContextDev
644
646
  sig { returns(String) }
645
647
  attr_accessor :url
646
648
 
647
- # URL path patterns to exclude.
649
+ # URL path patterns to exclude (max 50).
648
650
  sig { returns(T.nilable(T::Array[String])) }
649
651
  attr_reader :exclude
650
652
 
651
653
  sig { params(exclude: T::Array[String]).void }
652
654
  attr_writer :exclude
653
655
 
654
- # URL path patterns to include.
656
+ # URL path patterns to include (max 50).
655
657
  sig { returns(T.nilable(T::Array[String])) }
656
658
  attr_reader :include
657
659
 
@@ -682,9 +684,9 @@ module ContextDev
682
684
  def self.new(
683
685
  # Sitemap URL to monitor.
684
686
  url:,
685
- # URL path patterns to exclude.
687
+ # URL path patterns to exclude (max 50).
686
688
  exclude: nil,
687
- # URL path patterns to include.
689
+ # URL path patterns to include (max 50).
688
690
  include: nil,
689
691
  # Maximum number of sitemap URLs to track (capped at 10,000).
690
692
  max_urls: nil,
@@ -66,6 +66,7 @@ module ContextDev
66
66
  attr_writer :status
67
67
 
68
68
  # User-defined tags for grouping and filtering monitors and their changes.
69
+ # Duplicates are removed.
69
70
  sig { returns(T.nilable(T::Array[String])) }
70
71
  attr_reader :tags
71
72
 
@@ -142,6 +143,7 @@ module ContextDev
142
143
  schedule: nil,
143
144
  status: nil,
144
145
  # User-defined tags for grouping and filtering monitors and their changes.
146
+ # Duplicates are removed.
145
147
  tags: nil,
146
148
  # Discriminated union describing what the monitor watches.
147
149
  target: nil,
@@ -477,14 +479,14 @@ module ContextDev
477
479
  sig { returns(String) }
478
480
  attr_accessor :url
479
481
 
480
- # URL path patterns to exclude.
482
+ # URL path patterns to exclude (max 50).
481
483
  sig { returns(T.nilable(T::Array[String])) }
482
484
  attr_reader :exclude
483
485
 
484
486
  sig { params(exclude: T::Array[String]).void }
485
487
  attr_writer :exclude
486
488
 
487
- # URL path patterns to include.
489
+ # URL path patterns to include (max 50).
488
490
  sig { returns(T.nilable(T::Array[String])) }
489
491
  attr_reader :include
490
492
 
@@ -515,9 +517,9 @@ module ContextDev
515
517
  def self.new(
516
518
  # Sitemap URL to monitor.
517
519
  url:,
518
- # URL path patterns to exclude.
520
+ # URL path patterns to exclude (max 50).
519
521
  exclude: nil,
520
- # URL path patterns to include.
522
+ # URL path patterns to include (max 50).
521
523
  include: nil,
522
524
  # Maximum number of sitemap URLs to track (capped at 10,000).
523
525
  max_urls: nil,
@@ -107,6 +107,7 @@ module ContextDev
107
107
  attr_accessor :next_run_at
108
108
 
109
109
  # User-defined tags for grouping and filtering monitors and their changes.
110
+ # Duplicates are removed.
110
111
  sig { returns(T.nilable(T::Array[String])) }
111
112
  attr_reader :tags
112
113
 
@@ -230,6 +231,7 @@ module ContextDev
230
231
  # When the next scheduled run is due.
231
232
  next_run_at: nil,
232
233
  # User-defined tags for grouping and filtering monitors and their changes.
234
+ # Duplicates are removed.
233
235
  tags: nil,
234
236
  webhook: nil,
235
237
  # Present while webhook deliveries are failing consecutively; null when deliveries
@@ -636,14 +638,14 @@ module ContextDev
636
638
  sig { returns(String) }
637
639
  attr_accessor :url
638
640
 
639
- # URL path patterns to exclude.
641
+ # URL path patterns to exclude (max 50).
640
642
  sig { returns(T.nilable(T::Array[String])) }
641
643
  attr_reader :exclude
642
644
 
643
645
  sig { params(exclude: T::Array[String]).void }
644
646
  attr_writer :exclude
645
647
 
646
- # URL path patterns to include.
648
+ # URL path patterns to include (max 50).
647
649
  sig { returns(T.nilable(T::Array[String])) }
648
650
  attr_reader :include
649
651
 
@@ -674,9 +676,9 @@ module ContextDev
674
676
  def self.new(
675
677
  # Sitemap URL to monitor.
676
678
  url:,
677
- # URL path patterns to exclude.
679
+ # URL path patterns to exclude (max 50).
678
680
  exclude: nil,
679
- # URL path patterns to include.
681
+ # URL path patterns to include (max 50).
680
682
  include: nil,
681
683
  # Maximum number of sitemap URLs to track (capped at 10,000).
682
684
  max_urls: nil,