riffer 0.55.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 (114) hide show
  1. checksums.yaml +4 -4
  2. data/.release-please-manifest.json +1 -1
  3. data/CHANGELOG.md +37 -0
  4. data/README.md +3 -2
  5. data/UPGRADING.md +3 -0
  6. data/docs/AGENTS.md +105 -50
  7. data/docs/AGENT_LIFECYCLE.md +2 -2
  8. data/docs/CONFIGURATION.md +54 -3
  9. data/docs/EVALS.md +2 -0
  10. data/docs/GUARDRAILS.md +2 -0
  11. data/docs/MCP.md +36 -0
  12. data/docs/MESSAGES.md +125 -15
  13. data/docs/OVERVIEW.md +7 -7
  14. data/docs/SERIALIZATION.md +12 -2
  15. data/docs/SKILLS.md +1 -1
  16. data/docs/STABILITY.md +32 -0
  17. data/docs/STREAM_EVENTS.md +16 -0
  18. data/docs/TESTING.md +22 -1
  19. data/docs/TOOLS.md +93 -37
  20. data/docs/TOOL_ADVANCED.md +7 -0
  21. data/docs/providers/AMAZON_BEDROCK.md +7 -3
  22. data/docs/providers/ANTHROPIC.md +53 -16
  23. data/docs/providers/AZURE_OPENAI.md +9 -3
  24. data/docs/providers/CUSTOM_PROVIDERS.md +43 -0
  25. data/docs/providers/GEMINI.md +9 -5
  26. data/docs/providers/GOOGLE_CLOUD.md +10 -5
  27. data/docs/providers/MOCK_PROVIDER.md +4 -0
  28. data/docs/providers/OPENAI.md +28 -4
  29. data/docs/providers/OPENROUTER.md +11 -3
  30. data/docs/providers/PROVIDERS.md +1 -1
  31. data/docs-site/index.html.erb +1 -1
  32. data/docs-site/manifest.yml +3 -0
  33. data/lib/riffer/agent/config.rb +21 -0
  34. data/lib/riffer/agent/context.rb +36 -18
  35. data/lib/riffer/agent/run.rb +82 -21
  36. data/lib/riffer/agent/serializer.rb +5 -0
  37. data/lib/riffer/agent/session.rb +34 -10
  38. data/lib/riffer/agent.rb +43 -0
  39. data/lib/riffer/config/future.rb +53 -0
  40. data/lib/riffer/config/mcp.rb +17 -0
  41. data/lib/riffer/config/pricing.rb +5 -15
  42. data/lib/riffer/config.rb +28 -1
  43. data/lib/riffer/deprecation/event.rb +25 -0
  44. data/lib/riffer/deprecation.rb +60 -0
  45. data/lib/riffer/evals/evaluator.rb +8 -1
  46. data/lib/riffer/evals/evaluator_runner.rb +1 -0
  47. data/lib/riffer/evals/judge.rb +2 -2
  48. data/lib/riffer/evals.rb +2 -0
  49. data/lib/riffer/mcp/search_tool.rb +1 -1
  50. data/lib/riffer/mcp.rb +7 -0
  51. data/lib/riffer/messages/assistant/server_tool_part.rb +73 -0
  52. data/lib/riffer/messages/assistant/text_part.rb +52 -0
  53. data/lib/riffer/messages/assistant.rb +64 -17
  54. data/lib/riffer/messages/tool.rb +6 -2
  55. data/lib/riffer/params/any_of.rb +5 -8
  56. data/lib/riffer/params/boolean.rb +1 -1
  57. data/lib/riffer/params/param.rb +96 -67
  58. data/lib/riffer/params.rb +50 -71
  59. data/lib/riffer/providers/anthropic_compatible/messages_api/stream.rb +28 -11
  60. data/lib/riffer/providers/anthropic_compatible/messages_api.rb +136 -38
  61. data/lib/riffer/providers/base.rb +57 -12
  62. data/lib/riffer/providers/deferred_tool_gateway/sink.rb +54 -0
  63. data/lib/riffer/providers/deferred_tool_gateway/tool.rb +17 -0
  64. data/lib/riffer/providers/deferred_tool_gateway.rb +150 -0
  65. data/lib/riffer/providers/gemini.rb +5 -5
  66. data/lib/riffer/providers/mock.rb +6 -0
  67. data/lib/riffer/providers/open_ai.rb +59 -26
  68. data/lib/riffer/skills/activate_tool.rb +1 -1
  69. data/lib/riffer/stream_events/server_tool_done.rb +21 -0
  70. data/lib/riffer/testing.rb +6 -0
  71. data/lib/riffer/tool.rb +92 -2
  72. data/lib/riffer/tools/response.rb +11 -2
  73. data/lib/riffer/version.rb +1 -1
  74. data/lib/riffer.rb +2 -0
  75. data/sig/generated/riffer/agent/config.rbs +13 -1
  76. data/sig/generated/riffer/agent/context.rbs +16 -0
  77. data/sig/generated/riffer/agent/run.rbs +19 -2
  78. data/sig/generated/riffer/agent/session.rbs +6 -0
  79. data/sig/generated/riffer/agent.rbs +13 -0
  80. data/sig/generated/riffer/config/future.rbs +29 -0
  81. data/sig/generated/riffer/config/mcp.rbs +7 -0
  82. data/sig/generated/riffer/config/pricing.rbs +0 -9
  83. data/sig/generated/riffer/config.rbs +13 -1
  84. data/sig/generated/riffer/deprecation/event.rbs +17 -0
  85. data/sig/generated/riffer/deprecation.rbs +27 -0
  86. data/sig/generated/riffer/evals/evaluator.rbs +4 -0
  87. data/sig/generated/riffer/evals.rbs +1 -0
  88. data/sig/generated/riffer/mcp.rbs +1 -0
  89. data/sig/generated/riffer/messages/assistant/server_tool_part.rbs +44 -0
  90. data/sig/generated/riffer/messages/assistant/text_part.rbs +35 -0
  91. data/sig/generated/riffer/messages/assistant.rbs +24 -11
  92. data/sig/generated/riffer/messages/tool.rbs +4 -2
  93. data/sig/generated/riffer/params/any_of.rbs +4 -4
  94. data/sig/generated/riffer/params/boolean.rbs +1 -1
  95. data/sig/generated/riffer/params/param.rbs +28 -14
  96. data/sig/generated/riffer/params.rbs +20 -20
  97. data/sig/generated/riffer/providers/anthropic_compatible/messages_api/stream.rbs +12 -5
  98. data/sig/generated/riffer/providers/anthropic_compatible/messages_api.rbs +50 -9
  99. data/sig/generated/riffer/providers/base.rbs +18 -0
  100. data/sig/generated/riffer/providers/deferred_tool_gateway/sink.rbs +23 -0
  101. data/sig/generated/riffer/providers/deferred_tool_gateway/tool.rbs +4 -0
  102. data/sig/generated/riffer/providers/deferred_tool_gateway.rbs +58 -0
  103. data/sig/generated/riffer/providers/mock.rbs +4 -0
  104. data/sig/generated/riffer/providers/open_ai.rbs +23 -6
  105. data/sig/generated/riffer/stream_events/server_tool_done.rbs +15 -0
  106. data/sig/generated/riffer/testing.rbs +4 -0
  107. data/sig/generated/riffer/tool.rbs +48 -2
  108. data/sig/generated/riffer/tools/response.rbs +9 -2
  109. data/sig/generated/riffer.rbs +3 -0
  110. data/sig/manual/riffer/deprecation.rbs +5 -0
  111. data/sig/manual/riffer/providers/deferred_tool_gateway.rbs +5 -0
  112. metadata +23 -3
  113. data/lib/riffer/tools/toolable.rb +0 -113
  114. data/sig/generated/riffer/tools/toolable.rbs +0 -66
