temper-rb 0.5.1

data/lib/temper/generated/models/resource_lineage.rb

@@ -0,0 +1,224 @@
+=begin
+#Temper Cloud API
+
+#Knowledge base management API for temper cloud
+
+The version of the OpenAPI document: 0.5.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Temper::Generated
+  # A resource's bidirectional `derived_from` lineage, each side already gated to what the caller may read.
+  class ResourceLineage < ApiModelBase
+    # What the seed derives from, transitively (nearest first).
+    attr_accessor :ancestors
+
+    # What derives from the seed, transitively (nearest first).
+    attr_accessor :descendants
+
+    # The seed resource the lineage was requested for.
+    attr_accessor :resource_id
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'ancestors' => :'ancestors',
+        :'descendants' => :'descendants',
+        :'resource_id' => :'resource_id'
+      }
+    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
+      {
+        :'ancestors' => :'Array<LineageNode>',
+        :'descendants' => :'Array<LineageNode>',
+        :'resource_id' => :'String'
+      }
+    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 `Temper::Generated::ResourceLineage` 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 `Temper::Generated::ResourceLineage`. 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?(:'ancestors')
+        if (value = attributes[:'ancestors']).is_a?(Array)
+          self.ancestors = value
+        end
+      else
+        self.ancestors = nil
+      end
+
+      if attributes.key?(:'descendants')
+        if (value = attributes[:'descendants']).is_a?(Array)
+          self.descendants = value
+        end
+      else
+        self.descendants = nil
+      end
+
+      if attributes.key?(:'resource_id')
+        self.resource_id = attributes[:'resource_id']
+      else
+        self.resource_id = 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 @ancestors.nil?
+        invalid_properties.push('invalid value for "ancestors", ancestors cannot be nil.')
+      end
+
+      if @descendants.nil?
+        invalid_properties.push('invalid value for "descendants", descendants cannot be nil.')
+      end
+
+      if @resource_id.nil?
+        invalid_properties.push('invalid value for "resource_id", resource_id 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 @ancestors.nil?
+      return false if @descendants.nil?
+      return false if @resource_id.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] ancestors Value to be assigned
+    def ancestors=(ancestors)
+      if ancestors.nil?
+        fail ArgumentError, 'ancestors cannot be nil'
+      end
+
+      @ancestors = ancestors
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] descendants Value to be assigned
+    def descendants=(descendants)
+      if descendants.nil?
+        fail ArgumentError, 'descendants cannot be nil'
+      end
+
+      @descendants = descendants
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] resource_id Value to be assigned
+    def resource_id=(resource_id)
+      if resource_id.nil?
+        fail ArgumentError, 'resource_id cannot be nil'
+      end
+
+      @resource_id = resource_id
+    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 &&
+          ancestors == o.ancestors &&
+          descendants == o.descendants &&
+          resource_id == o.resource_id
+    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
+      [ancestors, descendants, resource_id].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/temper/generated/models/resource_list_response.rb

