weft-sdk 0.3.0 → 0.5.0

data/lib/weft/generated/models/search_ranking.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
+  class SearchRanking < ApiModelBase
+    attr_accessor :popularity_score
+
+    attr_accessor :settlement_count_30d
+
+    attr_accessor :success_rate_30d
+
+    attr_accessor :p50_latency_ms
+
+    attr_accessor :first_seen_at
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'popularity_score' => :'popularity_score',
+        :'settlement_count_30d' => :'settlement_count_30d',
+        :'success_rate_30d' => :'success_rate_30d',
+        :'p50_latency_ms' => :'p50_latency_ms',
+        :'first_seen_at' => :'first_seen_at'
+      }
+    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
+      {
+        :'popularity_score' => :'Float',
+        :'settlement_count_30d' => :'Integer',
+        :'success_rate_30d' => :'Float',
+        :'p50_latency_ms' => :'Integer',
+        :'first_seen_at' => :'Time'
+      }
+    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::SearchRanking` 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::SearchRanking`. 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?(:'popularity_score')
+        self.popularity_score = attributes[:'popularity_score']
+      end
+
+      if attributes.key?(:'settlement_count_30d')
+        self.settlement_count_30d = attributes[:'settlement_count_30d']
+      end
+
+      if attributes.key?(:'success_rate_30d')
+        self.success_rate_30d = attributes[:'success_rate_30d']
+      end
+
+      if attributes.key?(:'p50_latency_ms')
+        self.p50_latency_ms = attributes[:'p50_latency_ms']
+      end
+
+      if attributes.key?(:'first_seen_at')
+        self.first_seen_at = attributes[:'first_seen_at']
+      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
+      if !@popularity_score.nil? && @popularity_score > 1
+        invalid_properties.push('invalid value for "popularity_score", must be smaller than or equal to 1.')
+      end
+
+      if !@popularity_score.nil? && @popularity_score < 0
+        invalid_properties.push('invalid value for "popularity_score", must be greater than or equal to 0.')
+      end
+
+      if !@settlement_count_30d.nil? && @settlement_count_30d < 0
+        invalid_properties.push('invalid value for "settlement_count_30d", must be greater than or equal to 0.')
+      end
+
+      if !@success_rate_30d.nil? && @success_rate_30d > 1
+        invalid_properties.push('invalid value for "success_rate_30d", must be smaller than or equal to 1.')
+      end
+
+      if !@success_rate_30d.nil? && @success_rate_30d < 0
+        invalid_properties.push('invalid value for "success_rate_30d", must be greater than or equal to 0.')
+      end
+
+      if !@p50_latency_ms.nil? && @p50_latency_ms < 0
+        invalid_properties.push('invalid value for "p50_latency_ms", must be greater than or equal to 0.')
+      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 !@popularity_score.nil? && @popularity_score > 1
+      return false if !@popularity_score.nil? && @popularity_score < 0
+      return false if !@settlement_count_30d.nil? && @settlement_count_30d < 0
+      return false if !@success_rate_30d.nil? && @success_rate_30d > 1
+      return false if !@success_rate_30d.nil? && @success_rate_30d < 0
+      return false if !@p50_latency_ms.nil? && @p50_latency_ms < 0
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] popularity_score Value to be assigned
+    def popularity_score=(popularity_score)
+      if popularity_score.nil?
+        fail ArgumentError, 'popularity_score cannot be nil'
+      end
+
+      if popularity_score > 1
+        fail ArgumentError, 'invalid value for "popularity_score", must be smaller than or equal to 1.'
+      end
+
+      if popularity_score < 0
+        fail ArgumentError, 'invalid value for "popularity_score", must be greater than or equal to 0.'
+      end
+
+      @popularity_score = popularity_score
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] settlement_count_30d Value to be assigned
+    def settlement_count_30d=(settlement_count_30d)
+      if settlement_count_30d.nil?
+        fail ArgumentError, 'settlement_count_30d cannot be nil'
+      end
+
+      if settlement_count_30d < 0
+        fail ArgumentError, 'invalid value for "settlement_count_30d", must be greater than or equal to 0.'
+      end
+
+      @settlement_count_30d = settlement_count_30d
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] success_rate_30d Value to be assigned
+    def success_rate_30d=(success_rate_30d)
+      if success_rate_30d.nil?
+        fail ArgumentError, 'success_rate_30d cannot be nil'
+      end
+
+      if success_rate_30d > 1
+        fail ArgumentError, 'invalid value for "success_rate_30d", must be smaller than or equal to 1.'
+      end
+
+      if success_rate_30d < 0
+        fail ArgumentError, 'invalid value for "success_rate_30d", must be greater than or equal to 0.'
+      end
+
+      @success_rate_30d = success_rate_30d
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] p50_latency_ms Value to be assigned
+    def p50_latency_ms=(p50_latency_ms)
+      if p50_latency_ms.nil?
+        fail ArgumentError, 'p50_latency_ms cannot be nil'
+      end
+
+      if p50_latency_ms < 0
+        fail ArgumentError, 'invalid value for "p50_latency_ms", must be greater than or equal to 0.'
+      end
+
+      @p50_latency_ms = p50_latency_ms
+    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 &&
+          popularity_score == o.popularity_score &&
+          settlement_count_30d == o.settlement_count_30d &&
+          success_rate_30d == o.success_rate_30d &&
+          p50_latency_ms == o.p50_latency_ms &&
+          first_seen_at == o.first_seen_at
+    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
+      [popularity_score, settlement_count_30d, success_rate_30d, p50_latency_ms, first_seen_at].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_request.rb

