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
@@ -63,6 +63,9 @@ module Riffer
63
63
  class DuplicateIdentifierError < Error
64
64
  end
65
65
 
66
+ class DeprecationError < Error
67
+ end
68
+
66
69
  # --
67
70
  # : () -> Riffer::Config
68
71
  def config: () -> Riffer::Config
@@ -0,0 +1,5 @@
1
+ # `Riffer::Deprecation` uses `extend self`; rbs-inline doesn't emit that, so
2
+ # re-extend here to expose its instance methods as singleton methods.
3
+ module Riffer::Deprecation
4
+ extend ::Riffer::Deprecation
5
+ 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.55.0
4
+ version: 0.57.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Jake Bottrall
@@ -98,6 +98,7 @@ files:
98
98
  - README.md
99
99
  - Rakefile
100
100
  - Steepfile
101
+ - UPGRADING.md
101
102
  - docs-site/404.html
102
103
  - docs-site/build.rb
103
104
  - docs-site/check.rb
@@ -121,6 +122,7 @@ files:
121
122
  - docs/OVERVIEW.md
122
123
  - docs/SERIALIZATION.md
123
124
  - docs/SKILLS.md
125
+ - docs/STABILITY.md
124
126
  - docs/STREAM_EVENTS.md
125
127
  - docs/TESTING.md
126
128
  - docs/TOOLS.md
@@ -157,6 +159,7 @@ files:
157
159
  - lib/riffer/config/azure_open_ai.rb
158
160
  - lib/riffer/config/evals.rb
159
161
  - lib/riffer/config/files.rb
162
+ - lib/riffer/config/future.rb
160
163
  - lib/riffer/config/gemini.rb
161
164
  - lib/riffer/config/google_cloud.rb
162
165
  - lib/riffer/config/mcp.rb
@@ -165,6 +168,8 @@ files:
165
168
  - lib/riffer/config/pricing.rb
166
169
  - lib/riffer/config/skills.rb
167
170
  - lib/riffer/config/tracing.rb
171
+ - lib/riffer/deprecation.rb
172
+ - lib/riffer/deprecation/event.rb
168
173
  - lib/riffer/evals.rb
169
174
  - lib/riffer/evals/evaluator.rb
170
175
  - lib/riffer/evals/evaluator_runner.rb
@@ -202,6 +207,8 @@ files:
202
207
  - lib/riffer/messages.rb
203
208
  - lib/riffer/messages/assistant.rb
204
209
  - lib/riffer/messages/assistant/reasoning_part.rb
210
+ - lib/riffer/messages/assistant/server_tool_part.rb
211
+ - lib/riffer/messages/assistant/text_part.rb
205
212
  - lib/riffer/messages/assistant/tool_call.rb
206
213
  - lib/riffer/messages/base.rb
207
214
  - lib/riffer/messages/system.rb
@@ -223,6 +230,9 @@ files:
223
230
  - lib/riffer/providers/anthropic_vertex.rb
224
231
  - lib/riffer/providers/azure_open_ai.rb
225
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
226
236
  - lib/riffer/providers/finish_reason.rb
227
237
  - lib/riffer/providers/gemini.rb
228
238
  - lib/riffer/providers/gemini/client.rb
@@ -256,6 +266,7 @@ files:
256
266
  - lib/riffer/stream_events/interrupt.rb
257
267
  - lib/riffer/stream_events/reasoning_delta.rb
258
268
  - lib/riffer/stream_events/reasoning_done.rb
269
+ - lib/riffer/stream_events/server_tool_done.rb
259
270
  - lib/riffer/stream_events/skill_activation.rb
260
271
  - lib/riffer/stream_events/text_delta.rb
261
272
  - lib/riffer/stream_events/text_done.rb
@@ -274,7 +285,6 @@ files:
274
285
  - lib/riffer/tools/runtime/fibers.rb
275
286
  - lib/riffer/tools/runtime/inline.rb
276
287
  - lib/riffer/tools/runtime/threaded.rb
277
- - lib/riffer/tools/toolable.rb
278
288
  - lib/riffer/tracing.rb
279
289
  - lib/riffer/tracing/capture.rb
280
290
  - lib/riffer/tracing/no_op.rb
