riffer 0.53.0 → 0.55.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 (90) hide show
  1. checksums.yaml +4 -4
  2. data/.claude/rules/rbs-inline.md +8 -8
  3. data/.release-please-manifest.json +1 -1
  4. data/.ruby-version +1 -1
  5. data/CHANGELOG.md +43 -0
  6. data/README.md +24 -0
  7. data/Steepfile +19 -0
  8. data/docs/AGENTS.md +101 -14
  9. data/docs/CATALOG.md +8 -8
  10. data/docs/CONFIGURATION.md +47 -16
  11. data/docs/MCP.md +3 -4
  12. data/docs/OVERVIEW.md +1 -1
  13. data/docs/STREAM_EVENTS.md +1 -1
  14. data/docs/TOOLS.md +15 -12
  15. data/docs/TRACING.md +1 -1
  16. data/docs/providers/AMAZON_BEDROCK.md +2 -0
  17. data/docs/providers/ANTHROPIC.md +32 -36
  18. data/docs/providers/CUSTOM_PROVIDERS.md +35 -0
  19. data/docs/providers/GEMINI.md +76 -25
  20. data/docs/providers/GOOGLE_CLOUD.md +363 -0
  21. data/docs/providers/PROVIDERS.md +30 -18
  22. data/docs-site/manifest.yml +3 -0
  23. data/lib/riffer/agent/structured_output.rb +28 -3
  24. data/lib/riffer/config/anthropic.rb +9 -0
  25. data/lib/riffer/config/gemini.rb +9 -0
  26. data/lib/riffer/config/google_cloud.rb +38 -0
  27. data/lib/riffer/config.rb +3 -0
  28. data/lib/riffer/http/client.rb +141 -0
  29. data/lib/riffer/http.rb +5 -0
  30. data/lib/riffer/mcp/client.rb +0 -1
  31. data/lib/riffer/params/any_of.rb +50 -0
  32. data/lib/riffer/params/format.rb +73 -0
  33. data/lib/riffer/params/param.rb +143 -19
  34. data/lib/riffer/params.rb +156 -30
  35. data/lib/riffer/providers/amazon_bedrock.rb +38 -5
  36. data/lib/riffer/providers/anthropic/client.rb +49 -0
  37. data/lib/riffer/providers/anthropic.rb +19 -452
  38. data/lib/riffer/providers/anthropic_compatible/messages_api/stream.rb +195 -0
  39. data/lib/riffer/providers/anthropic_compatible/messages_api.rb +293 -0
  40. data/lib/riffer/providers/anthropic_compatible.rb +5 -0
  41. data/lib/riffer/providers/anthropic_vertex.rb +66 -0
  42. data/lib/riffer/providers/base.rb +13 -16
  43. data/lib/riffer/providers/gemini/client.rb +17 -85
  44. data/lib/riffer/providers/gemini.rb +213 -80
  45. data/lib/riffer/providers/google_cloud/client.rb +106 -0
  46. data/lib/riffer/providers/google_cloud.rb +99 -0
  47. data/lib/riffer/providers/repository.rb +2 -0
  48. data/lib/riffer/version.rb +1 -1
  49. data/lib/riffer/wire/sse.rb +51 -0
  50. data/lib/riffer/wire.rb +31 -0
  51. data/lib/riffer.rb +18 -0
  52. data/rbs_collection.lock.yaml +32 -4
  53. data/rbs_collection.yaml +2 -0
  54. data/sig/_private/faraday.rbs +8 -0
  55. data/sig/_private/googleauth.rbs +7 -0
  56. data/sig/generated/riffer/agent/structured_output.rbs +6 -0
  57. data/sig/generated/riffer/config/anthropic.rbs +6 -0
  58. data/sig/generated/riffer/config/gemini.rbs +6 -0
  59. data/sig/generated/riffer/config/google_cloud.rbs +28 -0
  60. data/sig/generated/riffer/config.rbs +2 -0
  61. data/sig/generated/riffer/http/client.rbs +59 -0
  62. data/sig/generated/riffer/http.rbs +4 -0
  63. data/sig/generated/riffer/params/any_of.rbs +21 -0
  64. data/sig/generated/riffer/params/format.rbs +39 -0
  65. data/sig/generated/riffer/params/param.rbs +27 -4
  66. data/sig/generated/riffer/params.rbs +38 -8
  67. data/sig/generated/riffer/providers/amazon_bedrock.rbs +14 -2
  68. data/sig/generated/riffer/providers/anthropic/client.rbs +34 -0
  69. data/sig/generated/riffer/providers/anthropic.rbs +5 -124
  70. data/sig/generated/riffer/providers/anthropic_compatible/messages_api/stream.rbs +71 -0
  71. data/sig/generated/riffer/providers/anthropic_compatible/messages_api.rbs +99 -0
  72. data/sig/generated/riffer/providers/anthropic_compatible.rbs +4 -0
  73. data/sig/generated/riffer/providers/anthropic_vertex.rbs +45 -0
  74. data/sig/generated/riffer/providers/gemini/client.rbs +11 -34
  75. data/sig/generated/riffer/providers/gemini.rbs +66 -4
  76. data/sig/generated/riffer/providers/google_cloud/client.rbs +71 -0
  77. data/sig/generated/riffer/providers/google_cloud.rbs +64 -0
  78. data/sig/generated/riffer/wire/sse.rbs +23 -0
  79. data/sig/generated/riffer/wire.rbs +17 -0
  80. data/sig/generated/riffer.rbs +12 -0
  81. data/sig/manifest.yaml +2 -1
  82. data/sig/manual/riffer/params/format.rbs +5 -0
  83. data/sig/manual/riffer/providers/anthropic_compatible/messages_api.rbs +8 -0
  84. data/sig/manual/riffer/providers/gemini.rbs +8 -0
  85. data/sig/manual/riffer/providers/google_cloud.rbs +8 -0
  86. data/sig/manual/riffer/wire.rbs +5 -0
  87. metadata +66 -5
  88. data/sig/_private/anthropic.rbs +0 -17
  89. data/sig/_private/riffer/providers/anthropic.rbs +0 -6
  90. data/sig/_private/riffer/providers/gemini.rbs +0 -7
