temper-rb 0.5.1

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

@@ -0,0 +1,217 @@
+=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
+  # Produced by `survey`.
+  class StageOutputOneOf1 < ApiModelBase
+    attr_accessor :hits
+
+    attr_accessor :produced
+
+    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
+      {
+        :'hits' => :'hits',
+        :'produced' => :'produced'
+      }
+    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
+      {
+        :'hits' => :'Array<RegionHit>',
+        :'produced' => :'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::StageOutputOneOf1` 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::StageOutputOneOf1`. 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?(:'hits')
+        if (value = attributes[:'hits']).is_a?(Array)
+          self.hits = value
+        end
+      else
+        self.hits = nil
+      end
+
+      if attributes.key?(:'produced')
+        self.produced = attributes[:'produced']
+      else
+        self.produced = 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 @hits.nil?
+        invalid_properties.push('invalid value for "hits", hits cannot be nil.')
+      end
+
+      if @produced.nil?
+        invalid_properties.push('invalid value for "produced", produced 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 @hits.nil?
+      return false if @produced.nil?
+      produced_validator = EnumAttributeValidator.new('String', ["regions"])
+      return false unless produced_validator.valid?(@produced)
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] hits Value to be assigned
+    def hits=(hits)
+      if hits.nil?
+        fail ArgumentError, 'hits cannot be nil'
+      end
+
+      @hits = hits
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] produced Object to be assigned
+    def produced=(produced)
+      validator = EnumAttributeValidator.new('String', ["regions"])
+      unless validator.valid?(produced)
+        fail ArgumentError, "invalid value for \"produced\", must be one of #{validator.allowable_values}."
+      end
+      @produced = produced
+    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 &&
+          hits == o.hits &&
+          produced == o.produced
+    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
+      [hits, produced].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/stage_relation.rb

@@ -0,0 +1,40 @@
+=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
+  class StageRelation
+    BOUND = "bound".freeze
+    SEED = "seed".freeze
+
+    def self.all_vars
+      @all_vars ||= [BOUND, SEED].freeze
+    end
+
+    # Builds the enum from string
+    # @param [String] The enum value in the form of the string
+    # @return [String] The enum value
+    def self.build_from_hash(value)
+      new.build_from_hash(value)
+    end
+
+    # Builds the enum from string
+    # @param [String] The enum value in the form of the string
+    # @return [String] The enum value
+    def build_from_hash(value)
+      return value if StageRelation.all_vars.include?(value)
+      raise "Invalid ENUM value #{value} for class #StageRelation"
+    end
+  end
+end

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

