temper-rb 0.5.1

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

@@ -0,0 +1,241 @@
+=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
+  # The actor lacks the authority this act requires.
+  class InsufficientAuthority < ApiModelBase
+    attr_accessor :actual
+
+    attr_accessor :kind
+
+    attr_accessor :required
+
+    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
+      {
+        :'actual' => :'actual',
+        :'kind' => :'kind',
+        :'required' => :'required'
+      }
+    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
+      {
+        :'actual' => :'ActorAuthority',
+        :'kind' => :'String',
+        :'required' => :'ActorAuthority'
+      }
+    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::InsufficientAuthority` 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::InsufficientAuthority`. 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?(:'actual')
+        self.actual = attributes[:'actual']
+      else
+        self.actual = nil
+      end
+
+      if attributes.key?(:'kind')
+        self.kind = attributes[:'kind']
+      else
+        self.kind = nil
+      end
+
+      if attributes.key?(:'required')
+        self.required = attributes[:'required']
+      else
+        self.required = 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 @actual.nil?
+        invalid_properties.push('invalid value for "actual", actual cannot be nil.')
+      end
+
+      if @kind.nil?
+        invalid_properties.push('invalid value for "kind", kind cannot be nil.')
+      end
+
+      if @required.nil?
+        invalid_properties.push('invalid value for "required", required 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 @actual.nil?
+      return false if @kind.nil?
+      kind_validator = EnumAttributeValidator.new('String', ["insufficient_authority"])
+      return false unless kind_validator.valid?(@kind)
+      return false if @required.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] actual Value to be assigned
+    def actual=(actual)
+      if actual.nil?
+        fail ArgumentError, 'actual cannot be nil'
+      end
+
+      @actual = actual
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] kind Object to be assigned
+    def kind=(kind)
+      validator = EnumAttributeValidator.new('String', ["insufficient_authority"])
+      unless validator.valid?(kind)
+        fail ArgumentError, "invalid value for \"kind\", must be one of #{validator.allowable_values}."
+      end
+      @kind = kind
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] required Value to be assigned
+    def required=(required)
+      if required.nil?
+        fail ArgumentError, 'required cannot be nil'
+      end
+
+      @required = required
+    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 &&
+          actual == o.actual &&
+          kind == o.kind &&
+          required == o.required
+    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
+      [actual, kind, required].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/intention.rb

