riffer 0.54.0 → 0.56.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 (117) 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 +46 -0
  6. data/README.md +26 -1
  7. data/Steepfile +2 -2
  8. data/UPGRADING.md +3 -0
  9. data/docs/AGENTS.md +37 -12
  10. data/docs/AGENT_LIFECYCLE.md +1 -1
  11. data/docs/CATALOG.md +8 -8
  12. data/docs/CONFIGURATION.md +95 -17
  13. data/docs/GUARDRAILS.md +2 -0
  14. data/docs/MCP.md +3 -4
  15. data/docs/MESSAGES.md +112 -15
  16. data/docs/STABILITY.md +32 -0
  17. data/docs/STREAM_EVENTS.md +17 -1
  18. data/docs/TESTING.md +22 -1
  19. data/docs/TOOLS.md +11 -11
  20. data/docs/TRACING.md +1 -1
  21. data/docs/providers/AMAZON_BEDROCK.md +3 -1
  22. data/docs/providers/ANTHROPIC.md +44 -44
  23. data/docs/providers/CUSTOM_PROVIDERS.md +59 -0
  24. data/docs/providers/GEMINI.md +76 -26
  25. data/docs/providers/GOOGLE_CLOUD.md +363 -0
  26. data/docs/providers/MOCK_PROVIDER.md +2 -0
  27. data/docs/providers/OPENAI.md +3 -1
  28. data/docs/providers/PROVIDERS.md +30 -18
  29. data/docs-site/manifest.yml +6 -0
  30. data/lib/riffer/agent/run.rb +28 -13
  31. data/lib/riffer/agent/session.rb +33 -10
  32. data/lib/riffer/agent/structured_output.rb +6 -1
  33. data/lib/riffer/config/anthropic.rb +9 -0
  34. data/lib/riffer/config/future.rb +53 -0
  35. data/lib/riffer/config/gemini.rb +9 -0
  36. data/lib/riffer/config/google_cloud.rb +38 -0
  37. data/lib/riffer/config/pricing.rb +5 -15
  38. data/lib/riffer/config.rb +19 -0
  39. data/lib/riffer/deprecation/event.rb +25 -0
  40. data/lib/riffer/deprecation.rb +60 -0
  41. data/lib/riffer/http/client.rb +141 -0
  42. data/lib/riffer/http.rb +5 -0
  43. data/lib/riffer/mcp/client.rb +0 -1
  44. data/lib/riffer/messages/assistant/server_tool_part.rb +73 -0
  45. data/lib/riffer/messages/assistant/text_part.rb +52 -0
  46. data/lib/riffer/messages/assistant.rb +64 -17
  47. data/lib/riffer/params/any_of.rb +37 -9
  48. data/lib/riffer/params/param.rb +35 -14
  49. data/lib/riffer/params.rb +34 -19
  50. data/lib/riffer/providers/amazon_bedrock.rb +38 -5
  51. data/lib/riffer/providers/anthropic/client.rb +49 -0
  52. data/lib/riffer/providers/anthropic.rb +19 -452
  53. data/lib/riffer/providers/anthropic_compatible/messages_api/stream.rb +219 -0
  54. data/lib/riffer/providers/anthropic_compatible/messages_api.rb +315 -0
  55. data/lib/riffer/providers/anthropic_compatible.rb +5 -0
  56. data/lib/riffer/providers/anthropic_vertex.rb +66 -0
  57. data/lib/riffer/providers/base.rb +19 -13
  58. data/lib/riffer/providers/gemini/client.rb +17 -85
  59. data/lib/riffer/providers/gemini.rb +213 -81
  60. data/lib/riffer/providers/google_cloud/client.rb +106 -0
  61. data/lib/riffer/providers/google_cloud.rb +99 -0
  62. data/lib/riffer/providers/open_ai.rb +21 -16
  63. data/lib/riffer/providers/repository.rb +2 -0
  64. data/lib/riffer/stream_events/server_tool_done.rb +21 -0
  65. data/lib/riffer/testing.rb +6 -0
  66. data/lib/riffer/version.rb +1 -1
  67. data/lib/riffer/wire/sse.rb +51 -0
  68. data/lib/riffer/wire.rb +31 -0
  69. data/lib/riffer.rb +20 -0
  70. data/rbs_collection.lock.yaml +24 -4
  71. data/sig/_private/faraday.rbs +8 -0
  72. data/sig/_private/googleauth.rbs +7 -0
  73. data/sig/generated/riffer/agent/run.rbs +5 -0
  74. data/sig/generated/riffer/agent/session.rbs +6 -0
  75. data/sig/generated/riffer/config/anthropic.rbs +6 -0
  76. data/sig/generated/riffer/config/future.rbs +29 -0
  77. data/sig/generated/riffer/config/gemini.rbs +6 -0
  78. data/sig/generated/riffer/config/google_cloud.rbs +28 -0
  79. data/sig/generated/riffer/config/pricing.rbs +0 -9
  80. data/sig/generated/riffer/config.rbs +10 -0
  81. data/sig/generated/riffer/deprecation/event.rbs +17 -0
  82. data/sig/generated/riffer/deprecation.rbs +27 -0
  83. data/sig/generated/riffer/http/client.rbs +59 -0
  84. data/sig/generated/riffer/http.rbs +4 -0
  85. data/sig/generated/riffer/messages/assistant/server_tool_part.rbs +44 -0
  86. data/sig/generated/riffer/messages/assistant/text_part.rbs +35 -0
  87. data/sig/generated/riffer/messages/assistant.rbs +24 -11
  88. data/sig/generated/riffer/params/any_of.rbs +13 -5
  89. data/sig/generated/riffer/params/param.rbs +10 -5
  90. data/sig/generated/riffer/params.rbs +8 -4
  91. data/sig/generated/riffer/providers/amazon_bedrock.rbs +14 -2
  92. data/sig/generated/riffer/providers/anthropic/client.rbs +34 -0
  93. data/sig/generated/riffer/providers/anthropic.rbs +5 -124
  94. data/sig/generated/riffer/providers/anthropic_compatible/messages_api/stream.rbs +81 -0
  95. data/sig/generated/riffer/providers/anthropic_compatible/messages_api.rbs +108 -0
  96. data/sig/generated/riffer/providers/anthropic_compatible.rbs +4 -0
  97. data/sig/generated/riffer/providers/anthropic_vertex.rbs +45 -0
  98. data/sig/generated/riffer/providers/base.rbs +5 -0
  99. data/sig/generated/riffer/providers/gemini/client.rbs +11 -34
  100. data/sig/generated/riffer/providers/gemini.rbs +66 -4
  101. data/sig/generated/riffer/providers/google_cloud/client.rbs +71 -0
  102. data/sig/generated/riffer/providers/google_cloud.rbs +64 -0
  103. data/sig/generated/riffer/providers/open_ai.rbs +7 -2
  104. data/sig/generated/riffer/stream_events/server_tool_done.rbs +15 -0
  105. data/sig/generated/riffer/testing.rbs +4 -0
  106. data/sig/generated/riffer/wire/sse.rbs +23 -0
  107. data/sig/generated/riffer/wire.rbs +17 -0
  108. data/sig/generated/riffer.rbs +15 -0
  109. data/sig/manual/riffer/deprecation.rbs +5 -0
  110. data/sig/manual/riffer/providers/anthropic_compatible/messages_api.rbs +8 -0
  111. data/sig/manual/riffer/providers/gemini.rbs +8 -0
  112. data/sig/manual/riffer/providers/google_cloud.rbs +8 -0
  113. data/sig/manual/riffer/wire.rbs +5 -0
  114. metadata +76 -5
  115. data/sig/_private/anthropic.rbs +0 -17
  116. data/sig/_private/riffer/providers/anthropic.rbs +0 -6
  117. data/sig/_private/riffer/providers/gemini.rbs +0 -7
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.56.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.
@@ -70,6 +98,7 @@ files:
70
98
  - README.md