@@ -0,0 +1,223 @@
+=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
+  class SearchRequest < ApiModelBase
+    # Free-text query. Required and non-empty.
+    attr_accessor :query
+
+    # Max number of hits to return. Clamped to [1, 50].
+    attr_accessor :limit
+
+    attr_accessor :filters
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'query' => :'query',
+        :'limit' => :'limit',
+        :'filters' => :'filters'
+      }
+    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
+      {
+        :'query' => :'String',
+        :'limit' => :'Integer',
+        :'filters' => :'SearchFilters'
+      }
+    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::SearchRequest` 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::SearchRequest`. 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?(:'query')
+        self.query = attributes[:'query']
+      else
+        self.query = nil
+      end
+
+      if attributes.key?(:'limit')
+        self.limit = attributes[:'limit']
+      else
+        self.limit = 10
+      end
+
+      if attributes.key?(:'filters')
+        self.filters = attributes[:'filters']
+      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
+      if @query.nil?
+        invalid_properties.push('invalid value for "query", query cannot be nil.')
+      end
+
+      if @query.to_s.length < 1
+        invalid_properties.push('invalid value for "query", the character length must be greater than or equal to 1.')
+      end
+
+      if !@limit.nil? && @limit > 50
+        invalid_properties.push('invalid value for "limit", must be smaller than or equal to 50.')
+      end
+
+      if !@limit.nil? && @limit < 1
+        invalid_properties.push('invalid value for "limit", must be greater than or equal to 1.')
+      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 @query.nil?
+      return false if @query.to_s.length < 1
+      return false if !@limit.nil? && @limit > 50
+      return false if !@limit.nil? && @limit < 1
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] query Value to be assigned
+    def query=(query)
+      if query.nil?
+        fail ArgumentError, 'query cannot be nil'
+      end
+
+      if query.to_s.length < 1
+        fail ArgumentError, 'invalid value for "query", the character length must be greater than or equal to 1.'
+      end
+
+      @query = query
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] limit Value to be assigned
+    def limit=(limit)
+      if limit.nil?
+        fail ArgumentError, 'limit cannot be nil'
+      end
+
+      if limit > 50
+        fail ArgumentError, 'invalid value for "limit", must be smaller than or equal to 50.'
+      end
+
+      if limit < 1
+        fail ArgumentError, 'invalid value for "limit", must be greater than or equal to 1.'
+      end
+
+      @limit = limit
+    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 &&
+          query == o.query &&
+          limit == o.limit &&
+          filters == o.filters
+    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
+      [query, limit, filters].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/{agent_response.rb → search_response.rb}

