fix: wrap text/highlights/summary/context in contents object

The Exa API requires content extraction options (text, highlights,
summary, context) to be nested inside a `contents` object in the
request payload. Previously, these were sent at the top level,
causing the API to silently ignore them and return no text content.

This fix modifies SearchRequest#to_payload to automatically wrap
these options in the required `contents` structure, making text
extraction work as documented.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: vicentereig

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.2.2] - 2025-12-22
+- **BUGFIX**: Fix text/highlights/summary/context extraction in search results.
+  - The Exa API requires these options to be wrapped in a `contents` object.
+  - Previously, passing `text: true` or `text: {max_characters: 1000}` would silently return no text.
+  - Now correctly serializes to `{"contents": {"text": ...}}` as the API expects.
+
 ## [1.2.0] - 2025-10-31
 - Add `Exa::Internal::Transport::AsyncRequester`, enabling optional fiber-scheduler-friendly HTTP via the `async` ecosystem.
 - Document async usage in the README with Gemfile requirements and concurrent request example.

lib/exa/types/search.rb

@@ -61,13 +61,33 @@ class ExtrasOptions < T::Struct
       const :image_links, T.nilable(Integer)
     end
 
+    # Content options that get wrapped in a `contents` object for the API
+    CONTENT_OPTION_KEYS = %i[text highlights summary context].freeze
+
     class SearchRequest < T::Struct
       include StructWrapper
       include SearchOptionProps
       const :query, String
 
       def to_payload
-        Serializer.to_payload(self)
+        payload = Serializer.to_payload(self)
+        wrap_contents_options(payload)
+      end
+
+      private
+
+      def wrap_contents_options(payload)
+        contents = {}
+
+        CONTENT_OPTION_KEYS.each do |key|
+          camel_key = Serializer.camelize(key)
+          next unless payload.key?(camel_key)
+
+          contents[camel_key] = payload.delete(camel_key)
+        end
+
+        payload["contents"] = contents unless contents.empty?
+        payload
       end
     end
   end

lib/exa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Exa
-  VERSION = "1.2.1"
+  VERSION = "1.2.2"
 end

test/types/serializer_test.rb

@@ -22,7 +22,7 @@ def test_search_request_serializes_to_camel_case
     assert_equal "latest ai", payload["query"]
     assert_equal 5, payload["numResults"]
     assert_equal 10, payload["livecrawlTimeout"]
-    assert_equal 1000, payload.dig("text", "maxCharacters")
+    assert_equal 1000, payload.dig("contents", "text", "maxCharacters")
   end
 
   def test_find_similar_serializes_flags