moonbase-sdk 0.1.0.pre.alpha.7 → 0.1.0.pre.alpha.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 152175f6a749114154155328a0e652c1aaa2f0708e25f9ad036a6f289e255b8c
-  data.tar.gz: f3ac09e2b7402221821ce8c9657423d76672d609bee8f7dfa1895606f0a191d0
+  metadata.gz: e03284abe6f7fc28ddef264df8add1e58c2ea12ed0c615ee3a381a1a561135e8
+  data.tar.gz: 7fd59defee63bb9da6221286420017ec6bd756fb37668be56620840ab6ba7d6e
 SHA512:
-  metadata.gz: b683ac149d1606cfbc4b9501a753ad78c645f1b24d1e1a32376e5cce60fcc924a13cbd69d18e7475629e6483938db886a92590d4e433d66f48ebc5eb06b8a494
-  data.tar.gz: d28d6a89f04dd6a25a846a02a821fb2f56ca838b9da287d90936d5e30b4dfe4b213c0ae5878a31475fe248391c48afe9bc96cba03ca0522a56940bfcf859a788
+  metadata.gz: 7fe47484e421bb3412ea1d91229d70f4ddb099e6f20a55b5ed4715e1e560c26e3a950bb2fb4c134fd0570d6001cd87d457944c5ba2f0479166406480bc7437a8
+  data.tar.gz: c12b4dc94ebe53d337f24ad01ca2265654db25ac8f24d4534db916ad636b31897f1e8af374b5a59e03429df370ba91f53fa2da4451baab4751fd6b007e0ad560

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.1.0-alpha.8 (2026-02-23)
+
+Full Changelog: [v0.1.0-alpha.7...v0.1.0-alpha.8](https://github.com/moonbaseai/moonbase-sdk-ruby/compare/v0.1.0-alpha.7...v0.1.0-alpha.8)
+
+### Features
+
+* **api:** add search resource, move items.search to collections.items, add include/sort params ([d99456c](https://github.com/moonbaseai/moonbase-sdk-ruby/commit/d99456c265311a9c11e88f73ed405a8b34570eb9))
+
+
+### Chores
+
+* update mock server docs ([cefe0f8](https://github.com/moonbaseai/moonbase-sdk-ruby/commit/cefe0f8a2f94b567596d621d8f993d15b3c8a6dd))
+
 ## 0.1.0-alpha.7 (2026-02-09)
 
 Full Changelog: [v0.1.0-alpha.6...v0.1.0-alpha.7](https://github.com/moonbaseai/moonbase-sdk-ruby/compare/v0.1.0-alpha.6...v0.1.0-alpha.7)

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "moonbase-sdk", "~> 0.1.0.pre.alpha.7"
+gem "moonbase-sdk", "~> 0.1.0.pre.alpha.8"
 ```
 
 <!-- x-release-please-end -->

data/lib/moonbase/client.rb

@@ -25,9 +25,6 @@ module Moonbase
     # @return [Moonbase::Resources::Collections]
     attr_reader :collections
 
-    # @return [Moonbase::Resources::Items]
-    attr_reader :items
-
     # @return [Moonbase::Resources::Views]
     attr_reader :views
 
@@ -76,6 +73,25 @@ module Moonbase
     # @return [Moonbase::Resources::AgentSettings]
     attr_reader :agent_settings
 
+    # @overload search(query:, request_options: {})
+    #
+    # @param query [String]
+    # @param request_options [Moonbase::RequestOptions, Hash{Symbol=>Object}, nil]
+    #
+    # @return [Moonbase::Models::SearchResponse]
+    #
+    # @see Moonbase::Models::ClientSearchParams
+    def search(params)
+      parsed, options = Moonbase::ClientSearchParams.dump_request(params)
+      request(
+        method: :post,
+        path: "search",
+        query: parsed,
+        model: Moonbase::Models::SearchResponse,
+        options: options
+      )
+    end
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -125,7 +141,6 @@ module Moonbase
 
       @funnels = Moonbase::Resources::Funnels.new(client: self)
       @collections = Moonbase::Resources::Collections.new(client: self)
-      @items = Moonbase::Resources::Items.new(client: self)
       @views = Moonbase::Resources::Views.new(client: self)
       @inboxes = Moonbase::Resources::Inboxes.new(client: self)
       @inbox_conversations = Moonbase::Resources::InboxConversations.new(client: self)

data/lib/moonbase/models/call.rb

@@ -76,13 +76,35 @@ module Moonbase
       #   @return [Time, nil]
       optional :end_at, Time
 
+      # @!attribute note
+      #   The Note object represents a block of text content, often used for meeting notes
+      #   or summaries.
+      #
+      #   @return [Moonbase::Models::Note, nil]
+      optional :note, -> { Moonbase::Note }
+
       # @!attribute provider_metadata
       #   A hash of additional metadata from the provider.
       #
       #   @return [Hash{Symbol=>Object}, nil]
       optional :provider_metadata, Moonbase::Internal::Type::HashOf[Moonbase::Internal::Type::Unknown]
 
-      # @!method initialize(id:, created_at:, direction:, participants:, provider:, provider_id:, provider_status:, start_at:, updated_at:, answered_at: nil, end_at: nil, provider_metadata: nil, type: :call)
+      # @!attribute summary
+      #   The Note object represents a block of text content, often used for meeting notes
+      #   or summaries.
+      #
+      #   @return [Moonbase::Models::Note, nil]
+      optional :summary, -> { Moonbase::Note }
+
+      # @!attribute transcript
+      #
+      #   @return [Moonbase::Models::Call::Transcript, nil]
+      optional :transcript, -> { Moonbase::Call::Transcript }, nil?: true
+
+      # @!method initialize(id:, created_at:, direction:, participants:, provider:, provider_id:, provider_status:, start_at:, updated_at:, answered_at: nil, end_at: nil, note: nil, provider_metadata: nil, summary: nil, transcript: nil, type: :call)
+      #   Some parameter documentations has been truncated, see {Moonbase::Models::Call}
+      #   for more details.
+      #
       #   The Call object represents a phone call that has been logged in the system. It
       #   contains details about the participants, timing, and outcome of the call.
       #
@@ -108,8 +130,14 @@ module Moonbase
       #
       #   @param end_at [Time] The time the call ended, if available, as an ISO 8601 timestamp in UTC.
       #
+      #   @param note [Moonbase::Models::Note] The Note object represents a block of text content, often used for meeting notes
+      #
       #   @param provider_metadata [Hash{Symbol=>Object}] A hash of additional metadata from the provider.
       #
+      #   @param summary [Moonbase::Models::Note] The Note object represents a block of text content, often used for meeting notes
+      #
+      #   @param transcript [Moonbase::Models::Call::Transcript, nil]
+      #
       #   @param type [Symbol, :call] String representing the object’s type. Always `call` for this object.
 
       # The direction of the call, either `incoming` or `outgoing`.
@@ -195,6 +223,62 @@ module Moonbase
           #   @return [Array<Symbol>]
         end
       end
+
+      # @see Moonbase::Models::Call#transcript
+      class Transcript < Moonbase::Internal::Type::BaseModel
+        # @!attribute cues
+        #
+        #   @return [Array<Moonbase::Models::Call::Transcript::Cue>]
+        required :cues, -> { Moonbase::Internal::Type::ArrayOf[Moonbase::Call::Transcript::Cue] }
+
+        # @!method initialize(cues:)
+        #   @param cues [Array<Moonbase::Models::Call::Transcript::Cue>]
+
+        class Cue < Moonbase::Internal::Type::BaseModel
+          # @!attribute from
+          #
+          #   @return [Float]
+          required :from, Float
+
+          # @!attribute speaker
+          #
+          #   @return [Moonbase::Models::Call::Transcript::Cue::Speaker]
+          required :speaker, -> { Moonbase::Call::Transcript::Cue::Speaker }
+
+          # @!attribute text
+          #
+          #   @return [String]
+          required :text, String
+
+          # @!attribute to
+          #
+          #   @return [Float]
+          required :to, Float
+
+          # @!method initialize(from:, speaker:, text:, to:)
+          #   @param from [Float]
+          #   @param speaker [Moonbase::Models::Call::Transcript::Cue::Speaker]
+          #   @param text [String]
+          #   @param to [Float]
+
+          # @see Moonbase::Models::Call::Transcript::Cue#speaker
+          class Speaker < Moonbase::Internal::Type::BaseModel
+            # @!attribute attendee_id
+            #
+            #   @return [String, nil]
+            optional :attendee_id, String
+
+            # @!attribute label
+            #
+            #   @return [String, nil]
+            optional :label, String
+
+            # @!method initialize(attendee_id: nil, label: nil)
+            #   @param attendee_id [String]
+            #   @param label [String]
+          end
+        end
+      end
     end
   end
 end

data/lib/moonbase/models/call_list_params.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    # @see Moonbase::Resources::Calls#list
+    class CallListParams < Moonbase::Internal::Type::BaseModel
+      extend Moonbase::Internal::Type::RequestParameters::Converter
+      include Moonbase::Internal::Type::RequestParameters
+
+      # @!attribute after
+      #   When specified, returns results starting immediately after the item identified
+      #   by this cursor. Use the cursor value from the previous response's metadata to
+      #   fetch the next page of results.
+      #
+      #   @return [String, nil]
+      optional :after, String
+
+      # @!attribute before
+      #   When specified, returns results starting immediately before the item identified
+      #   by this cursor. Use the cursor value from the response's metadata to fetch the
+      #   previous page of results.
+      #
+      #   @return [String, nil]
+      optional :before, String
+
+      # @!attribute limit
+      #   Maximum number of items to return per page. Must be between 1 and 100. Defaults
+      #   to 20 if not specified.
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!method initialize(after: nil, before: nil, limit: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Moonbase::Models::CallListParams} for more details.
+      #
+      #   @param after [String] When specified, returns results starting immediately after the item identified b
+      #
+      #   @param before [String] When specified, returns results starting immediately before the item identified
+      #
+      #   @param limit [Integer] Maximum number of items to return per page. Must be between 1 and 100. Defaults
+      #
+      #   @param request_options [Moonbase::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/moonbase/models/call_retrieve_params.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    # @see Moonbase::Resources::Calls#retrieve
+    class CallRetrieveParams < Moonbase::Internal::Type::BaseModel
+      extend Moonbase::Internal::Type::RequestParameters::Converter
+      include Moonbase::Internal::Type::RequestParameters
+
+      # @!attribute include
+      #   Specifies which related objects to include in the response. Valid options are
+      #   `transcript`, `note`, and `summary`.
+      #
+      #   @return [Array<Symbol, Moonbase::Models::CallRetrieveParams::Include>, nil]
+      optional :include, -> { Moonbase::Internal::Type::ArrayOf[enum: Moonbase::CallRetrieveParams::Include] }
+
+      # @!method initialize(include: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Moonbase::Models::CallRetrieveParams} for more details.
+      #
+      #   @param include [Array<Symbol, Moonbase::Models::CallRetrieveParams::Include>] Specifies which related objects to include in the response. Valid options are `t
+      #
+      #   @param request_options [Moonbase::RequestOptions, Hash{Symbol=>Object}]
+
+      module Include
+        extend Moonbase::Internal::Type::Enum
+
+        TRANSCRIPT = :transcript
+        NOTE = :note
+        SUMMARY = :summary
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/moonbase/models/client_search_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    # @see Moonbase::Resources::Client#search
+    class ClientSearchParams < Moonbase::Internal::Type::BaseModel
+      extend Moonbase::Internal::Type::RequestParameters::Converter
+      include Moonbase::Internal::Type::RequestParameters
+
+      # @!attribute query
+      #
+      #   @return [String]
+      required :query, String
+
+      # @!method initialize(query:, request_options: {})
+      #   @param query [String]
+      #   @param request_options [Moonbase::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/moonbase/models/collections/item_list_params.rb

@@ -24,6 +24,12 @@ module Moonbase
         #   @return [String, nil]
         optional :before, String
 
+        # @!attribute include
+        #   Include only specific fields in the returned items. Specify fields by id or key.
+        #
+        #   @return [Array<String>, nil]
+        optional :include, Moonbase::Internal::Type::ArrayOf[String]
+
         # @!attribute limit
         #   Maximum number of items to return per page. Must be between 1 and 100. Defaults
         #   to 20 if not specified.
@@ -31,7 +37,14 @@ module Moonbase
         #   @return [Integer, nil]
         optional :limit, Integer
 
-        # @!method initialize(after: nil, before: nil, limit: nil, request_options: {})
+        # @!attribute sort
+        #   Sort items by the specified field ids or keys. Prefix a field with a
+        #   hyphen/minus (`-`) to sort in descending order by that field.
+        #
+        #   @return [Array<String>, nil]
+        optional :sort, Moonbase::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(after: nil, before: nil, include: nil, limit: nil, sort: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Moonbase::Models::Collections::ItemListParams} for more details.
         #
@@ -39,8 +52,12 @@ module Moonbase
         #
         #   @param before [String] When specified, returns results starting immediately before the item identified
         #
+        #   @param include [Array<String>] Include only specific fields in the returned items. Specify fields by id or key.
+        #
         #   @param limit [Integer] Maximum number of items to return per page. Must be between 1 and 100. Defaults
         #
+        #   @param sort [Array<String>] Sort items by the specified field ids or keys. Prefix a field with a hyphen/minu
+        #
         #   @param request_options [Moonbase::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/moonbase/models/collections/item_search_params.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    module Collections
+      # @see Moonbase::Resources::Collections::Items#search
+      class ItemSearchParams < Moonbase::Internal::Type::BaseModel
+        extend Moonbase::Internal::Type::RequestParameters::Converter
+        include Moonbase::Internal::Type::RequestParameters
+
+        # @!attribute after
+        #   When specified, returns results starting immediately after the item identified
+        #   by this cursor. Use the cursor value from the previous response's metadata to
+        #   fetch the next page of results.
+        #
+        #   @return [String, nil]
+        optional :after, String
+
+        # @!attribute before
+        #   When specified, returns results starting immediately before the item identified
+        #   by this cursor. Use the cursor value from the response's metadata to fetch the
+        #   previous page of results.
+        #
+        #   @return [String, nil]
+        optional :before, String
+
+        # @!attribute limit
+        #   Maximum number of items to return per page. Must be between 1 and 100. Defaults
+        #   to 20 if not specified.
+        #
+        #   @return [Integer, nil]
+        optional :limit, Integer
+
+        # @!attribute filter
+        #   Return only items that match the filter conditions. Complex filters can be
+        #   created by nesting filters inside of `AND`, `OR`, and `NOT` filters.
+        #
+        #   @return [Moonbase::Models::ItemsFilterValueMatches, Moonbase::Models::ItemsFilterValueExists, Moonbase::Models::ItemsFilterAndGroup, Moonbase::Models::ItemsFilterOrGroup, Moonbase::Models::ItemsFilterNotGroup, nil]
+        optional :filter, union: -> { Moonbase::ItemsFilter }
+
+        # @!attribute include
+        #   Include only specific fields in the returned items. Specify fields by id or key.
+        #
+        #   @return [Array<String>, nil]
+        optional :include, Moonbase::Internal::Type::ArrayOf[String]
+
+        # @!attribute sort
+        #   Sort items by the specified field ids or keys. Prefix a field with a
+        #   hyphen/minus (`-`) to sort in descending order by that field.
+        #
+        #   @return [Array<String>, nil]
+        optional :sort, Moonbase::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(after: nil, before: nil, limit: nil, filter: nil, include: nil, sort: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Moonbase::Models::Collections::ItemSearchParams} for more details.
+        #
+        #   @param after [String] When specified, returns results starting immediately after the item identified b
+        #
+        #   @param before [String] When specified, returns results starting immediately before the item identified
+        #
+        #   @param limit [Integer] Maximum number of items to return per page. Must be between 1 and 100. Defaults
+        #
+        #   @param filter [Moonbase::Models::ItemsFilterValueMatches, Moonbase::Models::ItemsFilterValueExists, Moonbase::Models::ItemsFilterAndGroup, Moonbase::Models::ItemsFilterOrGroup, Moonbase::Models::ItemsFilterNotGroup] Return only items that match the filter conditions. Complex filters can be creat
+        #
+        #   @param include [Array<String>] Include only specific fields in the returned items. Specify fields by id or key.
+        #
+        #   @param sort [Array<String>] Sort items by the specified field ids or keys. Prefix a field with a hyphen/minu
+        #
+        #   @param request_options [Moonbase::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/moonbase/models/collections/item_search_response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    module Collections
+      # @see Moonbase::Resources::Collections::Items#search
+      class ItemSearchResponse < Moonbase::Internal::Type::BaseModel
+        # @!attribute data
+        #   An Item represents a single record or row within a Collection. It holds a set of
+        #   `values` corresponding to the Collection's `fields`.
+        #
+        #   @return [Moonbase::Models::Item]
+        required :data, -> { Moonbase::Item }
+
+        # @!method initialize(data:)
+        #   Some parameter documentations has been truncated, see
+        #   {Moonbase::Models::Collections::ItemSearchResponse} for more details.
+        #
+        #   A search result entry
+        #
+        #   @param data [Moonbase::Models::Item] An Item represents a single record or row within a Collection. It holds a set of
+      end
+    end
+  end
+end

data/lib/moonbase/models/file_delete_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    # @see Moonbase::Resources::Files#delete
+    class FileDeleteParams < Moonbase::Internal::Type::BaseModel
+      extend Moonbase::Internal::Type::RequestParameters::Converter
+      include Moonbase::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Moonbase::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/moonbase/models/items_filter.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    # Return only items that match the filter conditions. Complex filters can be
+    # created by nesting filters inside of `AND`, `OR`, and `NOT` filters.
+    module ItemsFilter
+      extend Moonbase::Internal::Type::Union
+
+      discriminator :op
+
+      # Include only items with a value in the given `field` that satisfies the `op` condition.
+      variant -> { Moonbase::ItemsFilterValueMatches }
+
+      # Include only items that have a value in the given `field`.
+      variant -> { Moonbase::ItemsFilterValueExists }
+
+      # Include only items that match ALL of the filters in `filters`.
+      variant -> { Moonbase::ItemsFilterAndGroup }
+
+      # Include only items that match ANY of the filters in `filters`.
+      variant -> { Moonbase::ItemsFilterOrGroup }
+
+      variant -> { Moonbase::ItemsFilterNotGroup }
+
+      # @!method self.variants
+      #   @return [Array(Moonbase::Models::ItemsFilterValueMatches, Moonbase::Models::ItemsFilterValueExists, Moonbase::Models::ItemsFilterAndGroup, Moonbase::Models::ItemsFilterOrGroup, Moonbase::Models::ItemsFilterNotGroup)]
+    end
+  end
+end

data/lib/moonbase/models/items_filter_and_group.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    class ItemsFilterAndGroup < Moonbase::Internal::Type::BaseModel
+      # @!attribute filters
+      #   An array of filters, ALL of which must be satisfied for this `and` filter to
+      #   match.
+      #
+      #   @return [Array<Moonbase::Models::ItemsFilter>]
+      required :filters, -> { Moonbase::Internal::Type::ArrayOf[union: Moonbase::ItemsFilter] }
+
+      # @!attribute op
+      #
+      #   @return [Symbol, :and]
+      required :op, const: :and
+
+      # @!method initialize(filters:, op: :and)
+      #   Some parameter documentations has been truncated, see
+      #   {Moonbase::Models::ItemsFilterAndGroup} for more details.
+      #
+      #   Include only items that match ALL of the filters in `filters`.
+      #
+      #   @param filters [Array<Moonbase::Models::ItemsFilter>] An array of filters, ALL of which must be satisfied for this `and` filter to mat
+      #
+      #   @param op [Symbol, :and]
+    end
+  end
+end

data/lib/moonbase/models/items_filter_not_group.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    class ItemsFilterNotGroup < Moonbase::Internal::Type::BaseModel
+      # @!attribute filter
+      #   A nested filter which must NOT match in order for this `not` filter to match.
+      #
+      #   @return [Moonbase::Models::ItemsFilter]
+      required :filter, union: -> { Moonbase::ItemsFilter }
+
+      # @!attribute op
+      #
+      #   @return [Symbol, :not]
+      required :op, const: :not
+
+      # @!method initialize(filter:, op: :not)
+      #   @param filter [Moonbase::Models::ItemsFilter] A nested filter which must NOT match in order for this `not` filter to match.
+      #
+      #   @param op [Symbol, :not]
+    end
+  end
+end

data/lib/moonbase/models/items_filter_or_group.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    class ItemsFilterOrGroup < Moonbase::Internal::Type::BaseModel
+      # @!attribute filters
+      #   An array of filters, ANY of which must be satisfied for this `or` filter to
+      #   match.
+      #
+      #   @return [Array<Moonbase::Models::ItemsFilter>]
+      required :filters, -> { Moonbase::Internal::Type::ArrayOf[union: Moonbase::ItemsFilter] }
+
+      # @!attribute op
+      #
+      #   @return [Symbol, :or]
+      required :op, const: :or
+
+      # @!method initialize(filters:, op: :or)
+      #   Some parameter documentations has been truncated, see
+      #   {Moonbase::Models::ItemsFilterOrGroup} for more details.
+      #
+      #   Include only items that match ANY of the filters in `filters`.
+      #
+      #   @param filters [Array<Moonbase::Models::ItemsFilter>] An array of filters, ANY of which must be satisfied for this `or` filter to matc
+      #
+      #   @param op [Symbol, :or]
+    end
+  end
+end

data/lib/moonbase/models/items_filter_value_exists.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    class ItemsFilterValueExists < Moonbase::Internal::Type::BaseModel
+      # @!attribute field
+      #   The id or key of the field for which a value must exist.
+      #
+      #   @return [String]
+      required :field, String
+
+      # @!attribute op
+      #
+      #   @return [Symbol, :exists]
+      required :op, const: :exists
+
+      # @!method initialize(field:, op: :exists)
+      #   Include only items that have a value in the given `field`.
+      #
+      #   @param field [String] The id or key of the field for which a value must exist.
+      #
+      #   @param op [Symbol, :exists]
+    end
+  end
+end