71
99
  - Rakefile
72
100
  - Steepfile
101
+ - UPGRADING.md
73
102
  - docs-site/404.html
74
103
  - docs-site/build.rb
75
104
  - docs-site/check.rb
@@ -93,6 +122,7 @@ files:
93
122
  - docs/OVERVIEW.md
94
123
  - docs/SERIALIZATION.md
95
124
  - docs/SKILLS.md
125
+ - docs/STABILITY.md
96
126
  - docs/STREAM_EVENTS.md
97
127
  - docs/TESTING.md
98
128
  - docs/TOOLS.md
@@ -103,6 +133,7 @@ files:
103
133
  - docs/providers/AZURE_OPENAI.md
104
134
  - docs/providers/CUSTOM_PROVIDERS.md
105
135
  - docs/providers/GEMINI.md
136
+ - docs/providers/GOOGLE_CLOUD.md
106
137
  - docs/providers/MOCK_PROVIDER.md
107
138
  - docs/providers/OPENAI.md
108
139
  - docs/providers/OPENROUTER.md
@@ -128,13 +159,17 @@ files:
128
159
  - lib/riffer/config/azure_open_ai.rb
129
160
  - lib/riffer/config/evals.rb
130
161
  - lib/riffer/config/files.rb
162
+ - lib/riffer/config/future.rb
131
163
  - lib/riffer/config/gemini.rb