@@ -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
@@ -11,10 +11,20 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI::Stream
11
11
 
12
12
  @tools: Array[singleton(Riffer::Tool)]
13
13
 
14
+ # Each server tool has its own result type (web search run from code execution returns
15
+ # +code_execution_tool_result+ blocks too), and the API rejects a server_tool_use sent back
16
+ # without its result. +mcp_tool_result+ pairs with +mcp_tool_use+, which riffer drops, so
17
+ # its result is dropped too.
18
+ SERVER_TOOL_RESULT_TYPE: Regexp
19
+
14
20
  # --
15
21
  # : (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ReasoningPart?
16
22
  def self.reasoning_part: (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ReasoningPart?
17
23
 
24
+ # --
25
+ # : (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ServerToolPart
26
+ def self.server_tool_part: (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ServerToolPart
27
+
18
28
  # --
19
29
  # : (tools: Array[singleton(Riffer::Tool)]) -> void
20
30
  def initialize: (tools: Array[singleton(Riffer::Tool)]) -> void
@@ -24,7 +34,8 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI::Stream
24
34
  # : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
25
35
  def handle: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
26
36
 
27
- # 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.
28
39
  # --
29
40
  # : () -> Hash[Symbol, untyped]
30
41
  def finish!: () -> Hash[Symbol, untyped]
@@ -51,10 +62,6 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI::Stream
51
62
  # : (Hash[Symbol, untyped]) -> void
52
63
  def apply_message_delta: (Hash[Symbol, untyped]) -> void
53
64
 
54
- # --
55
- # : (Riffer::Providers::_EventSink) -> void
56
- def stop_message: (Riffer::Providers::_EventSink) -> void
57
-
58
65
  # --
59
66
  # : (Hash[Symbol, untyped]) -> void
60
67
  def raise_stream_error: (Hash[Symbol, untyped]) -> void
@@ -5,15 +5,21 @@ 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
- # request.
12
+ # request. Server tool parts and text parts that keep their block carry it too.
11
13
  REASONING_FORMAT: String
12
14
 
13
15
  # --
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,21 +39,39 @@ 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
 
40
48
  # --
41
- # : (Hash[Symbol, untyped]) -> String
42
- def extract_content: (Hash[Symbol, untyped]) -> String
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]?
43
63
 
64
+ # Claude signs each thinking block over every block before it in the turn, so
65
+ # the blocks go back in the order they came.
44
66
  # --
45
- # : (Hash[Symbol, untyped]) -> Array[Riffer::Messages::Assistant::ToolCall]
46
- def extract_tool_calls: (Hash[Symbol, untyped]) -> Array[Riffer::Messages::Assistant::ToolCall]
67
+ # : (Hash[Symbol, untyped]) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
68
+ def extract_parts: (Hash[Symbol, untyped]) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
47
69
 
70
+ # The block is kept only when it carries citations, which point into the
71
+ # search results and go back with the text.
48
72
  # --
49
- # : (Hash[Symbol, untyped]) -> Array[Riffer::Messages::Assistant::ReasoningPart]
50
- def extract_reasoning: (Hash[Symbol, untyped]) -> Array[Riffer::Messages::Assistant::ReasoningPart]
73
+ # : (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::TextPart
74
+ def text_part: (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::TextPart
51
75
 
52
76
  # --
53
77
  # : (Hash[Symbol, untyped]) -> Riffer::Providers::TokenUsage?
@@ -78,13 +102,30 @@ 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]
86
118
  def convert_assistant: (Riffer::Messages::Assistant) -> Hash[Symbol, untyped]
87
119
 
120
+ # --
121
+ # : (Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart) -> Hash[Symbol, untyped]?
122
+ def convert_part: (Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart) -> Hash[Symbol, untyped]?
123
+
124
+ # The API rejects text blocks that are empty or only whitespace.
125
+ # --
126
+ # : (Riffer::Messages::Assistant::TextPart) -> Hash[Symbol, untyped]?
127
+ def convert_text_part: (Riffer::Messages::Assistant::TextPart) -> Hash[Symbol, untyped]?
128
+
88
129
  # --
89
130
  # : (Riffer::Messages::Assistant::ReasoningPart) -> Hash[Symbol, untyped]
90
131
  def convert_reasoning_part: (Riffer::Messages::Assistant::ReasoningPart) -> 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
@@ -103,6 +116,11 @@ class Riffer::Providers::Base
103
116
  # : (untyped) -> Riffer::Providers::FinishReason?
104
117
  def extract_finish_reason: (untyped) -> Riffer::Providers::FinishReason?
105
118
 
119
+ # Override when the provider interleaves blocks in one turn and needs them back in that order.
120
+ # --
121
+ # : (untyped) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
122
+ def extract_parts: (untyped) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
123
+
106
124
  # --
107
125
  # : (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
108
126
  def extract_reasoning: (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
@@ -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
@@ -3,10 +3,17 @@
3
3
  class Riffer::Providers::OpenAI < Riffer::Providers::Base
4
4
  WEB_SEARCH_TOOL_TYPE: String
5
5
 
6
+ # Without this include, a web_search_call's search action carries no sources.
7
+ WEB_SEARCH_SOURCES_INCLUDE: String
8
+
6
9
  # The Responses API has no finish_reason field, and an +incomplete+ status is only meaningful
7
10
  # together with <tt>incomplete_details.reason</tt>.
8
11
  FINISH_REASONS: Hash[String, Symbol | Hash[String, Symbol]]
9
12
 
13
+ # --
14
+ # : () -> bool
15
+ def self.supports_deferred_tools?: () -> bool
16
+
10
17
  # --
11
18
  # : () -> String
12
19
  def self.semconv_provider_name: () -> String
@@ -109,9 +116,11 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
109
116
  # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
110
117
  def handle_function_call_arguments_delta: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
111
118
 
119
+ # Emitted from the finished item rather than function_call_arguments.done, because only the
120
+ # item's status marks a call cut off by max_output_tokens, whose arguments can't be run.
112
121
  # --
113
- # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
114
- def handle_function_call_arguments_done: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
122
+ # : (untyped, yielder: Riffer::Providers::_EventSink) -> void
123
+ def handle_output_item_done_function_call: (untyped, yielder: Riffer::Providers::_EventSink) -> void
115
124
 
116
125
  # --
117
126
  # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
@@ -130,12 +139,20 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
130
139
  def handle_output_item_done_reasoning: (untyped, yielder: Riffer::Providers::_EventSink) -> void
131
140
 
132
141
  # --
133
- # : (Array[Riffer::Messages::Base]) -> Array[Hash[Symbol, untyped]]
134
- 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]
135
152
 
136
153
  # --
137
- # : (Riffer::Messages::Assistant) -> Array[Hash[Symbol, untyped]]
138
- 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]]
139
156
 
