riffer 0.54.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 (83) hide show
  1. checksums.yaml +4 -4
  2. data/.claude/rules/rbs-inline.md +6 -6
  3. data/.release-please-manifest.json +1 -1
  4. data/.ruby-version +1 -1
  5. data/CHANGELOG.md +28 -0
  6. data/README.md +24 -0
  7. data/Steepfile +2 -2
  8. data/docs/AGENTS.md +37 -12
  9. data/docs/CATALOG.md +8 -8
  10. data/docs/CONFIGURATION.md +47 -16
  11. data/docs/MCP.md +3 -4
  12. data/docs/STREAM_EVENTS.md +1 -1
  13. data/docs/TOOLS.md +11 -11
  14. data/docs/TRACING.md +1 -1
  15. data/docs/providers/AMAZON_BEDROCK.md +2 -0
  16. data/docs/providers/ANTHROPIC.md +32 -36
  17. data/docs/providers/CUSTOM_PROVIDERS.md +35 -0
  18. data/docs/providers/GEMINI.md +76 -26
  19. data/docs/providers/GOOGLE_CLOUD.md +363 -0
  20. data/docs/providers/PROVIDERS.md +30 -18
  21. data/docs-site/manifest.yml +3 -0
  22. data/lib/riffer/agent/structured_output.rb +6 -1
  23. data/lib/riffer/config/anthropic.rb +9 -0
  24. data/lib/riffer/config/gemini.rb +9 -0
  25. data/lib/riffer/config/google_cloud.rb +38 -0
  26. data/lib/riffer/config.rb +3 -0
  27. data/lib/riffer/http/client.rb +141 -0
  28. data/lib/riffer/http.rb +5 -0
  29. data/lib/riffer/mcp/client.rb +0 -1
  30. data/lib/riffer/params/any_of.rb +37 -9
  31. data/lib/riffer/params/param.rb +35 -14
  32. data/lib/riffer/params.rb +34 -19
  33. data/lib/riffer/providers/amazon_bedrock.rb +38 -5
  34. data/lib/riffer/providers/anthropic/client.rb +49 -0
  35. data/lib/riffer/providers/anthropic.rb +19 -452
  36. data/lib/riffer/providers/anthropic_compatible/messages_api/stream.rb +195 -0
  37. data/lib/riffer/providers/anthropic_compatible/messages_api.rb +293 -0
  38. data/lib/riffer/providers/anthropic_compatible.rb +5 -0
  39. data/lib/riffer/providers/anthropic_vertex.rb +66 -0
  40. data/lib/riffer/providers/base.rb +4 -7
  41. data/lib/riffer/providers/gemini/client.rb +17 -85
  42. data/lib/riffer/providers/gemini.rb +213 -81
  43. data/lib/riffer/providers/google_cloud/client.rb +106 -0
  44. data/lib/riffer/providers/google_cloud.rb +99 -0
  45. data/lib/riffer/providers/repository.rb +2 -0
  46. data/lib/riffer/version.rb +1 -1
  47. data/lib/riffer/wire/sse.rb +51 -0
  48. data/lib/riffer/wire.rb +31 -0
  49. data/lib/riffer.rb +18 -0
  50. data/rbs_collection.lock.yaml +24 -4
  51. data/sig/_private/faraday.rbs +8 -0
  52. data/sig/_private/googleauth.rbs +7 -0
  53. data/sig/generated/riffer/config/anthropic.rbs +6 -0
  54. data/sig/generated/riffer/config/gemini.rbs +6 -0
  55. data/sig/generated/riffer/config/google_cloud.rbs +28 -0
  56. data/sig/generated/riffer/config.rbs +2 -0
  57. data/sig/generated/riffer/http/client.rbs +59 -0
  58. data/sig/generated/riffer/http.rbs +4 -0
  59. data/sig/generated/riffer/params/any_of.rbs +13 -5
  60. data/sig/generated/riffer/params/param.rbs +10 -5
  61. data/sig/generated/riffer/params.rbs +8 -4
  62. data/sig/generated/riffer/providers/amazon_bedrock.rbs +14 -2
  63. data/sig/generated/riffer/providers/anthropic/client.rbs +34 -0
  64. data/sig/generated/riffer/providers/anthropic.rbs +5 -124
  65. data/sig/generated/riffer/providers/anthropic_compatible/messages_api/stream.rbs +71 -0
  66. data/sig/generated/riffer/providers/anthropic_compatible/messages_api.rbs +99 -0
  67. data/sig/generated/riffer/providers/anthropic_compatible.rbs +4 -0
  68. data/sig/generated/riffer/providers/anthropic_vertex.rbs +45 -0
  69. data/sig/generated/riffer/providers/gemini/client.rbs +11 -34
  70. data/sig/generated/riffer/providers/gemini.rbs +66 -4
  71. data/sig/generated/riffer/providers/google_cloud/client.rbs +71 -0
  72. data/sig/generated/riffer/providers/google_cloud.rbs +64 -0
  73. data/sig/generated/riffer/wire/sse.rbs +23 -0
  74. data/sig/generated/riffer/wire.rbs +17 -0
  75. data/sig/generated/riffer.rbs +12 -0
  76. data/sig/manual/riffer/providers/anthropic_compatible/messages_api.rbs +8 -0
  77. data/sig/manual/riffer/providers/gemini.rbs +8 -0
  78. data/sig/manual/riffer/providers/google_cloud.rbs +8 -0
  79. data/sig/manual/riffer/wire.rbs +5 -0
  80. metadata +61 -5
  81. data/sig/_private/anthropic.rbs +0 -17
  82. data/sig/_private/riffer/providers/anthropic.rbs +0 -6
  83. 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