164
+ - lib/riffer/config/google_cloud.rb
132
165
  - lib/riffer/config/mcp.rb
133
166
  - lib/riffer/config/open_ai.rb
134
167
  - lib/riffer/config/open_router.rb
135
168
  - lib/riffer/config/pricing.rb
136
169
  - lib/riffer/config/skills.rb
137
170
  - lib/riffer/config/tracing.rb
171
+ - lib/riffer/deprecation.rb
172
+ - lib/riffer/deprecation/event.rb
138
173
  - lib/riffer/evals.rb
139
174
  - lib/riffer/evals/evaluator.rb
140
175
  - lib/riffer/evals/evaluator_runner.rb
@@ -158,6 +193,8 @@ files:
158
193
  - lib/riffer/helpers/dependencies.rb
159
194
  - lib/riffer/helpers/identifier.rb
160
195
  - lib/riffer/helpers/validate.rb
196
+ - lib/riffer/http.rb
197
+ - lib/riffer/http/client.rb
161
198
  - lib/riffer/mcp.rb
162
199
  - lib/riffer/mcp/authenticated_tool.rb
163
200
  - lib/riffer/mcp/client.rb
@@ -170,6 +207,8 @@ files:
170
207
  - lib/riffer/messages.rb
171
208
  - lib/riffer/messages/assistant.rb
172
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
173
212
  - lib/riffer/messages/assistant/tool_call.rb
174
213
  - lib/riffer/messages/base.rb
175
214
  - lib/riffer/messages/system.rb
@@ -184,11 +223,18 @@ files:
184
223
  - lib/riffer/providers.rb
185
224
  - lib/riffer/providers/amazon_bedrock.rb
186
225
  - lib/riffer/providers/anthropic.rb
226
+ - lib/riffer/providers/anthropic/client.rb
227
+ - lib/riffer/providers/anthropic_compatible.rb
228
+ - lib/riffer/providers/anthropic_compatible/messages_api.rb
229
+ - lib/riffer/providers/anthropic_compatible/messages_api/stream.rb
230
+ - lib/riffer/providers/anthropic_vertex.rb
187
231
  - lib/riffer/providers/azure_open_ai.rb
188
232
  - lib/riffer/providers/base.rb
189
233
  - lib/riffer/providers/finish_reason.rb
190
234
  - lib/riffer/providers/gemini.rb
191
235
  - lib/riffer/providers/gemini/client.rb
236
+ - lib/riffer/providers/google_cloud.rb
237
+ - lib/riffer/providers/google_cloud/client.rb
192
238
  - lib/riffer/providers/mock.rb
193
239
  - lib/riffer/providers/open_ai.rb
194
240
  - lib/riffer/providers/open_router.rb
@@ -217,6 +263,7 @@ files:
217
263
  - lib/riffer/stream_events/interrupt.rb
218
264
  - lib/riffer/stream_events/reasoning_delta.rb
219
265
  - lib/riffer/stream_events/reasoning_done.rb
266
+ - lib/riffer/stream_events/server_tool_done.rb
220
267
  - lib/riffer/stream_events/skill_activation.rb
