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
@@ -0,0 +1,23 @@
1
+ # Generated from lib/riffer/providers/deferred_tool_gateway/sink.rb with RBS::Inline
2
+
3
+ class Riffer::Providers::DeferredToolGateway::Sink
4
+ @sink: Riffer::Providers::_EventSink
5
+
6
+ @deferred_tools: Array[singleton(Riffer::Tool)]
7
+
8
+ @gateway_item_ids: Array[String]
9
+
10
+ # --
11
+ # : (Riffer::Providers::_EventSink, deferred_tools: Array[singleton(Riffer::Tool)]) -> void
12
+ def initialize: (Riffer::Providers::_EventSink, deferred_tools: Array[singleton(Riffer::Tool)]) -> void
13
+
14
+ # --
15
+ # : (Riffer::StreamEvents::Base) -> self
16
+ def <<: (Riffer::StreamEvents::Base) -> self
17
+
18
+ private
19
+
20
+ # --
21
+ # : (Riffer::StreamEvents::ToolCallDone) -> Riffer::StreamEvents::ToolCallDone
22
+ def unwrap: (Riffer::StreamEvents::ToolCallDone) -> Riffer::StreamEvents::ToolCallDone
23
+ end
@@ -0,0 +1,4 @@
1
+ # Generated from lib/riffer/providers/deferred_tool_gateway/tool.rb with RBS::Inline
2
+
3
+ class Riffer::Providers::DeferredToolGateway::Tool < Riffer::Tool
4
+ end
@@ -0,0 +1,58 @@
1
+ # Generated from lib/riffer/providers/deferred_tool_gateway.rb with RBS::Inline
2
+
3
+ module Riffer::Providers::DeferredToolGateway
4
+ # +deferred_tools+ are the ones the gateway carries for the request. With none there is no gateway, and every
5
+ # function here returns its input.
6
+ # --
7
+ # : (Array[Riffer::Messages::Base], Array[singleton(Riffer::Tool)]) -> Array[Riffer::Messages::Base]
8
+ def wrap_messages: (Array[Riffer::Messages::Base], Array[singleton(Riffer::Tool)]) -> Array[Riffer::Messages::Base]
9
+
10
+ # --
11
+ # : (Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart], Array[singleton(Riffer::Tool)]) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
12
+ def unwrap_parts: (Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart], Array[singleton(Riffer::Tool)]) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
13
+
14
+ # A gateway call without a string name and string arguments, or naming a tool that isn't deferred, stays a call to
15
+ # the gateway, which is never one of the agent's tools, so the model gets an +:unknown_tool+ error result. Only a
16
+ # deferred tool's call is wrapped again on the way out, so unwrapping any other name would replay its arguments
17
+ # to the provider as they came, unparseable JSON included.
18
+ # --
19
+ # : (Riffer::Messages::Assistant::ToolCall, Array[singleton(Riffer::Tool)]) -> Riffer::Messages::Assistant::ToolCall
20
+ def unwrap_tool_call: (Riffer::Messages::Assistant::ToolCall, Array[singleton(Riffer::Tool)]) -> Riffer::Messages::Assistant::ToolCall
21
+
22
+ # --
23
+ # : (Riffer::Providers::_EventSink, Array[singleton(Riffer::Tool)]) -> Riffer::Providers::_EventSink
24
+ def unwrapping_sink: (Riffer::Providers::_EventSink, Array[singleton(Riffer::Tool)]) -> Riffer::Providers::_EventSink
25
+
26
+ private
27
+
28
+ # --
29
+ # : (String) -> [String, String]?
30
+ def parse_gateway_arguments: (String) -> [ String, String ]?
31
+
32
+ # --
33
+ # : (Riffer::Messages::Assistant, Array[String]) -> Riffer::Messages::Assistant
34
+ def wrap_assistant: (Riffer::Messages::Assistant, Array[String]) -> Riffer::Messages::Assistant
35
+
36
+ # --
37
+ # : (Riffer::Messages::Assistant::ToolCall, Array[String]) -> Riffer::Messages::Assistant::ToolCall
38
+ def wrap_tool_call: (Riffer::Messages::Assistant::ToolCall, Array[String]) -> Riffer::Messages::Assistant::ToolCall
39
+
40
+ # A result for a deferred tool is renamed along with its call, since Gemini sends the name with a function
41
+ # response and rejects one that names no declared function.
42
+ # --
43
+ # : (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Riffer::Messages::Tool
44
+ def wrap_tool_result: (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Riffer::Messages::Tool
45
+
46
+ # --
47
+ # : (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
48
+ def loaded_deferred_tools: (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
49
+
50
+ # Deterministic, so an earlier tool result reads the same on every request and the prompt cache holds.
51
+ # --
52
+ # : (Array[singleton(Riffer::Tool)]) -> String
53
+ def describe_loaded_tools: (Array[singleton(Riffer::Tool)]) -> String
54
+
55
+ # --
56
+ # : () -> String
57
+ def loaded_tools_header: () -> String
58
+ end
@@ -11,6 +11,10 @@ class Riffer::Providers::Mock < Riffer::Providers::Base
11
11
  # : (?String?) -> singleton(Riffer::Skills::Adapter)
12
12
  def self.skills_adapter: (?String?) -> singleton(Riffer::Skills::Adapter)
13
13
 
14
+ # --
15
+ # : () -> bool
16
+ def self.supports_deferred_tools?: () -> bool
17
+
14
18
  # --
15
19
  # : () -> String
16
20
  def self.semconv_provider_name: () -> String
@@ -10,6 +10,10 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
10
10
  # together with <tt>incomplete_details.reason</tt>.
11
11
  FINISH_REASONS: Hash[String, Symbol | Hash[String, Symbol]]
12
12
 
13
+ # --
14
+ # : () -> bool
15
+ def self.supports_deferred_tools?: () -> bool
16
+
13
17
  # --
14
18
  # : () -> String
15
19
  def self.semconv_provider_name: () -> String
@@ -135,12 +139,20 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
135
139
  def handle_output_item_done_reasoning: (untyped, yielder: Riffer::Providers::_EventSink) -> void
136
140
 
137
141
  # --
138
- # : (Array[Riffer::Messages::Base]) -> Array[Hash[Symbol, untyped]]
139
- def convert_messages_to_openai_format: (Array[Riffer::Messages::Base]) -> Array[Hash[Symbol, untyped]]
142
+ # : (Array[Riffer::Messages::Base], deferred_tools: Array[singleton(Riffer::Tool)]) -> Array[Hash[Symbol, untyped]]
143
+ def convert_messages_to_openai_format: (Array[Riffer::Messages::Base], deferred_tools: Array[singleton(Riffer::Tool)]) -> Array[Hash[Symbol, untyped]]
144
+
145
+ # --
146
+ # : (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
147
+ def loaded_deferred_tools: (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
148
+
149
+ # --
150
+ # : (Array[singleton(Riffer::Tool)]) -> Hash[Symbol, untyped]
151
+ def convert_additional_tools_to_openai_format: (Array[singleton(Riffer::Tool)]) -> Hash[Symbol, untyped]
140
152
 
141
153
  # --
142
- # : (Riffer::Messages::Assistant) -> Array[Hash[Symbol, untyped]]
143
- def convert_assistant_to_openai_format: (Riffer::Messages::Assistant) -> Array[Hash[Symbol, untyped]]
154
+ # : (Riffer::Messages::Assistant, deferred_tools: Array[singleton(Riffer::Tool)]) -> Array[Hash[Symbol, untyped]]
155
+ def convert_assistant_to_openai_format: (Riffer::Messages::Assistant, deferred_tools: Array[singleton(Riffer::Tool)]) -> Array[Hash[Symbol, untyped]]
144
156
 
145
157
  # --
146
158
  # : (Array[Riffer::Messages::Assistant::ReasoningPart]) -> Array[Hash[Symbol, untyped]]
@@ -1,10 +1,52 @@
1
1
  # Generated from lib/riffer/tool.rb with RBS::Inline
2
2
 
3
3
  class Riffer::Tool
4
- extend Riffer::Tools::Toolable
5
-
6
4
  extend Riffer::Registrable
7
5
 
6
+ self.@description: String?
7
+
8
+ self.@identifier: String?
9
+
10
+ self.@timeout: (Integer | Float)?
11
+
12
+ self.@params_builder: Riffer::Params?
13
+
14
+ DEFAULT_TIMEOUT: Integer
15
+
16
+ # --
17
+ # : (?String?) -> String?
18
+ def self.description: (?String?) -> String?
19
+
20
+ # --
21
+ # : (?String?) -> String
22
+ def self.identifier: (?String?) -> String
23
+
24
+ # --
25
+ # : (?String?) -> String
26
+ def self.name: (?String?) -> String
27
+
28
+ # --
29
+ # : (?(Integer | Float)?) -> (Integer | Float)
30
+ def self.timeout: (?(Integer | Float)?) -> (Integer | Float)
31
+
32
+ # --
33
+ # : () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
34
+ def self.params: () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
35
+
36
+ # --
37
+ # : (?strict: bool) -> Hash[Symbol, untyped]
38
+ def self.parameters_schema: (?strict: bool) -> Hash[Symbol, untyped]
39
+
40
+ # --
41
+ # : (?strict: bool) -> Hash[Symbol, untyped]
42
+ def self.to_tool_schema: (?strict: bool) -> Hash[Symbol, untyped]
43
+
44
+ # --
45
+ # : () -> true
46
+ def self.validate_as_tool!: () -> true
47
+
48
+ private def self.empty_schema: () -> untyped
49
+
8
50
  # --
9
51
  # : (context: Riffer::Agent::Context?, **untyped) -> Riffer::Tools::Response
10
52
  def call: (context: Riffer::Agent::Context?, **untyped) -> Riffer::Tools::Response
@@ -17,6 +59,10 @@ class Riffer::Tool
17
59
  # : (untyped) -> Riffer::Tools::Response
18
60
  def json: (untyped) -> Riffer::Tools::Response
19
61
 
62
+ # --
63
+ # : (Array[singleton(Riffer::Tool)]) -> Riffer::Tools::Response
64
+ def load_tools: (Array[singleton(Riffer::Tool)]) -> Riffer::Tools::Response
65
+
20
66
  # --
21
67
  # : (String, ?type: Symbol) -> Riffer::Tools::Response
22
68
  def error: (String, ?type: Symbol) -> Riffer::Tools::Response
@@ -12,6 +12,8 @@ class Riffer::Tools::Response
12
12
 
13
13
  attr_reader error_type: Symbol?
14
14
 
15
+ attr_reader loaded_tools: Array[singleton(Riffer::Tool)]
16
+
15
17
  # Kept out of every serialized form so it never reaches an LLM or a message
16
18
  # payload.
17
19
  attr_reader exception: Exception?
@@ -28,6 +30,11 @@ class Riffer::Tools::Response
28
30
  # : (untyped) -> Riffer::Tools::Response
29
31
  def self.json: (untyped) -> Riffer::Tools::Response
30
32
 
33
+ # No text alongside: Anthropic rejects a tool result that mixes +tool_reference+ blocks with text.
34
+ # --
35
+ # : (Array[singleton(Riffer::Tool)]) -> Riffer::Tools::Response
36
+ def self.load_tools: (Array[singleton(Riffer::Tool)]) -> Riffer::Tools::Response
37
+
31
38
  # --
32
39
  # : (String, ?type: Symbol, ?exception: Exception?) -> Riffer::Tools::Response
33
40
  def self.error: (String, ?type: Symbol, ?exception: Exception?) -> Riffer::Tools::Response
@@ -47,6 +54,6 @@ class Riffer::Tools::Response
47
54
  private
48
55
 
49
56
  # --
50
- # : (content: String, success: bool, ?error_message: String?, ?error_type: Symbol?, ?exception: Exception?) -> void
51
- def initialize: (content: String, success: bool, ?error_message: String?, ?error_type: Symbol?, ?exception: Exception?) -> void
57
+ # : (content: String, success: bool, ?error_message: String?, ?error_type: Symbol?, ?exception: Exception?, ?loaded_tools: Array[singleton(Riffer::Tool)]) -> void
58
+ def initialize: (content: String, success: bool, ?error_message: String?, ?error_type: Symbol?, ?exception: Exception?, ?loaded_tools: Array[singleton(Riffer::Tool)]) -> void
52
59
  end
@@ -0,0 +1,5 @@
1
+ # `Riffer::Providers::DeferredToolGateway` uses `extend self`; rbs-inline doesn't
2
+ # emit that, so re-extend here to expose its instance methods as singleton methods.
3
+ module Riffer::Providers::DeferredToolGateway
4
+ extend ::Riffer::Providers::DeferredToolGateway
5
+ end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: riffer
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.56.0
4
+ version: 0.57.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Jake Bottrall
@@ -230,6 +230,9 @@ files:
230
230
  - lib/riffer/providers/anthropic_vertex.rb
231
231
  - lib/riffer/providers/azure_open_ai.rb
232
232
  - lib/riffer/providers/base.rb
233
+ - lib/riffer/providers/deferred_tool_gateway.rb
234
+ - lib/riffer/providers/deferred_tool_gateway/sink.rb
235
+ - lib/riffer/providers/deferred_tool_gateway/tool.rb
233
236
  - lib/riffer/providers/finish_reason.rb
234
237
  - lib/riffer/providers/gemini.rb
235
238
  - lib/riffer/providers/gemini/client.rb
@@ -282,7 +285,6 @@ files:
282
285
  - lib/riffer/tools/runtime/fibers.rb
283
286
  - lib/riffer/tools/runtime/inline.rb
284
287
  - lib/riffer/tools/runtime/threaded.rb
285
- - lib/riffer/tools/toolable.rb
286
288
  - lib/riffer/tracing.rb
287
289
  - lib/riffer/tracing/capture.rb
288
290
  - lib/riffer/tracing/no_op.rb
@@ -399,6 +401,9 @@ files:
399
401
  - sig/generated/riffer/providers/anthropic_vertex.rbs
400
402
  - sig/generated/riffer/providers/azure_open_ai.rbs
401
403
  - sig/generated/riffer/providers/base.rbs
404
+ - sig/generated/riffer/providers/deferred_tool_gateway.rbs
405
+ - sig/generated/riffer/providers/deferred_tool_gateway/sink.rbs
406
+ - sig/generated/riffer/providers/deferred_tool_gateway/tool.rbs
402
407
  - sig/generated/riffer/providers/finish_reason.rbs
403
408
  - sig/generated/riffer/providers/gemini.rbs
404
409
  - sig/generated/riffer/providers/gemini/client.rbs
@@ -450,7 +455,6 @@ files:
450
455
  - sig/generated/riffer/tools/runtime/fibers.rbs
451
456
  - sig/generated/riffer/tools/runtime/inline.rbs
452
457
  - sig/generated/riffer/tools/runtime/threaded.rbs
453
- - sig/generated/riffer/tools/toolable.rbs
454
458
  - sig/generated/riffer/tracing.rbs
455
459
  - sig/generated/riffer/tracing/capture.rbs
456
460
  - sig/generated/riffer/tracing/no_op.rbs
@@ -481,6 +485,7 @@ files:
481
485
  - sig/manual/riffer/params/format.rbs
482
486
  - sig/manual/riffer/providers.rbs
483
487
  - sig/manual/riffer/providers/anthropic_compatible/messages_api.rbs
488
+ - sig/manual/riffer/providers/deferred_tool_gateway.rbs
484
489
  - sig/manual/riffer/providers/gemini.rbs
485
490
  - sig/manual/riffer/providers/google_cloud.rbs
486
491
  - sig/manual/riffer/providers/repository.rbs
@@ -1,113 +0,0 @@
1
- # frozen_string_literal: true
2
- # rbs_inline: enabled
3
-
4
- # @rbs module-self Module
5
- module Riffer::Tools::Toolable
6
- # @rbs self.@extenders: Array[Module]?
7
- # @rbs @description: String?
8
- # @rbs @identifier: String?
9
- # @rbs @timeout: (Integer | Float)?
10
- # @rbs @params_builder: Riffer::Params?
11
- # @rbs @kind: Symbol?
12
-
13
- DEFAULT_TIMEOUT = 10 #: Integer
14
-
15
- #--
16
- #: (Module) -> void
17
- def self.extended(base)
18
- extenders = (@extenders ||= []) #: Array[Module]
19
- extenders << base
20
- end
21
-
22
- #--
23
- #: () -> Array[Module]
24
- def self.all
25
- @extenders || []
26
- end
27
-
28
- #--
29
- #: (?String?) -> String?
30
- def description(value = nil)
31
- return @description if value.nil?
32
-
33
- @description = value.to_s
34
- end
35
-
36
- #--
37
- #: (?String?) -> String
38
- def identifier(value = nil)
39
- return @identifier || Riffer::Helpers::Identifier.for(self) if value.nil?
40
-
41
- @identifier = value.to_s
42
- end
43
-
44
- #--
45
- #: (?String?) -> String
46
- def name(value = nil)
47
- return identifier(value) if value
48
-
49
- identifier
50
- end
51
-
52
- #--
53
- #: (?(Integer | Float)?) -> (Integer | Float)
54
- def timeout(value = nil)
55
- return @timeout || DEFAULT_TIMEOUT if value.nil?
56
-
57
- @timeout = value.to_f
58
- end
59
-
60
- #--
61
- #: () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
62
- def params(&block)
63
- return @params_builder if block.nil?
64
-
65
- builder = Riffer::Params.new
66
- builder.instance_eval(&block)
67
- @params_builder = builder
68
- end
69
-
70
- #--
71
- #: (?strict: bool) -> Hash[Symbol, untyped]
72
- def parameters_schema(strict: false)
73
- @params_builder&.to_json_schema(strict: strict) || empty_schema
74
- end
75
-
76
- #--
77
- #: (?Symbol?) -> Symbol
78
- def kind(value = nil)
79
- return @kind || :tool if value.nil?
80
-
81
- @kind = value.to_sym
82
- end
83
-
84
- #--
85
- #: (?strict: bool) -> Hash[Symbol, untyped]
86
- def to_tool_schema(strict: false)
87
- {
88
- name: name,
89
- description: description,
90
- parameters_schema: parameters_schema(strict: strict),
91
- }
92
- end
93
-
94
- #--
95
- #: () -> true
96
- def validate_as_tool!
97
- if description.nil? || description.to_s.strip.empty?
98
- raise Riffer::ArgumentError,
99
- "#{self} must define a description"
100
- end
101
- raise Riffer::ArgumentError, "#{self} must have an identifier" if identifier.nil? || identifier.to_s.strip.empty?
102
-
103
- true
104
- end
105
-
106
- private
107
-
108
- def empty_schema # :nodoc:
109
- properties = {} #: Hash[Symbol, untyped]
110
- required = [] #: Array[untyped]
111
- { type: "object", properties: properties, required: required, additionalProperties: false }
112
- end
113
- end
@@ -1,66 +0,0 @@
1
- # Generated from lib/riffer/tools/toolable.rb with RBS::Inline
2
-
3
- # @rbs module-self Module
4
- module Riffer::Tools::Toolable : Module
5
- @kind: Symbol?
6
-
7
- @params_builder: Riffer::Params?
8
-
9
- @timeout: (Integer | Float)?
10
-
11
- @identifier: String?
12
-
13
- @description: String?
14
-
15
- self.@extenders: Array[Module]?
16
-
17
- DEFAULT_TIMEOUT: Integer
18
-
19
- # --
20
- # : (Module) -> void
21
- def self.extended: (Module) -> void
22
-
23
- # --
24
- # : () -> Array[Module]
25
- def self.all: () -> Array[Module]
26
-
27
- # --
28
- # : (?String?) -> String?
29
- def description: (?String?) -> String?
30
-
31
- # --
32
- # : (?String?) -> String
33
- def identifier: (?String?) -> String
34
-
35
- # --
36
- # : (?String?) -> String
37
- def name: (?String?) -> String
38
-
39
- # --
40
- # : (?(Integer | Float)?) -> (Integer | Float)
41
- def timeout: (?(Integer | Float)?) -> (Integer | Float)
42
-
43
- # --
44
- # : () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
45
- def params: () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
46
-
47
- # --
48
- # : (?strict: bool) -> Hash[Symbol, untyped]
49
- def parameters_schema: (?strict: bool) -> Hash[Symbol, untyped]
50
-
51
- # --
52
- # : (?Symbol?) -> Symbol
53
- def kind: (?Symbol?) -> Symbol
54
-
55
- # --
56
- # : (?strict: bool) -> Hash[Symbol, untyped]
57
- def to_tool_schema: (?strict: bool) -> Hash[Symbol, untyped]
58
-
59
- # --
60
- # : () -> true
61
- def validate_as_tool!: () -> true
62
-
63
- private
64
-
65
- def empty_schema: () -> untyped
66
- end