context.dev 2.19.0 → 2.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19bc4f2a046f36541d3290c8269b746a16049faa40b7b4d6927b7174abf7e9de
-  data.tar.gz: a7c8c5666908f100105f0327009e1e818e8c8dc2df8bc6456d6b68e2ac30316c
+  metadata.gz: 00b5d7dcb52a04ff3be4b212cbf64f01fa8728ea160adebf5cedc9f2c98b1680
+  data.tar.gz: 492420d10233d6bce72fca4f6ee94a4600892cedaa4e833658c30776480da726
 SHA512:
-  metadata.gz: b4276f10c86abd47c7c633387aec7307b5db99f8e4f3a48fea4212aad7065d3e842fd8371bf3915ad899f906348d0959d16de12e092c12763c8fe9d4c6031338
-  data.tar.gz: f9223e8de4932b02187fc5df5d2ade222843928c784ac4e7839ed693f0ed8cd7d50f1862f48ae83bc72d8b5486dc126e6e7a03d884f9fb6fe6ef8afbfaf6667b
+  metadata.gz: 7327c49a078d92775d9446f89c314bf72ccdad01f510321a305238a4f151751e03135ce864a4bc78085605c1c6432edf1b5f311441940cff4b960b5834acf80b
+  data.tar.gz: c6496a4bc18352abf4d13cc52f321982c79d14ab1d0652eafa7e44be273ede98b2a1f2f1f9721f155b0cc540c9f38c6db16b6f2f5e1a94e9e82781ffb8330d9c

data/CHANGELOG.md

@@ -1,5 +1,224 @@
 # Changelog
 
