riffer 0.56.0 → 0.57.0

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 (88) hide show
  1. checksums.yaml +4 -4
  2. data/.release-please-manifest.json +1 -1
  3. data/CHANGELOG.md +19 -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 +9 -4
  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 +88 -12
  50. data/lib/riffer/providers/base.rb +43 -7
  51. data/lib/riffer/providers/deferred_tool_gateway/sink.rb +54 -0
  52. data/lib/riffer/providers/deferred_tool_gateway/tool.rb +17 -0
  53. data/lib/riffer/providers/deferred_tool_gateway.rb +150 -0
  54. data/lib/riffer/providers/gemini.rb +5 -5
  55. data/lib/riffer/providers/mock.rb +6 -0
  56. data/lib/riffer/providers/open_ai.rb +38 -10
  57. data/lib/riffer/skills/activate_tool.rb +1 -1
  58. data/lib/riffer/tool.rb +92 -2
  59. data/lib/riffer/tools/response.rb +11 -2
  60. data/lib/riffer/version.rb +1 -1
  61. data/sig/generated/riffer/agent/config.rbs +13 -1
  62. data/sig/generated/riffer/agent/context.rbs +16 -0
  63. data/sig/generated/riffer/agent/run.rbs +14 -2
  64. data/sig/generated/riffer/agent.rbs +13 -0
  65. data/sig/generated/riffer/config/mcp.rbs +7 -0
  66. data/sig/generated/riffer/config.rbs +5 -1
  67. data/sig/generated/riffer/evals/evaluator.rbs +4 -0
  68. data/sig/generated/riffer/evals.rbs +1 -0
  69. data/sig/generated/riffer/mcp.rbs +1 -0
  70. data/sig/generated/riffer/messages/tool.rbs +4 -2
  71. data/sig/generated/riffer/params/any_of.rbs +4 -4
  72. data/sig/generated/riffer/params/boolean.rbs +1 -1
  73. data/sig/generated/riffer/params/param.rbs +28 -14
  74. data/sig/generated/riffer/params.rbs +20 -20
  75. data/sig/generated/riffer/providers/anthropic_compatible/messages_api/stream.rbs +2 -5
  76. data/sig/generated/riffer/providers/anthropic_compatible/messages_api.rbs +34 -2
  77. data/sig/generated/riffer/providers/base.rbs +13 -0
  78. data/sig/generated/riffer/providers/deferred_tool_gateway/sink.rbs +23 -0
  79. data/sig/generated/riffer/providers/deferred_tool_gateway/tool.rbs +4 -0
  80. data/sig/generated/riffer/providers/deferred_tool_gateway.rbs +58 -0
  81. data/sig/generated/riffer/providers/mock.rbs +4 -0
  82. data/sig/generated/riffer/providers/open_ai.rbs +16 -4
  83. data/sig/generated/riffer/tool.rbs +48 -2
  84. data/sig/generated/riffer/tools/response.rbs +9 -2
  85. data/sig/manual/riffer/providers/deferred_tool_gateway.rbs +5 -0
  86. metadata +8 -3
  87. data/lib/riffer/tools/toolable.rb +0 -113
  88. data/sig/generated/riffer/tools/toolable.rbs +0 -66
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.0" #: 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
@@ -34,7 +34,8 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI::Stream
34
34
  # : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
35
35
  def handle: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
36
36
 
37
- # The caller reads finish reason and usage from here so it can price the usage.
37
+ # The caller reads the text, finish reason and usage from here, since one turn
38
+ # can take several streams.
38
39
  # --
39
40
  # : () -> Hash[Symbol, untyped]
40
41
  def finish!: () -> Hash[Symbol, untyped]
@@ -61,10 +62,6 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI::Stream
61
62
  # : (Hash[Symbol, untyped]) -> void
62
63
  def apply_message_delta: (Hash[Symbol, untyped]) -> void
63
64
 
64
- # --
65
- # : (Riffer::Providers::_EventSink) -> void
66
- def stop_message: (Riffer::Providers::_EventSink) -> void
67
-
68
65
  # --
69
66
  # : (Hash[Symbol, untyped]) -> void
70
67
  def raise_stream_error: (Hash[Symbol, untyped]) -> void
@@ -5,6 +5,8 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI < Riffer::Providers::B
5
5
 
6
6
  FINISH_REASONS: Hash[String, Symbol]
7
7
 
8
+ PAUSE_TURN_CONTINUATIONS: Integer
9
+
8
10
  # Only parts carrying this tag are replayed, so reasoning captured by another
9
11
  # adapter, whose signatures the Messages API may not accept, never reaches the
10
12
  # request. Server tool parts and text parts that keep their block carry it too.