@@ -1,9 +1,9 @@
 =begin
 #Weft API
 
-#API for agent-first payments and discovery.
+#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.3.0
+The version of the OpenAPI document: 0.5.0
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.19.0
@@ -14,13 +14,30 @@ require 'date'
 require 'time'
 
 module Weft
-  class AgentResponse < ApiModelBase
-    attr_accessor :data
+  # Spec-11 search envelope. `paid_usd`, `tx_hash`, and `artifact_id` are reserved for a later release that adds per-call billing and artifact persistence; they are always `null` in v1. `_mock: true` is set only by the mock backend. 
+  class SearchResponse < ApiModelBase
+    attr_accessor :results
+
+    # Always `null` in v1.
+    attr_accessor :paid_usd
+
+    # Always `null` in v1.
+    attr_accessor :tx_hash
+
+    # Always `null` in v1.
+    attr_accessor :artifact_id
+
+    # Present and `true` only when served by the mock backend.
+    attr_accessor :_mock
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'data' => :'data'
+        :'results' => :'results',
+        :'paid_usd' => :'paid_usd',
+        :'tx_hash' => :'tx_hash',
+        :'artifact_id' => :'artifact_id',
+        :'_mock' => :'_mock'
       }
     end
 
@@ -37,7 +54,11 @@ module Weft
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'data' => :'Agent'
+        :'results' => :'Array<SearchResult>',
+        :'paid_usd' => :'String',
+        :'tx_hash' => :'String',
+        :'artifact_id' => :'String',
+        :'_mock' => :'Boolean'
       }
     end
 
@@ -51,22 +72,40 @@ module Weft
     # @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::AgentResponse` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Weft::SearchResponse` 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::AgentResponse`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Weft::SearchResponse`. 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?(:'data')
-        self.data = attributes[:'data']
+      if attributes.key?(:'results')
+        if (value = attributes[:'results']).is_a?(Array)
+          self.results = value
+        end
       else
-        self.data = nil
+        self.results = nil
+      end
+
+      if attributes.key?(:'paid_usd')
+        self.paid_usd = attributes[:'paid_usd']
+      end
+
+      if attributes.key?(:'tx_hash')
+        self.tx_hash = attributes[:'tx_hash']
+      end
+
+      if attributes.key?(:'artifact_id')
+        self.artifact_id = attributes[:'artifact_id']
+      end
+
+      if attributes.key?(:'_mock')
+        self._mock = attributes[:'_mock']
       end
     end
 
@@ -75,8 +114,8 @@ module Weft
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @data.nil?
-        invalid_properties.push('invalid value for "data", data cannot be nil.')
+      if @results.nil?
+        invalid_properties.push('invalid value for "results", results cannot be nil.')
       end
 
       invalid_properties
@@ -86,18 +125,18 @@ module Weft
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @data.nil?
+      return false if @results.nil?
       true
     end
 
     # Custom attribute writer method with validation
-    # @param [Object] data Value to be assigned
-    def data=(data)
-      if data.nil?
-        fail ArgumentError, 'data cannot be nil'
+    # @param [Object] results Value to be assigned
+    def results=(results)
+      if results.nil?
+        fail ArgumentError, 'results cannot be nil'
       end
 
-      @data = data
+      @results = results
     end
 
     # Checks equality by comparing each attribute.
@@ -105,7 +144,11 @@ module Weft
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          data == o.data
+          results == o.results &&
+          paid_usd == o.paid_usd &&
+          tx_hash == o.tx_hash &&
+          artifact_id == o.artifact_id &&
+          _mock == o._mock
     end
 
     # @see the `==` method
@@ -117,7 +160,7 @@ module Weft
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [data].hash
+      [results, paid_usd, tx_hash, artifact_id, _mock].hash
     end
 
     # Builds the object from hash