smplkit 2.0.11 → 2.0.13

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/api/logger_sources_api.rb

@@ -20,7 +20,7 @@ module SmplkitGeneratedClient::Logging
       @api_client = api_client
     end
     # List All Logger Sources
-    # List all logger sources across all loggers. Optionally filter by environment or service.
+    # List every logger source observation for this account.  Supports `filter[environment]` and `filter[service]` to narrow to a specific environment or service.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_environment 
     # @option opts [String] :filter_service 
@@ -31,7 +31,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List All Logger Sources
-    # List all logger sources across all loggers. Optionally filter by environment or service.
+    # List every logger source observation for this account.  Supports `filter[environment]` and `filter[service]` to narrow to a specific environment or service.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_environment 
     # @option opts [String] :filter_service 
@@ -83,7 +83,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Logger Sources
-    # List all sources (service/environment observations) for a specific logger.
+    # List the service / environment observations recorded for a logger.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [LoggerSourceListResponse]
@@ -93,7 +93,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Logger Sources
-    # List all sources (service/environment observations) for a specific logger.
+    # List the service / environment observations recorded for a logger.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LoggerSourceListResponse, Integer, Hash)>] LoggerSourceListResponse data, response status code and response headers

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/api/loggers_api.rb

@@ -20,7 +20,7 @@ module SmplkitGeneratedClient::Logging
       @api_client = api_client
     end
     # Bulk Register Loggers
-    # Register loggers discovered by an SDK. Creates new loggers or updates source observations on existing ones.
+    # Register loggers discovered by an SDK.  Creates new logger entries for previously unseen keys and refreshes the per-(service, environment) observation for keys already known. Returns the number of items processed.
     # @param logger_bulk_request [LoggerBulkRequest] 
     # @param [Hash] opts the optional parameters
     # @return [LoggerBulkResponse]
@@ -30,7 +30,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Bulk Register Loggers
-    # Register loggers discovered by an SDK. Creates new loggers or updates source observations on existing ones.
+    # Register loggers discovered by an SDK.  Creates new logger entries for previously unseen keys and refreshes the per-(service, environment) observation for keys already known. Returns the number of items processed.
     # @param logger_bulk_request [LoggerBulkRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LoggerBulkResponse, Integer, Hash)>] LoggerBulkResponse data, response status code and response headers
@@ -88,7 +88,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Delete Logger
-    # Delete a logger by its key.
+    # Delete a logger.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [nil]
@@ -98,7 +98,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Delete Logger
-    # Delete a logger by its key.
+    # Delete a logger.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -151,7 +151,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Get Logger
-    # Return a logger by its key.
+    # Retrieve a logger by its key.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [LoggerResponse]
@@ -161,7 +161,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Get Logger
-    # Return a logger by its key.
+    # Retrieve a logger by its key.
     # @param id [String] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LoggerResponse, Integer, Hash)>] LoggerResponse data, response status code and response headers
@@ -214,7 +214,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Loggers
-    # List all loggers for the authenticated account. Optionally filter by managed status, service, or last-seen time window.
+    # List loggers for this account.  Supports `filter[managed]` to narrow to managed (or unmanaged) loggers, `filter[service]` to keep only loggers observed in a specific service, and `filter[last_seen]` (interval notation `[<from>,*)`) to keep only loggers with a source observation at or after the given timestamp.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :filter_managed 
     # @option opts [String] :filter_service 
@@ -226,7 +226,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Loggers
-    # List all loggers for the authenticated account. Optionally filter by managed status, service, or last-seen time window.
+    # List loggers for this account.  Supports &#x60;filter[managed]&#x60; to narrow to managed (or unmanaged) loggers, &#x60;filter[service]&#x60; to keep only loggers observed in a specific service, and &#x60;filter[last_seen]&#x60; (interval notation &#x60;[&lt;from&gt;,*)&#x60;) to keep only loggers with a source observation at or after the given timestamp.
     # @param [Hash] opts the optional parameters
     # @option opts [Boolean] :filter_managed 
     # @option opts [String] :filter_service 
@@ -280,23 +280,23 @@ module SmplkitGeneratedClient::Logging
     end
 
     # Update or Create Logger