@@ -0,0 +1,23 @@
1
+ # Generated from lib/riffer/wire/sse.rb with RBS::Inline
2
+
3
+ class Riffer::Wire::SSE
4
+ @buffer: String
5
+
6
+ @data: Array[String]
7
+
8
+ @event: String?
9
+
10
+ # --
11
+ # : () -> void
12
+ def initialize: () -> void
13
+
14
+ # --
15
+ # : (String) { (String, String?) -> void } -> void
16
+ def feed: (String) { (String, String?) -> void } -> void
17
+
18
+ private
19
+
20
+ # --
21
+ # : (String) { (String, String?) -> void } -> void
22
+ def process_line: (String) { (String, String?) -> void } -> void
23
+ end
@@ -0,0 +1,17 @@
1
+ # Generated from lib/riffer/wire.rb with RBS::Inline
2
+
3
+ module Riffer::Wire
4
+ TOOL_NAME_SEPARATOR: String
5
+
6
+ # --
7
+ # : (String) -> String
8
+ def encode_tool_name: (String) -> String
9
+
10
+ # --
11
+ # : (String, tools: Array[singleton(Riffer::Tool)]) -> String
12
+ def decode_tool_name: (String, tools: Array[singleton(Riffer::Tool)]) -> String
13
+
14
+ # --
15
+ # : (String) -> Hash[String, untyped]
16
+ def parse_tool_arguments: (String) -> Hash[String, untyped]
17
+ end
@@ -12,6 +12,18 @@ module Riffer
12
12
  class ValidationError < Error
13
13
  end
14
14
 
15
+ # A provider answered with a non-success status, or sent an in-stream error
16
+ # event (+status+ is nil then). +body+ is the raw response text.
17
+ class APIError < Error
18
+ attr_reader status: Integer?
19
+
20
+ attr_reader body: String?
21
+
22
+ # --
23
+ # : (?String?, ?status: Integer?, ?body: String?) -> void
24
+ def initialize: (?String?, ?status: Integer?, ?body: String?) -> void
25
+ end
26
+
15
27
  # Rescue it in the tool to clean up; otherwise it becomes a
16
28
  # +:timeout_error+ response.
17
29
  class TimeoutError < Error
data/sig/manifest.yaml CHANGED
@@ -1,4 +1,5 @@
1
1
  dependencies:
2
2
  - name: uri
3
3
  - name: net-http
