Class: PromptBuilder::Items::Base

Inherits:

Object

• Object
• PromptBuilder::Items::Base

Defined in:

lib/prompt_builder/items/base.rb

Overview

Base class for conversation items. Provides polymorphic deserialization via the type field in the hash representation.

Direct Known Subclasses

Compaction, FunctionCall, FunctionCallOutput, ItemReference, Message, Reasoning

Constant Summary

TYPES =

Item type registry for polymorphic dispatch.

{
  "compaction" => "Compaction",
  "function_call" => "FunctionCall",
  "function_call_output" => "FunctionCallOutput",
  "item_reference" => "ItemReference",
  "message" => "Message",
  "reasoning" => "Reasoning"
}.freeze

Class Method Summary

• .from_h(hash) ⇒ Items::Base

  Deserialize an item from a Hash by dispatching on the type field.

Instance Method Summary

• #to_h ⇒ Hash

  Serialize the item to a Hash with string keys.

Class Method Details

.from_h(hash) ⇒ Items::Base

Deserialize an item from a Hash by dispatching on the type field.

Parameters:

• hash (Hash) —

  a Hash with string keys including a “type” field

Returns:

• (Items::Base) —

  the deserialized item

Raises:

• (InvalidItemError) —

  if the type is unknown

# File 'lib/prompt_builder/items/base.rb', line 24

def from_h(hash)
  type = hash["type"]
  class_name = TYPES[type]
  raise InvalidItemError, "Unknown item type: #{type.inspect}" unless class_name

  Items.const_get(class_name).from_h(hash)
end

Instance Method Details

#to_h ⇒ Hash

Serialize the item to a Hash with string keys.

Returns:

• (Hash) —

  the hash representation

Raises:

• (NotImplementedError)

# File 'lib/prompt_builder/items/base.rb', line 36

def to_h
  raise NotImplementedError
end