@@ -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.54.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
@@ -184,11 +216,18 @@ files:
184
216
  - lib/riffer/providers.rb
185
217
  - lib/riffer/providers/amazon_bedrock.rb
186
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
187
224
  - lib/riffer/providers/azure_open_ai.rb
188
225
  - lib/riffer/providers/base.rb
189
226
  - lib/riffer/providers/finish_reason.rb
190
227
  - lib/riffer/providers/gemini.rb
191
228
  - lib/riffer/providers/gemini/client.rb
229
+ - lib/riffer/providers/google_cloud.rb
230
+ - lib/riffer/providers/google_cloud/client.rb
192
231
  - lib/riffer/providers/mock.rb
193
232
  - lib/riffer/providers/open_ai.rb
194
233
  - lib/riffer/providers/open_router.rb
@@ -242,18 +281,19 @@ files:
242
281
  - lib/riffer/tracing/otel.rb
243
282
  - lib/riffer/tracing/stream_recorder.rb
244
283
  - lib/riffer/version.rb
284
+ - lib/riffer/wire.rb
285
+ - lib/riffer/wire/sse.rb
245
286
  - rbs_collection.lock.yaml
246
287
  - rbs_collection.yaml
247
- - sig/_private/anthropic.rbs
248
288
  - sig/_private/aws-sdk-core/event_error.rbs
249
289
  - sig/_private/aws-sdk-core/seahorse_request_context.rbs
250
290
  - sig/_private/aws-sdk-core/static_token_provider.rbs
291
+ - sig/_private/faraday.rbs
292
+ - sig/_private/googleauth.rbs
251
293
  - sig/_private/mcp.rbs
252
294
  - sig/_private/openai.rbs
253
295
  - sig/_private/opentelemetry.rbs
254
296
  - sig/_private/riffer/providers/amazon_bedrock.rbs
255
- - sig/_private/riffer/providers/anthropic.rbs
256
- - sig/_private/riffer/providers/gemini.rbs
257
297
  - sig/_private/riffer/providers/open_ai.rbs
258
298
  - sig/_private/riffer/providers/open_router.rbs
259
299
  - sig/_private/riffer/testing/minitest.rbs
@@ -281,6 +321,7 @@ files:
281
321
  - sig/generated/riffer/config/evals.rbs
282
322
  - sig/generated/riffer/config/files.rbs
283
323
  - sig/generated/riffer/config/gemini.rbs
324
+ - sig/generated/riffer/config/google_cloud.rbs
284
325
  - sig/generated/riffer/config/mcp.rbs
285
326
  - sig/generated/riffer/config/open_ai.rbs
286
327
  - sig/generated/riffer/config/open_router.rbs
@@ -310,6 +351,8 @@ files:
310
351
  - sig/generated/riffer/helpers/dependencies.rbs
311
352
  - sig/generated/riffer/helpers/identifier.rbs
312
353
  - sig/generated/riffer/helpers/validate.rbs
354
+ - sig/generated/riffer/http.rbs
355
+ - sig/generated/riffer/http/client.rbs
313
356
  - sig/generated/riffer/mcp.rbs
314
357
  - sig/generated/riffer/mcp/authenticated_tool.rbs
315
358
  - sig/generated/riffer/mcp/client.rbs
@@ -336,11 +379,18 @@ files:
336
379
  - sig/generated/riffer/providers.rbs
337
380
  - sig/generated/riffer/providers/amazon_bedrock.rbs
338
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
339
387
  - sig/generated/riffer/providers/azure_open_ai.rbs
340
388
  - sig/generated/riffer/providers/base.rbs
341
389
  - sig/generated/riffer/providers/finish_reason.rbs
342
390
  - sig/generated/riffer/providers/gemini.rbs
343
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
344
394
  - sig/generated/riffer/providers/mock.rbs
345
395
  - sig/generated/riffer/providers/open_ai.rbs
346
396
  - sig/generated/riffer/providers/open_router.rbs
@@ -393,6 +443,8 @@ files:
393
443
  - sig/generated/riffer/tracing/otel.rbs
394
444
  - sig/generated/riffer/tracing/stream_recorder.rbs
395
445
  - sig/generated/riffer/version.rbs
446
+ - sig/generated/riffer/wire.rbs
447
+ - sig/generated/riffer/wire/sse.rbs
396
448
  - sig/manifest.yaml
397
449
  - sig/manual/riffer.rbs
398
450
  - sig/manual/riffer/agent.rbs
@@ -413,12 +465,16 @@ files:
413
465
  - sig/manual/riffer/mcp/tool_factory.rbs
414
466
  - sig/manual/riffer/params/format.rbs
415
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
416
471
  - sig/manual/riffer/providers/repository.rbs
417
472
  - sig/manual/riffer/testing.rbs
418
473
  - sig/manual/riffer/tool.rbs
419
474
  - sig/manual/riffer/tracing.rbs
420
475
  - sig/manual/riffer/tracing/capture.rbs
421
476
  - sig/manual/riffer/tracing/no_op.rbs
477
+ - sig/manual/riffer/wire.rbs
422
478
  homepage: https://riffer.ai
423
479
  licenses:
424
480
  - MIT
@@ -448,7 +504,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
448
504
  - !ruby/object:Gem::Version
449
505
  version: '0'
450
506
  requirements: []
451
- rubygems_version: 4.0.10
507
+ rubygems_version: 4.0.20
452
508
  specification_version: 4
453
509
  summary: The all-in-one Ruby framework for building AI-powered applications and agents.
454
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