weft-sdk 0.3.0 → 0.5.0

data/lib/weft/generated/models/search_filters.rb

@@ -0,0 +1,277 @@
+=begin
+#Weft API
+
+#The Weft API is the buyer-runtime surface that powers the `weft` CLI, the hosted MCP server (`weft.network/mcp`), and any third-party agent that wants to discover and pay for paid resources on Weft. v1 covers five buyer concerns:    1. Account onboarding (`/api/v1/auth/*`, `/api/v1/me`)   2. CLI authentication (`/api/v1/api_keys`)   3. Wallet visibility (`/api/v1/balance`)   4. Discovery (`/api/v1/search`)   5. Paid execution (`/api/v1/fetch`)   6. Purchase history (`/api/v1/payments`)  Seller-side concerns (agent management, payout analytics, webhook delivery, the public storefront for `data_api` resources) live in the dashboard and are intentionally not documented here. They will be split out into a separate, dashboard-scoped spec when they need to be SDK-consumable.  All errors share the envelope defined by `ErrorResponse`, except the buyer-runtime endpoints (`/search`, `/fetch`) which use bespoke envelopes carrying additional context — see `SearchErrorResponse` and `FetchErrorResponse`. 
+
+The version of the OpenAPI document: 0.5.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Weft
+  # Optional narrowing applied after the embedding score is computed. Unknown keys are rejected. Price filters use the agent's cheapest skill for `max_price_usd` and the most-expensive skill for `min_price_usd`, so an agent stays in results as long as any one of its skills satisfies the band. 
+  class SearchFilters < ApiModelBase
+    # Decimal USD floor; agent must have at least one skill priced at or above this.
+    attr_accessor :min_price_usd
+
+    # Decimal USD ceiling; agent must have at least one skill priced at or below this.
+    attr_accessor :max_price_usd
+
+    # Payment protocol the agent settles on.
+    attr_accessor :payment_protocol
+
+    # Agent protocol surface (Agent-to-Agent, MCP, or raw OpenAPI).
+    attr_accessor :agent_protocol
+
+    # Substring match against any of the agent's declared domain tags (e.g. `email`, `sales`, `enrichment`). 
+    attr_accessor :domain
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'min_price_usd' => :'min_price_usd',
+        :'max_price_usd' => :'max_price_usd',
+        :'payment_protocol' => :'payment_protocol',
+        :'agent_protocol' => :'agent_protocol',
+        :'domain' => :'domain'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'min_price_usd' => :'String',
+        :'max_price_usd' => :'String',
+        :'payment_protocol' => :'String',
+        :'agent_protocol' => :'String',
+        :'domain' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Weft::SearchFilters` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Weft::SearchFilters`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'min_price_usd')
+        self.min_price_usd = attributes[:'min_price_usd']
+      end
+
+      if attributes.key?(:'max_price_usd')
+        self.max_price_usd = attributes[:'max_price_usd']
+      end
+
+      if attributes.key?(:'payment_protocol')
+        self.payment_protocol = attributes[:'payment_protocol']
+      end
+
+      if attributes.key?(:'agent_protocol')
+        self.agent_protocol = attributes[:'agent_protocol']
+      end
+
+      if attributes.key?(:'domain')
+        self.domain = attributes[:'domain']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      pattern = Regexp.new(/^\d+(\.\d{1,6})?$/)
+      if !@min_price_usd.nil? && @min_price_usd !~ pattern
+        invalid_properties.push("invalid value for \"min_price_usd\", must conform to the pattern #{pattern}.")
+      end
+
+      pattern = Regexp.new(/^\d+(\.\d{1,6})?$/)
+      if !@max_price_usd.nil? && @max_price_usd !~ pattern
+        invalid_properties.push("invalid value for \"max_price_usd\", must conform to the pattern #{pattern}.")
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if !@min_price_usd.nil? && @min_price_usd !~ Regexp.new(/^\d+(\.\d{1,6})?$/)
+      return false if !@max_price_usd.nil? && @max_price_usd !~ Regexp.new(/^\d+(\.\d{1,6})?$/)
+      payment_protocol_validator = EnumAttributeValidator.new('String', ["x402", "mpp", "free"])
+      return false unless payment_protocol_validator.valid?(@payment_protocol)
+      agent_protocol_validator = EnumAttributeValidator.new('String', ["a2a", "mcp", "openapi"])
+      return false unless agent_protocol_validator.valid?(@agent_protocol)
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] min_price_usd Value to be assigned
+    def min_price_usd=(min_price_usd)
+      if min_price_usd.nil?
+        fail ArgumentError, 'min_price_usd cannot be nil'
+      end
+
+      pattern = Regexp.new(/^\d+(\.\d{1,6})?$/)
+      if min_price_usd !~ pattern
+        fail ArgumentError, "invalid value for \"min_price_usd\", must conform to the pattern #{pattern}."
+      end
+
+      @min_price_usd = min_price_usd
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] max_price_usd Value to be assigned
+    def max_price_usd=(max_price_usd)
+      if max_price_usd.nil?
+        fail ArgumentError, 'max_price_usd cannot be nil'
+      end
+
+      pattern = Regexp.new(/^\d+(\.\d{1,6})?$/)
+      if max_price_usd !~ pattern
+        fail ArgumentError, "invalid value for \"max_price_usd\", must conform to the pattern #{pattern}."
+      end
+
+      @max_price_usd = max_price_usd
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] payment_protocol Object to be assigned
+    def payment_protocol=(payment_protocol)
+      validator = EnumAttributeValidator.new('String', ["x402", "mpp", "free"])
+      unless validator.valid?(payment_protocol)
+        fail ArgumentError, "invalid value for \"payment_protocol\", must be one of #{validator.allowable_values}."
+      end
+      @payment_protocol = payment_protocol
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] agent_protocol Object to be assigned
+    def agent_protocol=(agent_protocol)
+      validator = EnumAttributeValidator.new('String', ["a2a", "mcp", "openapi"])
+      unless validator.valid?(agent_protocol)
+        fail ArgumentError, "invalid value for \"agent_protocol\", must be one of #{validator.allowable_values}."
+      end
+      @agent_protocol = agent_protocol
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          min_price_usd == o.min_price_usd &&
+          max_price_usd == o.max_price_usd &&
+          payment_protocol == o.payment_protocol &&
+          agent_protocol == o.agent_protocol &&
+          domain == o.domain
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [min_price_usd, max_price_usd, payment_protocol, agent_protocol, domain].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/weft/generated/models/search_pricing.rb