-    # Create or update a logger (upsert). If the logger does not exist it is created. Fields absent from the body are preserved on update; explicit null clears them.
+    # Create or replace a logger at the given key.  If the logger does not yet exist, it is created. Fields omitted from the request body are preserved; explicit `null` clears them. Setting `level`, `group`, or `environments` on an unmanaged logger promotes it to managed automatically.
     # @param id [String] 
-    # @param logger_response [LoggerResponse] 
+    # @param logger_request [LoggerRequest] 
     # @param [Hash] opts the optional parameters
     # @return [LoggerResponse]
-    def update_logger(id, logger_response, opts = {})
-      data, _status_code, _headers = update_logger_with_http_info(id, logger_response, opts)
+    def update_logger(id, logger_request, opts = {})
+      data, _status_code, _headers = update_logger_with_http_info(id, logger_request, opts)
       data
     end
 
     # Update or Create Logger
-    # Create or update a logger (upsert). If the logger does not exist it is created. Fields absent from the body are preserved on update; explicit null clears them.
+    # Create or replace a logger at the given key.  If the logger does not yet exist, it is created. Fields omitted from the request body are preserved; explicit &#x60;null&#x60; clears them. Setting &#x60;level&#x60;, &#x60;group&#x60;, or &#x60;environments&#x60; on an unmanaged logger promotes it to managed automatically.
     # @param id [String] 
-    # @param logger_response [LoggerResponse] 
+    # @param logger_request [LoggerRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(LoggerResponse, Integer, Hash)>] LoggerResponse data, response status code and response headers
-    def update_logger_with_http_info(id, logger_response, opts = {})
+    def update_logger_with_http_info(id, logger_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: LoggersApi.update_logger ...'
       end
@@ -304,9 +304,9 @@ module SmplkitGeneratedClient::Logging
       if @api_client.config.client_side_validation && id.nil?
         fail ArgumentError, "Missing the required parameter 'id' when calling LoggersApi.update_logger"
       end
-      # verify the required parameter 'logger_response' is set
-      if @api_client.config.client_side_validation && logger_response.nil?
-        fail ArgumentError, "Missing the required parameter 'logger_response' when calling LoggersApi.update_logger"
+      # verify the required parameter 'logger_request' is set
+      if @api_client.config.client_side_validation && logger_request.nil?
+        fail ArgumentError, "Missing the required parameter 'logger_request' when calling LoggersApi.update_logger"
       end
       # resource path
       local_var_path = '/api/v1/loggers/{id}'.sub('{id}', CGI.escape(id.to_s))
@@ -328,7 +328,7 @@ module SmplkitGeneratedClient::Logging
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(logger_response)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(logger_request)
 
       # return_type
       return_type = opts[:debug_return_type] || 'LoggerResponse'

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/api/services_api.rb

@@ -20,7 +20,7 @@ module SmplkitGeneratedClient::Logging
       @api_client = api_client
     end
     # List Services
-    # Return the distinct service names observed across all logger sources for the account.
+    # List the services that have reported a logger for this account.
     # @param [Hash] opts the optional parameters
     # @return [ServiceListResponse]
     def list_services(opts = {})
@@ -29,7 +29,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Services
-    # Return the distinct service names observed across all logger sources for the account.
+    # List the services that have reported a logger for this account.
     # @param [Hash] opts the optional parameters
     # @return [Array<(ServiceListResponse, Integer, Hash)>] ServiceListResponse data, response status code and response headers
     def list_services_with_http_info(opts = {})

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/api/usage_api.rb

@@ -20,7 +20,7 @@ module SmplkitGeneratedClient::Logging
       @api_client = api_client
     end
     # List Logging Usage
-    # Return current resource usage counts for the authenticated account.
+    # Report the current-period usage counters for this account.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_period 
     # @return [UsageListResponse]
@@ -30,7 +30,7 @@ module SmplkitGeneratedClient::Logging
     end
 
     # List Logging Usage
-    # Return current resource usage counts for the authenticated account.
+    # Report the current-period usage counters for this account.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_period 
     # @return [Array<(UsageListResponse, Integer, Hash)>] UsageListResponse data, response status code and response headers

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/log_group.rb

@@ -14,19 +14,48 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # A named collection of loggers that share a level configuration.  Assigning a logger to a group ties the logger's effective level to the group's level (and per-environment overrides). Loggers can move between groups or be detached from a group entirely.
   class LogGroup < ApiModelBase
+    # Human-readable label for the group.
     attr_accessor :name
 
+    # Default level applied to every logger in the group. `null` leaves member loggers to inherit from elsewhere.
     attr_accessor :level
 
+    # Reserved for nested groups. Must be `null` in this version; nested groups are not yet supported.
     attr_accessor :parent_id
 
+    # Per-environment level overrides keyed by environment name. Each value is an object with an optional `level` field, e.g. `{\"production\": {\"level\": \"ERROR\"}}`. Member loggers inherit the per-environment level unless they set their own override.
     attr_accessor :environments
 
+    # When the group was created.
     attr_accessor :created_at
 
+    # When the group was last modified.
     attr_accessor :updated_at
 
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -130,10 +159,6 @@ module SmplkitGeneratedClient::Logging
         invalid_properties.push('invalid value for "name", the character length must be smaller than or equal to 255.')
       end
 
-      if !@level.nil? && @level.to_s.length > 10
-        invalid_properties.push('invalid value for "level", the character length must be smaller than or equal to 10.')
-      end
-
       invalid_properties
     end
 
@@ -143,7 +168,8 @@ module SmplkitGeneratedClient::Logging
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @name.nil?
       return false if @name.to_s.length > 255
-      return false if !@level.nil? && @level.to_s.length > 10
+      level_validator = EnumAttributeValidator.new('String', ["TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL", "SILENT"])
+      return false unless level_validator.valid?(@level)
       true
     end
 
@@ -161,13 +187,13 @@ module SmplkitGeneratedClient::Logging
       @name = name
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] level Value to be assigned
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] level Object to be assigned
     def level=(level)
