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.
Files changed (90) hide show
  1. checksums.yaml +4 -4
  2. data/.release-please-manifest.json +1 -1
  3. data/CHANGELOG.md +26 -0
  4. data/README.md +1 -1
  5. data/docs/AGENTS.md +105 -50
  6. data/docs/AGENT_LIFECYCLE.md +1 -1
  7. data/docs/CONFIGURATION.md +7 -3
  8. data/docs/EVALS.md +2 -0
  9. data/docs/MCP.md +36 -0
  10. data/docs/MESSAGES.md +13 -0
  11. data/docs/OVERVIEW.md +7 -7
  12. data/docs/SERIALIZATION.md +12 -2
  13. data/docs/SKILLS.md +1 -1
  14. data/docs/STABILITY.md +1 -1
  15. data/docs/TOOLS.md +93 -37
  16. data/docs/TOOL_ADVANCED.md +7 -0
  17. data/docs/providers/AMAZON_BEDROCK.md +6 -2
  18. data/docs/providers/ANTHROPIC.md +35 -2
  19. data/docs/providers/AZURE_OPENAI.md +9 -3
  20. data/docs/providers/CUSTOM_PROVIDERS.md +19 -0
  21. data/docs/providers/GEMINI.md +8 -4
  22. data/docs/providers/GOOGLE_CLOUD.md +10 -5
  23. data/docs/providers/MOCK_PROVIDER.md +2 -0
  24. data/docs/providers/OPENAI.md +25 -3
  25. data/docs/providers/OPENROUTER.md +11 -3
  26. data/docs/providers/PROVIDERS.md +1 -1
  27. data/docs-site/index.html.erb +1 -1
  28. data/lib/riffer/agent/config.rb +21 -0
  29. data/lib/riffer/agent/context.rb +36 -18
  30. data/lib/riffer/agent/run.rb +54 -8
  31. data/lib/riffer/agent/serializer.rb +5 -0
  32. data/lib/riffer/agent/session.rb +1 -0
  33. data/lib/riffer/agent.rb +43 -0
  34. data/lib/riffer/config/mcp.rb +17 -0
  35. data/lib/riffer/config/pricing.rb +2 -2
  36. data/lib/riffer/config.rb +12 -1
  37. data/lib/riffer/evals/evaluator.rb +8 -1
  38. data/lib/riffer/evals/evaluator_runner.rb +1 -0
  39. data/lib/riffer/evals/judge.rb +2 -2
  40. data/lib/riffer/evals.rb +2 -0
  41. data/lib/riffer/mcp/search_tool.rb +1 -1
  42. data/lib/riffer/mcp.rb +7 -0
  43. data/lib/riffer/messages/tool.rb +6 -2
  44. data/lib/riffer/params/any_of.rb +5 -8
  45. data/lib/riffer/params/boolean.rb +1 -1
  46. data/lib/riffer/params/param.rb +96 -67
  47. data/lib/riffer/params.rb +50 -71
  48. data/lib/riffer/providers/anthropic_compatible/messages_api/stream.rb +3 -10
  49. data/lib/riffer/providers/anthropic_compatible/messages_api.rb +89 -13
  50. data/lib/riffer/providers/anthropic_vertex.rb +7 -0
  51. data/lib/riffer/providers/base.rb +43 -7
  52. data/lib/riffer/providers/deferred_tool_gateway/sink.rb +54 -0
  53. data/lib/riffer/providers/deferred_tool_gateway/tool.rb +17 -0
  54. data/lib/riffer/providers/deferred_tool_gateway.rb +150 -0
  55. data/lib/riffer/providers/gemini.rb +5 -5
  56. data/lib/riffer/providers/mock.rb +6 -0
  57. data/lib/riffer/providers/open_ai.rb +38 -10
  58. data/lib/riffer/skills/activate_tool.rb +1 -1
  59. data/lib/riffer/tool.rb +92 -2
  60. data/lib/riffer/tools/response.rb +11 -2
  61. data/lib/riffer/version.rb +1 -1
  62. data/sig/generated/riffer/agent/config.rbs +13 -1
  63. data/sig/generated/riffer/agent/context.rbs +16 -0
  64. data/sig/generated/riffer/agent/run.rbs +14 -2
  65. data/sig/generated/riffer/agent.rbs +13 -0
  66. data/sig/generated/riffer/config/mcp.rbs +7 -0
  67. data/sig/generated/riffer/config.rbs +5 -1
  68. data/sig/generated/riffer/evals/evaluator.rbs +4 -0
  69. data/sig/generated/riffer/evals.rbs +1 -0
  70. data/sig/generated/riffer/mcp.rbs +1 -0
  71. data/sig/generated/riffer/messages/tool.rbs +4 -2
  72. data/sig/generated/riffer/params/any_of.rbs +4 -4
  73. data/sig/generated/riffer/params/boolean.rbs +1 -1
  74. data/sig/generated/riffer/params/param.rbs +28 -14
  75. data/sig/generated/riffer/params.rbs +20 -20
  76. data/sig/generated/riffer/providers/anthropic_compatible/messages_api/stream.rbs +2 -5
  77. data/sig/generated/riffer/providers/anthropic_compatible/messages_api.rbs +34 -2
  78. data/sig/generated/riffer/providers/anthropic_vertex.rbs +5 -0
  79. data/sig/generated/riffer/providers/base.rbs +13 -0
  80. data/sig/generated/riffer/providers/deferred_tool_gateway/sink.rbs +23 -0
  81. data/sig/generated/riffer/providers/deferred_tool_gateway/tool.rbs +4 -0
  82. data/sig/generated/riffer/providers/deferred_tool_gateway.rbs +58 -0
  83. data/sig/generated/riffer/providers/mock.rbs +4 -0
  84. data/sig/generated/riffer/providers/open_ai.rbs +16 -4
  85. data/sig/generated/riffer/tool.rbs +48 -2
  86. data/sig/generated/riffer/tools/response.rbs +9 -2
  87. data/sig/manual/riffer/providers/deferred_tool_gateway.rbs +5 -0
  88. metadata +8 -3
  89. data/lib/riffer/tools/toolable.rb +0 -113
  90. 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::Assistant) -> Array[Hash[Symbol, untyped]]
