openlayer 0.10.6 → 0.10.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 693c401df5cc5f3ab0562dbbac4d83595a67e9c27a6e1f732efabc3fb35f19e1
-  data.tar.gz: 54af0253a77a65945481b0d14719a3685550a0e956099e67c893f5d7c6074a81
+  metadata.gz: ca38fff0598cdb15093a9635372a51d58af21739704cfcec3b4c1e6baad4889a
+  data.tar.gz: 9ba60d0632f90dcebf67426c592027a91ae68a9b83c8ee2923eb3de634a4dc87
 SHA512:
-  metadata.gz: 3f914469bfc06b657757fed25c37e11c3436342d6a6d5a85f39fcc49ecff46aac9b6b7c32b09de01bfb931592905bb05655dcf24a8f02b0a371d8d11c40a7cd7
-  data.tar.gz: 5ad764d18ac529b0f8768233dd45183ea8d04ca3893048fd8a940c0fa13cc6f4fce4a349ee382e1b10f4925164aee3a6179f349001028dfa2d60b3a6aa16b1fe
+  metadata.gz: af8b3ebb45bfa11fe5fea269046fd636208444c5e38ea99c1f4ba674642ae9e6834a5011ed94f22611add7f579ed97254abb3db32440b610b2082cd5a211e30d
+  data.tar.gz: eefccb2c93aa33096974f7597f6c88e2a882803de592559cbc768534274f8622141f324b8b2ab2088a09e725389a777ca0a693e76007c58d540101c96b9296f3

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.10.7 (2026-02-10)
+
+Full Changelog: [v0.10.6...v0.10.7](https://github.com/openlayer-ai/openlayer-ruby/compare/v0.10.6...v0.10.7)
+
+### Chores
+
+* **closes OPEN-8647:** add endpoint to retrieve aggregated user data for inference pipelines ([5442bcb](https://github.com/openlayer-ai/openlayer-ruby/commit/5442bcbd5b6ab56d618fd36a985a7d864b65e7ae))
+
 ## 0.10.6 (2026-02-07)
 
 Full Changelog: [v0.10.5...v0.10.6](https://github.com/openlayer-ai/openlayer-ruby/compare/v0.10.5...v0.10.6)

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

data/lib/openlayer/models/inference_pipeline_retrieve_users_params.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Openlayer
+  module Models
+    # @see Openlayer::Resources::InferencePipelines#retrieve_users
+    class InferencePipelineRetrieveUsersParams < Openlayer::Internal::Type::BaseModel
+      extend Openlayer::Internal::Type::RequestParameters::Converter
+      include Openlayer::Internal::Type::RequestParameters
+
+      # @!attribute page
+      #   The page to return in a paginated query.
+      #
+      #   @return [Integer, nil]
+      optional :page, Integer
+
+      # @!attribute per_page
+      #   Maximum number of items to return per page.
+      #
+      #   @return [Integer, nil]
+      optional :per_page, Integer
+
+      # @!method initialize(page: nil, per_page: nil, request_options: {})
+      #   @param page [Integer] The page to return in a paginated query.
+      #
+      #   @param per_page [Integer] Maximum number of items to return per page.
+      #
+      #   @param request_options [Openlayer::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/openlayer/models/inference_pipeline_retrieve_users_response.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Openlayer
+  module Models
+    # @see Openlayer::Resources::InferencePipelines#retrieve_users
+    class InferencePipelineRetrieveUsersResponse < Openlayer::Internal::Type::BaseModel
+      # @!attribute items
+      #   Array of user aggregation data
+      #
+      #   @return [Array<Openlayer::Models::InferencePipelineRetrieveUsersResponse::Item>]
+      required :items,
+               -> { Openlayer::Internal::Type::ArrayOf[Openlayer::Models::InferencePipelineRetrieveUsersResponse::Item] }
+
+      # @!method initialize(items:)
+      #   @param items [Array<Openlayer::Models::InferencePipelineRetrieveUsersResponse::Item>] Array of user aggregation data
+
+      class Item < Openlayer::Internal::Type::BaseModel
+        # @!attribute id
+        #   The unique user identifier
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute cost
+        #   Total cost for this user
+        #
+        #   @return [Float]
+        required :cost, Float
+
+        # @!attribute date_of_first_record
+        #   Timestamp of the user's first event/trace
+        #
+        #   @return [Time]
+        required :date_of_first_record, Time, api_name: :dateOfFirstRecord
+
+        # @!attribute date_of_last_record
+        #   Timestamp of the user's last event/trace
+        #
+        #   @return [Time]
+        required :date_of_last_record, Time, api_name: :dateOfLastRecord
+
+        # @!attribute records
+        #   Total number of traces/rows for this user
+        #
+        #   @return [Integer]
+        required :records, Integer
+
+        # @!attribute sessions
+        #   Count of unique sessions for this user
+        #
+        #   @return [Integer]
+        required :sessions, Integer
+
+        # @!attribute tokens
+        #   Total token count for this user
+        #
+        #   @return [Float]
+        required :tokens, Float
+
+        # @!method initialize(id:, cost:, date_of_first_record:, date_of_last_record:, records:, sessions:, tokens:)
+        #   @param id [String] The unique user identifier
+        #
+        #   @param cost [Float] Total cost for this user
+        #
+        #   @param date_of_first_record [Time] Timestamp of the user's first event/trace
+        #
+        #   @param date_of_last_record [Time] Timestamp of the user's last event/trace
+        #
+        #   @param records [Integer] Total number of traces/rows for this user
+        #
+        #   @param sessions [Integer] Count of unique sessions for this user
+        #
+        #   @param tokens [Float] Total token count for this user
+      end
+    end
+  end
+end

data/lib/openlayer/models.rb

@@ -47,6 +47,8 @@ module Openlayer
 
   InferencePipelineRetrieveParams = Openlayer::Models::InferencePipelineRetrieveParams
 
+  InferencePipelineRetrieveUsersParams = Openlayer::Models::InferencePipelineRetrieveUsersParams
+
   InferencePipelines = Openlayer::Models::InferencePipelines
 
   InferencePipelineUpdateParams = Openlayer::Models::InferencePipelineUpdateParams

data/lib/openlayer/resources/inference_pipelines.rb

@@ -87,6 +87,36 @@ module Openlayer
         )
       end
 
+      # Get aggregated user data for an inference pipeline with pagination and metadata.
+      #
+      # Returns a list of users who have interacted with the inference pipeline,
+      # including their activity statistics such as session counts, record counts, token
+      # usage, and costs.
+      #
+      # @overload retrieve_users(inference_pipeline_id, page: nil, per_page: nil, request_options: {})
+      #
+      # @param inference_pipeline_id [String] The inference pipeline id (a UUID).
+      #
+      # @param page [Integer] The page to return in a paginated query.
+      #
+      # @param per_page [Integer] Maximum number of items to return per page.
+      #
+      # @param request_options [Openlayer::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Openlayer::Models::InferencePipelineRetrieveUsersResponse]
+      #
+      # @see Openlayer::Models::InferencePipelineRetrieveUsersParams
+      def retrieve_users(inference_pipeline_id, params = {})
+        parsed, options = Openlayer::InferencePipelineRetrieveUsersParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["inference-pipelines/%1$s/users", inference_pipeline_id],
+          query: parsed.transform_keys(per_page: "perPage"),
+          model: Openlayer::Models::InferencePipelineRetrieveUsersResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [Openlayer::Client]

data/lib/openlayer/version.rb

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

data/lib/openlayer.rb

@@ -59,6 +59,8 @@ require_relative "openlayer/models/commits/test_result_list_response"
 require_relative "openlayer/models/inference_pipeline_delete_params"
 require_relative "openlayer/models/inference_pipeline_retrieve_params"
 require_relative "openlayer/models/inference_pipeline_retrieve_response"
+require_relative "openlayer/models/inference_pipeline_retrieve_users_params"
+require_relative "openlayer/models/inference_pipeline_retrieve_users_response"
 require_relative "openlayer/models/inference_pipelines/data_stream_params"
 require_relative "openlayer/models/inference_pipelines/data_stream_response"
 require_relative "openlayer/models/inference_pipelines/row_update_params"

data/rbi/openlayer/models/inference_pipeline_retrieve_users_params.rbi

@@ -0,0 +1,60 @@
+# typed: strong
+
+module Openlayer
+  module Models
+    class InferencePipelineRetrieveUsersParams < Openlayer::Internal::Type::BaseModel
+      extend Openlayer::Internal::Type::RequestParameters::Converter
+      include Openlayer::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Openlayer::InferencePipelineRetrieveUsersParams,
+            Openlayer::Internal::AnyHash
+          )
+        end
+
+      # The page to return in a paginated query.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :page
+
+      sig { params(page: Integer).void }
+      attr_writer :page
+
+      # Maximum number of items to return per page.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :per_page
+
+      sig { params(per_page: Integer).void }
+      attr_writer :per_page
+
+      sig do
+        params(
+          page: Integer,
+          per_page: Integer,
+          request_options: Openlayer::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The page to return in a paginated query.
+        page: nil,
+        # Maximum number of items to return per page.
+        per_page: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            page: Integer,
+            per_page: Integer,
+            request_options: Openlayer::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/openlayer/models/inference_pipeline_retrieve_users_response.rbi

@@ -0,0 +1,135 @@
+# typed: strong
+
+module Openlayer
+  module Models
+    class InferencePipelineRetrieveUsersResponse < Openlayer::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Openlayer::Models::InferencePipelineRetrieveUsersResponse,
+            Openlayer::Internal::AnyHash
+          )
+        end
+
+      # Array of user aggregation data
+      sig do
+        returns(
+          T::Array[
+            Openlayer::Models::InferencePipelineRetrieveUsersResponse::Item
+          ]
+        )
+      end
+      attr_accessor :items
+
+      sig do
+        params(
+          items:
+            T::Array[
+              Openlayer::Models::InferencePipelineRetrieveUsersResponse::Item::OrHash
+            ]
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Array of user aggregation data
+        items:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            items:
+              T::Array[
+                Openlayer::Models::InferencePipelineRetrieveUsersResponse::Item
+              ]
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Item < Openlayer::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Openlayer::Models::InferencePipelineRetrieveUsersResponse::Item,
+              Openlayer::Internal::AnyHash
+            )
+          end
+
+        # The unique user identifier
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Total cost for this user
+        sig { returns(Float) }
+        attr_accessor :cost
+
+        # Timestamp of the user's first event/trace
+        sig { returns(Time) }
+        attr_accessor :date_of_first_record
+
+        # Timestamp of the user's last event/trace
+        sig { returns(Time) }
+        attr_accessor :date_of_last_record
+
+        # Total number of traces/rows for this user
+        sig { returns(Integer) }
+        attr_accessor :records
+
+        # Count of unique sessions for this user
+        sig { returns(Integer) }
+        attr_accessor :sessions
+
+        # Total token count for this user
+        sig { returns(Float) }
+        attr_accessor :tokens
+
+        sig do
+          params(
+            id: String,
+            cost: Float,
+            date_of_first_record: Time,
+            date_of_last_record: Time,
+            records: Integer,
+            sessions: Integer,
+            tokens: Float
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The unique user identifier
+          id:,
+          # Total cost for this user
+          cost:,
+          # Timestamp of the user's first event/trace
+          date_of_first_record:,
+          # Timestamp of the user's last event/trace
+          date_of_last_record:,
+          # Total number of traces/rows for this user
+          records:,
+          # Count of unique sessions for this user
+          sessions:,
+          # Total token count for this user
+          tokens:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              cost: Float,
+              date_of_first_record: Time,
+              date_of_last_record: Time,
+              records: Integer,
+              sessions: Integer,
+              tokens: Float
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/openlayer/models.rbi

@@ -11,6 +11,9 @@ module Openlayer
   InferencePipelineRetrieveParams =
     Openlayer::Models::InferencePipelineRetrieveParams
 
+  InferencePipelineRetrieveUsersParams =
+    Openlayer::Models::InferencePipelineRetrieveUsersParams
+
   InferencePipelines = Openlayer::Models::InferencePipelines
 
   InferencePipelineUpdateParams =

data/rbi/openlayer/resources/inference_pipelines.rbi

@@ -70,6 +70,30 @@ module Openlayer
       )
       end
 
+      # Get aggregated user data for an inference pipeline with pagination and metadata.
+      #
+      # Returns a list of users who have interacted with the inference pipeline,
+      # including their activity statistics such as session counts, record counts, token
+      # usage, and costs.
+      sig do
+        params(
+          inference_pipeline_id: String,
+          page: Integer,
+          per_page: Integer,
+          request_options: Openlayer::RequestOptions::OrHash
+        ).returns(Openlayer::Models::InferencePipelineRetrieveUsersResponse)
+      end
+      def retrieve_users(
+        # The inference pipeline id (a UUID).
+        inference_pipeline_id,
+        # The page to return in a paginated query.
+        page: nil,
+        # Maximum number of items to return per page.
+        per_page: nil,
+        request_options: {}
+      )
+      end
+
       # @api private
       sig { params(client: Openlayer::Client).returns(T.attached_class) }
       def self.new(client:)

data/sig/openlayer/models/inference_pipeline_retrieve_users_params.rbs

@@ -0,0 +1,32 @@
+module Openlayer
+  module Models
+    type inference_pipeline_retrieve_users_params =
+      { page: Integer, per_page: Integer }
+      & Openlayer::Internal::Type::request_parameters
+
+    class InferencePipelineRetrieveUsersParams < Openlayer::Internal::Type::BaseModel
+      extend Openlayer::Internal::Type::RequestParameters::Converter
+      include Openlayer::Internal::Type::RequestParameters
+
+      attr_reader page: Integer?
+
+      def page=: (Integer) -> Integer
+
+      attr_reader per_page: Integer?
+
+      def per_page=: (Integer) -> Integer
+
+      def initialize: (
+        ?page: Integer,
+        ?per_page: Integer,
+        ?request_options: Openlayer::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        page: Integer,
+        per_page: Integer,
+        request_options: Openlayer::RequestOptions
+      }
+    end
+  end
+end

data/sig/openlayer/models/inference_pipeline_retrieve_users_response.rbs

@@ -0,0 +1,67 @@
+module Openlayer
+  module Models
+    type inference_pipeline_retrieve_users_response =
+      {
+        items: ::Array[Openlayer::Models::InferencePipelineRetrieveUsersResponse::Item]
+      }
+
+    class InferencePipelineRetrieveUsersResponse < Openlayer::Internal::Type::BaseModel
+      attr_accessor items: ::Array[Openlayer::Models::InferencePipelineRetrieveUsersResponse::Item]
+
+      def initialize: (
+        items: ::Array[Openlayer::Models::InferencePipelineRetrieveUsersResponse::Item]
+      ) -> void
+
+      def to_hash: -> {
+        items: ::Array[Openlayer::Models::InferencePipelineRetrieveUsersResponse::Item]
+      }
+
+      type item =
+        {
+          id: String,
+          cost: Float,
+          date_of_first_record: Time,
+          date_of_last_record: Time,
+          records: Integer,
+          sessions: Integer,
+          tokens: Float
+        }
+
+      class Item < Openlayer::Internal::Type::BaseModel
+        attr_accessor id: String
+
+        attr_accessor cost: Float
+
+        attr_accessor date_of_first_record: Time
+
+        attr_accessor date_of_last_record: Time
+
+        attr_accessor records: Integer
+
+        attr_accessor sessions: Integer
+
+        attr_accessor tokens: Float
+
+        def initialize: (
+          id: String,
+          cost: Float,
+          date_of_first_record: Time,
+          date_of_last_record: Time,
+          records: Integer,
+          sessions: Integer,
+          tokens: Float
+        ) -> void
+
+        def to_hash: -> {
+          id: String,
+          cost: Float,
+          date_of_first_record: Time,
+          date_of_last_record: Time,
+          records: Integer,
+          sessions: Integer,
+          tokens: Float
+        }
+      end
+    end
+  end
+end

data/sig/openlayer/models.rbs

@@ -7,6 +7,8 @@ module Openlayer
 
   class InferencePipelineRetrieveParams = Openlayer::Models::InferencePipelineRetrieveParams
 
+  class InferencePipelineRetrieveUsersParams = Openlayer::Models::InferencePipelineRetrieveUsersParams
+
   module InferencePipelines = Openlayer::Models::InferencePipelines
 
   class InferencePipelineUpdateParams = Openlayer::Models::InferencePipelineUpdateParams

data/sig/openlayer/resources/inference_pipelines.rbs

@@ -26,6 +26,13 @@ module Openlayer
         ?request_options: Openlayer::request_opts
       ) -> nil
 
+      def retrieve_users: (
+        String inference_pipeline_id,
+        ?page: Integer,
+        ?per_page: Integer,
+        ?request_options: Openlayer::request_opts
+      ) -> Openlayer::Models::InferencePipelineRetrieveUsersResponse
+
       def initialize: (client: Openlayer::Client) -> void
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openlayer
 version: !ruby/object:Gem::Version
-  version: 0.10.6
+  version: 0.10.7
 platform: ruby
 authors:
 - Openlayer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-09 00:00:00.000000000 Z
+date: 2026-02-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -77,6 +77,8 @@ files:
 - lib/openlayer/models/inference_pipeline_delete_params.rb
 - lib/openlayer/models/inference_pipeline_retrieve_params.rb
 - lib/openlayer/models/inference_pipeline_retrieve_response.rb
+- lib/openlayer/models/inference_pipeline_retrieve_users_params.rb
+- lib/openlayer/models/inference_pipeline_retrieve_users_response.rb
 - lib/openlayer/models/inference_pipeline_update_params.rb
 - lib/openlayer/models/inference_pipeline_update_response.rb
 - lib/openlayer/models/inference_pipelines/data_stream_params.rb
@@ -167,6 +169,8 @@ files:
 - rbi/openlayer/models/inference_pipeline_delete_params.rbi
 - rbi/openlayer/models/inference_pipeline_retrieve_params.rbi
 - rbi/openlayer/models/inference_pipeline_retrieve_response.rbi
+- rbi/openlayer/models/inference_pipeline_retrieve_users_params.rbi
+- rbi/openlayer/models/inference_pipeline_retrieve_users_response.rbi
 - rbi/openlayer/models/inference_pipeline_update_params.rbi
 - rbi/openlayer/models/inference_pipeline_update_response.rbi
 - rbi/openlayer/models/inference_pipelines/data_stream_params.rbi
@@ -254,6 +258,8 @@ files:
 - sig/openlayer/models/inference_pipeline_delete_params.rbs
 - sig/openlayer/models/inference_pipeline_retrieve_params.rbs
 - sig/openlayer/models/inference_pipeline_retrieve_response.rbs
+- sig/openlayer/models/inference_pipeline_retrieve_users_params.rbs
+- sig/openlayer/models/inference_pipeline_retrieve_users_response.rbs
 - sig/openlayer/models/inference_pipeline_update_params.rbs
 - sig/openlayer/models/inference_pipeline_update_response.rbs
 - sig/openlayer/models/inference_pipelines/data_stream_params.rbs