140
157
  # --
141
158
  # : (Array[Riffer::Messages::Assistant::ReasoningPart]) -> Array[Hash[Symbol, untyped]]
@@ -0,0 +1,15 @@
1
+ # Generated from lib/riffer/stream_events/server_tool_done.rb with RBS::Inline
2
+
3
+ # Carries a server tool block for replay. WebSearchStatus and WebSearchDone are the events to
4
+ # display.
5
+ class Riffer::StreamEvents::ServerToolDone < Riffer::StreamEvents::Base
6
+ attr_reader part: Riffer::Messages::Assistant::ServerToolPart
7
+
8
+ # --
9
+ # : (Riffer::Messages::Assistant::ServerToolPart, ?role: Symbol) -> void
10
+ def initialize: (Riffer::Messages::Assistant::ServerToolPart, ?role: Symbol) -> void
11
+
12
+ # --
13
+ # : () -> Hash[Symbol, untyped]
14
+ def to_h: () -> Hash[Symbol, untyped]
15
+ end
@@ -13,6 +13,10 @@ module Riffer::Testing
13
13
  # : (?(String | Symbol)?, ?base: singleton(Riffer::Tool)) ?{ () [self: singleton(Riffer::Tool)] -> void } -> singleton(Riffer::Tool)
14
14
  def stub_tool: (?(String | Symbol)?, ?base: singleton(Riffer::Tool)) ?{ () [self: singleton(Riffer::Tool)] -> void } -> singleton(Riffer::Tool)
15
15
 
16
+ # --
17
+ # : [T] () { () -> T } -> T
18
+ def allow_deprecations: [T] () { () -> T } -> T
19
+
16
20
  # --
17
21
  # : () -> void
18
22
  def reset!: () -> void
@@ -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