221
268
  - lib/riffer/stream_events/text_delta.rb
222
269
  - lib/riffer/stream_events/text_done.rb
@@ -242,18 +289,19 @@ files:
242
289
  - lib/riffer/tracing/otel.rb
243
290
  - lib/riffer/tracing/stream_recorder.rb
244
291
  - lib/riffer/version.rb
292
+ - lib/riffer/wire.rb
293
+ - lib/riffer/wire/sse.rb
245
294
  - rbs_collection.lock.yaml
246
295
  - rbs_collection.yaml
247
- - sig/_private/anthropic.rbs
248
296
  - sig/_private/aws-sdk-core/event_error.rbs
249
297
  - sig/_private/aws-sdk-core/seahorse_request_context.rbs
250
298
  - sig/_private/aws-sdk-core/static_token_provider.rbs
299
+ - sig/_private/faraday.rbs
300
+ - sig/_private/googleauth.rbs
251
301
  - sig/_private/mcp.rbs
252
302
  - sig/_private/openai.rbs
253
303
  - sig/_private/opentelemetry.rbs
254
304
  - sig/_private/riffer/providers/amazon_bedrock.rbs
255
- - sig/_private/riffer/providers/anthropic.rbs
256
- - sig/_private/riffer/providers/gemini.rbs
257
305
  - sig/_private/riffer/providers/open_ai.rbs
258
306
  - sig/_private/riffer/providers/open_router.rbs
259
307
  - sig/_private/riffer/testing/minitest.rbs
@@ -280,13 +328,17 @@ files:
280
328
  - sig/generated/riffer/config/azure_open_ai.rbs
281
329
  - sig/generated/riffer/config/evals.rbs
282
330
  - sig/generated/riffer/config/files.rbs
331
+ - sig/generated/riffer/config/future.rbs
283
332
  - sig/generated/riffer/config/gemini.rbs
333
+ - sig/generated/riffer/config/google_cloud.rbs
284
334
  - sig/generated/riffer/config/mcp.rbs
285
335
  - sig/generated/riffer/config/open_ai.rbs
286
336
  - sig/generated/riffer/config/open_router.rbs
287
337
  - sig/generated/riffer/config/pricing.rbs
288
338
  - sig/generated/riffer/config/skills.rbs
289
339
  - sig/generated/riffer/config/tracing.rbs
340
+ - sig/generated/riffer/deprecation.rbs
341
+ - sig/generated/riffer/deprecation/event.rbs
290
342
  - sig/generated/riffer/evals.rbs
291
343
  - sig/generated/riffer/evals/evaluator.rbs
292
344
  - sig/generated/riffer/evals/evaluator_runner.rbs
@@ -310,6 +362,8 @@ files:
310
362
  - sig/generated/riffer/helpers/dependencies.rbs
311
363
  - sig/generated/riffer/helpers/identifier.rbs
312
364
  - sig/generated/riffer/helpers/validate.rbs
365
+ - sig/generated/riffer/http.rbs
366
+ - sig/generated/riffer/http/client.rbs
313
367
  - sig/generated/riffer/mcp.rbs
314
368
  - sig/generated/riffer/mcp/authenticated_tool.rbs
315
369
  - sig/generated/riffer/mcp/client.rbs
@@ -322,6 +376,8 @@ files:
322
376
  - sig/generated/riffer/messages.rbs
323
377
  - sig/generated/riffer/messages/assistant.rbs
324
378
  - sig/generated/riffer/messages/assistant/reasoning_part.rbs
379
+ - sig/generated/riffer/messages/assistant/server_tool_part.rbs
380
+ - sig/generated/riffer/messages/assistant/text_part.rbs
325
381
  - sig/generated/riffer/messages/assistant/tool_call.rbs
326
382
  - sig/generated/riffer/messages/base.rbs
327
383
  - sig/generated/riffer/messages/system.rbs
@@ -336,11 +392,18 @@ files:
336
392
  - sig/generated/riffer/providers.rbs
337
393
  - sig/generated/riffer/providers/amazon_bedrock.rbs
338
394
  - sig/generated/riffer/providers/anthropic.rbs
