Class: Riffer::Skills::Config

Inherits:
Object
  • Object
show all
Defined in:
lib/riffer/skills/config.rb

Overview

Configuration object for the skills block DSL.

Used inside the skills block on Riffer::Agent:

skills do
  backend Riffer::Skills::FilesystemBackend.new(".skills")
  adapter Riffer::Skills::XmlAdapter
  activate ["code-review"]
end

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Config

Creates a new Config with all options unset.

– : () -> void



18
19
20
21
22
23
 
# File 'lib/riffer/skills/config.rb', line 18

def initialize
  @backend = nil
  @adapter = nil
  @activate = nil
  @activate_tool = nil
end

Instance Method Details

#activate(value = nil) ⇒ Object

Gets or sets skill names to activate at startup.

Activated skills have their full body included in the system prompt without requiring a tool call.

Accepts an array of skill name strings or a Proc that receives context and returns an array of names.

– : (?(Array | Proc)?) -> (Array | Proc)?



59
60
61
62
 
# File 'lib/riffer/skills/config.rb', line 59

def activate(value = nil)
  return @activate if value.nil?
  @activate = value
end

#activate_tool(value = nil) ⇒ Object

Gets or sets the per-agent override for the skill activation tool class.

Returns the configured override when set, or nil when unset. The global fallback to Riffer.config.skills.default_activate_tool is applied by the agent at resolution time (see Riffer::Agent.resolved_tool_classes), not by this getter.

The override must be a subclass of Riffer::Tool.

– : (?singleton(Riffer::Tool)?) -> singleton(Riffer::Tool)?

Raises:



75
76
77
78
79
 
# File 'lib/riffer/skills/config.rb', line 75

def activate_tool(value = nil)
  return @activate_tool if value.nil?
  raise Riffer::ArgumentError, "activate_tool must be a Riffer::Tool subclass" unless value.is_a?(Class) && value < Riffer::Tool
  @activate_tool = value
end

#adapter(value = nil) ⇒ Object

Gets or sets a custom skill adapter class.

Must be a subclass of Riffer::Skills::Adapter. Defaults to the provider’s preferred adapter.

– : (?singleton(Riffer::Skills::Adapter)?) -> singleton(Riffer::Skills::Adapter)?



44
45
46
47
 
# File 'lib/riffer/skills/config.rb', line 44

def adapter(value = nil)
  return @adapter if value.nil?
  @adapter = value
end

#backend(value = nil) ⇒ Object

Gets or sets the skills backend.

Accepts a Riffer::Skills::Backend instance, or a Proc that receives context and returns a Backend.

– : (?(Riffer::Skills::Backend | Proc)?) -> (Riffer::Skills::Backend | Proc)?



32
33
34
35
 
# File 'lib/riffer/skills/config.rb', line 32

def backend(value = nil)
  return @backend if value.nil?
  @backend = value
end