-      if !level.nil? && level.to_s.length > 10
-        fail ArgumentError, 'invalid value for "level", the character length must be smaller than or equal to 10.'
+      validator = EnumAttributeValidator.new('String', ["TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL", "SILENT"])
+      unless validator.valid?(level)
+        fail ArgumentError, "invalid value for \"level\", must be one of #{validator.allowable_values}."
       end
-
       @level = level
     end
 

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/log_group_list_response.rb

@@ -14,6 +14,7 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # JSON:API collection response for log groups.
   class LogGroupListResponse < ApiModelBase
     attr_accessor :data
 

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/log_group_request.rb

@@ -0,0 +1,165 @@
+=begin
+#smplkit Logging API
+
+#API for the smplkit logging service.
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'date'
+require 'time'
+
+module SmplkitGeneratedClient::Logging
+  # JSON:API request envelope for creating or updating a log group.
+  class LogGroupRequest < ApiModelBase
+    attr_accessor :data
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'data' => :'data'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'data' => :'LogGroupResource'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `SmplkitGeneratedClient::Logging::LogGroupRequest` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `SmplkitGeneratedClient::Logging::LogGroupRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'data')
+        self.data = attributes[:'data']
+      else
+        self.data = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @data.nil?
+        invalid_properties.push('invalid value for "data", data cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @data.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] data Value to be assigned
+    def data=(data)
+      if data.nil?
+        fail ArgumentError, 'data cannot be nil'
+      end
+
+      @data = data
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          data == o.data
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [data].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/log_group_resource.rb

@@ -14,6 +14,7 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # JSON:API resource envelope for a log group.  `id` is the group's key (e.g. `database-loggers`). On a create request the id may be supplied; if omitted, the server generates one from `name`.
   class LogGroupResource < ApiModelBase
     attr_accessor :id
 

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/log_group_response.rb

@@ -14,6 +14,7 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # JSON:API single-resource response envelope for a log group.
   class LogGroupResponse < ApiModelBase
     attr_accessor :data
 

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/logger.rb

@@ -14,25 +14,57 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # A logger configured for the account.  Loggers are organized by dot-separated key (for example, `sqlalchemy.engine`), matching the hierarchical naming convention used by most logging frameworks. A managed logger applies the configured level to every runtime where the logger appears; unmanaged loggers are tracked only as observations from SDKs.
   class Logger < ApiModelBase
+    # Human-readable label for the logger.
     attr_accessor :name
 
+    # Account-wide log level applied to this logger. `null` means no override at the logger level — the level is inherited from the logger's group or the framework default.
     attr_accessor :level
 
+    # Key of the log group this logger belongs to, or `null` if the logger is not grouped. Assigning a logger to a group promotes it to managed; assigning a group cascades to unmanaged descendants by clearing their group reference.
     attr_accessor :group
 
+    # When `true`, the logger is part of the account's managed configuration and counts toward the managed-loggers usage counter. Setting `level`, `group`, or `environments` on an unmanaged logger promotes it to managed automatically.
     attr_accessor :managed
 
+    # Service / environment observations reported by SDKs for this logger. Each entry carries the service name, environment, the level the SDK saw, the resolved level after framework inheritance, and timestamps for the first and most recent sighting.
     attr_accessor :sources
 
+    # Per-environment level overrides keyed by environment name. Each value is an object with an optional `level` field, e.g. `{\"production\": {\"level\": \"WARN\"}}`. An environment may be present with no `level` to record that the logger applies there without changing the resolved level.
     attr_accessor :environments
 
+    # Per-environment summary of what runtimes are reporting for this logger. Keyed by environment name; each entry is one of `{\"status\": \"none\"}`, `{\"status\": \"agrees\", \"level\": \"<LEVEL>\"}`, or `{\"status\": \"varies\"}`. `agrees` means every observed source in that environment reports the same resolved level; `varies` means at least two sources disagree.
     attr_accessor :effective_levels
 
+    # When the logger was first created or discovered.
     attr_accessor :created_at
 
+    # When the logger was last modified.
     attr_accessor :updated_at
 
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -161,10 +193,6 @@ module SmplkitGeneratedClient::Logging
         invalid_properties.push('invalid value for "name", the character length must be smaller than or equal to 255.')
       end
 
-      if !@level.nil? && @level.to_s.length > 10
-        invalid_properties.push('invalid value for "level", the character length must be smaller than or equal to 10.')
-      end
-
       invalid_properties
     end
 
@@ -174,7 +202,8 @@ module SmplkitGeneratedClient::Logging
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @name.nil?
       return false if @name.to_s.length > 255
-      return false if !@level.nil? && @level.to_s.length > 10
+      level_validator = EnumAttributeValidator.new('String', ["TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL", "SILENT"])
+      return false unless level_validator.valid?(@level)
       true
     end
 
@@ -192,13 +221,13 @@ module SmplkitGeneratedClient::Logging
       @name = name
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] level Value to be assigned
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] level Object to be assigned
     def level=(level)
