soilsidekick 3.0.0

data/lib/soilsidekick/api/satellite_data_api.rb

@@ -0,0 +1,90 @@
+=begin
+#SoilSidekick Pro API
+
+#Agricultural intelligence and soil analysis API with tier-based access control.  ## What's New in 1.2.0 - **Consumer Plant Care APIs**: Three new endpoints addressing top pain points in plant ID apps:   - `/safe-identification`: Toxic lookalike warnings and environmental context   - `/dynamic-care`: Hyper-localized, real-time care recommendations   - `/beginner-guidance`: Judgment-free, jargon-free plant guidance  ## Authentication All endpoints require an API key passed via the `x-api-key` header: ``` x-api-key: ak_your_api_key_here ```  API keys are generated through the dashboard and use the `ak_*` format.  ## Rate Limiting Rate limits are enforced based on your subscription tier: - **Free**: 10 req/min, 100 req/hour, 1,000 req/day - **Starter**: 30 req/min, 500 req/hour, 5,000 req/day - **Pro**: 100 req/min, 2,000 req/hour, 25,000 req/day - **Enterprise**: 500 req/min, 10,000 req/hour, 100,000 req/day  Rate limit information is returned in response headers: - `X-RateLimit-Limit`: Maximum requests in window - `X-RateLimit-Remaining`: Remaining requests in window - `X-RateLimit-Reset`: Unix timestamp when limit resets  ## Response Time SLAs All endpoints return response time headers for performance monitoring: - `X-Response-Time`: Human-readable response time (e.g., \"245ms\") - `X-Response-Time-Ms`: Response time in milliseconds - `X-Response-Time-Target`: Target response time for this endpoint - `X-Response-Time-Max`: Maximum acceptable response time - `X-Response-Time-Status`: Performance status (`optimal`, `acceptable`, `exceeded`)  ### Response Time Targets by Category  | Category | Target | Maximum | Endpoints | |----------|--------|---------|-----------| | **Fast** | 200ms | 500ms | county-lookup, check-subscription | | **Standard** | 500ms | 1,500ms | get-soil-data, territorial-water-quality | | **Complex** | 2,000ms | 5,000ms | agricultural-intelligence, gpt5-chat, visual-crop-analysis | | **Heavy** | 5,000ms | 15,000ms | live-agricultural-data, generate-vrt-prescription | 
+
+The version of the OpenAPI document: 3.0.0
+Contact: support@soilsidekickpro.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module SoilSidekick
+  class SatelliteDataApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get satellite environmental data
+    # AlphaEarth satellite intelligence integration
+    # @param get_satellite_data_request [GetSatelliteDataRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [SatelliteData]
+    def get_satellite_data(get_satellite_data_request, opts = {})
+      data, _status_code, _headers = get_satellite_data_with_http_info(get_satellite_data_request, opts)
+      data
+    end
+
+    # Get satellite environmental data
+    # AlphaEarth satellite intelligence integration
+    # @param get_satellite_data_request [GetSatelliteDataRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SatelliteData, Integer, Hash)>] SatelliteData data, response status code and response headers
+    def get_satellite_data_with_http_info(get_satellite_data_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SatelliteDataApi.get_satellite_data ...'
+      end
+      # verify the required parameter 'get_satellite_data_request' is set
+      if @api_client.config.client_side_validation && get_satellite_data_request.nil?
+        fail ArgumentError, "Missing the required parameter 'get_satellite_data_request' when calling SatelliteDataApi.get_satellite_data"
+      end
+      # resource path
+      local_var_path = '/alpha-earth-environmental-enhancement'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(get_satellite_data_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SatelliteData'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"SatelliteDataApi.get_satellite_data",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SatelliteDataApi#get_satellite_data\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/soilsidekick/api/soil_analysis_api.rb

@@ -0,0 +1,247 @@
+=begin
+#SoilSidekick Pro API
+
+#Agricultural intelligence and soil analysis API with tier-based access control.  ## What's New in 1.2.0 - **Consumer Plant Care APIs**: Three new endpoints addressing top pain points in plant ID apps:   - `/safe-identification`: Toxic lookalike warnings and environmental context   - `/dynamic-care`: Hyper-localized, real-time care recommendations   - `/beginner-guidance`: Judgment-free, jargon-free plant guidance  ## Authentication All endpoints require an API key passed via the `x-api-key` header: ``` x-api-key: ak_your_api_key_here ```  API keys are generated through the dashboard and use the `ak_*` format.  ## Rate Limiting Rate limits are enforced based on your subscription tier: - **Free**: 10 req/min, 100 req/hour, 1,000 req/day - **Starter**: 30 req/min, 500 req/hour, 5,000 req/day - **Pro**: 100 req/min, 2,000 req/hour, 25,000 req/day - **Enterprise**: 500 req/min, 10,000 req/hour, 100,000 req/day  Rate limit information is returned in response headers: - `X-RateLimit-Limit`: Maximum requests in window - `X-RateLimit-Remaining`: Remaining requests in window - `X-RateLimit-Reset`: Unix timestamp when limit resets  ## Response Time SLAs All endpoints return response time headers for performance monitoring: - `X-Response-Time`: Human-readable response time (e.g., \"245ms\") - `X-Response-Time-Ms`: Response time in milliseconds - `X-Response-Time-Target`: Target response time for this endpoint - `X-Response-Time-Max`: Maximum acceptable response time - `X-Response-Time-Status`: Performance status (`optimal`, `acceptable`, `exceeded`)  ### Response Time Targets by Category  | Category | Target | Maximum | Endpoints | |----------|--------|---------|-----------| | **Fast** | 200ms | 500ms | county-lookup, check-subscription | | **Standard** | 500ms | 1,500ms | get-soil-data, territorial-water-quality | | **Complex** | 2,000ms | 5,000ms | agricultural-intelligence, gpt5-chat, visual-crop-analysis | | **Heavy** | 5,000ms | 15,000ms | live-agricultural-data, generate-vrt-prescription | 
+
+The version of the OpenAPI document: 3.0.0
+Contact: support@soilsidekickpro.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module SoilSidekick
+  class SoilAnalysisApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get live agricultural data
+    # Fetch real-time agricultural data from multiple federal sources (NOAA, USDA, EPA)
+    # @param get_live_agricultural_data_request [GetLiveAgriculturalDataRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [LiveAgriculturalData]
+    def get_live_agricultural_data(get_live_agricultural_data_request, opts = {})
+      data, _status_code, _headers = get_live_agricultural_data_with_http_info(get_live_agricultural_data_request, opts)
+      data
+    end
+
+    # Get live agricultural data
+    # Fetch real-time agricultural data from multiple federal sources (NOAA, USDA, EPA)
+    # @param get_live_agricultural_data_request [GetLiveAgriculturalDataRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(LiveAgriculturalData, Integer, Hash)>] LiveAgriculturalData data, response status code and response headers
+    def get_live_agricultural_data_with_http_info(get_live_agricultural_data_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SoilAnalysisApi.get_live_agricultural_data ...'
+      end
+      # verify the required parameter 'get_live_agricultural_data_request' is set
+      if @api_client.config.client_side_validation && get_live_agricultural_data_request.nil?
+        fail ArgumentError, "Missing the required parameter 'get_live_agricultural_data_request' when calling SoilAnalysisApi.get_live_agricultural_data"
+      end
+      # resource path
+      local_var_path = '/live-agricultural-data'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(get_live_agricultural_data_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LiveAgriculturalData'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"SoilAnalysisApi.get_live_agricultural_data",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SoilAnalysisApi#get_live_agricultural_data\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get planting calendar recommendations
+    # Multi-parameter planting calendar with climate and soil factors
+    # @param get_planting_calendar_request [GetPlantingCalendarRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :x_tq_context_mode TurboQuant extended context window size (tokens). With 3-bit KV cache, context windows up to 24K tokens are feasible within the same memory budget as standard 4K.  (default to 4096)
+    # @option opts [String] :x_tq_kv_cache_hint KV cache management hint. - &#x60;none&#x60;: No caching (default) - &#x60;reuse&#x60;: Reuse KV cache from previous request in same session (40-60% compute savings) - &#x60;persist&#x60;: Persist cache to disk for cross-session reuse  (default to 'none')
+    # @option opts [String] :x_tq_model_tier Preferred model tier for inference. - &#x60;auto&#x60;: Server selects optimal model based on device capabilities - &#x60;gemma-2b&#x60;: Lightweight model (~0.5GB KV with TQ) - &#x60;gemma-7b&#x60;: Full model, standard KV cache - &#x60;gemma-7b-tq&#x60;: Full model with TurboQuant 3-bit KV cache (~1.3GB)  (default to 'auto')
+    # @return [PlantingCalendar]
+    def get_planting_calendar(get_planting_calendar_request, opts = {})
+      data, _status_code, _headers = get_planting_calendar_with_http_info(get_planting_calendar_request, opts)
+      data
+    end
+
+    # Get planting calendar recommendations
+    # Multi-parameter planting calendar with climate and soil factors
+    # @param get_planting_calendar_request [GetPlantingCalendarRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :x_tq_context_mode TurboQuant extended context window size (tokens). With 3-bit KV cache, context windows up to 24K tokens are feasible within the same memory budget as standard 4K.  (default to 4096)
+    # @option opts [String] :x_tq_kv_cache_hint KV cache management hint. - &#x60;none&#x60;: No caching (default) - &#x60;reuse&#x60;: Reuse KV cache from previous request in same session (40-60% compute savings) - &#x60;persist&#x60;: Persist cache to disk for cross-session reuse  (default to 'none')
+    # @option opts [String] :x_tq_model_tier Preferred model tier for inference. - &#x60;auto&#x60;: Server selects optimal model based on device capabilities - &#x60;gemma-2b&#x60;: Lightweight model (~0.5GB KV with TQ) - &#x60;gemma-7b&#x60;: Full model, standard KV cache - &#x60;gemma-7b-tq&#x60;: Full model with TurboQuant 3-bit KV cache (~1.3GB)  (default to 'auto')
+    # @return [Array<(PlantingCalendar, Integer, Hash)>] PlantingCalendar data, response status code and response headers
+    def get_planting_calendar_with_http_info(get_planting_calendar_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SoilAnalysisApi.get_planting_calendar ...'
+      end
+      # verify the required parameter 'get_planting_calendar_request' is set
+      if @api_client.config.client_side_validation && get_planting_calendar_request.nil?
+        fail ArgumentError, "Missing the required parameter 'get_planting_calendar_request' when calling SoilAnalysisApi.get_planting_calendar"
+      end
+      allowable_values = [4096, 8192, 16384, 24576]
+      if @api_client.config.client_side_validation && opts[:'x_tq_context_mode'] && !allowable_values.include?(opts[:'x_tq_context_mode'])
+        fail ArgumentError, "invalid value for \"x_tq_context_mode\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["none", "reuse", "persist"]
+      if @api_client.config.client_side_validation && opts[:'x_tq_kv_cache_hint'] && !allowable_values.include?(opts[:'x_tq_kv_cache_hint'])
+        fail ArgumentError, "invalid value for \"x_tq_kv_cache_hint\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["auto", "gemma-2b", "gemma-7b", "gemma-7b-tq"]
+      if @api_client.config.client_side_validation && opts[:'x_tq_model_tier'] && !allowable_values.include?(opts[:'x_tq_model_tier'])
+        fail ArgumentError, "invalid value for \"x_tq_model_tier\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/multi-parameter-planting-calendar'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-tq-context-mode'] = opts[:'x_tq_context_mode'] if !opts[:'x_tq_context_mode'].nil?
+      header_params[:'x-tq-kv-cache-hint'] = opts[:'x_tq_kv_cache_hint'] if !opts[:'x_tq_kv_cache_hint'].nil?
+      header_params[:'x-tq-model-tier'] = opts[:'x_tq_model_tier'] if !opts[:'x_tq_model_tier'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(get_planting_calendar_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PlantingCalendar'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"SoilAnalysisApi.get_planting_calendar",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SoilAnalysisApi#get_planting_calendar\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get soil analysis data
+    # Retrieve comprehensive soil analysis for a specific county
+    # @param get_soil_data_request [GetSoilDataRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [SoilData]
+    def get_soil_data(get_soil_data_request, opts = {})
+      data, _status_code, _headers = get_soil_data_with_http_info(get_soil_data_request, opts)
+      data
+    end
+
+    # Get soil analysis data
+    # Retrieve comprehensive soil analysis for a specific county
+    # @param get_soil_data_request [GetSoilDataRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SoilData, Integer, Hash)>] SoilData data, response status code and response headers
+    def get_soil_data_with_http_info(get_soil_data_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SoilAnalysisApi.get_soil_data ...'
+      end
+      # verify the required parameter 'get_soil_data_request' is set
+      if @api_client.config.client_side_validation && get_soil_data_request.nil?
+        fail ArgumentError, "Missing the required parameter 'get_soil_data_request' when calling SoilAnalysisApi.get_soil_data"
+      end
+      # resource path
+      local_var_path = '/get-soil-data'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(get_soil_data_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SoilData'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"SoilAnalysisApi.get_soil_data",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SoilAnalysisApi#get_soil_data\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/soilsidekick/api/turbo_quant_api.rb

@@ -0,0 +1,111 @@
+=begin
+#SoilSidekick Pro API
+
+#Agricultural intelligence and soil analysis API with tier-based access control.  ## What's New in 1.2.0 - **Consumer Plant Care APIs**: Three new endpoints addressing top pain points in plant ID apps:   - `/safe-identification`: Toxic lookalike warnings and environmental context   - `/dynamic-care`: Hyper-localized, real-time care recommendations   - `/beginner-guidance`: Judgment-free, jargon-free plant guidance  ## Authentication All endpoints require an API key passed via the `x-api-key` header: ``` x-api-key: ak_your_api_key_here ```  API keys are generated through the dashboard and use the `ak_*` format.  ## Rate Limiting Rate limits are enforced based on your subscription tier: - **Free**: 10 req/min, 100 req/hour, 1,000 req/day - **Starter**: 30 req/min, 500 req/hour, 5,000 req/day - **Pro**: 100 req/min, 2,000 req/hour, 25,000 req/day - **Enterprise**: 500 req/min, 10,000 req/hour, 100,000 req/day  Rate limit information is returned in response headers: - `X-RateLimit-Limit`: Maximum requests in window - `X-RateLimit-Remaining`: Remaining requests in window - `X-RateLimit-Reset`: Unix timestamp when limit resets  ## Response Time SLAs All endpoints return response time headers for performance monitoring: - `X-Response-Time`: Human-readable response time (e.g., \"245ms\") - `X-Response-Time-Ms`: Response time in milliseconds - `X-Response-Time-Target`: Target response time for this endpoint - `X-Response-Time-Max`: Maximum acceptable response time - `X-Response-Time-Status`: Performance status (`optimal`, `acceptable`, `exceeded`)  ### Response Time Targets by Category  | Category | Target | Maximum | Endpoints | |----------|--------|---------|-----------| | **Fast** | 200ms | 500ms | county-lookup, check-subscription | | **Standard** | 500ms | 1,500ms | get-soil-data, territorial-water-quality | | **Complex** | 2,000ms | 5,000ms | agricultural-intelligence, gpt5-chat, visual-crop-analysis | | **Heavy** | 5,000ms | 15,000ms | live-agricultural-data, generate-vrt-prescription | 
+
+The version of the OpenAPI document: 3.0.0
+Contact: support@soilsidekickpro.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module SoilSidekick
+  class TurboQuantApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Query TurboQuant device capabilities
+    # Returns hardware-specific model recommendations and estimated performance based on detected device capabilities. Use this to determine the optimal local inference configuration for the end-user's device.  **Tier requirement:** Pro or Enterprise 
+    # @param turbo_quant_capabilities_request [TurboQuantCapabilitiesRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :x_tq_context_mode TurboQuant extended context window size (tokens). With 3-bit KV cache, context windows up to 24K tokens are feasible within the same memory budget as standard 4K.  (default to 4096)
+    # @option opts [String] :x_tq_kv_cache_hint KV cache management hint. - `none`: No caching (default) - `reuse`: Reuse KV cache from previous request in same session (40-60% compute savings) - `persist`: Persist cache to disk for cross-session reuse  (default to 'none')
+    # @option opts [String] :x_tq_model_tier Preferred model tier for inference. - `auto`: Server selects optimal model based on device capabilities - `gemma-2b`: Lightweight model (~0.5GB KV with TQ) - `gemma-7b`: Full model, standard KV cache - `gemma-7b-tq`: Full model with TurboQuant 3-bit KV cache (~1.3GB)  (default to 'auto')
+    # @return [TurboQuantCapabilities]
+    def turbo_quant_capabilities(turbo_quant_capabilities_request, opts = {})
+      data, _status_code, _headers = turbo_quant_capabilities_with_http_info(turbo_quant_capabilities_request, opts)
+      data
+    end
+
+    # Query TurboQuant device capabilities
+    # Returns hardware-specific model recommendations and estimated performance based on detected device capabilities. Use this to determine the optimal local inference configuration for the end-user's device.  **Tier requirement:** Pro or Enterprise 
+    # @param turbo_quant_capabilities_request [TurboQuantCapabilitiesRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :x_tq_context_mode TurboQuant extended context window size (tokens). With 3-bit KV cache, context windows up to 24K tokens are feasible within the same memory budget as standard 4K.  (default to 4096)
+    # @option opts [String] :x_tq_kv_cache_hint KV cache management hint. - `none`: No caching (default) - `reuse`: Reuse KV cache from previous request in same session (40-60% compute savings) - `persist`: Persist cache to disk for cross-session reuse  (default to 'none')
+    # @option opts [String] :x_tq_model_tier Preferred model tier for inference. - `auto`: Server selects optimal model based on device capabilities - `gemma-2b`: Lightweight model (~0.5GB KV with TQ) - `gemma-7b`: Full model, standard KV cache - `gemma-7b-tq`: Full model with TurboQuant 3-bit KV cache (~1.3GB)  (default to 'auto')
+    # @return [Array<(TurboQuantCapabilities, Integer, Hash)>] TurboQuantCapabilities data, response status code and response headers
+    def turbo_quant_capabilities_with_http_info(turbo_quant_capabilities_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TurboQuantApi.turbo_quant_capabilities ...'
+      end
+      # verify the required parameter 'turbo_quant_capabilities_request' is set
+      if @api_client.config.client_side_validation && turbo_quant_capabilities_request.nil?
+        fail ArgumentError, "Missing the required parameter 'turbo_quant_capabilities_request' when calling TurboQuantApi.turbo_quant_capabilities"
+      end
+      allowable_values = [4096, 8192, 16384, 24576]
+      if @api_client.config.client_side_validation && opts[:'x_tq_context_mode'] && !allowable_values.include?(opts[:'x_tq_context_mode'])
+        fail ArgumentError, "invalid value for \"x_tq_context_mode\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["none", "reuse", "persist"]
+      if @api_client.config.client_side_validation && opts[:'x_tq_kv_cache_hint'] && !allowable_values.include?(opts[:'x_tq_kv_cache_hint'])
+        fail ArgumentError, "invalid value for \"x_tq_kv_cache_hint\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["auto", "gemma-2b", "gemma-7b", "gemma-7b-tq"]
+      if @api_client.config.client_side_validation && opts[:'x_tq_model_tier'] && !allowable_values.include?(opts[:'x_tq_model_tier'])
+        fail ArgumentError, "invalid value for \"x_tq_model_tier\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/turbo-quant-capabilities'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'x-tq-context-mode'] = opts[:'x_tq_context_mode'] if !opts[:'x_tq_context_mode'].nil?
+      header_params[:'x-tq-kv-cache-hint'] = opts[:'x_tq_kv_cache_hint'] if !opts[:'x_tq_kv_cache_hint'].nil?
+      header_params[:'x-tq-model-tier'] = opts[:'x_tq_model_tier'] if !opts[:'x_tq_model_tier'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(turbo_quant_capabilities_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TurboQuantCapabilities'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"TurboQuantApi.turbo_quant_capabilities",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TurboQuantApi#turbo_quant_capabilities\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/soilsidekick/api/vrt_api.rb

@@ -0,0 +1,90 @@
+=begin
+#SoilSidekick Pro API
+
+#Agricultural intelligence and soil analysis API with tier-based access control.  ## What's New in 1.2.0 - **Consumer Plant Care APIs**: Three new endpoints addressing top pain points in plant ID apps:   - `/safe-identification`: Toxic lookalike warnings and environmental context   - `/dynamic-care`: Hyper-localized, real-time care recommendations   - `/beginner-guidance`: Judgment-free, jargon-free plant guidance  ## Authentication All endpoints require an API key passed via the `x-api-key` header: ``` x-api-key: ak_your_api_key_here ```  API keys are generated through the dashboard and use the `ak_*` format.  ## Rate Limiting Rate limits are enforced based on your subscription tier: - **Free**: 10 req/min, 100 req/hour, 1,000 req/day - **Starter**: 30 req/min, 500 req/hour, 5,000 req/day - **Pro**: 100 req/min, 2,000 req/hour, 25,000 req/day - **Enterprise**: 500 req/min, 10,000 req/hour, 100,000 req/day  Rate limit information is returned in response headers: - `X-RateLimit-Limit`: Maximum requests in window - `X-RateLimit-Remaining`: Remaining requests in window - `X-RateLimit-Reset`: Unix timestamp when limit resets  ## Response Time SLAs All endpoints return response time headers for performance monitoring: - `X-Response-Time`: Human-readable response time (e.g., \"245ms\") - `X-Response-Time-Ms`: Response time in milliseconds - `X-Response-Time-Target`: Target response time for this endpoint - `X-Response-Time-Max`: Maximum acceptable response time - `X-Response-Time-Status`: Performance status (`optimal`, `acceptable`, `exceeded`)  ### Response Time Targets by Category  | Category | Target | Maximum | Endpoints | |----------|--------|---------|-----------| | **Fast** | 200ms | 500ms | county-lookup, check-subscription | | **Standard** | 500ms | 1,500ms | get-soil-data, territorial-water-quality | | **Complex** | 2,000ms | 5,000ms | agricultural-intelligence, gpt5-chat, visual-crop-analysis | | **Heavy** | 5,000ms | 15,000ms | live-agricultural-data, generate-vrt-prescription | 
+
+The version of the OpenAPI document: 3.0.0
+Contact: support@soilsidekickpro.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'cgi'
+
+module SoilSidekick
+  class VRTApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Generate VRT prescription map
+    # Generate variable rate technology prescription maps
+    # @param generate_vrt_prescription_request [GenerateVRTPrescriptionRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [VRTPrescription]
+    def generate_vrt_prescription(generate_vrt_prescription_request, opts = {})
+      data, _status_code, _headers = generate_vrt_prescription_with_http_info(generate_vrt_prescription_request, opts)
+      data
+    end
+
+    # Generate VRT prescription map
+    # Generate variable rate technology prescription maps
+    # @param generate_vrt_prescription_request [GenerateVRTPrescriptionRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(VRTPrescription, Integer, Hash)>] VRTPrescription data, response status code and response headers
+    def generate_vrt_prescription_with_http_info(generate_vrt_prescription_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: VRTApi.generate_vrt_prescription ...'
+      end
+      # verify the required parameter 'generate_vrt_prescription_request' is set
+      if @api_client.config.client_side_validation && generate_vrt_prescription_request.nil?
+        fail ArgumentError, "Missing the required parameter 'generate_vrt_prescription_request' when calling VRTApi.generate_vrt_prescription"
+      end
+      # resource path
+      local_var_path = '/generate-vrt-prescription'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(generate_vrt_prescription_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'VRTPrescription'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"VRTApi.generate_vrt_prescription",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: VRTApi#generate_vrt_prescription\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end