@@ -14,6 +16,10 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI < Riffer::Providers::B
14
16
  # : (?String?) -> singleton(Riffer::Skills::Adapter)
15
17
  def self.skills_adapter: (?String?) -> singleton(Riffer::Skills::Adapter)
16
18
 
19
+ # --
20
+ # : () -> bool
21
+ def self.supports_deferred_tools?: () -> bool
22
+
17
23
  private
18
24
 
19
25
  # --
@@ -33,10 +39,28 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI < Riffer::Providers::B
33
39
  # : (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
34
40
  def execute_generate: (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
35
41
 
42
+ # The done events cover the whole turn, so they wait until every paused
43
+ # response has been continued.
36
44
  # --
37
45
  # : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
38
46
  def execute_stream: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
39
47
 
48
+ # --
49
+ # : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> Hash[Symbol, untyped]
50
+ def stream_message: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> Hash[Symbol, untyped]
51
+
52
+ # To resume a paused turn, resend the same request with the paused response's
53
+ # content array appended as an assistant message, copied as-is and with nothing after it.
54
+ # --
55
+ # : (Hash[Symbol, untyped]) { (Hash[Symbol, untyped]) -> Hash[Symbol, untyped] } -> Hash[Symbol, untyped]
56
+ def continue_paused_turn: (Hash[Symbol, untyped]) { (Hash[Symbol, untyped]) -> Hash[Symbol, untyped] } -> Hash[Symbol, untyped]
57
+
58
+ # Each request is billed for its own input and output, so the counts add up.
59
+ # A nil count in the later response would replace the running total, so it's dropped.
60
+ # --
61
+ # : (Hash[Symbol, untyped]?, Hash[Symbol, untyped]?) -> Hash[Symbol, untyped]?
62
+ def merge_usage: (Hash[Symbol, untyped]?, Hash[Symbol, untyped]?) -> Hash[Symbol, untyped]?
63
+
40
64
  # Claude signs each thinking block over every block before it in the turn, so
41
65
  # the blocks go back in the order they came.
42
66
  # --
@@ -78,8 +102,16 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI < Riffer::Providers::B
78
102
  def structured_output_config: (Riffer::Agent::StructuredOutput) -> Hash[Symbol, untyped]
79
103
 
80
104
  # --
81
- # : (Array[Riffer::Messages::Base]) -> Hash[Symbol, untyped]
82
- def partition_messages: (Array[Riffer::Messages::Base]) -> Hash[Symbol, untyped]
105
+ # : (Array[Riffer::Messages::Base], Array[singleton(Riffer::Tool)]) -> Hash[Symbol, untyped]
106
+ def partition_messages: (Array[Riffer::Messages::Base], Array[singleton(Riffer::Tool)]) -> Hash[Symbol, untyped]
107
+
108
+ # A load goes as tool_reference blocks alone, since the API rejects them mixed
109
+ # with text. Only this request's deferred tools are referenced: the API rejects
110
+ # a reference to a tool missing from +tools+, and a restored history may name
111
+ # tools the agent no longer defers.
112
+ # --
113
+ # : (Riffer::Messages::Tool, Array[String]) -> (String | Array[Hash[Symbol, untyped]])
114
+ def tool_result_content: (Riffer::Messages::Tool, Array[String]) -> (String | Array[Hash[Symbol, untyped]])
83
115
 
84
116
  # --
85
117
  # : (Riffer::Messages::Assistant) -> Hash[Symbol, untyped]
@@ -15,6 +15,10 @@ class Riffer::Providers::Base
15
15
  # : (?String?) -> singleton(Riffer::Skills::Adapter)
16
16
  def self.skills_adapter: (?String?) -> singleton(Riffer::Skills::Adapter)
17
17
 
18
+ # --
19
+ # : () -> bool
20
+ def self.supports_deferred_tools?: () -> bool
21
+
18
22
  # --
19
23
  # : () -> String
20
24
  def self.semconv_provider_name: () -> String
@@ -48,6 +52,15 @@ class Riffer::Providers::Base
48
52
  # : () -> untyped
49
53
  def build_client: () -> untyped
50
54
 
55
+ # The model calls a loaded deferred tool, and the gateway, by its wire name too.
56
+ # --
57
+ # : (Hash[Symbol, untyped]) -> Array[singleton(Riffer::Tool)]
58
+ def decodable_tools: (Hash[Symbol, untyped]) -> Array[singleton(Riffer::Tool)]
59
+
60
+ # --
61
+ # : (Hash[Symbol, untyped]) -> Array[singleton(Riffer::Tool)]
62
+ def gateway_deferred_tools: (Hash[Symbol, untyped]) -> Array[singleton(Riffer::Tool)]
63
+
51
64
  # --
52
65
  # : (String) -> String
53
66
  def encode_tool_name: (String) -> String