Class: Legion::Extensions::Llm::Inventory::ProbeRequest

Inherits:
Data
  • Object
show all
Defined in:
lib/legion/extensions/llm/inventory/probe_token.rb

Overview

A process-local enqueue value asking the owning provider actor to run its safe readiness operation. Grants no registry mutation authority and carries no authorization secret. See section 11.2.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(instance_key:, publisher_token_id:, unavailable_revision:, reason:) ⇒ ProbeRequest

Returns a new instance of ProbeRequest.

Raises:



119
120
121
122
123
124
125
126
127
128
 
# File 'lib/legion/extensions/llm/inventory/probe_token.rb', line 119

def initialize(instance_key:, publisher_token_id:, unavailable_revision:, reason:)
  raise Errors::ValidationError, 'instance_key must be an InstanceKey' unless instance_key.is_a?(Identity::InstanceKey)
  raise Errors::ValidationError, 'publisher_token_id must be a nonempty ptok:v1: String' unless publisher_token_id.is_a?(::String) && publisher_token_id.start_with?('ptok:v1:')
  raise Errors::ValidationError, 'unavailable_revision must be a positive Integer' unless unavailable_revision.is_a?(::Integer) && unavailable_revision.positive?

  super(
    instance_key: instance_key, publisher_token_id: publisher_token_id.dup.freeze,
    unavailable_revision: unavailable_revision, reason: sanitized_reason(reason)
  )
end

Instance Attribute Details

#instance_key ⇒ Object (readonly)

Returns the value of attribute instance_key

Returns:

  • (Object) —

    the current value of instance_key



118
119
120
 
# File 'lib/legion/extensions/llm/inventory/probe_token.rb', line 118

def instance_key
  @instance_key
end

#publisher_token_id ⇒ Object (readonly)

Returns the value of attribute publisher_token_id

Returns:

  • (Object) —

    the current value of publisher_token_id



118
119
120
 
# File 'lib/legion/extensions/llm/inventory/probe_token.rb', line 118

def publisher_token_id
  @publisher_token_id
end

#reason ⇒ Object (readonly)

Returns the value of attribute reason

Returns:

  • (Object) —

    the current value of reason



118
119
120
 
# File 'lib/legion/extensions/llm/inventory/probe_token.rb', line 118

def reason
  @reason
end

#unavailable_revision ⇒ Object (readonly)

Returns the value of attribute unavailable_revision

Returns:

  • (Object) —

    the current value of unavailable_revision



118
119
120
 
# File 'lib/legion/extensions/llm/inventory/probe_token.rb', line 118

def unavailable_revision
  @unavailable_revision
end

Instance Method Details

#sanitized_reason(reason) ⇒ Object

Raises:



130
131
132
133
134
135
136
137
138
139
140
141
 
# File 'lib/legion/extensions/llm/inventory/probe_token.rb', line 130

def sanitized_reason(reason)
  unless reason.is_a?(::String) &&
         [::Encoding::UTF_8, ::Encoding::US_ASCII].include?(reason.encoding) && reason.valid_encoding?
    raise Errors::ValidationError, 'reason must be a valid UTF-8 String'
  end

  trimmed = reason.strip
  raise Errors::ValidationError, 'reason must not be empty' if trimmed.empty?
  raise Errors::ValidationError, 'reason exceeds 1024 UTF-8 bytes' if trimmed.bytesize > 1024

  trimmed.b.dup.force_encoding(::Encoding::UTF_8).freeze
end