@@ -0,0 +1,232 @@
+=begin
+#Weft API
+
+#The Weft API is the buyer-runtime surface that powers the `weft` CLI, the hosted MCP server (`weft.network/mcp`), and any third-party agent that wants to discover and pay for paid resources on Weft. v1 covers five buyer concerns:    1. Account onboarding (`/api/v1/auth/*`, `/api/v1/me`)   2. CLI authentication (`/api/v1/api_keys`)   3. Wallet visibility (`/api/v1/balance`)   4. Discovery (`/api/v1/search`)   5. Paid execution (`/api/v1/fetch`)   6. Purchase history (`/api/v1/payments`)  Seller-side concerns (agent management, payout analytics, webhook delivery, the public storefront for `data_api` resources) live in the dashboard and are intentionally not documented here. They will be split out into a separate, dashboard-scoped spec when they need to be SDK-consumable.  All errors share the envelope defined by `ErrorResponse`, except the buyer-runtime endpoints (`/search`, `/fetch`) which use bespoke envelopes carrying additional context — see `SearchErrorResponse` and `FetchErrorResponse`. 
+
+The version of the OpenAPI document: 0.5.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.19.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Weft
+  # Aggregate pricing at the agent level. `recipient_address` is intentionally absent from the index — under x402 it is delivered per-request in the `402 Payment Required` challenge from the agent. 
+  class SearchPricing < ApiModelBase
+    attr_accessor :protocol
+
+    attr_accessor :scheme
+
+    # Default per-call amount; individual skills may override via `price_usd`.
+    attr_accessor :amount_usd
+
+    # Settlement network (e.g. `base-sepolia`).
+    attr_accessor :network
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'protocol' => :'protocol',
+        :'scheme' => :'scheme',
+        :'amount_usd' => :'amount_usd',
+        :'network' => :'network'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'protocol' => :'String',
+        :'scheme' => :'String',
+        :'amount_usd' => :'String',
+        :'network' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Weft::SearchPricing` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Weft::SearchPricing`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'protocol')
+        self.protocol = attributes[:'protocol']
+      end
+
+      if attributes.key?(:'scheme')
+        self.scheme = attributes[:'scheme']
+      end
+
+      if attributes.key?(:'amount_usd')
+        self.amount_usd = attributes[:'amount_usd']
+      end
+
+      if attributes.key?(:'network')
+        self.network = attributes[:'network']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      pattern = Regexp.new(/^\d+(\.\d{1,6})?$/)
+      if !@amount_usd.nil? && @amount_usd !~ pattern
+        invalid_properties.push("invalid value for \"amount_usd\", must conform to the pattern #{pattern}.")
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      protocol_validator = EnumAttributeValidator.new('String', ["x402", "mpp", "free"])
+      return false unless protocol_validator.valid?(@protocol)
+      return false if !@amount_usd.nil? && @amount_usd !~ Regexp.new(/^\d+(\.\d{1,6})?$/)
+      true
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] protocol Object to be assigned
+    def protocol=(protocol)
+      validator = EnumAttributeValidator.new('String', ["x402", "mpp", "free"])
+      unless validator.valid?(protocol)
+        fail ArgumentError, "invalid value for \"protocol\", must be one of #{validator.allowable_values}."
+      end
+      @protocol = protocol
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] amount_usd Value to be assigned
+    def amount_usd=(amount_usd)
+      if amount_usd.nil?
+        fail ArgumentError, 'amount_usd cannot be nil'
+      end
+
+      pattern = Regexp.new(/^\d+(\.\d{1,6})?$/)
+      if amount_usd !~ pattern
+        fail ArgumentError, "invalid value for \"amount_usd\", must conform to the pattern #{pattern}."
+      end
+
+      @amount_usd = amount_usd
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          protocol == o.protocol &&
+          scheme == o.scheme &&
+          amount_usd == o.amount_usd &&
+          network == o.network
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [protocol, scheme, amount_usd, network].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end