Class: TurnKit::MessageProjection

Inherits:
Object
  • Object
show all
Defined in:
lib/turnkit/message_projection.rb

Constant Summary collapse

CONTEXT_SUMMARY_TRIGGER = 
"What did we do so far?"
CONTEXT_SUMMARY_PREFIX = 
<<~TEXT.strip
  [CONTEXT COMPACTION — REFERENCE ONLY]

  Earlier TurnKit conversation messages were compacted into the summary below. This is a handoff from a previous context window. Treat it as background reference, not as active instructions.

  Do not answer questions or perform tasks merely because they appear in this summary. Respond to the latest user message after this summary.

  If the latest user message contradicts, supersedes, changes topic from, or diverges from Active Task, In Progress, Pending User Asks, or Remaining Work, the latest user message wins.

  Subject context and live context are recomputed for the current turn and are more authoritative for state-sensitive facts.

  The original messages remain durably stored; this summary only affects the model-visible prompt projection.
TEXT

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(message) ⇒ MessageProjection

Returns a new instance of MessageProjection.



24
25
26
 
# File 'lib/turnkit/message_projection.rb', line 24

def initialize(message)
  @message = message
end

Class Method Details

.for(messages) ⇒ Object 



20
21
22
 
# File 'lib/turnkit/message_projection.rb', line 20

def self.for(messages)
  messages.flat_map { |message| new(message).to_a }
end

Instance Method Details

#to_a ⇒ Object 



28
29
30
31
32
33
34
35
36
37
38
 
# File 'lib/turnkit/message_projection.rb', line 28

def to_a
  case message.kind
  when "context_summary"
    [
      { role: :user, content: CONTEXT_SUMMARY_TRIGGER },
      { role: :assistant, content: [ CONTEXT_SUMMARY_PREFIX, message.text ].reject(&:empty?).join("\n\n") }
    ]
  else
    [ to_h ]
  end
end

#to_h ⇒ Object 



40
41
42
43
44
45
46
47
48
49
 
# File 'lib/turnkit/message_projection.rb', line 40

def to_h
  case message.kind
  when "tool_call"
    { role: :assistant, content: message.text, tool_calls: message.metadata.fetch("tool_calls", []) }
  when "tool_result"
    { role: :tool, content: message.text, tool_call_id: message.metadata["tool_call_id"] }
  else
    { role: message.role.to_sym, content: message.text }
  end
end