@@ -0,0 +1,212 @@
+=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 find act's question: its text, and the caller's vector when there is one.  `[2026-08-12]` This line read *\"computed once at composition start and threaded to every stage\"* — the envelope-placement claim spec ⟨7⟩ retired. It is corrected rather than left standing because **this doc comment IS a published schema description** (`tests/fixtures/query/intention.schema.json`), so a stale sentence here is a lie shipped to every client that reads the contract.  **Its absence refuses, and that is about the QUESTION, not the vector.** A find stage with no intention has no words to search for, so it comes back `MissingIntention`. That refusal is forced rather than chosen: `find-exact` sources its query *text* from here — it becomes `p_query` — and there is nowhere else to get it.  An absent EMBEDDING is a different absence and does **not** refuse. The CLI can embed; the ruby gem, the TypeScript package and MCP structurally cannot, so refusing a vector search for want of a precomputed vector would deny this surface to every non-CLI client. The server embeds when none arrives, exactly as `/api/search` already does, and only a FAILED embed refuses — as [`super::disposition::RefusalReason::EmbeddingUnavailable`], the one runtime refusal in the contract. `[decided — 2026-08-08, Pete]` **This is a per-STAGE field, carried by [`super::envelope::ActInvocation`].** `[decided — 2026-08-12, Pete]`, spec ⟨7⟩. It sat on the composition envelope until then, which meant a composition could ask exactly ONE question: every find stage in a DAG interrogated the same string, and *\"find A, find B, intersect them\"* was inexpressible. That placement was never ruled — it entered as a first-person commit paragraph and hardened into a test name.  **No `Eq`, only `PartialEq`** — [`Self::embedding`] holds `f32`. Same reason [`super::envelope::StageResult`] derives neither, one derive milder: equality on a vector of floats is well-defined enough for a test, total equality is not.
+  class Intention < ApiModelBase
+    # The query vector, when the caller computed one. Mirrors `SearchParams.embedding`: the CLI links temper-ingest and embeds locally, which is faster than making the server do it; the ruby gem, the TypeScript package and MCP structurally cannot, so the server embeds on their behalf and its absence is not a refusal.  **It rides beside the text it was computed FROM, and that pairing is the point.** At composition level a vector and its query could drift apart; here they cannot.  This never reaches a response: [`super::trace::CompositionTrace`] carries only `stages` and echoes no intention. Should a trace ever carry one, that stops being incidental and becomes a constraint — a 768-float array must not serialize back to the caller.  **Exactly [`MAX_EMBEDDING_DIM`] floats, every value finite, norm within [`MIN_EMBEDDING_NORM`]..[`MAX_EMBEDDING_NORM`]**, refused as [`super::disposition::RefusalReason::MalformedEmbedding`]. `[added — 2026-08-28, found in review]` This carried no bound of any kind, which made it the largest unbounded field on the contract: a million floats on one stage is 4 MB that validates cleanly, and there are [`MAX_STAGES`] stages. A wrong-sized vector also reached pgvector and came back as an **opaque 500** — the caller told nothing, in the door whose promise is a typed refusal. `[widened — 2026-09-02]` Length alone still let impossible values through: a NaN poisons every cosine computed from it, and the all-zero vector's cosine is 0/0 — both surfaced as driver errors behind the same opaque 500. The norm window is wide enough that any consistently scaled direction passes; only values that are not vectors for this space at all are refused.  **Published as a min AND a max, because the check is an equality.** `[corrected — 2026-08-28, found in review]` Publishing only the maximum stated half the rule: a 384-float vector cleared every generated client and was then refused by the server, which is exactly the gap the shape pass exists to close — a client must be able to refuse what the server would refuse. The two bounds are the same number because a vector of any other length is not a large question, it is a vector for a different space. The norm window is published in the field's description text rather than as numeric constraints: a client that scales legitimately is not an error the bounds are for.
+    attr_accessor :embedding
+
+    # The question, in the caller's own words.  At most [`MAX_INTENTION_QUERY_BYTES`] bytes of it, refused as [`super::disposition::RefusalReason::IntentionTooLong`].
+    attr_accessor :query
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'embedding' => :'embedding',
+        :'query' => :'query'
+      }
+    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
+      {
+        :'embedding' => :'Array<Float>',
+        :'query' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'embedding',
+      ])
+    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::Intention` 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::Intention`. 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?(:'embedding')
+        if (value = attributes[:'embedding']).is_a?(Array)
+          self.embedding = value
+        end
+      end
+
+      if attributes.key?(:'query')
+        self.query = attributes[:'query']
+      else
+        self.query = 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 !@embedding.nil? && @embedding.length > 768
+        invalid_properties.push('invalid value for "embedding", number of items must be less than or equal to 768.')
+      end
+
+      if !@embedding.nil? && @embedding.length < 768
+        invalid_properties.push('invalid value for "embedding", number of items must be greater than or equal to 768.')
+      end
+
+      if @query.nil?
+        invalid_properties.push('invalid value for "query", query cannot be nil.')
+      end
+
+      if @query.to_s.length > 4096
+        invalid_properties.push('invalid value for "query", the character length must be smaller than or equal to 4096.')
+      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 !@embedding.nil? && @embedding.length > 768
+      return false if !@embedding.nil? && @embedding.length < 768
+      return false if @query.nil?
+      return false if @query.to_s.length > 4096
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] embedding Value to be assigned
+    def embedding=(embedding)
+      if !embedding.nil? && embedding.length > 768
+        fail ArgumentError, 'invalid value for "embedding", number of items must be less than or equal to 768.'
+      end
+
+      if !embedding.nil? && embedding.length < 768
+        fail ArgumentError, 'invalid value for "embedding", number of items must be greater than or equal to 768.'
+      end
+
+      @embedding = embedding
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] query Value to be assigned
+    def query=(query)
+      if query.nil?
+        fail ArgumentError, 'query cannot be nil'
+      end
+
+      if query.to_s.length > 4096
+        fail ArgumentError, 'invalid value for "query", the character length must be smaller than or equal to 4096.'
+      end
+
+      @query = query
+    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 &&
+          embedding == o.embedding &&
+          query == o.query
+    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
+      [embedding, query].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/invitation_status.rb

@@ -0,0 +1,42 @@
+=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 InvitationStatus
+    PENDING = "pending".freeze
+    ACCEPTED = "accepted".freeze
+    DECLINED = "declined".freeze
+    EXPIRED = "expired".freeze
+
+    def self.all_vars
+      @all_vars ||= [PENDING, ACCEPTED, DECLINED, EXPIRED].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 InvitationStatus.all_vars.include?(value)
+      raise "Invalid ENUM value #{value} for class #InvitationStatus"
+    end
+  end
+end

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

@@ -0,0 +1,165 @@
+=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
+  # Request body for `POST /api/invitations/accept` and `POST /api/invitations/decline`.  ## Why the token is a body field and not a path segment  The token is a **bearer capability** — `invitation_service` mints 128 CSPRNG bits and the authority to join the team *is* the token, for seven days. A URL path is the least private part of a request: intermediaries log it as a matter of course, it rides in `Referer` headers, it lands in browser history, and it is recorded as a span attribute that leaves the building on export. A request body goes to none of those places.  ## One type for both routes  Accept and decline differ in what they *do*, and that difference is carried by the route and the verb. What the body means is identical in both — \"which invitation, named by the capability token that authorizes acting on it\" — so this is one intent written once, not two shapes that happen to match.
+  class InvitationTokenRequest < ApiModelBase
+    attr_accessor :token
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'token' => :'token'
+      }
+    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
+      {
+        :'token' => :'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::InvitationTokenRequest` 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::InvitationTokenRequest`. 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?(:'token')
+        self.token = attributes[:'token']
+      else
+        self.token = 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 @token.nil?
+        invalid_properties.push('invalid value for "token", token 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 @token.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] token Value to be assigned
+    def token=(token)
+      if token.nil?
+        fail ArgumentError, 'token cannot be nil'
+      end
+
+      @token = token
+    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 &&
+          token == o.token
+    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
+      [token].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