425
- def convert_assistant_to_openai_format(message)
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: encode_tool_name(tc.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
 
@@ -8,7 +8,7 @@ class Riffer::Skills::ActivateTool < Riffer::Tool
8
8
  timeout 1
9
9
 
10
10
  params do
11
- required :name, String, description: "The skill name to activate"
11
+ required :name, :string, description: "The skill name to activate"
12
12
  end
13
13
 
14
14
  #--
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
- kind :tool
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
@@ -2,5 +2,5 @@
2
2
  # rbs_inline: enabled
3
3
 
4
4
  module Riffer
5
- VERSION = "0.56.0" #: String
5
+ VERSION = "0.57.1" #: String
6
6
  end
@@ -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
- # : (Riffer::Agent, Array[[Riffer::Messages::Assistant::ToolCall, Riffer::Tools::Response]]) -> void
61
- def inject_discovered_tools: (Riffer::Agent, Array[[ Riffer::Messages::Assistant::ToolCall, Riffer::Tools::Response ]]) -> void
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
- attr_reader evals: Riffer::Config::Evals
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
@@ -1,4 +1,5 @@
1
1
  # Generated from lib/riffer/evals.rb with RBS::Inline
2
2
 
3
3
  module Riffer::Evals
4
+ DEPRECATION_MESSAGE: String
4
5
  end
@@ -1,5 +1,6 @@
1
1
  # Generated from lib/riffer/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
  module Riffer::Mcp
4
5
  class Error < Riffer::Error
5
6
  end
@@ -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,5 +1,5 @@
1
1
  # Generated from lib/riffer/params/boolean.rb with RBS::Inline
2
2
 
3
- # Ruby has no +Boolean+ class, so params declare booleans with this sentinel.
3
+ # Deprecated: declare boolean params with +:boolean+.
4
4
  module Riffer::Params::Boolean
5
5
  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
- TYPE_MAPPINGS: Hash[Module, String]
4
+ PRIMITIVE_TYPES: Array[Symbol]
5
5
 
6
- PRIMITIVE_TYPES: Array[Module]
6
+ TYPES: Array[Symbol]
7
7
 
8
- JSON_TYPE_MAPPINGS: Hash[String, Module]
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: Module
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: Module?
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
- # : (Module, Hash[Symbol, untyped]) -> Riffer::Params?
42
- def self.resolve_nested_params: (Module, Hash[Symbol, untyped]) -> Riffer::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]) -> [Module, Integer, Hash[Symbol, untyped]]?
46
- def self.resolve_typed_items: (Hash[Symbol, untyped]) -> [ Module, Integer, 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) -> Module
50
- def self.json_type_to_ruby: (untyped) -> Module
63
+ # : (untyped) -> Symbol
64
+ def self.json_type: (untyped) -> Symbol
51
65
 
52
66
  # --
53
- # : (name: Symbol, type: Module, required: bool, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?item_type: Module?, ?dimensions: Integer, ?nested_params: Riffer::Params?, ?variants: Array[Riffer::Params | Riffer::Params::Param]?) -> void
54
- def initialize: (name: Symbol, type: Module, required: bool, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?item_type: Module?, ?dimensions: Integer, ?nested_params: Riffer::Params?, ?variants: Array[Riffer::Params | Riffer::Params::Param]?) -> void
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 Float variant without an enum accepts any number.
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])?, ?Integer) -> [Module?, Integer]
46
- def unwrap_of: ((Module | Array[untyped])?, ?Integer) -> [ Module?, Integer ]
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
- # : (Module, Module?, Array[untyped]?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
50
- def build_nested: (Module, Module?, Array[untyped]?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
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, (Module | Array[untyped])?, Array[untyped]?) ?{ (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> Array[Riffer::Params | Riffer::Params::Param]
54
- def build_variants: (Symbol, (Module | Array[untyped])?, Array[untyped]?) ?{ (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> Array[Riffer::Params | Riffer::Params::Param]
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
- # : (Module, untyped) -> bool
88
- def valid_item?: (Module, untyped) -> bool
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