4
- - name: digest
4
+ - name: digest
5
+ - name: ipaddr
@@ -0,0 +1,5 @@
1
+ # `Riffer::Params::Format` uses `extend self`; rbs-inline doesn't emit that,
2
+ # so re-extend here to expose its instance methods as singleton methods.
3
+ module Riffer::Params::Format
4
+ extend ::Riffer::Params::Format
5
+ end
@@ -0,0 +1,8 @@
1
+ # Narrows the private `client` to riffer's HTTP transport. It ships, since
2
+ # consumers always have Riffer::HTTP::Client; rbs-inline can't generate it
3
+ # because the class only inherits `client`.
4
+ class Riffer::Providers::AnthropicCompatible::MessagesAPI
5
+ private
6
+
7
+ def client: () -> Riffer::HTTP::Client
8
+ end
@@ -0,0 +1,8 @@
1
+ # Narrows the private `client` to riffer's Gemini transport. It ships, since
2
+ # the transport ships with riffer; rbs-inline can't generate it because the
3
+ # class only inherits `client`.
4
+ class Riffer::Providers::Gemini
5
+ private
6
+
7
+ def client: () -> Riffer::Providers::Gemini::Client
8
+ end
@@ -0,0 +1,8 @@
1
+ # Narrows the private `client` to riffer's Agent Platform transport. It ships,
2
+ # since the transport ships with riffer; rbs-inline can't generate it because
3
+ # the class only inherits `client`.
4
+ class Riffer::Providers::GoogleCloud
5
+ private
6
+
7
+ def client: () -> Riffer::Providers::GoogleCloud::Client
8
+ end
@@ -0,0 +1,5 @@
1
+ # `Riffer::Wire` uses `extend self`; rbs-inline doesn't emit that, so re-extend
2
+ # here to expose its instance methods as singleton methods.
3
+ module Riffer::Wire
4
+ extend ::Riffer::Wire
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.53.0
4
+ version: 0.55.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Jake Bottrall
@@ -43,6 +43,34 @@ dependencies:
43
43
  - - ">="
44
44
  - !ruby/object:Gem::Version
45
45
  version: '0'
46
+ - !ruby/object:Gem::Dependency
47
+ name: faraday
48
+ requirement: !ruby/object:Gem::Requirement
49
+ requirements:
50
+ - - "~>"
51
+ - !ruby/object:Gem::Version
52
+ version: '2.6'
53
+ type: :runtime
54
+ prerelease: false
55
+ version_requirements: !ruby/object:Gem::Requirement
56
+ requirements:
57
+ - - "~>"
58
+ - !ruby/object:Gem::Version
59
+ version: '2.6'
60
+ - !ruby/object:Gem::Dependency
61
+ name: faraday-net_http
62
+ requirement: !ruby/object:Gem::Requirement
63
+ requirements:
64
+ - - ">="
65
+ - !ruby/object:Gem::Version
66
+ version: '3.0'
67
+ type: :runtime
68
+ prerelease: false
69
+ version_requirements: !ruby/object:Gem::Requirement
70
+ requirements:
71
+ - - ">="
72
+ - !ruby/object:Gem::Version
73
+ version: '3.0'
46
74
  description: Riffer is a comprehensive Ruby framework designed to simplify the development
47
75
  of AI-powered applications and agents. It provides a complete toolkit for integrating
48
76
  artificial intelligence capabilities into your Ruby projects.
@@ -103,6 +131,7 @@ files:
103
131
  - docs/providers/AZURE_OPENAI.md
104
132
  - docs/providers/CUSTOM_PROVIDERS.md
105
133
  - docs/providers/GEMINI.md
134
+ - docs/providers/GOOGLE_CLOUD.md
106
135
  - docs/providers/MOCK_PROVIDER.md
107
136
  - docs/providers/OPENAI.md
108
137
  - docs/providers/OPENROUTER.md
@@ -129,6 +158,7 @@ files:
129
158
  - lib/riffer/config/evals.rb
130
159
  - lib/riffer/config/files.rb
131
160
  - lib/riffer/config/gemini.rb
161
+ - lib/riffer/config/google_cloud.rb
132
162
  - lib/riffer/config/mcp.rb
133
163
  - lib/riffer/config/open_ai.rb
134
164
  - lib/riffer/config/open_router.rb
@@ -158,6 +188,8 @@ files:
158
188
  - lib/riffer/helpers/dependencies.rb
159
189
  - lib/riffer/helpers/identifier.rb
160
190
  - lib/riffer/helpers/validate.rb
191
+ - lib/riffer/http.rb
192
+ - lib/riffer/http/client.rb
161
193
  - lib/riffer/mcp.rb
162
194
  - lib/riffer/mcp/authenticated_tool.rb
163
195
  - lib/riffer/mcp/client.rb
@@ -177,16 +209,25 @@ files:
177
209
  - lib/riffer/messages/user.rb
178
210
  - lib/riffer/messages/user/file_part.rb
179
211
  - lib/riffer/params.rb
212
+ - lib/riffer/params/any_of.rb
180
213
  - lib/riffer/params/boolean.rb
214
+ - lib/riffer/params/format.rb
181
215
  - lib/riffer/params/param.rb
182
216
  - lib/riffer/providers.rb
183
217
  - lib/riffer/providers/amazon_bedrock.rb
184
218
  - lib/riffer/providers/anthropic.rb
219
+ - lib/riffer/providers/anthropic/client.rb
220
+ - lib/riffer/providers/anthropic_compatible.rb
221
+ - lib/riffer/providers/anthropic_compatible/messages_api.rb
222
+ - lib/riffer/providers/anthropic_compatible/messages_api/stream.rb
223
+ - lib/riffer/providers/anthropic_vertex.rb
185
224
  - lib/riffer/providers/azure_open_ai.rb
186
225
  - lib/riffer/providers/base.rb
187
226
  - lib/riffer/providers/finish_reason.rb
188
227
  - lib/riffer/providers/gemini.rb
189
228
  - lib/riffer/providers/gemini/client.rb
229
+ - lib/riffer/providers/google_cloud.rb
230
+ - lib/riffer/providers/google_cloud/client.rb
190
231
  - lib/riffer/providers/mock.rb
191
232
  - lib/riffer/providers/open_ai.rb
192
233
  - lib/riffer/providers/open_router.rb
@@ -240,18 +281,19 @@ files:
240
281
  - lib/riffer/tracing/otel.rb
241
282
  - lib/riffer/tracing/stream_recorder.rb
242
283
  - lib/riffer/version.rb
284
+ - lib/riffer/wire.rb
285
+ - lib/riffer/wire/sse.rb
243
286
  - rbs_collection.lock.yaml
244
287
  - rbs_collection.yaml
245
- - sig/_private/anthropic.rbs
246
288
  - sig/_private/aws-sdk-core/event_error.rbs
247
289
  - sig/_private/aws-sdk-core/seahorse_request_context.rbs
248
290
  - sig/_private/aws-sdk-core/static_token_provider.rbs
291
+ - sig/_private/faraday.rbs
292
+ - sig/_private/googleauth.rbs
249
293
  - sig/_private/mcp.rbs
250
294
  - sig/_private/openai.rbs
251
295
  - sig/_private/opentelemetry.rbs
252
296
  - sig/_private/riffer/providers/amazon_bedrock.rbs
253
- - sig/_private/riffer/providers/anthropic.rbs
254
- - sig/_private/riffer/providers/gemini.rbs
255
297
  - sig/_private/riffer/providers/open_ai.rbs
256
298
  - sig/_private/riffer/providers/open_router.rbs
257
299
  - sig/_private/riffer/testing/minitest.rbs
@@ -279,6 +321,7 @@ files:
279
321
  - sig/generated/riffer/config/evals.rbs
280
322
  - sig/generated/riffer/config/files.rbs
281
323
  - sig/generated/riffer/config/gemini.rbs
324
+ - sig/generated/riffer/config/google_cloud.rbs
282
325
  - sig/generated/riffer/config/mcp.rbs
283
326
  - sig/generated/riffer/config/open_ai.rbs
284
327
  - sig/generated/riffer/config/open_router.rbs
@@ -308,6 +351,8 @@ files:
308
351
  - sig/generated/riffer/helpers/dependencies.rbs
309
352
  - sig/generated/riffer/helpers/identifier.rbs
310
353
  - sig/generated/riffer/helpers/validate.rbs
354
+ - sig/generated/riffer/http.rbs
355
+ - sig/generated/riffer/http/client.rbs
311
356
  - sig/generated/riffer/mcp.rbs
312
357
  - sig/generated/riffer/mcp/authenticated_tool.rbs
313
358
  - sig/generated/riffer/mcp/client.rbs
@@ -327,16 +372,25 @@ files:
327
372
  - sig/generated/riffer/messages/user.rbs
328
373
  - sig/generated/riffer/messages/user/file_part.rbs
329
374
  - sig/generated/riffer/params.rbs
375
+ - sig/generated/riffer/params/any_of.rbs
330
376
  - sig/generated/riffer/params/boolean.rbs
377
+ - sig/generated/riffer/params/format.rbs
331
378
  - sig/generated/riffer/params/param.rbs
332
379
  - sig/generated/riffer/providers.rbs
333
380
  - sig/generated/riffer/providers/amazon_bedrock.rbs
334
381
  - sig/generated/riffer/providers/anthropic.rbs