+## [2.21.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.20.0...v2.21.0) (2026-09-27)
+
+
+### Features
+
+* **feedback:** add agent feedback endpoint ([#1322](https://github.com/context-dot-dev/context-ruby-sdk/issues/1322)) ([f3a9dce](https://github.com/context-dot-dev/context-ruby-sdk/commit/f3a9dce10e0f8a20977d0133e387fe20a9e11d18))
+* **highlights:** preserve Markdown structure in scrape excerpts ([#1236](https://github.com/context-dot-dev/context-ruby-sdk/issues/1236)) ([d3c383a](https://github.com/context-dot-dev/context-ruby-sdk/commit/d3c383a7ccfcea00a01c9c85955d62e871227ceb))
+* **scrape:** enable highlights with zero data retention ([#1246](https://github.com/context-dot-dev/context-ruby-sdk/issues/1246)) ([487a289](https://github.com/context-dot-dev/context-ruby-sdk/commit/487a2897d19d15d5164d0e69c2700f511b223216))
+
+
+### Bug Fixes
+
+* **openapi:** document exclusive news filters ([#1265](https://github.com/context-dot-dev/context-ruby-sdk/issues/1265)) ([5b7c79d](https://github.com/context-dot-dev/context-ruby-sdk/commit/5b7c79de83fd209760bfb5738670229024480206))
+* **scrape:** only flag partial success when a requested format succeeds ([#1325](https://github.com/context-dot-dev/context-ruby-sdk/issues/1325)) ([1120d93](https://github.com/context-dot-dev/context-ruby-sdk/commit/1120d9344525c6fc1ffb60403df75790ea6bbf1c))
+* **scrape:** preserve successful formats when other outputs fail ([#1263](https://github.com/context-dot-dev/context-ruby-sdk/issues/1263)) ([e2ccfa7](https://github.com/context-dot-dev/context-ruby-sdk/commit/e2ccfa7ea613221d3c6ad755aec93e01c58ca402))
+* **scrape:** retain highlight headings only when needed ([#1245](https://github.com/context-dot-dev/context-ruby-sdk/issues/1245)) ([492a305](https://github.com/context-dot-dev/context-ruby-sdk/commit/492a3058c77fd4d2edad2be9007c010e1745cfc9))
+
+## [2.20.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.19.0...v2.20.0) (2026-09-23)
+
+
+### Features
+
+* **answers:** add live web research with fast and ultra modes ([#954](https://github.com/context-dot-dev/context-ruby-sdk/issues/954)) ([838e943](https://github.com/context-dot-dev/context-ruby-sdk/commit/838e943b1fe34aeaf6f804ff534c22f62b4900fe))
+* **api-keys:** enforce scoped API key permissions ([#1038](https://github.com/context-dot-dev/context-ruby-sdk/issues/1038)) ([7f87431](https://github.com/context-dot-dev/context-ruby-sdk/commit/7f874312c42b5c12020d71251f8bfc6eaa8ab2aa))
+* **api:** api update ([f7adbd6](https://github.com/context-dot-dev/context-ruby-sdk/commit/f7adbd63407b697245019ea9483dc090de9ba0ff))
+* **api:** api update ([c26b304](https://github.com/context-dot-dev/context-ruby-sdk/commit/c26b30411607dcc2eaad14962d582f4588f5193f))
+* **api:** api update ([852a96e](https://github.com/context-dot-dev/context-ruby-sdk/commit/852a96e58dab7e6fef53af10093119ffc237f52e))
+* **api:** api update ([c16beb5](https://github.com/context-dot-dev/context-ruby-sdk/commit/c16beb55d66977611c58711b489132f347ab2c96))
+* **api:** api update ([9bff49f](https://github.com/context-dot-dev/context-ruby-sdk/commit/9bff49f9a966fd40691f2cd7a41ba96ec7679243))
+* **api:** api update ([5b19e0c](https://github.com/context-dot-dev/context-ruby-sdk/commit/5b19e0ce1f7ad615a92e28440bec6ab3703ffe02))
+* **api:** api update ([f4ccf22](https://github.com/context-dot-dev/context-ruby-sdk/commit/f4ccf220f130672950d3231a6b9952c166168ef9))
+* **api:** api update ([6f90ebf](https://github.com/context-dot-dev/context-ruby-sdk/commit/6f90ebff6164a8daf2f6c4bf8d1492ade1ad2779))
+* **api:** api update ([95cbdde](https://github.com/context-dot-dev/context-ruby-sdk/commit/95cbddeb3a3351a03c394709dfeaf3fb5c98be92))
+* **api:** api update ([97520df](https://github.com/context-dot-dev/context-ruby-sdk/commit/97520df52a798122460e2f219d7b582d2f6830da))
+* **api:** api update ([2b73772](https://github.com/context-dot-dev/context-ruby-sdk/commit/2b737722e962cf7a5aba20a2b596d379f7f2bce0))
+* **api:** api update ([630b415](https://github.com/context-dot-dev/context-ruby-sdk/commit/630b4156f12004d2da154e26003271cd143ccbb8))
+* **api:** api update ([ea29f67](https://github.com/context-dot-dev/context-ruby-sdk/commit/ea29f67042bd6fd9b987d7ad4ad9f8993a871653))
+* **api:** api update ([e7c64e4](https://github.com/context-dot-dev/context-ruby-sdk/commit/e7c64e4540db4cc313d70cebe5409739b052e567))
+* **api:** api update ([975de89](https://github.com/context-dot-dev/context-ruby-sdk/commit/975de893c9145f20f541a443730d7d99f575a313))
+* **api:** api update ([a1f13c2](https://github.com/context-dot-dev/context-ruby-sdk/commit/a1f13c2244b0ac81a58c350e6cba79875e0c4bf1))
+* **api:** api update ([e7cfd87](https://github.com/context-dot-dev/context-ruby-sdk/commit/e7cfd87ff2e163f572cc33ee4b6af5be79811d03))
+* **api:** api update ([c827408](https://github.com/context-dot-dev/context-ruby-sdk/commit/c8274088947813e1090d6232190b5333c025696a))
+* **api:** api update ([5c09f03](https://github.com/context-dot-dev/context-ruby-sdk/commit/5c09f03dd90cda2cad388ac2605d6cadebf0e137))
+* **api:** api update ([b0bdc3e](https://github.com/context-dot-dev/context-ruby-sdk/commit/b0bdc3ec9322ce5854177cdaff808caaba427746))
+* **api:** api update ([17848b3](https://github.com/context-dot-dev/context-ruby-sdk/commit/17848b313dcbd098b21902bd2bd2cab6d9ad5ce2))
+* **api:** api update ([4db7386](https://github.com/context-dot-dev/context-ruby-sdk/commit/4db7386bf6f686a33beae7817ec9122e1adad47f))
+* **api:** api update ([cedd9b1](https://github.com/context-dot-dev/context-ruby-sdk/commit/cedd9b1191e1297236c2aa6dede3fa640380b651))
+* **api:** api update ([98fedb9](https://github.com/context-dot-dev/context-ruby-sdk/commit/98fedb99aae187cff9284efd0a6c574b1b71d749))
+* **api:** api update ([7a5cc9a](https://github.com/context-dot-dev/context-ruby-sdk/commit/7a5cc9aa3bd2c746d0e47a58fbc426453db3b8c7))
+* **api:** api update ([6cfd0e8](https://github.com/context-dot-dev/context-ruby-sdk/commit/6cfd0e80f3860cfbddd595ac4c72461075775415))
+* **api:** api update ([99bdfb2](https://github.com/context-dot-dev/context-ruby-sdk/commit/99bdfb24af9adfac64ee68ca714fb1176c1d61c0))
+* **api:** api update ([5af0d4b](https://github.com/context-dot-dev/context-ruby-sdk/commit/5af0d4b1954673356f6200967dbea5ea61685025))
+* **api:** api update ([28793d8](https://github.com/context-dot-dev/context-ruby-sdk/commit/28793d84ed93dcf457aaf3f346056f2480f37724))
+* **api:** api update ([c9c4475](https://github.com/context-dot-dev/context-ruby-sdk/commit/c9c447554772879c742d72ac88174a75fbff599a))
+* **api:** api update ([72e6d90](https://github.com/context-dot-dev/context-ruby-sdk/commit/72e6d90baaeeb9181482488e7b49e511597d2175))
+* **api:** api update ([2574f7d](https://github.com/context-dot-dev/context-ruby-sdk/commit/2574f7db809d8480db2b7ae2705fd2de6a1ce2ff))
+* **api:** api update ([8fb7d29](https://github.com/context-dot-dev/context-ruby-sdk/commit/8fb7d29835d4ffe7eb53b1619d3da20fa45df52c))
+* **api:** api update ([f5684a3](https://github.com/context-dot-dev/context-ruby-sdk/commit/f5684a355f24bf6a80aa904f09087a899f2121aa))
+* **api:** api update ([426deb1](https://github.com/context-dot-dev/context-ruby-sdk/commit/426deb18249b214c3ccaa44c1e654e75ef666dd2))
+* **api:** api update ([3fd9604](https://github.com/context-dot-dev/context-ruby-sdk/commit/3fd960488c341f082b6d312dda927aeee23dccff))
+* **api:** api update ([bdd3176](https://github.com/context-dot-dev/context-ruby-sdk/commit/bdd3176c7f507880adb7becae314b816c6bbe9bc))
+* **api:** api update ([d68d31d](https://github.com/context-dot-dev/context-ruby-sdk/commit/d68d31dc5aa77ad154789b6cf91e0b8558353214))
+* **api:** api update ([d4c601e](https://github.com/context-dot-dev/context-ruby-sdk/commit/d4c601ea30aa1d47ef041d0439ab8b5d976cc8e2))
+* **api:** api update ([03fa3ac](https://github.com/context-dot-dev/context-ruby-sdk/commit/03fa3ac3c7c61aba88846db890bf4d3fd22d1086))
+* **api:** api update ([626d105](https://github.com/context-dot-dev/context-ruby-sdk/commit/626d1054da9622e88469bb9c3b755f43d1d75280))
+* **api:** api update ([04e3709](https://github.com/context-dot-dev/context-ruby-sdk/commit/04e370916ae9679892d86fc297e3c935afa1e2c2))
+* **api:** api update ([59b7e62](https://github.com/context-dot-dev/context-ruby-sdk/commit/59b7e62e57eff7482db12fe2dd1a97298620b88f))
+* **api:** api update ([7fe6a1f](https://github.com/context-dot-dev/context-ruby-sdk/commit/7fe6a1fbd2977c0669b7623ba96533b43789b8ae))
+* **api:** api update ([cd5b872](https://github.com/context-dot-dev/context-ruby-sdk/commit/cd5b8725dcd7fb06d7bd684aa4ce11b81ca4409a))
+* **api:** api update ([bdc4962](https://github.com/context-dot-dev/context-ruby-sdk/commit/bdc4962f436086be52293ea489960b6b6158726b))
+* **api:** api update ([531ccbe](https://github.com/context-dot-dev/context-ruby-sdk/commit/531ccbeb9770c4340641353859064b50aa6d72bc))
+* **api:** api update ([b0511d9](https://github.com/context-dot-dev/context-ruby-sdk/commit/b0511d905641a19d59391ff26ac27d474016ac26))
+* **api:** api update ([a146323](https://github.com/context-dot-dev/context-ruby-sdk/commit/a14632340e78b4b21be6c742f3792a7f14ca4fae))
+* **api:** api update ([4a4a076](https://github.com/context-dot-dev/context-ruby-sdk/commit/4a4a0762b6c422c5507f847bb06b9ac0fb11e605))
+* **api:** api update ([4682d0b](https://github.com/context-dot-dev/context-ruby-sdk/commit/4682d0b50170440ce7a3b60beadad10cefff3168))
+* **api:** api update ([0026695](https://github.com/context-dot-dev/context-ruby-sdk/commit/00266958beb99d8747e4e5422a122792e0cb8080))
+* **api:** api update ([3393a00](https://github.com/context-dot-dev/context-ruby-sdk/commit/3393a0047608f81e85a7c011ff3fd6356d7433a3))
+* **api:** api update ([ab547fb](https://github.com/context-dot-dev/context-ruby-sdk/commit/ab547fb83535a1184f2aa1414b86022e4550704f))
+* **api:** api update ([d71fbde](https://github.com/context-dot-dev/context-ruby-sdk/commit/d71fbde94bc39245091db193f120fa383efea82f))
+* **api:** api update ([8fb393a](https://github.com/context-dot-dev/context-ruby-sdk/commit/8fb393a6a53d4ec6867efe8d9daf8458d9fa3cc8))
+* **api:** api update ([edf39d7](https://github.com/context-dot-dev/context-ruby-sdk/commit/edf39d75e9ca0a7b96ddac6467f9b50ceca0acf1))
+* **api:** api update ([893f11d](https://github.com/context-dot-dev/context-ruby-sdk/commit/893f11d2746ccb636e971e12c24553043046cb11))
+* **api:** api update ([59319b0](https://github.com/context-dot-dev/context-ruby-sdk/commit/59319b0421154c96a444f5e2d45b83e8f4bc9074))
+* **api:** api update ([125ebe5](https://github.com/context-dot-dev/context-ruby-sdk/commit/125ebe5cb023b276c01bdc8c3cafbe8841dffddb))
+* **api:** api update ([26f4358](https://github.com/context-dot-dev/context-ruby-sdk/commit/26f43582d8d63b9ebd98f0ba04c64e93d61b185f))
+* **api:** api update ([94469da](https://github.com/context-dot-dev/context-ruby-sdk/commit/94469da02de1d8713f5bcb723cab05f0e23bb33d))
+* **api:** api update ([65310de](https://github.com/context-dot-dev/context-ruby-sdk/commit/65310de1d9739b217660fc4ab8e5462bc5a0f081))
+* **api:** api update ([67ddd60](https://github.com/context-dot-dev/context-ruby-sdk/commit/67ddd60fffad48a4cc6697fb940f6510bc04d0cb))
+* **api:** api update ([e987167](https://github.com/context-dot-dev/context-ruby-sdk/commit/e9871675c89fd313209d95cd54071fe986dd772a))
+* **api:** api update ([2170040](https://github.com/context-dot-dev/context-ruby-sdk/commit/2170040142dab272a55f903f0d062b0d36d751aa))
+* **api:** api update ([c57bae4](https://github.com/context-dot-dev/context-ruby-sdk/commit/c57bae40d99770e18c92d402eb71dc0aa651f522))
+* **api:** api update ([c897bbf](https://github.com/context-dot-dev/context-ruby-sdk/commit/c897bbf03235960c8036bd808c5239b935d94bf3))
+* **api:** api update ([9aa6127](https://github.com/context-dot-dev/context-ruby-sdk/commit/9aa6127b563032655648c3c24fe9564616ebe3f1))
+* **api:** api update ([22eb08f](https://github.com/context-dot-dev/context-ruby-sdk/commit/22eb08f65d1001052f1bd247a4d60e2680bb33ea))
+* **api:** api update ([d442168](https://github.com/context-dot-dev/context-ruby-sdk/commit/d442168b67accce12463e36f03630f155c1c7be3))
+* **api:** api update ([f3a97c1](https://github.com/context-dot-dev/context-ruby-sdk/commit/f3a97c19ef01be5e6cf1ce7ecfa26c972edfdf33))
+* **api:** api update ([8d8abf7](https://github.com/context-dot-dev/context-ruby-sdk/commit/8d8abf7c1600bce17ea26aa245f41b2e3199f722))
+* **api:** api update ([7948cbf](https://github.com/context-dot-dev/context-ruby-sdk/commit/7948cbf296742dd0fea7c08c148962a35ed88c20))
+* **api:** api update ([5574aa6](https://github.com/context-dot-dev/context-ruby-sdk/commit/5574aa6793f9ff576b625cbb2e86fa819fd3bf36))
+* **api:** api update ([6e08ffc](https://github.com/context-dot-dev/context-ruby-sdk/commit/6e08ffc77cc708d31b9a3972bc3e2ac86c2fdb92))
+* **api:** api update ([ab9c393](https://github.com/context-dot-dev/context-ruby-sdk/commit/ab9c3935b669fbe2c7a8ffdd5bff7ea05fc2ae56))
+* **api:** api update ([7f8b7b7](https://github.com/context-dot-dev/context-ruby-sdk/commit/7f8b7b7a720f3fdf5364ffaf7c7e55f171b72c0e))
+* **api:** api update ([b582c05](https://github.com/context-dot-dev/context-ruby-sdk/commit/b582c05376102bb0cb6f8d4d8c9a2cefdef8c1ec))
+* **api:** api update ([4a4e4bb](https://github.com/context-dot-dev/context-ruby-sdk/commit/4a4e4bbc547662de263a307b213dd7eecd03a61d))
+* **api:** api update ([ae638b0](https://github.com/context-dot-dev/context-ruby-sdk/commit/ae638b04d0e08bf93e2cdd1211236d841d5313b1))
+* **api:** api update ([8376344](https://github.com/context-dot-dev/context-ruby-sdk/commit/8376344a7a72a7ff01906bc3d6a5913a4de60bcb))
+* **api:** api update ([f0b1f3a](https://github.com/context-dot-dev/context-ruby-sdk/commit/f0b1f3afd885c44cb464393b57d944fa27a6c0b5))
+* **api:** api update ([42c8282](https://github.com/context-dot-dev/context-ruby-sdk/commit/42c8282f18c421ca317b51c640ea42cc04c61230))
+* **api:** api update ([58cb73a](https://github.com/context-dot-dev/context-ruby-sdk/commit/58cb73a109e20f296f6a5f256a94d690b1203f70))
+* **api:** api update ([59a9399](https://github.com/context-dot-dev/context-ruby-sdk/commit/59a93997a90f6afac755abf6686c139b92d8463e))
+* **api:** api update ([c74cbf3](https://github.com/context-dot-dev/context-ruby-sdk/commit/c74cbf354e15c2b56680b4248ed69462a1a84d23))
+* **api:** api update ([cc57672](https://github.com/context-dot-dev/context-ruby-sdk/commit/cc576729ce6c522ee578e7dc5f99122463014515))
+* **api:** api update ([84bfef2](https://github.com/context-dot-dev/context-ruby-sdk/commit/84bfef260d99a7a444c243edc4be1c72191929dd))
+* **api:** api update ([5405b96](https://github.com/context-dot-dev/context-ruby-sdk/commit/5405b9676800e2004d92dd9f621dfc56972bacd2))
+* **api:** api update ([9c8b4d9](https://github.com/context-dot-dev/context-ruby-sdk/commit/9c8b4d9b1d813c5b7992998a3fa23cde63fe2f4c))
+* **api:** api update ([c1543f7](https://github.com/context-dot-dev/context-ruby-sdk/commit/c1543f7513b2d88b0c8ad8e209e62075bd9658bc))
+* **api:** api update ([9c98e20](https://github.com/context-dot-dev/context-ruby-sdk/commit/9c98e20725dcda8466a2274b61be75943d0564d9))
+* **api:** api update ([8ccafd9](https://github.com/context-dot-dev/context-ruby-sdk/commit/8ccafd9625079f40393fe23890958a80d8bdb4e8))
+* **api:** api update ([30ef99f](https://github.com/context-dot-dev/context-ruby-sdk/commit/30ef99f9a0d61f6528aed16b080f376753b3447a))
+* **api:** api update ([c9851eb](https://github.com/context-dot-dev/context-ruby-sdk/commit/c9851ebc0618d7433ed88f7062902fcec575b229))
+* **api:** api update ([55529f6](https://github.com/context-dot-dev/context-ruby-sdk/commit/55529f63e23cf255645bdb2d0420bf24aaba28b1))
+* **api:** api update ([51320a5](https://github.com/context-dot-dev/context-ruby-sdk/commit/51320a5677298ab231dc417ef3c54d6a75e640ba))
+* **api:** api update ([5a69904](https://github.com/context-dot-dev/context-ruby-sdk/commit/5a69904d89cc873614e8320308eecac9304992d2))
+* **api:** api update ([7d186fa](https://github.com/context-dot-dev/context-ruby-sdk/commit/7d186faf849e20bcd958beb5f46b71f6440b8358))
+* **api:** api update ([2d439b9](https://github.com/context-dot-dev/context-ruby-sdk/commit/2d439b9814f0e3be9efead3d2e70e3e5d7e3a1f0))
+* **api:** api update ([8b33b1e](https://github.com/context-dot-dev/context-ruby-sdk/commit/8b33b1ee26acc8314d9c285ea53e3531ba390a16))
+* **api:** api update ([7b5ddec](https://github.com/context-dot-dev/context-ruby-sdk/commit/7b5ddec0b8e306df34a72ccd39e8d731168a62ea))
+* **api:** api update ([b09024f](https://github.com/context-dot-dev/context-ruby-sdk/commit/b09024fa19c7aecafaf4fe4bd211bfc3738484ed))
+* **api:** api update ([4e74fe3](https://github.com/context-dot-dev/context-ruby-sdk/commit/4e74fe3f395778efb1ca3f1e752f2f71e21a3191))
+* **api:** api update ([f475665](https://github.com/context-dot-dev/context-ruby-sdk/commit/f47566556bc4d2c81a52084979f83be62cb17cf2))
+* **api:** api update ([a4e99e6](https://github.com/context-dot-dev/context-ruby-sdk/commit/a4e99e6e0659cb7b09375d7a467e9771aa6cea44))
+* **api:** api update ([b13514f](https://github.com/context-dot-dev/context-ruby-sdk/commit/b13514f872498b08e54fc8b4264179201ee30311))
+* **api:** api update ([5f00bc0](https://github.com/context-dot-dev/context-ruby-sdk/commit/5f00bc076f0081065bc274ce9f28cd26a7daa944))
+* **api:** api update ([9ae9b10](https://github.com/context-dot-dev/context-ruby-sdk/commit/9ae9b108ce2737b42574a6f781103410a546f704))
+* **api:** api update ([58ed755](https://github.com/context-dot-dev/context-ruby-sdk/commit/58ed7551637936ea3c007e28af3358eb96a339ca))
+* **api:** api update ([4767618](https://github.com/context-dot-dev/context-ruby-sdk/commit/4767618765a8f15bde582bf35f78190649681453))
+* **api:** api update ([0891a8f](https://github.com/context-dot-dev/context-ruby-sdk/commit/0891a8f97fa7ca1b8e49dbc5d383763406ac85ae))
+* **api:** api update ([ff1db16](https://github.com/context-dot-dev/context-ruby-sdk/commit/ff1db1692a06315279532c93a05722223cb2c7ee))
+* **api:** api update ([97eac17](https://github.com/context-dot-dev/context-ruby-sdk/commit/97eac17686bff356d4d5b6ad6438beb24c05b05a))
+* **api:** enable ZDR on remaining AI endpoints via OpenAI ([#1099](https://github.com/context-dot-dev/context-ruby-sdk/issues/1099)) ([36e5487](https://github.com/context-dot-dev/context-ruby-sdk/commit/36e548724224b3198e49d248735916f3af6d1b61))
+* **api:** manual updates ([54ad450](https://github.com/context-dot-dev/context-ruby-sdk/commit/54ad450f892542378cec0ce5430d1436e1437a4d))
+* **api:** manual updates ([cf2f79f](https://github.com/context-dot-dev/context-ruby-sdk/commit/cf2f79ff77dca3e57069cfac612e7fd333a8d83f))
+* **api:** manual updates ([054713e](https://github.com/context-dot-dev/context-ruby-sdk/commit/054713ecd7a6c12c29a2aaf0df0ea0eeb0ff61fc))
+* **api:** manual updates ([d7a4669](https://github.com/context-dot-dev/context-ruby-sdk/commit/d7a46695c2ba5ec1f54eaedec751bfd1d1559c4b))
+* **api:** manual updates ([2a83a5f](https://github.com/context-dot-dev/context-ruby-sdk/commit/2a83a5f976bf2b75964ea56ff07f99872acd5022))
+* **api:** manual updates ([b7f6b2c](https://github.com/context-dot-dev/context-ruby-sdk/commit/b7f6b2c0a5bb91cc065bcc2ef497c9999414262c))
+* **api:** manual updates ([b18f464](https://github.com/context-dot-dev/context-ruby-sdk/commit/b18f46485bf70c10b0a20459ed38b2991ea5add0))
+* **api:** manual updates ([fa7f5bf](https://github.com/context-dot-dev/context-ruby-sdk/commit/fa7f5bfa1e892a7dff26b169bd3ea7a6d0863048))
+* **api:** manual updates ([7277672](https://github.com/context-dot-dev/context-ruby-sdk/commit/7277672e289e4d8a54791a154e989ec6ba25e3b2))
+* **api:** manual updates ([e3971dc](https://github.com/context-dot-dev/context-ruby-sdk/commit/e3971dcc3b94f5b998562f8ecb82a292cc8f00bd))
+* **api:** manual updates ([688e5f5](https://github.com/context-dot-dev/context-ruby-sdk/commit/688e5f56137aeac7c5219383f241a459173f961f))
+* **api:** manual updates ([b6c283e](https://github.com/context-dot-dev/context-ruby-sdk/commit/b6c283ee6c514421e07fb0b6d61aace62df318d1))
+* **api:** manual updates ([6d640e9](https://github.com/context-dot-dev/context-ruby-sdk/commit/6d640e9d1c52818badc55b8f9e5c545766a26d01))
+* **api:** manual updates ([ec963bb](https://github.com/context-dot-dev/context-ruby-sdk/commit/ec963bb99ac36d162552c76fb067e87144f21089))
+* **api:** manual updates ([1017ae4](https://github.com/context-dot-dev/context-ruby-sdk/commit/1017ae4d595beb2e5b466326a4db19c78ce6db51))
+* **api:** manual updates ([490fde0](https://github.com/context-dot-dev/context-ruby-sdk/commit/490fde06ead702db0640f9d1161c3d8ecedd31a9))
+* **api:** manual updates ([e1f12de](https://github.com/context-dot-dev/context-ruby-sdk/commit/e1f12de44bcadd047b5746fdddcd828a29107e1e))
+* **api:** manual updates ([f451afe](https://github.com/context-dot-dev/context-ruby-sdk/commit/f451afea50625bba49a808a4b193c451c7019571))
+* **api:** manual updates ([11ea49f](https://github.com/context-dot-dev/context-ruby-sdk/commit/11ea49fac95ca680db1f9880b8b8590aa650b00a))
+* **api:** manual updates ([739b99f](https://github.com/context-dot-dev/context-ruby-sdk/commit/739b99fddcd745960b3cf390cc9bff4220941ee8))
+* **api:** manual updates ([d32eb69](https://github.com/context-dot-dev/context-ruby-sdk/commit/d32eb69f2bafb655156587bfb2daa659dcc3b731))
+* **api:** manual updates ([8e8fcc2](https://github.com/context-dot-dev/context-ruby-sdk/commit/8e8fcc26f2fbbb2bdcca9713fa3b9f8518303586))
+* **api:** manual updates ([d120a5d](https://github.com/context-dot-dev/context-ruby-sdk/commit/d120a5dde6665acced2c75394beb6910389e344e))
+* **api:** manual updates ([fe32a5e](https://github.com/context-dot-dev/context-ruby-sdk/commit/fe32a5e431bf152d8b0966f9927efcd8ebc3b5c1))
+* **api:** return request_id on every response ([012ba65](https://github.com/context-dot-dev/context-ruby-sdk/commit/012ba65ea7648ebd7b18fa7ad00955a13b8394b9))
+* **api:** unify timeout configuration and return partial results ([#1030](https://github.com/context-dot-dev/context-ruby-sdk/issues/1030)) ([7c0fa1f](https://github.com/context-dot-dev/context-ruby-sdk/commit/7c0fa1f308fc51885405c065aef2fd4ab8fe5725))
+* **billing:** charge for 404s and skip fraud accounting ([#1152](https://github.com/context-dot-dev/context-ruby-sdk/issues/1152)) ([d1fa73e](https://github.com/context-dot-dev/context-ruby-sdk/commit/d1fa73e0809ce7acb5668f413f40b902e539fe72))
+* initial stlc build ([bf63ae0](https://github.com/context-dot-dev/context-ruby-sdk/commit/bf63ae0769d9756a0b36480fd0c2d05ae939997c))
+* **logs:** expose request log endpoints in SDKs ([#1025](https://github.com/context-dot-dev/context-ruby-sdk/issues/1025)) ([5b22be7](https://github.com/context-dot-dev/context-ruby-sdk/commit/5b22be7bd1cb6401b8260b5a756b6ec040cbc6a8))
+* **monitors:** add page selector filters ([#1037](https://github.com/context-dot-dev/context-ruby-sdk/issues/1037)) ([1f3a748](https://github.com/context-dot-dev/context-ruby-sdk/commit/1f3a74858133f69ea52c3a189f9ed8c80b80c0c6))
+* **products:** extract ProductGroup variants with images ([#1124](https://github.com/context-dot-dev/context-ruby-sdk/issues/1124)) ([dd14116](https://github.com/context-dot-dev/context-ruby-sdk/commit/dd141167200666c0bbb658f9a83ffa8896411aae))
+* **scrape:** add cache age support to byte downloads ([#1171](https://github.com/context-dot-dev/context-ruby-sdk/issues/1171)) ([9b2704f](https://github.com/context-dot-dev/context-ruby-sdk/commit/9b2704f21f51249319a1536a535b881769da0864))
+* **scrape:** add CSS extraction rules to HTML scraping ([#1146](https://github.com/context-dot-dev/context-ruby-sdk/issues/1146)) ([4ed406d](https://github.com/context-dot-dev/context-ruby-sdk/commit/4ed406dfa5bf0dd2ad8e6652fb85ef9ebe37ff07))
+* **scrape:** add highlights format to POST /web/scrape ([#1210](https://github.com/context-dot-dev/context-ruby-sdk/issues/1210)) ([b15aa13](https://github.com/context-dot-dev/context-ruby-sdk/commit/b15aa139b666c263900f0f058344887cf3da3e4b))
+* **scrape:** add json output format to POST /web/scrape ([#1213](https://github.com/context-dot-dev/context-ruby-sdk/issues/1213)) ([03ec23b](https://github.com/context-dot-dev/context-ruby-sdk/commit/03ec23bb699bf1cc7c3662979ce2a5a0c7f0a8dd))
+* **scrape:** add product extraction format to POST /web/scrape ([#1212](https://github.com/context-dot-dev/context-ruby-sdk/issues/1212)) ([cf6a8ca](https://github.com/context-dot-dev/context-ruby-sdk/commit/cf6a8caaf6c4d913847d034aef557bdb1d5622cf))
+* **scrape:** add unified scrape API ([#1182](https://github.com/context-dot-dev/context-ruby-sdk/issues/1182)) ([f96de1a](https://github.com/context-dot-dev/context-ruby-sdk/commit/f96de1aceca6305f47851701708cba674ed5c30b))
+* **scrape:** align timeout options and public SDK methods ([#1207](https://github.com/context-dot-dev/context-ruby-sdk/issues/1207)) ([f1f8442](https://github.com/context-dot-dev/context-ruby-sdk/commit/f1f84420192e0b686f973187d2efdadd4a1509cd))
+* **scrape:** support country for image scraping ([#1172](https://github.com/context-dot-dev/context-ruby-sdk/issues/1172)) ([9b2704f](https://github.com/context-dot-dev/context-ruby-sdk/commit/9b2704f21f51249319a1536a535b881769da0864))
+* **scrape:** support custom screenshot headers ([#1169](https://github.com/context-dot-dev/context-ruby-sdk/issues/1169)) ([ea364f2](https://github.com/context-dot-dev/context-ruby-sdk/commit/ea364f242b9120982ee69006305a1929464d4dfe))
+* **scrape:** support waitForMs for byte downloads ([#1170](https://github.com/context-dot-dev/context-ruby-sdk/issues/1170)) ([267301b](https://github.com/context-dot-dev/context-ruby-sdk/commit/267301b3da971db51c63102242ed0dece4ba6630))
+* **sitemap:** add subdomain discovery ([5630b67](https://github.com/context-dot-dev/context-ruby-sdk/commit/5630b67ab555ab5dabd06b0ade2c4d2837f13423))
+* **stlc:** configurable CI runner and private-production-repo support in workflow templates ([f1c36e9](https://github.com/context-dot-dev/context-ruby-sdk/commit/f1c36e95f04eb617aa1769ba9cd21e3dad7bc5ee))
+* support setting headers via env ([e625fee](https://github.com/context-dot-dev/context-ruby-sdk/commit/e625fee97a6d4f6ab25f69447b33521cac6a896c))
+* **web:** add raw bytes scraping endpoint ([#1081](https://github.com/context-dot-dev/context-ruby-sdk/issues/1081)) ([e4b2347](https://github.com/context-dot-dev/context-ruby-sdk/commit/e4b23477deab52f1822eb2e3e2bbbca6b9cf9c07))
+* **web:** add URL-based scrape screenshot endpoint ([#1150](https://github.com/context-dot-dev/context-ruby-sdk/issues/1150)) ([52c8043](https://github.com/context-dot-dev/context-ruby-sdk/commit/52c80435c9c767bdb6ff782c487ada1263d9f767))
+* **webhooks:** add configurable retries and manual replay ([00388ec](https://github.com/context-dot-dev/context-ruby-sdk/commit/00388ec76d375d7466c9b0d85dfe983d2a369807))
+* **webhooks:** simplify delivery APIs ([fbd879e](https://github.com/context-dot-dev/context-ruby-sdk/commit/fbd879eaa0c0008cba1c3b19f1fe1accb53d8771))
+
+
+### Bug Fixes
+
+* align path encoding with RFC 3986 section 3.3 ([2c4072d](https://github.com/context-dot-dev/context-ruby-sdk/commit/2c4072df7df531933f5352c611183b1d152e3ec2))
+* **api:** guarantee search descriptions and align response types ([#1089](https://github.com/context-dot-dev/context-ruby-sdk/issues/1089)) ([7ee03fc](https://github.com/context-dot-dev/context-ruby-sdk/commit/7ee03fc233d3e975f01fd3d290defb48a6e6ad56))
+* **api:** honour maxAgeMs=0 on brand retrieve, styleguide and fonts endpoints ([#998](https://github.com/context-dot-dev/context-ruby-sdk/issues/998)) ([78491ef](https://github.com/context-dot-dev/context-ruby-sdk/commit/78491ef8e43ab49074d011ce8c10e3cda5cb27db))
+* **api:** lower partial scrape timeout minimum to five seconds ([#1118](https://github.com/context-dot-dev/context-ruby-sdk/issues/1118)) ([871982b](https://github.com/context-dot-dev/context-ruby-sdk/commit/871982bff814f9cb698fc59f1e07c2d87c5a6dad))
+* **api:** reject timeoutMS too short for waitForMs ([e8a6725](https://github.com/context-dot-dev/context-ruby-sdk/commit/e8a67255c9354f69d632697179a4d6270a4677ee))
+* **client:** elide content type header on requests without body ([f53ad05](https://github.com/context-dot-dev/context-ruby-sdk/commit/f53ad05fc7e00b2be604cc1e637998bf4ed187f5))
+* **client:** send content-type header for requests with an omitted optional body ([63d0f66](https://github.com/context-dot-dev/context-ruby-sdk/commit/63d0f66c1d871786bf80989b7a8ad11b859ec12a))
+* **internal:** correct multipart form field name encoding ([221d059](https://github.com/context-dot-dev/context-ruby-sdk/commit/221d0598148243acddae6c9679c949c07e1dcd7a))
+* multipart encoding for file arrays ([105116f](https://github.com/context-dot-dev/context-ruby-sdk/commit/105116f48178f46bae721d32e987d684fc662dd0))
+* **openapi:** strip empty-object defaults from the generated spec ([fcbb393](https://github.com/context-dot-dev/context-ruby-sdk/commit/fcbb393067fd9058bb2d443bd2a8f2a9e4b8f17c))
+* **scrape:** reuse legacy caches across all output formats ([#1197](https://github.com/context-dot-dev/context-ruby-sdk/issues/1197)) ([007ad3f](https://github.com/context-dot-dev/context-ruby-sdk/commit/007ad3f81ba753e74093d5ee05dfe8df2db06be9))
+* variable name typo ([10e1853](https://github.com/context-dot-dev/context-ruby-sdk/commit/10e185365b3196732fc5e0649975ab696f80e893))
+* **webhooks:** format Slack webhook notifications ([#1045](https://github.com/context-dot-dev/context-ruby-sdk/issues/1045)) ([4bd0df1](https://github.com/context-dot-dev/context-ruby-sdk/commit/4bd0df1c614713a46e366ca1320942fa777452fc))
+
+
+### Chores
+
+* **ci:** support opting out of skipping builds on metadata-only commits ([aad82ac](https://github.com/context-dot-dev/context-ruby-sdk/commit/aad82ac90dd1c55ca4db05e63b70b46abded53e3))
+* configure new SDK language ([8d24989](https://github.com/context-dot-dev/context-ruby-sdk/commit/8d2498986b1358432204720208f1a9b18d0f53f0))
+* **internal:** bound formatter parallelism to CPU count ([8b73d53](https://github.com/context-dot-dev/context-ruby-sdk/commit/8b73d53426ce571223386b1decabcb0bf58eaa37))
+* **internal:** more robust bootstrap script ([57b2d93](https://github.com/context-dot-dev/context-ruby-sdk/commit/57b2d93877e5ceeb388679f239e21c09b087b2a1))
+* **internal:** tweak CI branches ([2b124b9](https://github.com/context-dot-dev/context-ruby-sdk/commit/2b124b9fd6a5eeb81fa445afc448ce4819fc077e))
+* release 2.17.1 ([eeb2a0d](https://github.com/context-dot-dev/context-ruby-sdk/commit/eeb2a0db6c069449f6c062113583657a3dfa7bdc))
+* sync repo ([663ae2b](https://github.com/context-dot-dev/context-ruby-sdk/commit/663ae2b31199fd8a6b7e37161111d2c37a8d76df))
+* update SDK settings ([8a92059](https://github.com/context-dot-dev/context-ruby-sdk/commit/8a920591a4a5ef301d26d19ca2a985ac7c0d8efd))
+* update SDK settings ([3c49703](https://github.com/context-dot-dev/context-ruby-sdk/commit/3c49703a25e8951d07f597cc16b1abc03b248d84))
+
 ## [2.19.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v2.18.0...v2.19.0) (2026-09-22)
 
 

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "context.dev", "~> 2.19.0"
+gem "context.dev", "~> 2.21.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/client.rb

@@ -59,6 +59,11 @@ module ContextDev
     # @return [ContextDev::Resources::Logs]
     attr_reader :logs
 
+    # Report bugs, docs mismatches, and friction with any Context.dev API. Submissions
+    # cost no credits and use a separate rate limit.
+    # @return [ContextDev::Resources::Feedback]
+    attr_reader :feedback
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -131,6 +136,7 @@ module ContextDev
       @people = ContextDev::Resources::People.new(client: self)
       @news = ContextDev::Resources::News.new(client: self)
       @logs = ContextDev::Resources::Logs.new(client: self)
+      @feedback = ContextDev::Resources::Feedback.new(client: self)
     end
   end
 end

data/lib/context_dev/models/feedback_submit_params.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Feedback#submit
+    class FeedbackSubmitParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute category
+      #   Kind of issue.
+      #
+      #   @return [Symbol, ContextDev::Models::FeedbackSubmitParams::Category]
+      required :category, enum: -> { ContextDev::FeedbackSubmitParams::Category }
+
+      # @!attribute note
+      #   What went wrong and what you expected instead.
+      #
+      #   @return [String]
+      required :note, String
+
+      # @!attribute request_id
+      #   The request_id of the API call the feedback is about, from its response body or
+      #   X-Request-Id header.
+      #
+      #   @return [String, nil]
+      optional :request_id, String
+
+      # @!attribute tags
+      #   Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      #
+      #   @return [Array<String>, nil]
+      optional :tags, ContextDev::Internal::Type::ArrayOf[String]
+
+      # @!attribute url
+      #   The page the feedback is about, such as one page of a crawl or a docs page.
+      #
+      #   @return [String, nil]
+      optional :url, String
+
+      # @!method initialize(category:, note:, request_id: nil, tags: nil, url: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::FeedbackSubmitParams} for more details.
+      #
+      #   @param category [Symbol, ContextDev::Models::FeedbackSubmitParams::Category] Kind of issue.
+      #
+      #   @param note [String] What went wrong and what you expected instead.
+      #
+      #   @param request_id [String] The request_id of the API call the feedback is about, from its response body or
+      #
+      #   @param tags [Array<String>] Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      #
+      #   @param url [String] The page the feedback is about, such as one page of a crawl or a docs page.
+      #
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+
+      # Kind of issue.
+      module Category
+        extend ContextDev::Internal::Type::Enum
+
+        BUG = :bug
+        DOCS_MISMATCH = :docs_mismatch
+        FRICTION = :friction
+        FEATURE_GAP = :feature_gap
+        QUALITY_DEGRADATION = :quality_degradation
+        OTHER = :other
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/context_dev/models/feedback_submit_response.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Feedback#submit
+    class FeedbackSubmitResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute already_submitted
+      #   True when feedback for this request_id was already recorded; the original
+      #   feedback_id is returned.
+      #
+      #   @return [Boolean]
+      required :already_submitted, ContextDev::Internal::Type::Boolean
+
+      # @!attribute feedback_id
+      #   ID of the stored feedback.
+      #
+      #   @return [String]
+      required :feedback_id, String
+
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
+      # @!attribute key_metadata
+      #   Credit usage, included whenever a valid API key is provided.
+      #
+      #   @return [ContextDev::Models::FeedbackSubmitResponse::KeyMetadata, nil]
+      optional :key_metadata, -> { ContextDev::Models::FeedbackSubmitResponse::KeyMetadata }
+
+      # @!method initialize(already_submitted:, feedback_id:, request_id:, key_metadata: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::FeedbackSubmitResponse} for more details.
+      #
+      #   @param already_submitted [Boolean] True when feedback for this request_id was already recorded; the original feedba
+      #
+      #   @param feedback_id [String] ID of the stored feedback.
+      #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
+      #   @param key_metadata [ContextDev::Models::FeedbackSubmitResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
+
+      # @see ContextDev::Models::FeedbackSubmitResponse#key_metadata
+      class KeyMetadata < ContextDev::Internal::Type::BaseModel
+        # @!attribute credits_consumed
+        #   Credits used by this request.
+        #
+        #   @return [Integer]
+        required :credits_consumed, Integer
+
+        # @!attribute credits_remaining
+        #   Credits remaining for your organization.
+        #
+        #   @return [Integer]
+        required :credits_remaining, Integer
+
+        # @!method initialize(credits_consumed:, credits_remaining:)
+        #   Credit usage, included whenever a valid API key is provided.
+        #
+        #   @param credits_consumed [Integer] Credits used by this request.
+        #
+        #   @param credits_remaining [Integer] Credits remaining for your organization.
+      end
+    end
+  end
+end

data/lib/context_dev/models/news_search_params.rb

@@ -20,7 +20,9 @@ module ContextDev
       optional :cursor, String, nil?: true
 
       # @!attribute filter_by
-      #   Optional result filters.
+      #   Optional result filters. Use at most one of sourceDomain, sourceCountry,
+      #   articleLanguage, or articleType. A date range may accompany that category;
+      #   date.from must not exceed date.to.
       #
       #   @return [ContextDev::Models::NewsSearchParams::FilterBy, nil]
       optional :filter_by, -> { ContextDev::NewsSearchParams::FilterBy }, api_name: :filterBy
@@ -44,11 +46,14 @@ module ContextDev
       optional :tags, ContextDev::Internal::Type::ArrayOf[String]
 
       # @!method initialize(search_by:, cursor: nil, filter_by: nil, limit: nil, sort_by: nil, tags: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::NewsSearchParams} for more details.
+      #
       #   @param search_by [ContextDev::Models::NewsSearchParams::SearchBy] What to search for.
       #
       #   @param cursor [String, nil] Opaque next_cursor from the previous response, or null for the first page.
       #
-      #   @param filter_by [ContextDev::Models::NewsSearchParams::FilterBy] Optional result filters.
+      #   @param filter_by [ContextDev::Models::NewsSearchParams::FilterBy] Optional result filters. Use at most one of sourceDomain, sourceCountry, article
       #
       #   @param limit [Integer] Maximum results to return. Defaults to 10.
       #
@@ -314,7 +319,7 @@ module ContextDev
                  api_name: :articleType
 
         # @!attribute date
-        #   Published-at window in epoch milliseconds.
+        #   Published-at window in epoch milliseconds. from must be before or equal to to.
         #
         #   @return [ContextDev::Models::NewsSearchParams::FilterBy::Date, nil]
         optional :date, -> { ContextDev::NewsSearchParams::FilterBy::Date }
@@ -336,13 +341,15 @@ module ContextDev
         optional :source_domain, ContextDev::Internal::Type::ArrayOf[String], api_name: :sourceDomain
 
         # @!method initialize(article_language: nil, article_type: nil, date: nil, source_country: nil, source_domain: nil)
-        #   Optional result filters.
+        #   Optional result filters. Use at most one of sourceDomain, sourceCountry,
+        #   articleLanguage, or articleType. A date range may accompany that category;
+        #   date.from must not exceed date.to.
         #
         #   @param article_language [Array<Symbol, ContextDev::Models::NewsSearchParams::FilterBy::ArticleLanguage>] Article languages to include. Up to 3.
         #
         #   @param article_type [Array<Symbol, ContextDev::Models::NewsSearchParams::FilterBy::ArticleType>] Article types to include. Up to 3.
         #
-        #   @param date [ContextDev::Models::NewsSearchParams::FilterBy::Date] Published-at window in epoch milliseconds.
+        #   @param date [ContextDev::Models::NewsSearchParams::FilterBy::Date] Published-at window in epoch milliseconds. from must be before or equal to to.
         #
         #   @param source_country [Array<Symbol, ContextDev::Models::NewsSearchParams::FilterBy::SourceCountry>] Publisher countries to include, as lowercase ISO 3166-1 alpha-2 codes. Up to 3.
         #
@@ -396,7 +403,7 @@ module ContextDev
           optional :to, Integer
 
           # @!method initialize(from: nil, to: nil)
-          #   Published-at window in epoch milliseconds.
+          #   Published-at window in epoch milliseconds. from must be before or equal to to.
           #
           #   @param from [Integer] Inclusive start of the published-at window, in epoch milliseconds.
           #