soilsidekick 3.0.0

data/lib/soilsidekick/api/ai_services_api.rb

@@ -0,0 +1,378 @@
+=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 AIServicesApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Generate AI report summary
+    # Generate AI-powered summaries for soil or water quality reports
+    # @param generate_smart_report_summary_request [GenerateSmartReportSummaryRequest] 
+    # @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 [SmartReportSummary]
+    def generate_smart_report_summary(generate_smart_report_summary_request, opts = {})
+      data, _status_code, _headers = generate_smart_report_summary_with_http_info(generate_smart_report_summary_request, opts)
+      data
+    end
+
+    # Generate AI report summary
+    # Generate AI-powered summaries for soil or water quality reports
+    # @param generate_smart_report_summary_request [GenerateSmartReportSummaryRequest] 
+    # @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<(SmartReportSummary, Integer, Hash)>] SmartReportSummary data, response status code and response headers
+    def generate_smart_report_summary_with_http_info(generate_smart_report_summary_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AIServicesApi.generate_smart_report_summary ...'
+      end
+      # verify the required parameter 'generate_smart_report_summary_request' is set
+      if @api_client.config.client_side_validation && generate_smart_report_summary_request.nil?
+        fail ArgumentError, "Missing the required parameter 'generate_smart_report_summary_request' when calling AIServicesApi.generate_smart_report_summary"
+      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 = '/smart-report-summary'
+
+      # 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(generate_smart_report_summary_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SmartReportSummary'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"AIServicesApi.generate_smart_report_summary",
+        :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: AIServicesApi#generate_smart_report_summary\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get AI-powered agricultural insights
+    # Agricultural intelligence with AI recommendations
+    # @param get_agricultural_intelligence_request [GetAgriculturalIntelligenceRequest] 
+    # @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 [AIAnalysis]
+    def get_agricultural_intelligence(get_agricultural_intelligence_request, opts = {})
+      data, _status_code, _headers = get_agricultural_intelligence_with_http_info(get_agricultural_intelligence_request, opts)
+      data
+    end
+
+    # Get AI-powered agricultural insights
+    # Agricultural intelligence with AI recommendations
+    # @param get_agricultural_intelligence_request [GetAgriculturalIntelligenceRequest] 
+    # @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<(AIAnalysis, Integer, Hash)>] AIAnalysis data, response status code and response headers
+    def get_agricultural_intelligence_with_http_info(get_agricultural_intelligence_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AIServicesApi.get_agricultural_intelligence ...'
+      end
+      # verify the required parameter 'get_agricultural_intelligence_request' is set
+      if @api_client.config.client_side_validation && get_agricultural_intelligence_request.nil?
+        fail ArgumentError, "Missing the required parameter 'get_agricultural_intelligence_request' when calling AIServicesApi.get_agricultural_intelligence"
+      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 = '/agricultural-intelligence'
+
+      # 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_agricultural_intelligence_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AIAnalysis'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"AIServicesApi.get_agricultural_intelligence",
+        :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: AIServicesApi#get_agricultural_intelligence\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get seasonal planning recommendations
+    # AI-powered seasonal planning with weather integration
+    # @param get_seasonal_planning_assistant_request [GetSeasonalPlanningAssistantRequest] 
+    # @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 [SeasonalPlanningResponse]
+    def get_seasonal_planning_assistant(get_seasonal_planning_assistant_request, opts = {})
+      data, _status_code, _headers = get_seasonal_planning_assistant_with_http_info(get_seasonal_planning_assistant_request, opts)
+      data
+    end
+
+    # Get seasonal planning recommendations
+    # AI-powered seasonal planning with weather integration
+    # @param get_seasonal_planning_assistant_request [GetSeasonalPlanningAssistantRequest] 
+    # @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<(SeasonalPlanningResponse, Integer, Hash)>] SeasonalPlanningResponse data, response status code and response headers
+    def get_seasonal_planning_assistant_with_http_info(get_seasonal_planning_assistant_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AIServicesApi.get_seasonal_planning_assistant ...'
+      end
+      # verify the required parameter 'get_seasonal_planning_assistant_request' is set
+      if @api_client.config.client_side_validation && get_seasonal_planning_assistant_request.nil?
+        fail ArgumentError, "Missing the required parameter 'get_seasonal_planning_assistant_request' when calling AIServicesApi.get_seasonal_planning_assistant"
+      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 = '/seasonal-planning-assistant'
+
+      # 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_seasonal_planning_assistant_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SeasonalPlanningResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"AIServicesApi.get_seasonal_planning_assistant",
+        :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: AIServicesApi#get_seasonal_planning_assistant\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Analyze crop images
+    # AI-powered visual crop analysis for pest detection, health assessment, and disease screening
+    # @param visual_crop_analysis_request [VisualCropAnalysisRequest] 
+    # @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 [VisualCropAnalysis]
+    def visual_crop_analysis(visual_crop_analysis_request, opts = {})
+      data, _status_code, _headers = visual_crop_analysis_with_http_info(visual_crop_analysis_request, opts)
+      data
+    end
+
+    # Analyze crop images
+    # AI-powered visual crop analysis for pest detection, health assessment, and disease screening
+    # @param visual_crop_analysis_request [VisualCropAnalysisRequest] 
+    # @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<(VisualCropAnalysis, Integer, Hash)>] VisualCropAnalysis data, response status code and response headers
+    def visual_crop_analysis_with_http_info(visual_crop_analysis_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AIServicesApi.visual_crop_analysis ...'
+      end
+      # verify the required parameter 'visual_crop_analysis_request' is set
+      if @api_client.config.client_side_validation && visual_crop_analysis_request.nil?
+        fail ArgumentError, "Missing the required parameter 'visual_crop_analysis_request' when calling AIServicesApi.visual_crop_analysis"
+      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 = '/visual-crop-analysis'
+
+      # 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(visual_crop_analysis_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'VisualCropAnalysis'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"AIServicesApi.visual_crop_analysis",
+        :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: AIServicesApi#visual_crop_analysis\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/soilsidekick/api/carbon_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 CarbonApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Calculate carbon credits
+    # Calculate carbon credits based on field data and soil organic matter
+    # @param calculate_carbon_credits_request [CalculateCarbonCreditsRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [CarbonCreditCalculation]
+    def calculate_carbon_credits(calculate_carbon_credits_request, opts = {})
+      data, _status_code, _headers = calculate_carbon_credits_with_http_info(calculate_carbon_credits_request, opts)
+      data
+    end
+
+    # Calculate carbon credits
+    # Calculate carbon credits based on field data and soil organic matter
+    # @param calculate_carbon_credits_request [CalculateCarbonCreditsRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CarbonCreditCalculation, Integer, Hash)>] CarbonCreditCalculation data, response status code and response headers
+    def calculate_carbon_credits_with_http_info(calculate_carbon_credits_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CarbonApi.calculate_carbon_credits ...'
+      end
+      # verify the required parameter 'calculate_carbon_credits_request' is set
+      if @api_client.config.client_side_validation && calculate_carbon_credits_request.nil?
+        fail ArgumentError, "Missing the required parameter 'calculate_carbon_credits_request' when calling CarbonApi.calculate_carbon_credits"
+      end
+      # resource path
+      local_var_path = '/carbon-credit-calculator'
+
+      # 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(calculate_carbon_credits_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CarbonCreditCalculation'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"CarbonApi.calculate_carbon_credits",
+        :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: CarbonApi#calculate_carbon_credits\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end