Class: Insika::Tools::StuckSignal

Inherits:
RubyLLM::Tool
  • Object
show all
Defined in:
lib/insika/tools/stuck_signal.rb

Overview

The agent's deterministic "I cannot proceed" signal (WS5). A system builtin like remember: the model calls it when it determines it cannot continue (out of scope, missing data, a case a human must take over). It ends the turn with outcome: :stuck recorded in the contract (the executor reads state.stuck_outcome at stage 8/9 and tags the terminal event) and a final message: the model's lead-in when it wrote one, else this tool's message.

The ENGINE does not decide what "stuck" means — the consumer does. This tool is the deterministic signal the Agent.Shop subscribes to (:turn_stuck / outcome: "stuck") to run its escalation (CRM/operator, which answers with MessageOrigin::OPERATOR). Nothing about handoff, pause or resume lives here.

Instance Method Summary collapse

Constructor Details

#initialize(state:) ⇒ StuckSignal

Returns a new instance of StuckSignal.



27
28
29
30
 
# File 'lib/insika/tools/stuck_signal.rb', line 27

def initialize(state:, **)
  @state = state
  super()
end

Instance Method Details

#execute(reason:, message: nil) ⇒ Object 



32
33
34
35
36
37
38
39
40
41
 
# File 'lib/insika/tools/stuck_signal.rb', line 32

def execute(reason:, message: nil)
  @state.stuck_outcome = { reason: reason.to_s, message: message.to_s }
  # A Halt ends the tool loop here, so the turn cannot continue after declaring
  # stuck. The payload's `say` is the fallback final message when the model
  # wrote no lead-in (the executor's halt_answer already prefers the lead-in).
  RubyLLM::Tool::Halt.new(Insika::ToolDefinition.wrap_halt(
                            { "reason" => reason.to_s },
                            message.to_s
                          ))
end

#name ⇒ Object 



25
 
# File 'lib/insika/tools/stuck_signal.rb', line 25

def name = "signal_stuck"