@@ -320,6 +330,7 @@ files:
320
330
  - sig/generated/riffer/config/azure_open_ai.rbs
321
331
  - sig/generated/riffer/config/evals.rbs
322
332
  - sig/generated/riffer/config/files.rbs
333
+ - sig/generated/riffer/config/future.rbs
323
334
  - sig/generated/riffer/config/gemini.rbs
324
335
  - sig/generated/riffer/config/google_cloud.rbs
325
336
  - sig/generated/riffer/config/mcp.rbs
@@ -328,6 +339,8 @@ files:
328
339
  - sig/generated/riffer/config/pricing.rbs
329
340
  - sig/generated/riffer/config/skills.rbs
330
341
  - sig/generated/riffer/config/tracing.rbs
342
+ - sig/generated/riffer/deprecation.rbs
343
+ - sig/generated/riffer/deprecation/event.rbs
331
344
  - sig/generated/riffer/evals.rbs
332
345
  - sig/generated/riffer/evals/evaluator.rbs
333
346
  - sig/generated/riffer/evals/evaluator_runner.rbs
@@ -365,6 +378,8 @@ files:
365
378
  - sig/generated/riffer/messages.rbs
366
379
  - sig/generated/riffer/messages/assistant.rbs
367
380
  - sig/generated/riffer/messages/assistant/reasoning_part.rbs
381
+ - sig/generated/riffer/messages/assistant/server_tool_part.rbs
382
+ - sig/generated/riffer/messages/assistant/text_part.rbs
368
383
  - sig/generated/riffer/messages/assistant/tool_call.rbs
369
384
  - sig/generated/riffer/messages/base.rbs
370
385
  - sig/generated/riffer/messages/system.rbs
@@ -386,6 +401,9 @@ files:
386
401
  - sig/generated/riffer/providers/anthropic_vertex.rbs
387
402
  - sig/generated/riffer/providers/azure_open_ai.rbs
388
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
389
407
  - sig/generated/riffer/providers/finish_reason.rbs
390
408
  - sig/generated/riffer/providers/gemini.rbs
391
409
  - sig/generated/riffer/providers/gemini/client.rbs
@@ -419,6 +437,7 @@ files:
419
437
  - sig/generated/riffer/stream_events/interrupt.rbs
420
438
  - sig/generated/riffer/stream_events/reasoning_delta.rbs
421
439
  - sig/generated/riffer/stream_events/reasoning_done.rbs
440
+ - sig/generated/riffer/stream_events/server_tool_done.rbs
422
441
  - sig/generated/riffer/stream_events/skill_activation.rbs
423
442
  - sig/generated/riffer/stream_events/text_delta.rbs
424
443
  - sig/generated/riffer/stream_events/text_done.rbs
@@ -436,7 +455,6 @@ files:
436
455
  - sig/generated/riffer/tools/runtime/fibers.rbs
437
456
  - sig/generated/riffer/tools/runtime/inline.rbs
438
457
  - sig/generated/riffer/tools/runtime/threaded.rbs
439
- - sig/generated/riffer/tools/toolable.rbs
440
458
  - sig/generated/riffer/tracing.rbs
441
459
  - sig/generated/riffer/tracing/capture.rbs
442
460
  - sig/generated/riffer/tracing/no_op.rbs
@@ -452,6 +470,7 @@ files:
452
470
  - sig/manual/riffer/agent/serializer.rbs
453
471
  - sig/manual/riffer/agent/session/repair.rbs
454
472
  - sig/manual/riffer/agent/structured_output/parser.rbs
473
+ - sig/manual/riffer/deprecation.rbs
455
474
  - sig/manual/riffer/evals/evaluator_runner.rbs
456
475
  - sig/manual/riffer/helpers/boolean.rbs
457
476
  - sig/manual/riffer/helpers/call_or_value.rbs
@@ -466,6 +485,7 @@ files:
466
485
  - sig/manual/riffer/params/format.rbs
467
486
  - sig/manual/riffer/providers.rbs
468
487
  - sig/manual/riffer/providers/anthropic_compatible/messages_api.rbs
488
+ - sig/manual/riffer/providers/deferred_tool_gateway.rbs
469
489
  - sig/manual/riffer/providers/gemini.rbs
470
490
  - sig/manual/riffer/providers/google_cloud.rbs
471
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