openlayer 0.14.0 → 0.14.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7df732e3f7923ec58467e297ca5fe1fb8ff35ae552c66d55740e0087edd72962
-  data.tar.gz: ad8e4d93a70d7164d0ec01028749d2ece806a538804dce306804846d56db4dbb
+  metadata.gz: 697bde0fdcf61182dd6235f06ab2ab9439b245251284f66100a53c44a6bfc146
+  data.tar.gz: ea5d247e85a34a14143e82e2aa49e39e44c322d7329cbba01967afb15fb7fc5e
 SHA512:
-  metadata.gz: 201e0fdc1d72da7b17b45dc9e73ea971d56d36dada8f691b324ee0852dd95be44e8061bf6ef21122e11f108f2ac33a51255fde830e3b9655b118f7b35912101d
-  data.tar.gz: 7619b1e64944741e9335620a0e60e0f4e3de5f638bba1fafd080c86c21ebf61aa71110384157f95063dcf170b6562cd3437e21406eb66aa2e0dbd7f22966e2d8
+  metadata.gz: a22c1acd44798f116733781f5648b8cf74697811c09a8ed76ac73a217b803467dd3213a7efe19a1b57c13b3ff93dddd7ca0b4eb5496ea05228f559a29c830dc5
+  data.tar.gz: c2b731b11958e0adc38bd37b30045494a832225daf1d8c79a310fb78b8cb72e49a7765d45700c3fcf01e982a5a830faacc7bf8127b0e84806d4a79dccbfc4f8f

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.14.1 (2026-07-06)
+
+Full Changelog: [v0.14.0...v0.14.1](https://github.com/openlayer-ai/openlayer-ruby/compare/v0.14.0...v0.14.1)
+
 ## 0.14.0 (2026-07-06)
 
 Full Changelog: [v0.13.1...v0.14.0](https://github.com/openlayer-ai/openlayer-ruby/compare/v0.13.1...v0.14.0)

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 "openlayer", "~> 0.14.0"
+gem "openlayer", "~> 0.14.1"
 ```
 
 <!-- x-release-please-end -->

data/lib/openlayer/integrations/google_conversational_search_tracer.rb

@@ -345,6 +345,9 @@ module Openlayer
 
       # Extract references from answer
       #
+      # Each reference's `content` is a oneof: exactly one of chunk_info,
+      # structured_document_info, or unstructured_document_info is present.
+      #
       # @param answer [Object] Answer object from response
       # @return [Array<Hash>, nil] Array of reference hashes or nil
       def self.extract_references(answer)
@@ -354,25 +357,85 @@ module Openlayer
         return nil if references.nil? || !references.respond_to?(:each_with_index)
 
         references.each_with_index.map do |reference, index|
-          chunk_info = safe_extract(reference, :chunk_info)
-          next nil if chunk_info.nil?
-
-          doc_metadata = safe_extract(chunk_info, :document_metadata)
-
-          {
-            reference_id: index.to_s,
-            content: safe_extract(chunk_info, :content),
-            relevance_score: safe_extract(chunk_info, :relevance_score)&.to_f,
-            document_id: doc_metadata ? safe_extract(doc_metadata, :document) : nil,
-            uri: doc_metadata ? safe_extract(doc_metadata, :uri) : nil,
-            title: doc_metadata ? safe_extract(doc_metadata, :title) : nil
-          }.compact
+          extract_reference(reference, index)
         end.compact
       rescue StandardError => e
         warn_if_debug("[Openlayer] Failed to extract references: #{e.message}")
         nil
       end
 
+      # Extract a single reference hash from whichever `content` oneof
+      # variant is present on it
+      #
+      # @param reference [Object] Reference object
+      # @param index [Integer] Reference's index in the references array
+      # @return [Hash, nil] Reference hash, or nil if no known variant is set
+      def self.extract_reference(reference, index)
+        if (chunk_info = safe_extract(reference, :chunk_info))
+          extract_chunk_info_reference(chunk_info, index)
+        elsif (structured_document_info = safe_extract(reference, :structured_document_info))
+          extract_structured_document_info_reference(structured_document_info, index)
+        elsif (unstructured_document_info = safe_extract(reference, :unstructured_document_info))
+          extract_unstructured_document_info_reference(unstructured_document_info, index)
+        end
+      rescue StandardError => e
+        warn_if_debug("[Openlayer] Failed to extract reference: #{e.message}")
+        nil
+      end
+
+      # Build a reference hash from a ChunkInfo variant
+      #
+      # @param chunk_info [Object] ChunkInfo object
+      # @param index [Integer] Reference's index in the references array
+      # @return [Hash] Reference hash
+      def self.extract_chunk_info_reference(chunk_info, index)
+        doc_metadata = safe_extract(chunk_info, :document_metadata)
+
+        {
+          reference_id: index.to_s,
+          content: safe_extract(chunk_info, :content),
+          relevance_score: safe_extract(chunk_info, :relevance_score)&.to_f,
+          document_id: doc_metadata ? safe_extract(doc_metadata, :document) : nil,
+          uri: doc_metadata ? safe_extract(doc_metadata, :uri) : nil,
+          title: doc_metadata ? safe_extract(doc_metadata, :title) : nil
+        }.compact
+      end
+
+      # Build a reference hash from a StructuredDocumentInfo variant
+      #
+      # @param structured_document_info [Object] StructuredDocumentInfo object
+      # @param index [Integer] Reference's index in the references array
+      # @return [Hash] Reference hash
+      def self.extract_structured_document_info_reference(structured_document_info, index)
+        {
+          reference_id: index.to_s,
+          document_id: safe_extract(structured_document_info, :document),
+          uri: safe_extract(structured_document_info, :uri),
+          title: safe_extract(structured_document_info, :title),
+          struct_data: safe_extract(structured_document_info, :struct_data)
+        }.compact
+      end
+
+      # Build a reference hash from an UnstructuredDocumentInfo variant
+      #
+      # @param unstructured_document_info [Object] UnstructuredDocumentInfo object
+      # @param index [Integer] Reference's index in the references array
+      # @return [Hash] Reference hash
+      def self.extract_unstructured_document_info_reference(unstructured_document_info, index)
+        chunk_contents = safe_extract(unstructured_document_info, :chunk_contents)
+        content = if chunk_contents.respond_to?(:map)
+          chunk_contents.map { |chunk| safe_extract(chunk, :content) }.compact.join("\n")
+        end
+
+        {
+          reference_id: index.to_s,
+          content: (content unless content.nil? || content.empty?),
+          document_id: safe_extract(unstructured_document_info, :document),
+          uri: safe_extract(unstructured_document_info, :uri),
+          title: safe_extract(unstructured_document_info, :title)
+        }.compact
+      end
+
       # Extract related questions from answer
       #
       # @param answer [Object] Answer object from response
@@ -717,6 +780,10 @@ module Openlayer
                            :extract_citations,
                            :extract_citation_sources,
                            :extract_references,
+                           :extract_reference,
+                           :extract_chunk_info_reference,
+                           :extract_structured_document_info_reference,
+                           :extract_unstructured_document_info_reference,
                            :extract_related_questions,
                            :extract_steps,
                            :extract_step_data,

data/lib/openlayer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Openlayer
-  VERSION = "0.14.0"
+  VERSION = "0.14.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openlayer
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.14.1
 platform: ruby
 authors:
 - Openlayer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-06 00:00:00.000000000 Z
+date: 2026-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi