soilsidekick 3.0.0

data/lib/soilsidekick/api/consumer_plant_care_api.rb

@@ -0,0 +1,289 @@
+=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 ConsumerPlantCareApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Beginner-friendly plant guidance without jargon
+    # Judgment-free, accessible plant guidance that solves community gatekeeping issues. This endpoint: - Translates scientific jargon into plain language - Never makes users feel stupid for asking about common plants - Uses progressive disclosure (simple answer first, details on request) - Provides encouraging, supportive tone - Offers practical \"what do I do right now\" guidance 
+    # @param beginner_guidance_request [BeginnerGuidanceRequest] 
+    # @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 [BeginnerGuidance]
+    def beginner_guidance(beginner_guidance_request, opts = {})
+      data, _status_code, _headers = beginner_guidance_with_http_info(beginner_guidance_request, opts)
+      data
+    end
+
+    # Beginner-friendly plant guidance without jargon
+    # Judgment-free, accessible plant guidance that solves community gatekeeping issues. This endpoint: - Translates scientific jargon into plain language - Never makes users feel stupid for asking about common plants - Uses progressive disclosure (simple answer first, details on request) - Provides encouraging, supportive tone - Offers practical \"what do I do right now\" guidance 
+    # @param beginner_guidance_request [BeginnerGuidanceRequest] 
+    # @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<(BeginnerGuidance, Integer, Hash)>] BeginnerGuidance data, response status code and response headers
+    def beginner_guidance_with_http_info(beginner_guidance_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ConsumerPlantCareApi.beginner_guidance ...'
+      end
+      # verify the required parameter 'beginner_guidance_request' is set
+      if @api_client.config.client_side_validation && beginner_guidance_request.nil?
+        fail ArgumentError, "Missing the required parameter 'beginner_guidance_request' when calling ConsumerPlantCareApi.beginner_guidance"
+      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 = '/beginner-guidance'
+
+      # 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(beginner_guidance_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'BeginnerGuidance'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"ConsumerPlantCareApi.beginner_guidance",
+        :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: ConsumerPlantCareApi#beginner_guidance\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Hyper-localized dynamic plant care recommendations
+    # Real-time, environment-aware care recommendations that solve the \"generic advice\" problem. Unlike static \"water every 7 days\" recommendations, this endpoint: - Adjusts watering based on current humidity, temperature, and recent rainfall - Considers container type, soil composition, and drainage - Factors in seasonal changes and indoor environment conditions - Accounts for plant maturity and growth phase - Provides actionable guidance, not rigid schedules 
+    # @param dynamic_care_request [DynamicCareRequest] 
+    # @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 [DynamicCare]
+    def dynamic_care(dynamic_care_request, opts = {})
+      data, _status_code, _headers = dynamic_care_with_http_info(dynamic_care_request, opts)
+      data
+    end
+
+    # Hyper-localized dynamic plant care recommendations
+    # Real-time, environment-aware care recommendations that solve the \&quot;generic advice\&quot; problem. Unlike static \&quot;water every 7 days\&quot; recommendations, this endpoint: - Adjusts watering based on current humidity, temperature, and recent rainfall - Considers container type, soil composition, and drainage - Factors in seasonal changes and indoor environment conditions - Accounts for plant maturity and growth phase - Provides actionable guidance, not rigid schedules 
+    # @param dynamic_care_request [DynamicCareRequest] 
+    # @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<(DynamicCare, Integer, Hash)>] DynamicCare data, response status code and response headers
+    def dynamic_care_with_http_info(dynamic_care_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ConsumerPlantCareApi.dynamic_care ...'
+      end
+      # verify the required parameter 'dynamic_care_request' is set
+      if @api_client.config.client_side_validation && dynamic_care_request.nil?
+        fail ArgumentError, "Missing the required parameter 'dynamic_care_request' when calling ConsumerPlantCareApi.dynamic_care"
+      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 = '/dynamic-care'
+
+      # 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(dynamic_care_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DynamicCare'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"ConsumerPlantCareApi.dynamic_care",
+        :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: ConsumerPlantCareApi#dynamic_care\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Safe plant identification with toxic lookalike warnings
+    # Environmentally-contextualized plant identification that addresses misidentification concerns. Unlike generic plant ID, this endpoint: - Checks against a toxic lookalike database with visual similarity scores - Uses environmental context (soil, climate, regional flora) to weight identification probability - Provides confidence breakdowns showing why alternatives were considered - Issues explicit warnings for dangerous lookalikes (Poison Hemlock vs Wild Carrot) - Accounts for plant growth stage (seedling identification challenges) 
+    # @param safe_identification_request [SafeIdentificationRequest] 
+    # @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 [SafeIdentification]
+    def safe_identification(safe_identification_request, opts = {})
+      data, _status_code, _headers = safe_identification_with_http_info(safe_identification_request, opts)
+      data
+    end
+
+    # Safe plant identification with toxic lookalike warnings
+    # Environmentally-contextualized plant identification that addresses misidentification concerns. Unlike generic plant ID, this endpoint: - Checks against a toxic lookalike database with visual similarity scores - Uses environmental context (soil, climate, regional flora) to weight identification probability - Provides confidence breakdowns showing why alternatives were considered - Issues explicit warnings for dangerous lookalikes (Poison Hemlock vs Wild Carrot) - Accounts for plant growth stage (seedling identification challenges) 
+    # @param safe_identification_request [SafeIdentificationRequest] 
+    # @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<(SafeIdentification, Integer, Hash)>] SafeIdentification data, response status code and response headers
+    def safe_identification_with_http_info(safe_identification_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ConsumerPlantCareApi.safe_identification ...'
+      end
+      # verify the required parameter 'safe_identification_request' is set
+      if @api_client.config.client_side_validation && safe_identification_request.nil?
+        fail ArgumentError, "Missing the required parameter 'safe_identification_request' when calling ConsumerPlantCareApi.safe_identification"
+      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 = '/safe-identification'
+
+      # 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(safe_identification_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SafeIdentification'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"ConsumerPlantCareApi.safe_identification",
+        :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: ConsumerPlantCareApi#safe_identification\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/soilsidekick/api/environmental_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 EnvironmentalApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Calculate environmental impact
+    # Assess environmental impact including runoff risk, contamination, and eco-friendly alternatives
+    # @param calculate_environmental_impact_request [CalculateEnvironmentalImpactRequest] 
+    # @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 [EnvironmentalImpact]
+    def calculate_environmental_impact(calculate_environmental_impact_request, opts = {})
+      data, _status_code, _headers = calculate_environmental_impact_with_http_info(calculate_environmental_impact_request, opts)
+      data
+    end
+
+    # Calculate environmental impact
+    # Assess environmental impact including runoff risk, contamination, and eco-friendly alternatives
+    # @param calculate_environmental_impact_request [CalculateEnvironmentalImpactRequest] 
+    # @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<(EnvironmentalImpact, Integer, Hash)>] EnvironmentalImpact data, response status code and response headers
+    def calculate_environmental_impact_with_http_info(calculate_environmental_impact_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: EnvironmentalApi.calculate_environmental_impact ...'
+      end
+      # verify the required parameter 'calculate_environmental_impact_request' is set
+      if @api_client.config.client_side_validation && calculate_environmental_impact_request.nil?
+        fail ArgumentError, "Missing the required parameter 'calculate_environmental_impact_request' when calling EnvironmentalApi.calculate_environmental_impact"
+      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 = '/environmental-impact-engine'
+
+      # 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(calculate_environmental_impact_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'EnvironmentalImpact'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"EnvironmentalApi.calculate_environmental_impact",
+        :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: EnvironmentalApi#calculate_environmental_impact\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/soilsidekick/api/geographic_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 GeographicApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Search for counties
+    # Search counties by name, state, or FIPS code
+    # @param county_lookup_request [CountyLookupRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [CountyLookup200Response]
+    def county_lookup(county_lookup_request, opts = {})
+      data, _status_code, _headers = county_lookup_with_http_info(county_lookup_request, opts)
+      data
+    end
+
+    # Search for counties
+    # Search counties by name, state, or FIPS code
+    # @param county_lookup_request [CountyLookupRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CountyLookup200Response, Integer, Hash)>] CountyLookup200Response data, response status code and response headers
+    def county_lookup_with_http_info(county_lookup_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GeographicApi.county_lookup ...'
+      end
+      # verify the required parameter 'county_lookup_request' is set
+      if @api_client.config.client_side_validation && county_lookup_request.nil?
+        fail ArgumentError, "Missing the required parameter 'county_lookup_request' when calling GeographicApi.county_lookup"
+      end
+      # resource path
+      local_var_path = '/county-lookup'
+
+      # 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(county_lookup_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CountyLookup200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"GeographicApi.county_lookup",
+        :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: GeographicApi#county_lookup\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/soilsidekick/api/leaf_engines_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 LeafEnginesApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Query plant-environment compatibility
+    # LeafEngines API for plant compatibility scoring with environmental factors
+    # @param leafengines_query_request [LeafenginesQueryRequest] 
+    # @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 [LeafEnginesCompatibility]
+    def leafengines_query(leafengines_query_request, opts = {})
+      data, _status_code, _headers = leafengines_query_with_http_info(leafengines_query_request, opts)
+      data
+    end
+
+    # Query plant-environment compatibility
+    # LeafEngines API for plant compatibility scoring with environmental factors
+    # @param leafengines_query_request [LeafenginesQueryRequest] 
+    # @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<(LeafEnginesCompatibility, Integer, Hash)>] LeafEnginesCompatibility data, response status code and response headers
+    def leafengines_query_with_http_info(leafengines_query_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: LeafEnginesApi.leafengines_query ...'
+      end
+      # verify the required parameter 'leafengines_query_request' is set
+      if @api_client.config.client_side_validation && leafengines_query_request.nil?
+        fail ArgumentError, "Missing the required parameter 'leafengines_query_request' when calling LeafEnginesApi.leafengines_query"
+      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 = '/leafengines-query'
+
+      # 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(leafengines_query_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LeafEnginesCompatibility'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"LeafEnginesApi.leafengines_query",
+        :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: LeafEnginesApi#leafengines_query\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end