@@ -0,0 +1,313 @@
+=begin
+#Temper Cloud API
+
+#Knowledge base management API for temper cloud
+
+The version of the OpenAPI document: 0.5.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.23.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Temper::Generated
+  # Paginated response for resource list endpoints, with doc-type facets.  The envelope carries its own paging state, so a caller can tell a whole set from a page of one without knowing what it asked for. `returned` and `truncated` used to be injected render-time by the CLI alone (`temper-cli/src/commands/resource.rs`), so MCP and raw-HTTP callers never received them — while the shipped agent skill instructs every agent that \"every list response carries `total`, `returned`, and `truncated`\". Same defect class as the `ref` the CLI was likewise the only surface to emit.  Build through [`ResourceListResponse::new`], which derives `returned` and `truncated` from the page rather than trusting a caller to keep them consistent with `rows`.
+  class ResourceListResponse < ApiModelBase
+    attr_accessor :facets
+
+    # The effective page size the server applied, or `None` for an uncapped page (`--all`). An echo of what the caller asked for, not a clamp — no server-side clamp exists.
+    attr_accessor :limit
+
+    # The offset this page starts at; `0` when the caller sent none.
+    attr_accessor :offset
+
+    # This page's row count. Always `rows.len()`; carried explicitly so the count survives a projection that drops or summarizes the rows.
+    attr_accessor :returned
+
+    # One [`ResourceView`] per row — **the same shape `show` answers in**, so a single-row list and a `show` of that resource serialize identically when neither asks for the body. There is no second list envelope: `?sections=` varies which parts of this shape are filled, never which type comes back.
+    attr_accessor :rows
+
+    # The FILTERED match count — every row the filters admit, before `limit`/`offset`.
+    attr_accessor :total
+
+    # Are there matching rows beyond this page? `offset + returned < total`.  Deliberately not `total > returned`, which is true on the last page of a walk (total 25, offset 20, returned 5) where nothing is in fact hidden. `true` here is what tells a caller it may not conclude a resource is absent from what it sees.
+    attr_accessor :truncated
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'facets' => :'facets',
+        :'limit' => :'limit',
+        :'offset' => :'offset',
+        :'returned' => :'returned',
+        :'rows' => :'rows',
+        :'total' => :'total',
+        :'truncated' => :'truncated'
+      }
+    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
+      {
+        :'facets' => :'ResourceFacets',
+        :'limit' => :'Integer',
+        :'offset' => :'Integer',
+        :'returned' => :'Integer',
+        :'rows' => :'Array<ResourceView>',
+        :'total' => :'Integer',
+        :'truncated' => :'Boolean'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'limit',
+      ])
+    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 `Temper::Generated::ResourceListResponse` 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 `Temper::Generated::ResourceListResponse`. 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?(:'facets')
+        self.facets = attributes[:'facets']
+      else
+        self.facets = nil
+      end
+
+      if attributes.key?(:'limit')
+        self.limit = attributes[:'limit']
+      end
+
+      if attributes.key?(:'offset')
+        self.offset = attributes[:'offset']
+      else
+        self.offset = nil
+      end
+
+      if attributes.key?(:'returned')
+        self.returned = attributes[:'returned']
+      else
+        self.returned = nil
+      end
+
+      if attributes.key?(:'rows')
+        if (value = attributes[:'rows']).is_a?(Array)
+          self.rows = value
+        end
+      else
+        self.rows = nil
+      end
+
+      if attributes.key?(:'total')
+        self.total = attributes[:'total']
+      else
+        self.total = nil
+      end
+
+      if attributes.key?(:'truncated')
+        self.truncated = attributes[:'truncated']
+      else
+        self.truncated = 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 @facets.nil?
+        invalid_properties.push('invalid value for "facets", facets cannot be nil.')
+      end
+
+      if @offset.nil?
+        invalid_properties.push('invalid value for "offset", offset cannot be nil.')
+      end
+
+      if @returned.nil?
+        invalid_properties.push('invalid value for "returned", returned cannot be nil.')
+      end
+
+      if @rows.nil?
+        invalid_properties.push('invalid value for "rows", rows cannot be nil.')
+      end
+
+      if @total.nil?
+        invalid_properties.push('invalid value for "total", total cannot be nil.')
+      end
+
+      if @truncated.nil?
+        invalid_properties.push('invalid value for "truncated", truncated 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 @facets.nil?
+      return false if @offset.nil?
+      return false if @returned.nil?
+      return false if @rows.nil?
+      return false if @total.nil?
+      return false if @truncated.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] facets Value to be assigned
+    def facets=(facets)
+      if facets.nil?
+        fail ArgumentError, 'facets cannot be nil'
+      end
+
+      @facets = facets
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] offset Value to be assigned
+    def offset=(offset)
+      if offset.nil?
+        fail ArgumentError, 'offset cannot be nil'
+      end
+
+      @offset = offset
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] returned Value to be assigned
+    def returned=(returned)
+      if returned.nil?
+        fail ArgumentError, 'returned cannot be nil'
+      end
+
+      @returned = returned
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] rows Value to be assigned
+    def rows=(rows)
+      if rows.nil?
+        fail ArgumentError, 'rows cannot be nil'
+      end
+
+      @rows = rows
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] total Value to be assigned
+    def total=(total)
+      if total.nil?
+        fail ArgumentError, 'total cannot be nil'
+      end
+
+      @total = total
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] truncated Value to be assigned
+    def truncated=(truncated)
+      if truncated.nil?
+        fail ArgumentError, 'truncated cannot be nil'
+      end
+
+      @truncated = truncated
+    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 &&
+          facets == o.facets &&
+          limit == o.limit &&
+          offset == o.offset &&
+          returned == o.returned &&
+          rows == o.rows &&
+          total == o.total &&
+          truncated == o.truncated
+    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
+      [facets, limit, offset, returned, rows, total, truncated].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