382
+ - sig/generated/riffer/providers/anthropic/client.rbs
383
+ - sig/generated/riffer/providers/anthropic_compatible.rbs
384
+ - sig/generated/riffer/providers/anthropic_compatible/messages_api.rbs
385
+ - sig/generated/riffer/providers/anthropic_compatible/messages_api/stream.rbs
386
+ - sig/generated/riffer/providers/anthropic_vertex.rbs
335
387
  - sig/generated/riffer/providers/azure_open_ai.rbs
336
388
  - sig/generated/riffer/providers/base.rbs
337
389
  - sig/generated/riffer/providers/finish_reason.rbs
338
390
  - sig/generated/riffer/providers/gemini.rbs
339
391
  - sig/generated/riffer/providers/gemini/client.rbs
392
+ - sig/generated/riffer/providers/google_cloud.rbs
393
+ - sig/generated/riffer/providers/google_cloud/client.rbs
340
394
  - sig/generated/riffer/providers/mock.rbs
341
395
  - sig/generated/riffer/providers/open_ai.rbs
342
396
  - sig/generated/riffer/providers/open_router.rbs
@@ -389,6 +443,8 @@ files:
389
443
  - sig/generated/riffer/tracing/otel.rbs
390
444
  - sig/generated/riffer/tracing/stream_recorder.rbs
391
445
  - sig/generated/riffer/version.rbs
446
+ - sig/generated/riffer/wire.rbs
447
+ - sig/generated/riffer/wire/sse.rbs
392
448
  - sig/manifest.yaml
393
449
  - sig/manual/riffer.rbs
394
450
  - sig/manual/riffer/agent.rbs
@@ -407,13 +463,18 @@ files:
407
463
  - sig/manual/riffer/mcp/authenticated_tool.rbs
408
464
  - sig/manual/riffer/mcp/registry.rbs
409
465
  - sig/manual/riffer/mcp/tool_factory.rbs
466
+ - sig/manual/riffer/params/format.rbs
410
467
  - sig/manual/riffer/providers.rbs
468
+ - sig/manual/riffer/providers/anthropic_compatible/messages_api.rbs
469
+ - sig/manual/riffer/providers/gemini.rbs
470
+ - sig/manual/riffer/providers/google_cloud.rbs
411
471
  - sig/manual/riffer/providers/repository.rbs
412
472
  - sig/manual/riffer/testing.rbs
413
473
  - sig/manual/riffer/tool.rbs
414
474
  - sig/manual/riffer/tracing.rbs
415
475
  - sig/manual/riffer/tracing/capture.rbs
416
476
  - sig/manual/riffer/tracing/no_op.rbs
477
+ - sig/manual/riffer/wire.rbs
417
478
  homepage: https://riffer.ai
418
479
  licenses:
419
480
  - MIT
@@ -443,7 +504,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
443
504
  - !ruby/object:Gem::Version
444
505
  version: '0'
445
506
  requirements: []
446
- rubygems_version: 4.0.10
507
+ rubygems_version: 4.0.20
447
508
  specification_version: 4
448
509
  summary: The all-in-one Ruby framework for building AI-powered applications and agents.
449
510
  test_files: []
@@ -1,17 +0,0 @@
1
- # Arity patch for the `anthropic` gem (see openai.rbs for the rationale). Both
2
- # `Messages#create` and `Messages#stream` are positional `def x(params)` at
3
- # runtime but typed keyword-only in the gem's RBS. Streaming returns `untyped`
4
- # (a MessageStream helper). Loaded only for riffer's own Steep run.
5
- module Anthropic
6
- module Resources
7
- class Messages
8
- def create: (Hash[Symbol, untyped] params) -> Anthropic::Models::Message
9
- | (**untyped) -> Anthropic::Models::Message
10
- | ...
11
-
12
- def stream: (Hash[Symbol, untyped] params) -> untyped
13
- | (**untyped) -> untyped
14
- | ...
15
- end
16
- end
17
- end
@@ -1,6 +0,0 @@
1
- # `client` is typed against the SDK, so this narrowing stays in _private (never ships)
2
- class Riffer::Providers::Anthropic
3
- private
4
-
5
- def client: () -> ::Anthropic::Client
6
- end
@@ -1,7 +0,0 @@
1
- # Narrows the private `client` to riffer's Gemini transport, mirroring the
2
- # SDK-typed narrowings alongside it.
3
- class Riffer::Providers::Gemini
4
- private
5
-
6
- def client: () -> Riffer::Providers::Gemini::Client
7
- end