-      if !level.nil? && level.to_s.length > 10
-        fail ArgumentError, 'invalid value for "level", the character length must be smaller than or equal to 10.'
+      validator = EnumAttributeValidator.new('String', ["TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL", "SILENT"])
+      unless validator.valid?(level)
+        fail ArgumentError, "invalid value for \"level\", must be one of #{validator.allowable_values}."
       end
-
       @level = level
     end
 

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/logger_bulk_item.rb

@@ -14,20 +14,21 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # One logger discovered by an SDK during a bulk registration call.
   class LoggerBulkItem < ApiModelBase
-    # Normalized logger name
+    # Dot-separated logger key as the SDK saw it.
     attr_accessor :id
 
-    # The explicitly-set level on this logger. Null if inherited.
+    # Level explicitly set on the logger by application code. `null` when the level is inherited.
     attr_accessor :level
 
-    # The effective level after framework inheritance. Never null in compliant SDKs.
+    # Effective level after framework inheritance. SDKs should always report this; the server falls back to `level` when `resolved_level` is missing.
     attr_accessor :resolved_level
 
-    # Service name that discovered this logger
+    # Service name that observed the logger.
     attr_accessor :service
 
-    # Environment where this logger was observed
+    # Environment where the logger was observed.
     attr_accessor :environment
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/logger_bulk_request.rb

@@ -14,7 +14,9 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # Payload for bulk registration of loggers discovered by an SDK.
   class LoggerBulkRequest < ApiModelBase
+    # Loggers to register or refresh observations for.
     attr_accessor :loggers
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/logger_bulk_response.rb

@@ -14,7 +14,9 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # Result of a bulk registration call.
   class LoggerBulkResponse < ApiModelBase
+    # Number of loggers that were created or had a source observation refreshed.
     attr_accessor :registered
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/smplkit/_generated/logging/lib/smplkit_logging_client/models/logger_list_response.rb

@@ -14,6 +14,7 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::Logging
+  # JSON:API collection response for loggers.
   class LoggerListResponse < ApiModelBase
     attr_accessor :data