riffer 0.56.0 → 0.57.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.release-please-manifest.json +1 -1
- data/CHANGELOG.md +26 -0
- data/README.md +1 -1
- data/docs/AGENTS.md +105 -50
- data/docs/AGENT_LIFECYCLE.md +1 -1
- data/docs/CONFIGURATION.md +7 -3
- data/docs/EVALS.md +2 -0
- data/docs/MCP.md +36 -0
- data/docs/MESSAGES.md +13 -0
- data/docs/OVERVIEW.md +7 -7
- data/docs/SERIALIZATION.md +12 -2
- data/docs/SKILLS.md +1 -1
- data/docs/STABILITY.md +1 -1
- data/docs/TOOLS.md +93 -37
- data/docs/TOOL_ADVANCED.md +7 -0
- data/docs/providers/AMAZON_BEDROCK.md +6 -2
- data/docs/providers/ANTHROPIC.md +35 -2
- data/docs/providers/AZURE_OPENAI.md +9 -3
- data/docs/providers/CUSTOM_PROVIDERS.md +19 -0
- data/docs/providers/GEMINI.md +8 -4
- data/docs/providers/GOOGLE_CLOUD.md +10 -5
- data/docs/providers/MOCK_PROVIDER.md +2 -0
- data/docs/providers/OPENAI.md +25 -3
- data/docs/providers/OPENROUTER.md +11 -3
- data/docs/providers/PROVIDERS.md +1 -1
- data/docs-site/index.html.erb +1 -1
- data/lib/riffer/agent/config.rb +21 -0
- data/lib/riffer/agent/context.rb +36 -18
- data/lib/riffer/agent/run.rb +54 -8
- data/lib/riffer/agent/serializer.rb +5 -0
- data/lib/riffer/agent/session.rb +1 -0
- data/lib/riffer/agent.rb +43 -0
- data/lib/riffer/config/mcp.rb +17 -0
- data/lib/riffer/config/pricing.rb +2 -2
- data/lib/riffer/config.rb +12 -1
- data/lib/riffer/evals/evaluator.rb +8 -1
- data/lib/riffer/evals/evaluator_runner.rb +1 -0
- data/lib/riffer/evals/judge.rb +2 -2
- data/lib/riffer/evals.rb +2 -0
- data/lib/riffer/mcp/search_tool.rb +1 -1
- data/lib/riffer/mcp.rb +7 -0
- data/lib/riffer/messages/tool.rb +6 -2
- data/lib/riffer/params/any_of.rb +5 -8
- data/lib/riffer/params/boolean.rb +1 -1
- data/lib/riffer/params/param.rb +96 -67
- data/lib/riffer/params.rb +50 -71
- data/lib/riffer/providers/anthropic_compatible/messages_api/stream.rb +3 -10
- data/lib/riffer/providers/anthropic_compatible/messages_api.rb +89 -13
- data/lib/riffer/providers/anthropic_vertex.rb +7 -0
- data/lib/riffer/providers/base.rb +43 -7
- data/lib/riffer/providers/deferred_tool_gateway/sink.rb +54 -0
- data/lib/riffer/providers/deferred_tool_gateway/tool.rb +17 -0
- data/lib/riffer/providers/deferred_tool_gateway.rb +150 -0
- data/lib/riffer/providers/gemini.rb +5 -5
- data/lib/riffer/providers/mock.rb +6 -0
- data/lib/riffer/providers/open_ai.rb +38 -10
- data/lib/riffer/skills/activate_tool.rb +1 -1
- data/lib/riffer/tool.rb +92 -2
- data/lib/riffer/tools/response.rb +11 -2
- data/lib/riffer/version.rb +1 -1
- data/sig/generated/riffer/agent/config.rbs +13 -1
- data/sig/generated/riffer/agent/context.rbs +16 -0
- data/sig/generated/riffer/agent/run.rbs +14 -2
- data/sig/generated/riffer/agent.rbs +13 -0
- data/sig/generated/riffer/config/mcp.rbs +7 -0
- data/sig/generated/riffer/config.rbs +5 -1
- data/sig/generated/riffer/evals/evaluator.rbs +4 -0
- data/sig/generated/riffer/evals.rbs +1 -0
- data/sig/generated/riffer/mcp.rbs +1 -0
- data/sig/generated/riffer/messages/tool.rbs +4 -2
- data/sig/generated/riffer/params/any_of.rbs +4 -4
- data/sig/generated/riffer/params/boolean.rbs +1 -1
- data/sig/generated/riffer/params/param.rbs +28 -14
- data/sig/generated/riffer/params.rbs +20 -20
- data/sig/generated/riffer/providers/anthropic_compatible/messages_api/stream.rbs +2 -5
- data/sig/generated/riffer/providers/anthropic_compatible/messages_api.rbs +34 -2
- data/sig/generated/riffer/providers/anthropic_vertex.rbs +5 -0
- data/sig/generated/riffer/providers/base.rbs +13 -0
- data/sig/generated/riffer/providers/deferred_tool_gateway/sink.rbs +23 -0
- data/sig/generated/riffer/providers/deferred_tool_gateway/tool.rbs +4 -0
- data/sig/generated/riffer/providers/deferred_tool_gateway.rbs +58 -0
- data/sig/generated/riffer/providers/mock.rbs +4 -0
- data/sig/generated/riffer/providers/open_ai.rbs +16 -4
- data/sig/generated/riffer/tool.rbs +48 -2
- data/sig/generated/riffer/tools/response.rbs +9 -2
- data/sig/manual/riffer/providers/deferred_tool_gateway.rbs +5 -0
- metadata +8 -3
- data/lib/riffer/tools/toolable.rb +0 -113
- data/sig/generated/riffer/tools/toolable.rbs +0 -66
|
@@ -21,6 +21,12 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
|
|
|
21
21
|
"queued" => :other,
|
|
22
22
|
}.freeze #: Hash[String, Symbol | Hash[String, Symbol]]
|
|
23
23
|
|
|
24
|
+
#--
|
|
25
|
+
#: () -> bool
|
|
26
|
+
def self.supports_deferred_tools?
|
|
27
|
+
true
|
|
28
|
+
end
|
|
29
|
+
|
|
24
30
|
#--
|
|
25
31
|
#: () -> String
|
|
26
32
|
def self.semconv_provider_name
|
|
@@ -75,13 +81,13 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
|
|
|
75
81
|
tags = options[:tags] || {}
|
|
76
82
|
|
|
77
83
|
params = {
|
|
78
|
-
input: convert_messages_to_openai_format(messages),
|
|
84
|
+
input: convert_messages_to_openai_format(messages, deferred_tools: options[:deferred_tools] || []),
|
|
79
85
|
model: model,
|
|
80
86
|
reasoning: reasoning && {
|
|
81
87
|
effort: reasoning,
|
|
82
88
|
summary: "auto",
|
|
83
89
|
},
|
|
84
|
-
**options.except(:reasoning, :tools, :structured_output, :web_search, :tags),
|
|
90
|
+
**options.except(:reasoning, :tools, :structured_output, :web_search, :tags, :deferred_tools),
|
|
85
91
|
} #: Hash[Symbol, untyped]
|
|
86
92
|
|
|
87
93
|
unless tags.empty?
|
|
@@ -392,8 +398,8 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
|
|
|
392
398
|
end
|
|
393
399
|
|
|
394
400
|
#--
|
|
395
|
-
#: (Array[Riffer::Messages::Base]) -> Array[Hash[Symbol, untyped]]
|
|
396
|
-
def convert_messages_to_openai_format(messages)
|
|
401
|
+
#: (Array[Riffer::Messages::Base], deferred_tools: Array[singleton(Riffer::Tool)]) -> Array[Hash[Symbol, untyped]]
|
|
402
|
+
def convert_messages_to_openai_format(messages, deferred_tools:)
|
|
397
403
|
messages.flat_map do |message|
|
|
398
404
|
case message
|
|
399
405
|
when Riffer::Messages::System
|
|
@@ -407,13 +413,17 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
|
|
|
407
413
|
{ role: "user", content: content }
|
|
408
414
|
end
|
|
409
415
|
when Riffer::Messages::Assistant
|
|
410
|
-
convert_assistant_to_openai_format(message)
|
|
416
|
+
convert_assistant_to_openai_format(message, deferred_tools: deferred_tools)
|
|
411
417
|
when Riffer::Messages::Tool
|
|
412
|
-
{
|
|
418
|
+
output = {
|
|
413
419
|
type: "function_call_output",
|
|
414
420
|
call_id: message.tool_call_id,
|
|
415
421
|
output: message.content,
|
|
416
422
|
}
|
|
423
|
+
loaded = loaded_deferred_tools(message, deferred_tools)
|
|
424
|
+
# A repeat load is sent again: a load that brings no definitions leaves the model unsure it worked, and
|
|
425
|
+
# it keeps calling the loading tool instead of the loaded one.
|
|
426
|
+
loaded.empty? ? output : [output, convert_additional_tools_to_openai_format(loaded)]
|
|
417
427
|
else
|
|
418
428
|
raise Riffer::ArgumentError, "unsupported message type: #{message.class}"
|
|
419
429
|
end
|
|
@@ -421,8 +431,22 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
|
|
|
421
431
|
end
|
|
422
432
|
|
|
423
433
|
#--
|
|
424
|
-
#: (Riffer::Messages::
|
|
425
|
-
def
|
|
434
|
+
#: (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
|
|
435
|
+
def loaded_deferred_tools(message, deferred_tools)
|
|
436
|
+
return [] if message.error?
|
|
437
|
+
|
|
438
|
+
deferred_tools.select { |tool| message.loaded_tools.include?(tool.name) }
|
|
439
|
+
end
|
|
440
|
+
|
|
441
|
+
#--
|
|
442
|
+
#: (Array[singleton(Riffer::Tool)]) -> Hash[Symbol, untyped]
|
|
443
|
+
def convert_additional_tools_to_openai_format(tools)
|
|
444
|
+
{ type: "additional_tools", role: "developer", tools: tools.map { |tool| convert_tool_to_openai_format(tool) } }
|
|
445
|
+
end
|
|
446
|
+
|
|
447
|
+
#--
|
|
448
|
+
#: (Riffer::Messages::Assistant, deferred_tools: Array[singleton(Riffer::Tool)]) -> Array[Hash[Symbol, untyped]]
|
|
449
|
+
def convert_assistant_to_openai_format(message, deferred_tools:)
|
|
426
450
|
items = convert_reasoning_to_openai_format(message.reasoning)
|
|
427
451
|
|
|
428
452
|
if message.tool_calls.empty?
|
|
@@ -433,12 +457,16 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
|
|
|
433
457
|
content: message.content, }
|
|
434
458
|
end
|
|
435
459
|
message.tool_calls.each do |tc|
|
|
460
|
+
name = encode_tool_name(tc.name)
|
|
436
461
|
items << {
|
|
437
462
|
type: "function_call",
|
|
438
463
|
call_id: tc.call_id,
|
|
439
|
-
name:
|
|
464
|
+
name: name,
|
|
465
|
+
# The API rejects a replayed call to a tool loaded through additional_tools unless it carries the
|
|
466
|
+
# namespace the model returned, which is always the tool's own name; it accepts one on an unloaded call too.
|
|
467
|
+
namespace: (name if deferred_tools.any? { |tool| tool.name == tc.name }),
|
|
440
468
|
arguments: tc.arguments,
|
|
441
|
-
}
|
|
469
|
+
}.compact
|
|
442
470
|
end
|
|
443
471
|
end
|
|
444
472
|
|
data/lib/riffer/tool.rb
CHANGED
|
@@ -4,10 +4,94 @@
|
|
|
4
4
|
require "timeout"
|
|
5
5
|
|
|
6
6
|
class Riffer::Tool
|
|
7
|
-
extend Riffer::Tools::Toolable
|
|
8
7
|
extend Riffer::Registrable
|
|
9
8
|
|
|
10
|
-
|
|
9
|
+
# @rbs self.@description: String?
|
|
10
|
+
# @rbs self.@identifier: String?
|
|
11
|
+
# @rbs self.@timeout: (Integer | Float)?
|
|
12
|
+
# @rbs self.@params_builder: Riffer::Params?
|
|
13
|
+
|
|
14
|
+
DEFAULT_TIMEOUT = 10 #: Integer
|
|
15
|
+
|
|
16
|
+
class << self
|
|
17
|
+
#--
|
|
18
|
+
#: (?String?) -> String?
|
|
19
|
+
def description(value = nil)
|
|
20
|
+
return @description if value.nil?
|
|
21
|
+
|
|
22
|
+
@description = value.to_s
|
|
23
|
+
end
|
|
24
|
+
|
|
25
|
+
#--
|
|
26
|
+
#: (?String?) -> String
|
|
27
|
+
def identifier(value = nil)
|
|
28
|
+
return @identifier || Riffer::Helpers::Identifier.for(self) if value.nil?
|
|
29
|
+
|
|
30
|
+
@identifier = value.to_s
|
|
31
|
+
end
|
|
32
|
+
|
|
33
|
+
#--
|
|
34
|
+
#: (?String?) -> String
|
|
35
|
+
def name(value = nil)
|
|
36
|
+
return identifier(value) if value
|
|
37
|
+
|
|
38
|
+
identifier
|
|
39
|
+
end
|
|
40
|
+
|
|
41
|
+
#--
|
|
42
|
+
#: (?(Integer | Float)?) -> (Integer | Float)
|
|
43
|
+
def timeout(value = nil)
|
|
44
|
+
return @timeout || DEFAULT_TIMEOUT if value.nil?
|
|
45
|
+
|
|
46
|
+
@timeout = value.to_f
|
|
47
|
+
end
|
|
48
|
+
|
|
49
|
+
#--
|
|
50
|
+
#: () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
|
|
51
|
+
def params(&block)
|
|
52
|
+
return @params_builder if block.nil?
|
|
53
|
+
|
|
54
|
+
builder = Riffer::Params.new
|
|
55
|
+
builder.instance_eval(&block)
|
|
56
|
+
@params_builder = builder
|
|
57
|
+
end
|
|
58
|
+
|
|
59
|
+
#--
|
|
60
|
+
#: (?strict: bool) -> Hash[Symbol, untyped]
|
|
61
|
+
def parameters_schema(strict: false)
|
|
62
|
+
@params_builder&.to_json_schema(strict: strict) || empty_schema
|
|
63
|
+
end
|
|
64
|
+
|
|
65
|
+
#--
|
|
66
|
+
#: (?strict: bool) -> Hash[Symbol, untyped]
|
|
67
|
+
def to_tool_schema(strict: false)
|
|
68
|
+
{
|
|
69
|
+
name: name,
|
|
70
|
+
description: description,
|
|
71
|
+
parameters_schema: parameters_schema(strict: strict),
|
|
72
|
+
}
|
|
73
|
+
end
|
|
74
|
+
|
|
75
|
+
#--
|
|
76
|
+
#: () -> true
|
|
77
|
+
def validate_as_tool!
|
|
78
|
+
if description.nil? || description.to_s.strip.empty?
|
|
79
|
+
raise Riffer::ArgumentError,
|
|
80
|
+
"#{self} must define a description"
|
|
81
|
+
end
|
|
82
|
+
raise Riffer::ArgumentError, "#{self} must have an identifier" if identifier.nil? || identifier.to_s.strip.empty?
|
|
83
|
+
|
|
84
|
+
true
|
|
85
|
+
end
|
|
86
|
+
|
|
87
|
+
private
|
|
88
|
+
|
|
89
|
+
def empty_schema # :nodoc:
|
|
90
|
+
properties = {} #: Hash[Symbol, untyped]
|
|
91
|
+
required = [] #: Array[untyped]
|
|
92
|
+
{ type: "object", properties: properties, required: required, additionalProperties: false }
|
|
93
|
+
end
|
|
94
|
+
end
|
|
11
95
|
|
|
12
96
|
#--
|
|
13
97
|
#: (context: Riffer::Agent::Context?, **untyped) -> Riffer::Tools::Response
|
|
@@ -27,6 +111,12 @@ class Riffer::Tool
|
|
|
27
111
|
Riffer::Tools::Response.json(result)
|
|
28
112
|
end
|
|
29
113
|
|
|
114
|
+
#--
|
|
115
|
+
#: (Array[singleton(Riffer::Tool)]) -> Riffer::Tools::Response
|
|
116
|
+
def load_tools(tools)
|
|
117
|
+
Riffer::Tools::Response.load_tools(tools)
|
|
118
|
+
end
|
|
119
|
+
|
|
30
120
|
#--
|
|
31
121
|
#: (String, ?type: Symbol) -> Riffer::Tools::Response
|
|
32
122
|
def error(message, type: :execution_error)
|
|
@@ -12,6 +12,7 @@ class Riffer::Tools::Response
|
|
|
12
12
|
attr_reader :content #: String # @dynamic content
|
|
13
13
|
attr_reader :error_message #: String? # @dynamic error_message
|
|
14
14
|
attr_reader :error_type #: Symbol? # @dynamic error_type
|
|
15
|
+
attr_reader :loaded_tools #: Array[singleton(Riffer::Tool)] # @dynamic loaded_tools
|
|
15
16
|
|
|
16
17
|
# Kept out of every serialized form so it never reaches an LLM or a message
|
|
17
18
|
# payload.
|
|
@@ -40,6 +41,13 @@ class Riffer::Tools::Response
|
|
|
40
41
|
success(result, format: :json)
|
|
41
42
|
end
|
|
42
43
|
|
|
44
|
+
# No text alongside: Anthropic rejects a tool result that mixes +tool_reference+ blocks with text.
|
|
45
|
+
#--
|
|
46
|
+
#: (Array[singleton(Riffer::Tool)]) -> Riffer::Tools::Response
|
|
47
|
+
def self.load_tools(tools)
|
|
48
|
+
new(content: "", success: true, loaded_tools: tools)
|
|
49
|
+
end
|
|
50
|
+
|
|
43
51
|
#--
|
|
44
52
|
#: (String, ?type: Symbol, ?exception: Exception?) -> Riffer::Tools::Response
|
|
45
53
|
def self.error(message, type: :execution_error, exception: nil)
|
|
@@ -63,12 +71,13 @@ class Riffer::Tools::Response
|
|
|
63
71
|
private
|
|
64
72
|
|
|
65
73
|
#--
|
|
66
|
-
#: (content: String, success: bool, ?error_message: String?, ?error_type: Symbol?, ?exception: Exception?) -> void
|
|
67
|
-
def initialize(content:, success:, error_message: nil, error_type: nil, exception: nil)
|
|
74
|
+
#: (content: String, success: bool, ?error_message: String?, ?error_type: Symbol?, ?exception: Exception?, ?loaded_tools: Array[singleton(Riffer::Tool)]) -> void
|
|
75
|
+
def initialize(content:, success:, error_message: nil, error_type: nil, exception: nil, loaded_tools: [])
|
|
68
76
|
@content = content
|
|
69
77
|
@success = success
|
|
70
78
|
@error_message = error_message
|
|
71
79
|
@error_type = error_type
|
|
72
80
|
@exception = exception
|
|
81
|
+
@loaded_tools = loaded_tools
|
|
73
82
|
end
|
|
74
83
|
end
|
data/lib/riffer/version.rb
CHANGED
|
@@ -5,6 +5,8 @@ class Riffer::Agent::Config
|
|
|
5
5
|
|
|
6
6
|
STRUCTURED_OUTPUT_STRATEGIES: Array[Symbol]
|
|
7
7
|
|
|
8
|
+
DEFERRED_TOOLS_STRATEGIES: Array[Symbol]
|
|
9
|
+
|
|
8
10
|
REASONING_LEVELS: Array[Symbol]
|
|
9
11
|
|
|
10
12
|
@tool_runtime: (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)?
|
|
@@ -27,6 +29,10 @@ class Riffer::Agent::Config
|
|
|
27
29
|
|
|
28
30
|
attr_accessor tools_config: (Array[singleton(Riffer::Tool)] | Proc)?
|
|
29
31
|
|
|
32
|
+
attr_accessor deferred_tools_config: (Array[singleton(Riffer::Tool)] | Proc)?
|
|
33
|
+
|
|
34
|
+
attr_reader deferred_tools_strategy: Symbol
|
|
35
|
+
|
|
30
36
|
attr_reader mcp_configs: Array[Hash[Symbol, untyped]]
|
|
31
37
|
|
|
32
38
|
attr_accessor skills_config: Riffer::Skills::Config?
|
|
@@ -44,12 +50,14 @@ class Riffer::Agent::Config
|
|
|
44
50
|
# ?max_steps: Numeric?,
|
|
45
51
|
# ?reasoning: (Symbol | String)?,
|
|
46
52
|
# ?tools_config: (Array[singleton(Riffer::Tool)] | Proc)?,
|
|
53
|
+
# ?deferred_tools_config: (Array[singleton(Riffer::Tool)] | Proc)?,
|
|
54
|
+
# ?deferred_tools_strategy: Symbol,
|
|
47
55
|
# ?mcp_configs: Array[Hash[Symbol, untyped]],
|
|
48
56
|
# ?tool_runtime: (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)?,
|
|
49
57
|
# ?skills_config: Riffer::Skills::Config?,
|
|
50
58
|
# ?guardrails: Hash[Symbol, Array[Hash[Symbol, untyped]]]
|
|
51
59
|
# ) -> void
|
|
52
|
-
def initialize: (?identifier: String?, ?model: (String | Proc)?, ?instructions: (String | Proc)?, ?model_options: Hash[Symbol, untyped], ?structured_output: Riffer::Params?, ?structured_output_strategy: Symbol, ?max_steps: Numeric?, ?reasoning: (Symbol | String)?, ?tools_config: (Array[singleton(Riffer::Tool)] | Proc)?, ?mcp_configs: Array[Hash[Symbol, untyped]], ?tool_runtime: (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)?, ?skills_config: Riffer::Skills::Config?, ?guardrails: Hash[Symbol, Array[Hash[Symbol, untyped]]]) -> void
|
|
60
|
+
def initialize: (?identifier: String?, ?model: (String | Proc)?, ?instructions: (String | Proc)?, ?model_options: Hash[Symbol, untyped], ?structured_output: Riffer::Params?, ?structured_output_strategy: Symbol, ?max_steps: Numeric?, ?reasoning: (Symbol | String)?, ?tools_config: (Array[singleton(Riffer::Tool)] | Proc)?, ?deferred_tools_config: (Array[singleton(Riffer::Tool)] | Proc)?, ?deferred_tools_strategy: Symbol, ?mcp_configs: Array[Hash[Symbol, untyped]], ?tool_runtime: (singleton(Riffer::Tools::Runtime) | Riffer::Tools::Runtime | Proc)?, ?skills_config: Riffer::Skills::Config?, ?guardrails: Hash[Symbol, Array[Hash[Symbol, untyped]]]) -> void
|
|
53
61
|
|
|
54
62
|
# --
|
|
55
63
|
# : (untyped) -> String?
|
|
@@ -63,6 +71,10 @@ class Riffer::Agent::Config
|
|
|
63
71
|
# : (Symbol) -> Symbol
|
|
64
72
|
def structured_output_strategy=: (Symbol) -> Symbol
|
|
65
73
|
|
|
74
|
+
# --
|
|
75
|
+
# : (Symbol) -> Symbol
|
|
76
|
+
def deferred_tools_strategy=: (Symbol) -> Symbol
|
|
77
|
+
|
|
66
78
|
# --
|
|
67
79
|
# : ((Symbol | String)?) -> Symbol?
|
|
68
80
|
def reasoning=: ((Symbol | String)?) -> Symbol?
|
|
@@ -47,6 +47,12 @@ class Riffer::Agent::Context
|
|
|
47
47
|
# : (Array[singleton(Riffer::Tool)]?) -> Array[singleton(Riffer::Tool)]?
|
|
48
48
|
def discovered_tools=: (Array[singleton(Riffer::Tool)]?) -> Array[singleton(Riffer::Tool)]?
|
|
49
49
|
|
|
50
|
+
attr_reader deferred_tools: Array[singleton(Riffer::Tool)]?
|
|
51
|
+
|
|
52
|
+
# --
|
|
53
|
+
# : (Array[singleton(Riffer::Tool)]?) -> Array[singleton(Riffer::Tool)]?
|
|
54
|
+
def deferred_tools=: (Array[singleton(Riffer::Tool)]?) -> Array[singleton(Riffer::Tool)]?
|
|
55
|
+
|
|
50
56
|
# --
|
|
51
57
|
# : (Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
|
|
52
58
|
def discover_tools: (Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
|
|
@@ -58,4 +64,14 @@ class Riffer::Agent::Context
|
|
|
58
64
|
# --
|
|
59
65
|
# : () -> Hash[Symbol, untyped]
|
|
60
66
|
def to_h: () -> Hash[Symbol, untyped]
|
|
67
|
+
|
|
68
|
+
private
|
|
69
|
+
|
|
70
|
+
# --
|
|
71
|
+
# : (Symbol, Array[singleton(Riffer::Tool)]?) -> Array[singleton(Riffer::Tool)]?
|
|
72
|
+
def validate_tool_classes: (Symbol, Array[singleton(Riffer::Tool)]?) -> Array[singleton(Riffer::Tool)]?
|
|
73
|
+
|
|
74
|
+
# --
|
|
75
|
+
# : () -> void
|
|
76
|
+
def warn_deferred_tools_key: () -> void
|
|
61
77
|
end
|
|
@@ -57,8 +57,20 @@ module Riffer::Agent::Run
|
|
|
57
57
|
def execute_tool_calls: (Riffer::Agent, Riffer::Messages::Assistant, ?tool_calls: Array[Riffer::Messages::Assistant::ToolCall], ?tags: Hash[String, String]) -> void
|
|
58
58
|
|
|
59
59
|
# --
|
|
60
|
-
# : (
|
|
61
|
-
def
|
|
60
|
+
# : (Array[Riffer::Messages::Base], Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
|
|
61
|
+
def loaded_tools: (Array[Riffer::Messages::Base], Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
|
|
62
|
+
|
|
63
|
+
# --
|
|
64
|
+
# : (Riffer::Agent, Riffer::Tools::Response) -> Riffer::Tools::Response
|
|
65
|
+
def reject_invalid_load: (Riffer::Agent, Riffer::Tools::Response) -> Riffer::Tools::Response
|
|
66
|
+
|
|
67
|
+
# --
|
|
68
|
+
# : (Riffer::Messages::Assistant::ToolCall) -> Riffer::Tools::Response
|
|
69
|
+
def tool_not_loaded: (Riffer::Messages::Assistant::ToolCall) -> Riffer::Tools::Response
|
|
70
|
+
|
|
71
|
+
# --
|
|
72
|
+
# : (Riffer::Agent, Hash[Riffer::Messages::Assistant::ToolCall, Riffer::Tools::Response]) -> void
|
|
73
|
+
def inject_discovered_tools: (Riffer::Agent, Hash[Riffer::Messages::Assistant::ToolCall, Riffer::Tools::Response]) -> void
|
|
62
74
|
|
|
63
75
|
# --
|
|
64
76
|
# : (Riffer::Agent, ?Hash[String, String]) -> void
|
|
@@ -47,6 +47,11 @@ class Riffer::Agent
|
|
|
47
47
|
# : (?(Array[singleton(Riffer::Tool)] | Proc)?) -> (Array[singleton(Riffer::Tool)] | Proc)?
|
|
48
48
|
def self.uses_tools: (?(Array[singleton(Riffer::Tool)] | Proc)?) -> (Array[singleton(Riffer::Tool)] | Proc)?
|
|
49
49
|
|
|
50
|
+
# --
|
|
51
|
+
# : (?(Array[singleton(Riffer::Tool)] | Proc)?, ?strategy: Symbol?) -> (Array[singleton(Riffer::Tool)] | Proc)?
|
|
52
|
+
def self.deferred_tools: (?(Array[singleton(Riffer::Tool)] | Proc)?, ?strategy: Symbol?) -> (Array[singleton(Riffer::Tool)] | Proc)?
|
|
53
|
+
|
|
54
|
+
# @deprecated MCP client support will be removed; wrap the +mcp+ gem in your own Riffer::Tool (see docs/MCP.md).
|
|
50
55
|
# +progressive+ exposes +mcp_search+ instead of every tool schema up front.
|
|
51
56
|
# --
|
|
52
57
|
# : (String | Symbol, ?progressive: bool) -> void
|
|
@@ -118,6 +123,10 @@ class Riffer::Agent
|
|
|
118
123
|
# : () -> String
|
|
119
124
|
def identifier: () -> String
|
|
120
125
|
|
|
126
|
+
# --
|
|
127
|
+
# : () -> Array[singleton(Riffer::Tool)]
|
|
128
|
+
def deferred_tools: () -> Array[singleton(Riffer::Tool)]
|
|
129
|
+
|
|
121
130
|
# --
|
|
122
131
|
# : (?String?, ?files: Array[Hash[Symbol, untyped] | Riffer::Messages::User::FilePart]?, ?tags: Hash[(String | Symbol), untyped]) -> Riffer::Agent::Response
|
|
123
132
|
def generate: (?String?, ?files: Array[Hash[Symbol, untyped] | Riffer::Messages::User::FilePart]?, ?tags: Hash[String | Symbol, untyped]) -> Riffer::Agent::Response
|
|
@@ -170,6 +179,10 @@ class Riffer::Agent
|
|
|
170
179
|
# : () -> Array[singleton(Riffer::Tool)]
|
|
171
180
|
def resolve_tools: () -> Array[singleton(Riffer::Tool)]
|
|
172
181
|
|
|
182
|
+
# --
|
|
183
|
+
# : () -> Array[singleton(Riffer::Tool)]
|
|
184
|
+
def resolve_deferred_tools: () -> Array[singleton(Riffer::Tool)]
|
|
185
|
+
|
|
173
186
|
# --
|
|
174
187
|
# : () -> Riffer::Tools::Runtime
|
|
175
188
|
def resolve_tool_runtime: () -> Riffer::Tools::Runtime
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
# Generated from lib/riffer/config/mcp.rb with RBS::Inline
|
|
2
2
|
|
|
3
|
+
# @deprecated MCP client support will be removed; wrap the +mcp+ gem in your own Riffer::Tool (see docs/MCP.md).
|
|
3
4
|
class Riffer::Config::Mcp
|
|
4
5
|
attr_reader credentials: untyped
|
|
5
6
|
|
|
@@ -16,4 +17,10 @@ class Riffer::Config::Mcp
|
|
|
16
17
|
# --
|
|
17
18
|
# : (untyped) -> void
|
|
18
19
|
def discovery_runner=: (untyped) -> void
|
|
20
|
+
|
|
21
|
+
private
|
|
22
|
+
|
|
23
|
+
# --
|
|
24
|
+
# : () -> void
|
|
25
|
+
def warn_deprecated: () -> void
|
|
19
26
|
end
|
|
@@ -19,7 +19,11 @@ class Riffer::Config
|
|
|
19
19
|
|
|
20
20
|
attr_reader openrouter: Riffer::Config::OpenRouter
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
@evals: Riffer::Config::Evals
|
|
23
|
+
|
|
24
|
+
# --
|
|
25
|
+
# : () -> Riffer::Config::Evals
|
|
26
|
+
def evals: () -> Riffer::Config::Evals
|
|
23
27
|
|
|
24
28
|
attr_reader mcp: Riffer::Config::Mcp
|
|
25
29
|
|
|
@@ -29,6 +29,10 @@ class Riffer::Evals::Evaluator
|
|
|
29
29
|
# : (?String?) -> String
|
|
30
30
|
def self.identifier: (?String?) -> String
|
|
31
31
|
|
|
32
|
+
# --
|
|
33
|
+
# : (Class) -> void
|
|
34
|
+
private def self.inherited: (Class) -> void
|
|
35
|
+
|
|
32
36
|
# --
|
|
33
37
|
# : () -> String
|
|
34
38
|
private def self.derived_identifier: () -> String
|
|
@@ -13,9 +13,11 @@ class Riffer::Messages::Tool < Riffer::Messages::Base
|
|
|
13
13
|
|
|
14
14
|
attr_reader error_type: Symbol?
|
|
15
15
|
|
|
16
|
+
attr_reader loaded_tools: Array[String]
|
|
17
|
+
|
|
16
18
|
# --
|
|
17
|
-
# : (String, tool_call_id: String, name: String, ?id: String?, ?error: String?, ?error_type: Symbol?) -> void
|
|
18
|
-
def initialize: (String, tool_call_id: String, name: String, ?id: String?, ?error: String?, ?error_type: Symbol?) -> void
|
|
19
|
+
# : (String, tool_call_id: String, name: String, ?id: String?, ?error: String?, ?error_type: Symbol?, ?loaded_tools: Array[String]) -> void
|
|
20
|
+
def initialize: (String, tool_call_id: String, name: String, ?id: String?, ?error: String?, ?error_type: Symbol?, ?loaded_tools: Array[String]) -> void
|
|
19
21
|
|
|
20
22
|
# --
|
|
21
23
|
# : () -> bool
|
|
@@ -10,12 +10,12 @@ class Riffer::Params::AnyOf
|
|
|
10
10
|
def initialize: (Symbol) -> void
|
|
11
11
|
|
|
12
12
|
# --
|
|
13
|
-
# : (?Module?, ?description: String?, ?enum: Array[untyped]?, ?format: String?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
14
|
-
def variant: (?Module?, ?description: String?, ?enum: Array[untyped]?, ?format: String?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
13
|
+
# : (?(Symbol | Module)?, ?description: String?, ?enum: Array[untyped]?, ?format: String?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
14
|
+
def variant: (?(Symbol | Module)?, ?description: String?, ?enum: Array[untyped]?, ?format: String?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
15
15
|
|
|
16
16
|
private
|
|
17
17
|
|
|
18
18
|
# --
|
|
19
|
-
# : (Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
|
|
20
|
-
def primitive: (Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
|
|
19
|
+
# : (Symbol | Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
|
|
20
|
+
def primitive: (Symbol | Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
|
|
21
21
|
end
|
|
@@ -1,15 +1,17 @@
|
|
|
1
1
|
# Generated from lib/riffer/params/param.rb with RBS::Inline
|
|
2
2
|
|
|
3
3
|
class Riffer::Params::Param
|
|
4
|
-
|
|
4
|
+
PRIMITIVE_TYPES: Array[Symbol]
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
TYPES: Array[Symbol]
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
CLASS_TYPES: Hash[Module, Symbol]
|
|
9
|
+
|
|
10
|
+
JSON_TYPE_MAPPINGS: Hash[String, Symbol]
|
|
9
11
|
|
|
10
12
|
attr_reader name: Symbol
|
|
11
13
|
|
|
12
|
-
attr_reader type:
|
|
14
|
+
attr_reader type: Symbol
|
|
13
15
|
|
|
14
16
|
attr_reader required: bool
|
|
15
17
|
|
|
@@ -21,7 +23,7 @@ class Riffer::Params::Param
|
|
|
21
23
|
|
|
22
24
|
attr_reader default: untyped
|
|
23
25
|
|
|
24
|
-
attr_reader item_type:
|
|
26
|
+
attr_reader item_type: Symbol?
|
|
25
27
|
|
|
26
28
|
attr_reader dimensions: Integer
|
|
27
29
|
|
|
@@ -29,6 +31,18 @@ class Riffer::Params::Param
|
|
|
29
31
|
|
|
30
32
|
attr_reader variants: Array[Riffer::Params | Riffer::Params::Param]?
|
|
31
33
|
|
|
34
|
+
# --
|
|
35
|
+
# : (untyped) -> Symbol?
|
|
36
|
+
def self.resolve_type: (untyped) -> Symbol?
|
|
37
|
+
|
|
38
|
+
# --
|
|
39
|
+
# : (untyped, String, Array[Symbol]) -> Symbol
|
|
40
|
+
def self.resolve_type!: (untyped, String, Array[Symbol]) -> Symbol
|
|
41
|
+
|
|
42
|
+
# --
|
|
43
|
+
# : (Symbol, untyped) -> bool
|
|
44
|
+
def self.value_of_type?: (Symbol, untyped) -> bool
|
|
45
|
+
|
|
32
46
|
# --
|
|
33
47
|
# : (Symbol, Hash[Symbol, untyped], required: bool) -> Riffer::Params::Param
|
|
34
48
|
def self.from_json_schema: (Symbol, Hash[Symbol, untyped], required: bool) -> Riffer::Params::Param
|
|
@@ -38,20 +52,20 @@ class Riffer::Params::Param
|
|
|
38
52
|
def self.resolve_variants: (Symbol, Array[Hash[Symbol, untyped]]) -> Array[Riffer::Params | Riffer::Params::Param]
|
|
39
53
|
|
|
40
54
|
# --
|
|
41
|
-
# : (
|
|
42
|
-
def self.resolve_nested_params: (
|
|
55
|
+
# : (Symbol, Hash[Symbol, untyped]) -> Riffer::Params?
|
|
56
|
+
def self.resolve_nested_params: (Symbol, Hash[Symbol, untyped]) -> Riffer::Params?
|
|
43
57
|
|
|
44
58
|
# --
|
|
45
|
-
# : (Hash[Symbol, untyped]) -> [
|
|
46
|
-
def self.resolve_typed_items: (Hash[Symbol, untyped]) -> [
|
|
59
|
+
# : (Hash[Symbol, untyped]) -> [Symbol, Integer, Hash[Symbol, untyped]]?
|
|
60
|
+
def self.resolve_typed_items: (Hash[Symbol, untyped]) -> [ Symbol, Integer, Hash[Symbol, untyped] ]?
|
|
47
61
|
|
|
48
62
|
# --
|
|
49
|
-
# : (untyped) ->
|
|
50
|
-
def self.
|
|
63
|
+
# : (untyped) -> Symbol
|
|
64
|
+
def self.json_type: (untyped) -> Symbol
|
|
51
65
|
|
|
52
66
|
# --
|
|
53
|
-
# : (name: Symbol, type:
|
|
54
|
-
def initialize: (name: Symbol, type:
|
|
67
|
+
# : (name: Symbol, type: Symbol, required: bool, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?item_type: Symbol?, ?dimensions: Integer, ?nested_params: Riffer::Params?, ?variants: Array[Riffer::Params | Riffer::Params::Param]?) -> void
|
|
68
|
+
def initialize: (name: Symbol, type: Symbol, required: bool, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?item_type: Symbol?, ?dimensions: Integer, ?nested_params: Riffer::Params?, ?variants: Array[Riffer::Params | Riffer::Params::Param]?) -> void
|
|
55
69
|
|
|
56
70
|
# --
|
|
57
71
|
# : (untyped) -> bool
|
|
@@ -74,7 +88,7 @@ class Riffer::Params::Param
|
|
|
74
88
|
# : (Riffer::Params::Param) -> void
|
|
75
89
|
def initialize_copy: (Riffer::Params::Param) -> void
|
|
76
90
|
|
|
77
|
-
# The first matching variant wins, and a
|
|
91
|
+
# The first matching variant wins, and a :number variant without an enum accepts any number.
|
|
78
92
|
# --
|
|
79
93
|
# : () -> void
|
|
80
94
|
def validate_variant_order!: () -> void
|
|
@@ -14,16 +14,16 @@ class Riffer::Params
|
|
|
14
14
|
def self.from_json_schema: (Hash[Symbol, untyped]) -> Riffer::Params
|
|
15
15
|
|
|
16
16
|
# --
|
|
17
|
-
# : (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
18
|
-
# : (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
19
|
-
def required: (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
20
|
-
| (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
17
|
+
# : (Symbol, :any_of | singleton(Riffer::Params::AnyOf), ?description: String?) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
18
|
+
# : (Symbol, Symbol | Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?of: (Symbol | Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
19
|
+
def required: (Symbol, :any_of | singleton(Riffer::Params::AnyOf), ?description: String?) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
20
|
+
| (Symbol, Symbol | Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?of: (Symbol | Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
21
21
|
|
|
22
22
|
# --
|
|
23
|
-
# : (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?, ?default: untyped) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
24
|
-
# : (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
25
|
-
def optional: (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?, ?default: untyped) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
26
|
-
| (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
23
|
+
# : (Symbol, :any_of | singleton(Riffer::Params::AnyOf), ?description: String?, ?default: untyped) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
24
|
+
# : (Symbol, Symbol | Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?of: (Symbol | Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
25
|
+
def optional: (Symbol, :any_of | singleton(Riffer::Params::AnyOf), ?description: String?, ?default: untyped) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
26
|
+
| (Symbol, Symbol | Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?of: (Symbol | Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
27
27
|
|
|
28
28
|
# --
|
|
29
29
|
# : (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
|
|
@@ -42,16 +42,20 @@ class Riffer::Params
|
|
|
42
42
|
def initialize_copy: (Riffer::Params) -> void
|
|
43
43
|
|
|
44
44
|
# --
|
|
45
|
-
# : ((Module | Array[untyped])
|
|
46
|
-
def
|
|
45
|
+
# : (Symbol, untyped, required: bool, description: String?, enum: Array[untyped]?, format: String?, ?default: untyped, of: (Symbol | Module | Array[untyped])?) ?{ (untyped) [self: untyped] -> void } -> void
|
|
46
|
+
def add_param: (Symbol, untyped, required: bool, description: String?, enum: Array[untyped]?, format: String?, of: (Symbol | Module | Array[untyped])?, ?default: untyped) ?{ (untyped) [self: untyped] -> void } -> void
|
|
47
47
|
|
|
48
48
|
# --
|
|
49
|
-
# : (
|
|
50
|
-
def
|
|
49
|
+
# : ((Symbol | Module | Array[untyped])?, ?Integer) -> [(Symbol | Module)?, Integer]
|
|
50
|
+
def unwrap_of: ((Symbol | Module | Array[untyped])?, ?Integer) -> [ (Symbol | Module)?, Integer ]
|
|
51
51
|
|
|
52
52
|
# --
|
|
53
|
-
# : (Symbol,
|
|
54
|
-
def
|
|
53
|
+
# : (Symbol, Symbol?, Array[untyped]?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
|
|
54
|
+
def build_nested: (Symbol, Symbol?, Array[untyped]?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
|
|
55
|
+
|
|
56
|
+
# --
|
|
57
|
+
# : (Symbol, (Symbol | Module | Array[untyped])?, Array[untyped]?) ?{ (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> Array[Riffer::Params | Riffer::Params::Param]
|
|
58
|
+
def build_variants: (Symbol, (Symbol | Module | Array[untyped])?, Array[untyped]?) ?{ (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> Array[Riffer::Params | Riffer::Params::Param]
|
|
55
59
|
|
|
56
60
|
# --
|
|
57
61
|
# : (Riffer::Params::Param, untyped) -> String?
|
|
@@ -84,10 +88,6 @@ class Riffer::Params
|
|
|
84
88
|
def validate_typed_array: (Riffer::Params::Param, Array[untyped], Array[String], ?String, ?Integer) -> Array[untyped]
|
|
85
89
|
|
|
86
90
|
# --
|
|
87
|
-
# : (
|
|
88
|
-
def
|
|
89
|
-
|
|
90
|
-
# --
|
|
91
|
-
# : (Module, untyped) -> untyped
|
|
92
|
-
def coerce_value: (Module, untyped) -> untyped
|
|
91
|
+
# : (Symbol, untyped) -> untyped
|
|
92
|
+
def coerce_value: (Symbol, untyped) -> untyped
|
|
93
93
|
end
|