395
+ - sig/generated/riffer/providers/anthropic/client.rbs
396
+ - sig/generated/riffer/providers/anthropic_compatible.rbs
397
+ - sig/generated/riffer/providers/anthropic_compatible/messages_api.rbs
398
+ - sig/generated/riffer/providers/anthropic_compatible/messages_api/stream.rbs
399
+ - sig/generated/riffer/providers/anthropic_vertex.rbs
339
400
  - sig/generated/riffer/providers/azure_open_ai.rbs
340
401
  - sig/generated/riffer/providers/base.rbs
341
402
  - sig/generated/riffer/providers/finish_reason.rbs
342
403
  - sig/generated/riffer/providers/gemini.rbs
343
404
  - sig/generated/riffer/providers/gemini/client.rbs
405
+ - sig/generated/riffer/providers/google_cloud.rbs
406
+ - sig/generated/riffer/providers/google_cloud/client.rbs
344
407
  - sig/generated/riffer/providers/mock.rbs
345
408
  - sig/generated/riffer/providers/open_ai.rbs
346
409
  - sig/generated/riffer/providers/open_router.rbs
@@ -369,6 +432,7 @@ files:
369
432
  - sig/generated/riffer/stream_events/interrupt.rbs
370
433
  - sig/generated/riffer/stream_events/reasoning_delta.rbs
371
434
  - sig/generated/riffer/stream_events/reasoning_done.rbs
435
+ - sig/generated/riffer/stream_events/server_tool_done.rbs
372
436
  - sig/generated/riffer/stream_events/skill_activation.rbs
373
437
  - sig/generated/riffer/stream_events/text_delta.rbs
374
438
  - sig/generated/riffer/stream_events/text_done.rbs
@@ -393,6 +457,8 @@ files:
393
457
  - sig/generated/riffer/tracing/otel.rbs
394
458
  - sig/generated/riffer/tracing/stream_recorder.rbs
395
459
  - sig/generated/riffer/version.rbs
460
+ - sig/generated/riffer/wire.rbs
461
+ - sig/generated/riffer/wire/sse.rbs
396
462
  - sig/manifest.yaml
397
463
  - sig/manual/riffer.rbs
398
464
  - sig/manual/riffer/agent.rbs
@@ -400,6 +466,7 @@ files:
400
466
  - sig/manual/riffer/agent/serializer.rbs
401
467
  - sig/manual/riffer/agent/session/repair.rbs
402
468
  - sig/manual/riffer/agent/structured_output/parser.rbs
469
+ - sig/manual/riffer/deprecation.rbs
403
470
  - sig/manual/riffer/evals/evaluator_runner.rbs
404
471
  - sig/manual/riffer/helpers/boolean.rbs
405
472
  - sig/manual/riffer/helpers/call_or_value.rbs
@@ -413,12 +480,16 @@ files:
413
480
  - sig/manual/riffer/mcp/tool_factory.rbs
414
481
  - sig/manual/riffer/params/format.rbs
415
482
  - sig/manual/riffer/providers.rbs
483
+ - sig/manual/riffer/providers/anthropic_compatible/messages_api.rbs
484
+ - sig/manual/riffer/providers/gemini.rbs
485
+ - sig/manual/riffer/providers/google_cloud.rbs
416
486
  - sig/manual/riffer/providers/repository.rbs
417
487
  - sig/manual/riffer/testing.rbs
418
488
  - sig/manual/riffer/tool.rbs
419
489
  - sig/manual/riffer/tracing.rbs
420
490
  - sig/manual/riffer/tracing/capture.rbs
421
491
  - sig/manual/riffer/tracing/no_op.rbs
492
+ - sig/manual/riffer/wire.rbs
422
493
  homepage: https://riffer.ai
423
494
  licenses:
424
495
  - MIT
@@ -448,7 +519,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
448
519
  - !ruby/object:Gem::Version
449
520
  version: '0'
450
521
  requirements: []
451
- rubygems_version: 4.0.10
522
+ rubygems_version: 4.0.20
452
523
  specification_version: 4
453
524
  summary: The all-in-one Ruby framework for building AI-powered applications and agents.
454
525
  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