@@ -0,0 +1,423 @@
+=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
+  # One returned stage's answer.  Neither `PartialEq` nor `Eq`, unlike its neighbours here: it holds hydrated rows, and [`crate::types::resource_view::ResourceView`] derives neither while the quantities are floats. The tests below compare the SERIALIZED form instead, which is what a client actually observes and is the stronger assertion anyway — a field that fails to serialize is invisible to structural equality.  `[renamed from StageResult — 2026-08-08]` A stage runs one act, but the thing being described is the STAGE — it is keyed by the caller's stage name, and its numbers are about the set that stage was handed. Naming it for the act invited exactly the ordinal-keyed trace this reshape also removed.
+  class StageResult < ApiModelBase
+    attr_accessor :act
+
+    # Which regions a `survey` stage matched, and at what score. Empty for every other act.  **The pair rule**: [`super::trace::StageTrace::disclosed_regions`] carries the same value, from one `disclosed_regions_for` definition rather than two. That field's doc carries the argument and the history; this one exists because a caller reading only `returned` must not have to reach into `trace` for a disclosure about a stage whose rows they already hold.
+    attr_accessor :disclosed_regions
+
+    attr_accessor :disposition
+
+    # Complete / partial / indeterminate. NOT a total — see `Extent`.
+    attr_accessor :extent
+
+    # How many ids this stage was handed. Zero for a stage with no input.
+    attr_accessor :input_ids
+
+    # How many did not — for ANY reason, deliberately conflated.  Invisible, nonexistent and malformed are one number on purpose. Separating them, or naming this field for the invisible case alone, is a **single-probe existence oracle**: pass one id, read the counter, learn whether it exists. This shipped in T2 as `bounds_withheld`, whose name inherited [`super::disposition::StageDisposition::Withheld`]'s meaning — *material exists* — and so disclosed exactly that. The arithmetic was always harmless (`input_ids - input_contributed` is derivable either way); the leak was in the label.  The caller still learns that 28 of their 40 did not contribute, which is what `composition-is-legible` asks for. They do not learn why. Decision `019fcd13-4e65-7213-ac6f-20c3c8ccfce1`.
+    attr_accessor :input_unusable
+
+    attr_accessor :narrowed_by
+
+    # Echoed from this act's declaration. Present iff the act orders anything.  **Once per stage, rather than once per row.** The row keeps a literal field name so two acts' numbers cannot be summed by accident; this carries the RANGE so a reader is not left to assume `[0,1]`. Assuming `[0,1]` is the live mistake in this family, not a hypothetical one: `vec_norm` rescales a cosine distance as `1 - d/2` into `[0,1]` while `region_score` spans `[-0.6, 1.0]`, and neither column name says so.
+    attr_accessor :orders_by
+
+    # What this stage produced, as a tagged union. Declared kind, so contract chaining compares kinds rather than inferring them — through [`StageOutput::kind`] rather than a bare field.
+    attr_accessor :produced
+
+    # Present iff `disposition` is `refused` — the reason and standing-aware detail of the runtime refusal (`embedding_unavailable` is the only current case; the vocabulary is open). Ruled ADJ-3 `[2026-08-10, Pete]`: the contract's \"one behaviour\" promise requires the reason to reach the reader, so [`super::disposition::ActRefusal`] is resurrected from declared-unreachable to the carrier.  **The pair rule**: [`super::trace::StageTrace`] carries an identical field, and the two must stay identical for the same reason as the input numbers — the trace covers every stage and the results only the returned ones, so disagreeing copies would leave a reader with no way to tell which was right.
+    attr_accessor :refusal
+
+    # The APPLIED value of every admitted term, beside what was asked. Generalizes the `regions_effective` pattern the audit calls \"a model of an honest knob\" — which existed for exactly one term and was never extended to `limit` or `depth`.  There is no separate \"you were clamped\" flag, deliberately `[decided — 2026-08-03, Pete]`: ceilings are published per act, so the applied value is the whole story. Clamping to a ceiling nobody published would be the bug. This covers only terms the act ADMITS — one it does not is refused outright.
+    attr_accessor :terms_applied
+
+    # Carried only by acts that can produce one WITHOUT a second query. Never by a composition.
+    attr_accessor :total
+
+    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
+      {
+        :'act' => :'act',
+        :'disclosed_regions' => :'disclosed_regions',
+        :'disposition' => :'disposition',
+        :'extent' => :'extent',
+        :'input_ids' => :'input_ids',
+        :'input_unusable' => :'input_unusable',
+        :'narrowed_by' => :'narrowed_by',
+        :'orders_by' => :'orders_by',
+        :'produced' => :'produced',
+        :'refusal' => :'refusal',
+        :'terms_applied' => :'terms_applied',
+        :'total' => :'total'
+      }
+    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
+      {
+        :'act' => :'ActName',
+        :'disclosed_regions' => :'Array<RegionDisclosure>',
+        :'disposition' => :'StageDisposition',
+        :'extent' => :'Extent',
+        :'input_ids' => :'Integer',
+        :'input_unusable' => :'Integer',
+        :'narrowed_by' => :'Array<NarrowedBy>',
+        :'orders_by' => :'ActQuantity',
+        :'produced' => :'StageOutput',
+        :'refusal' => :'ActRefusal',
+        :'terms_applied' => :'Hash<String, Integer>',
+        :'total' => :'Integer'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'orders_by',
+        :'refusal',
+        :'total'
+      ])
+    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::StageResult` 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::StageResult`. 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?(:'act')
+        self.act = attributes[:'act']
+      else
+        self.act = nil
+      end
+
+      if attributes.key?(:'disclosed_regions')
+        if (value = attributes[:'disclosed_regions']).is_a?(Array)
+          self.disclosed_regions = value
+        end
+      end
+
+      if attributes.key?(:'disposition')
+        self.disposition = attributes[:'disposition']
+      else
+        self.disposition = nil
+      end
+
+      if attributes.key?(:'extent')
+        self.extent = attributes[:'extent']
+      else
+        self.extent = nil
+      end
+
+      if attributes.key?(:'input_ids')
+        self.input_ids = attributes[:'input_ids']
+      else
+        self.input_ids = nil
+      end
+
+      if attributes.key?(:'input_unusable')
+        self.input_unusable = attributes[:'input_unusable']
+      else
+        self.input_unusable = nil
+      end
+
+      if attributes.key?(:'narrowed_by')
+        if (value = attributes[:'narrowed_by']).is_a?(Array)
+          self.narrowed_by = value
+        end
+      else
+        self.narrowed_by = nil
+      end
+
+      if attributes.key?(:'orders_by')
+        self.orders_by = attributes[:'orders_by']
+      end
+
+      if attributes.key?(:'produced')
+        self.produced = attributes[:'produced']
+      else
+        self.produced = nil
+      end
+
+      if attributes.key?(:'refusal')
+        self.refusal = attributes[:'refusal']
+      end
+
+      if attributes.key?(:'terms_applied')
+        if (value = attributes[:'terms_applied']).is_a?(Hash)
+          self.terms_applied = value
+        end
+      else
+        self.terms_applied = nil
+      end
+
+      if attributes.key?(:'total')
+        self.total = attributes[:'total']
+      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 @act.nil?
+        invalid_properties.push('invalid value for "act", act cannot be nil.')
+      end
+
+      if @disposition.nil?
+        invalid_properties.push('invalid value for "disposition", disposition cannot be nil.')
+      end
+
+      if @extent.nil?
+        invalid_properties.push('invalid value for "extent", extent cannot be nil.')
+      end
+
+      if @input_ids.nil?
+        invalid_properties.push('invalid value for "input_ids", input_ids cannot be nil.')
+      end
+
+      if @input_unusable.nil?
+        invalid_properties.push('invalid value for "input_unusable", input_unusable cannot be nil.')
+      end
+
+      if @narrowed_by.nil?
+        invalid_properties.push('invalid value for "narrowed_by", narrowed_by cannot be nil.')
+      end
+
+      if @produced.nil?
+        invalid_properties.push('invalid value for "produced", produced cannot be nil.')
+      end
+
+      if @terms_applied.nil?
+        invalid_properties.push('invalid value for "terms_applied", terms_applied 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 @act.nil?
+      return false if @disposition.nil?
+      return false if @extent.nil?
+      return false if @input_ids.nil?
+      return false if @input_unusable.nil?
+      return false if @narrowed_by.nil?
+      return false if @produced.nil?
+      return false if @terms_applied.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] act Value to be assigned
+    def act=(act)
+      if act.nil?
+        fail ArgumentError, 'act cannot be nil'
+      end
+
+      @act = act
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] disposition Value to be assigned
+    def disposition=(disposition)
+      if disposition.nil?
+        fail ArgumentError, 'disposition cannot be nil'
+      end
+
+      @disposition = disposition
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] extent Value to be assigned
+    def extent=(extent)
+      if extent.nil?
+        fail ArgumentError, 'extent cannot be nil'
+      end
+
+      @extent = extent
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] input_ids Value to be assigned
+    def input_ids=(input_ids)
+      if input_ids.nil?
+        fail ArgumentError, 'input_ids cannot be nil'
+      end
+
+      @input_ids = input_ids
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] input_unusable Value to be assigned
+    def input_unusable=(input_unusable)
+      if input_unusable.nil?
+        fail ArgumentError, 'input_unusable cannot be nil'
+      end
+
+      @input_unusable = input_unusable
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] narrowed_by Value to be assigned
+    def narrowed_by=(narrowed_by)
+      if narrowed_by.nil?
+        fail ArgumentError, 'narrowed_by cannot be nil'
+      end
+
+      @narrowed_by = narrowed_by
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] produced Value to be assigned
+    def produced=(produced)
+      if produced.nil?
+        fail ArgumentError, 'produced cannot be nil'
+      end
+
+      @produced = produced
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] terms_applied Value to be assigned
+    def terms_applied=(terms_applied)
+      if terms_applied.nil?
+        fail ArgumentError, 'terms_applied cannot be nil'
+      end
+
+      @terms_applied = terms_applied
+    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 &&
+          act == o.act &&
+          disclosed_regions == o.disclosed_regions &&
+          disposition == o.disposition &&
+          extent == o.extent &&
+          input_ids == o.input_ids &&
+          input_unusable == o.input_unusable &&
+          narrowed_by == o.narrowed_by &&
+          orders_by == o.orders_by &&
+          produced == o.produced &&
+          refusal == o.refusal &&
+          terms_applied == o.terms_applied &&
+          total == o.total
+    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
+      [act, disclosed_regions, disposition, extent, input_ids, input_unusable, narrowed_by, orders_by, produced, refusal, terms_applied, total].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