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
@@ -0,0 +1,59 @@
1
+ # Generated from lib/riffer/http/client.rb with RBS::Inline
2
+
3
+ class Riffer::HTTP::Client
4
+ @connection: Faraday::Connection
5
+
6
+ @extra_headers: Hash[String, String]
7
+
8
+ DEFAULT_OPEN_TIMEOUT: Integer
9
+
10
+ DEFAULT_READ_TIMEOUT: Integer
11
+
12
+ # +headers+ are sent on every request and win over the subclass's auth and
13
+ # version headers, as do headers set on the +connection+.
14
+ # --
15
+ # : (?headers: Hash[String, String], ?connection: Faraday::Connection?) -> void
16
+ def initialize: (?headers: Hash[String, String], ?connection: Faraday::Connection?) -> void
17
+
18
+ # Raises Riffer::APIError on a non-success status.
19
+ # --
20
+ # : (String, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
21
+ def post: (String, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
22
+
23
+ # Raises Riffer::APIError on a non-success status; the error body is never yielded.
24
+ # --
25
+ # : (String, Hash[Symbol, untyped]) { (String) -> void } -> void
26
+ def post_stream: (String, Hash[Symbol, untyped]) { (String) -> void } -> void
27
+
28
+ private
29
+
30
+ # --
31
+ # : (String) -> String
32
+ def url_for: (String) -> String
33
+
34
+ # Called per request so short-lived credentials can refresh.
35
+ # --
36
+ # : () -> Hash[String, String]
37
+ def headers: () -> Hash[String, String]
38
+
39
+ # --
40
+ # : () -> String
41
+ def error_label: () -> String
42
+
43
+ # --
44
+ # : (Hash[Symbol, untyped], String) -> String
45
+ def error_message: (Hash[Symbol, untyped], String) -> String
46
+
47
+ # Headers go on the request, never on the connection, which may be shared
48
+ # across fibers and keeps whatever headers the caller configured on it.
49
+ # Faraday matches header names case-insensitively, so a caller's header
50
+ # replaces the subclass's whatever its casing. The content and encoding
51
+ # headers below are always riffer's: the body and the stream depend on them.
52
+ # --
53
+ # : (String, Hash[Symbol, untyped], ?on_data: Proc?) -> Faraday::Response
54
+ def request: (String, Hash[Symbol, untyped], ?on_data: Proc?) -> Faraday::Response
55
+
56
+ # --
57
+ # : (Integer, String) -> bot
58
+ def raise_api_error!: (Integer, String) -> bot
59
+ end
@@ -0,0 +1,4 @@
1
+ # Generated from lib/riffer/http.rb with RBS::Inline
2
+
3
+ module Riffer::HTTP
4
+ end
@@ -0,0 +1,44 @@
1
+ # Generated from lib/riffer/messages/assistant/server_tool_part.rb with RBS::Inline
2
+
3
+ # A call or result of a tool the provider ran itself (e.g. web search). Stored and replayed
4
+ # verbatim under the same rule as reasoning parts: only the adapter whose +format+ it is sends
5
+ # it back.
6
+ class Riffer::Messages::Assistant::ServerToolPart
7
+ KINDS: Array[Symbol]
8
+
9
+ attr_reader name: String
10
+
11
+ attr_reader kind: Symbol
12
+
13
+ # The provider's block, JSON-encoded and unchanged.
14
+ attr_reader data: String
15
+
16
+ # Shared by a call and its result.
17
+ attr_reader id: String?
18
+
19
+ attr_reader format: String?
20
+
21
+ # --
22
+ # : ((Hash[Symbol, untyped] | Riffer::Messages::Assistant::ServerToolPart)) -> Riffer::Messages::Assistant::ServerToolPart
23
+ def self.from_hash: (Hash[Symbol, untyped] | Riffer::Messages::Assistant::ServerToolPart) -> Riffer::Messages::Assistant::ServerToolPart
24
+
25
+ # --
26
+ # : (name: String, kind: Symbol, data: String, ?id: String?, ?format: String?) -> void
27
+ def initialize: (name: String, kind: Symbol, data: String, ?id: String?, ?format: String?) -> void
28
+
29
+ # --
30
+ # : () -> Hash[Symbol, untyped]
31
+ def to_h: () -> Hash[Symbol, untyped]
32
+
33
+ # --
34
+ # : (untyped) -> bool
35
+ def ==: (untyped) -> bool
36
+
37
+ # --
38
+ # : (untyped) -> bool
39
+ def eql?: (untyped) -> bool
40
+
41
+ # --
42
+ # : () -> Integer
43
+ def hash: () -> Integer
44
+ end
@@ -0,0 +1,35 @@
1
+ # Generated from lib/riffer/messages/assistant/text_part.rb with RBS::Inline
2
+
3
+ class Riffer::Messages::Assistant::TextPart
4
+ attr_reader text: String
5
+
6
+ # The provider's whole block as JSON, kept when it carries more than the text (e.g. Anthropic
7
+ # +citations+), so the adapter that produced it can send it back unchanged.
8
+ attr_reader data: String?
9
+
10
+ attr_reader format: String?
11
+
12
+ # --
13
+ # : ((Hash[Symbol, untyped] | Riffer::Messages::Assistant::TextPart)) -> Riffer::Messages::Assistant::TextPart
14
+ def self.from_hash: (Hash[Symbol, untyped] | Riffer::Messages::Assistant::TextPart) -> Riffer::Messages::Assistant::TextPart
15
+
16
+ # --
17
+ # : (String, ?data: String?, ?format: String?) -> void
18
+ def initialize: (String, ?data: String?, ?format: String?) -> void
19
+
20
+ # --
21
+ # : () -> Hash[Symbol, untyped]
22
+ def to_h: () -> Hash[Symbol, untyped]
23
+
24
+ # --
25
+ # : (untyped) -> bool
26
+ def ==: (untyped) -> bool
27
+
28
+ # --
29
+ # : (untyped) -> bool
30
+ def eql?: (untyped) -> bool
31
+
32
+ # --
33
+ # : () -> Integer
34
+ def hash: () -> Integer
35
+ end
@@ -4,10 +4,20 @@ class Riffer::Messages::Assistant < Riffer::Messages::Base
4
4
  # The other reasoning part types carry no prose.
5
5
  REASONING_TEXT_TYPES: Array[Symbol]
6
6
 
7
+ PART_TAGS: Hash[singleton(Riffer::Messages::Assistant::TextPart) | singleton(Riffer::Messages::Assistant::ReasoningPart) | singleton(Riffer::Messages::Assistant::ToolCall) | singleton(Riffer::Messages::Assistant::ServerToolPart), Symbol]
8
+
7
9
  # --
8
10
  # : ((Hash[Symbol, untyped] | Riffer::Messages::Assistant)) -> Riffer::Messages::Assistant
9
11
  def self.from_hash: (Hash[Symbol, untyped] | Riffer::Messages::Assistant) -> Riffer::Messages::Assistant
10
12
 
13
+ # --
14
+ # : ((Hash[Symbol, untyped] | Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart)) -> (Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart)
15
+ def self.part_from_hash: (Hash[Symbol, untyped] | Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart) -> (Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart)
16
+
17
+ # The turn in the order the provider produced it. +content+, +tool_calls+ and +reasoning+ are
18
+ # views over it.
19
+ attr_reader parts: Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
20
+
11
21
  attr_reader tool_calls: Array[Riffer::Messages::Assistant::ToolCall]
12
22
 
13
23
  attr_reader reasoning: Array[Riffer::Messages::Assistant::ReasoningPart]
@@ -20,18 +30,11 @@ class Riffer::Messages::Assistant < Riffer::Messages::Base
20
30
 
21
31
  attr_reader finish_reason_raw: String?
22
32
 
33
+ # Without +parts:+, the parts are built in a fixed order: reasoning, then the content as one
34
+ # text part, then tool calls.
23
35
  # --
24
- # : (
25
- # String,
26
- # ?id: String?,
27
- # ?tool_calls: Array[Riffer::Messages::Assistant::ToolCall],
28
- # ?reasoning: Array[Riffer::Messages::Assistant::ReasoningPart],
29
- # ?token_usage: Riffer::Providers::TokenUsage?,
30
- # ?structured_output: Hash[Symbol, untyped]?,
31
- # ?finish_reason: Symbol?,
32
- # ?finish_reason_raw: String?
33
- # ) -> void
34
- def initialize: (String, ?id: String?, ?tool_calls: Array[Riffer::Messages::Assistant::ToolCall], ?reasoning: Array[Riffer::Messages::Assistant::ReasoningPart], ?token_usage: Riffer::Providers::TokenUsage?, ?structured_output: Hash[Symbol, untyped]?, ?finish_reason: Symbol?, ?finish_reason_raw: String?) -> void
36
+ # : (?String?, ?id: String?, ?parts: Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]?, ?tool_calls: Array[Riffer::Messages::Assistant::ToolCall], ?reasoning: Array[Riffer::Messages::Assistant::ReasoningPart], ?token_usage: Riffer::Providers::TokenUsage?, ?structured_output: Hash[Symbol, untyped]?, ?finish_reason: Symbol?, ?finish_reason_raw: String?) -> void
37
+ def initialize: (?String?, ?id: String?, ?parts: Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]?, ?tool_calls: Array[Riffer::Messages::Assistant::ToolCall], ?reasoning: Array[Riffer::Messages::Assistant::ReasoningPart], ?token_usage: Riffer::Providers::TokenUsage?, ?structured_output: Hash[Symbol, untyped]?, ?finish_reason: Symbol?, ?finish_reason_raw: String?) -> void
35
38
 
36
39
  # --
37
40
  # : () -> Symbol
@@ -60,4 +63,14 @@ class Riffer::Messages::Assistant < Riffer::Messages::Base
60
63
  # --
61
64
  # : () -> Hash[Symbol, untyped]
62
65
  def to_h: () -> Hash[Symbol, untyped]
66
+
67
+ private
68
+
69
+ # --
70
+ # : (String?, Array[Riffer::Messages::Assistant::ToolCall], Array[Riffer::Messages::Assistant::ReasoningPart]) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
71
+ def default_parts: (String?, Array[Riffer::Messages::Assistant::ToolCall], Array[Riffer::Messages::Assistant::ReasoningPart]) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
72
+
73
+ # --
74
+ # : (Riffer::Messages::Assistant) -> bool
75
+ def described_by_fields?: (Riffer::Messages::Assistant) -> bool
63
76
  end
@@ -1,13 +1,21 @@
1
1
  # Generated from lib/riffer/params/any_of.rb with RBS::Inline
2
2
 
3
3
  class Riffer::Params::AnyOf
4
- attr_reader variants: Array[Riffer::Params]
4
+ @name: Symbol
5
+
6
+ attr_reader variants: Array[Riffer::Params | Riffer::Params::Param]
7
+
8
+ # --
9
+ # : (Symbol) -> void
10
+ def initialize: (Symbol) -> void
5
11
 
6
12
  # --
7
- # : () -> void
8
- def initialize: () -> void
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
15
+
16
+ private
9
17
 
10
18
  # --
11
- # : () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
12
- def variant: () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
19
+ # : (Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
20
+ def primitive: (Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
13
21
  end
@@ -27,15 +27,15 @@ class Riffer::Params::Param
27
27
 
28
28
  attr_reader nested_params: Riffer::Params?
29
29
 
30
- attr_reader variants: Array[Riffer::Params]?
30
+ attr_reader variants: Array[Riffer::Params | Riffer::Params::Param]?
31
31
 
32
32
  # --
33
33
  # : (Symbol, Hash[Symbol, untyped], required: bool) -> Riffer::Params::Param
34
34
  def self.from_json_schema: (Symbol, Hash[Symbol, untyped], required: bool) -> Riffer::Params::Param
35
35
 
36
36
  # --
37
- # : (Array[Hash[Symbol, untyped]]) -> Array[Riffer::Params]
38
- def self.resolve_variants: (Array[Hash[Symbol, untyped]]) -> Array[Riffer::Params]
37
+ # : (Symbol, Array[Hash[Symbol, untyped]]) -> Array[Riffer::Params | Riffer::Params::Param]
38
+ def self.resolve_variants: (Symbol, Array[Hash[Symbol, untyped]]) -> Array[Riffer::Params | Riffer::Params::Param]
39
39
 
40
40
  # --
41
41
  # : (Module, Hash[Symbol, untyped]) -> Riffer::Params?
@@ -50,8 +50,8 @@ class Riffer::Params::Param
50
50
  def self.json_type_to_ruby: (untyped) -> Module
51
51
 
52
52
  # --
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]?) -> 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]?) -> void
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
55
55
 
56
56
  # --
57
57
  # : (untyped) -> bool
@@ -74,6 +74,11 @@ class Riffer::Params::Param
74
74
  # : (Riffer::Params::Param) -> void
75
75
  def initialize_copy: (Riffer::Params::Param) -> void
76
76
 
77
+ # The first matching variant wins, and a Float variant without an enum accepts any number.
78
+ # --
79
+ # : () -> void
80
+ def validate_variant_order!: () -> void
81
+
77
82
  # --
78
83
  # : () -> void
79
84
  def validate_format!: () -> void
@@ -50,8 +50,12 @@ class Riffer::Params
50
50
  def build_nested: (Module, Module?, Array[untyped]?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
51
51
 
52
52
  # --
53
- # : ((Module | Array[untyped])?, Array[untyped]?) ?{ (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> Array[Riffer::Params]
54
- def build_variants: ((Module | Array[untyped])?, Array[untyped]?) ?{ (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> Array[Riffer::Params]
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]
55
+
56
+ # --
57
+ # : (Riffer::Params::Param, untyped) -> String?
58
+ def value_error: (Riffer::Params::Param, untyped) -> String?
55
59
 
56
60
  # --
57
61
  # : (Riffer::Params::Param, untyped, Array[String]) -> untyped
@@ -62,8 +66,8 @@ class Riffer::Params
62
66
  def validate_nested_hash: (Riffer::Params::Param, Hash[Symbol, untyped], Array[String]) -> Hash[Symbol, untyped]
63
67
 
64
68
  # --
65
- # : (Riffer::Params::Param, Hash[Symbol, untyped], Array[String]) -> Hash[Symbol, untyped]
66
- def validate_any_of: (Riffer::Params::Param, Hash[Symbol, untyped], Array[String]) -> Hash[Symbol, untyped]
69
+ # : (Riffer::Params::Param, untyped, Array[String]) -> untyped
70
+ def validate_any_of: (Riffer::Params::Param, untyped, Array[String]) -> untyped
67
71
 
68
72
  # Validation drops keys a Params doesn't declare, at any depth, so they are
69
73
  # the keys in the input that are missing from the output.
@@ -150,9 +150,21 @@ class Riffer::Providers::AmazonBedrock < Riffer::Providers::Base
150
150
  # : (Array[Hash[Symbol, untyped]], Riffer::Messages::Tool) -> void
151
151
  def append_tool_result: (Array[Hash[Symbol, untyped]], Riffer::Messages::Tool) -> void
152
152
 
153
+ # +document_names+ collects the names already used in the request, which
154
+ # Converse requires to be unique across every message.
153
155
  # --
154
- # : (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
155
- def convert_file_part_to_bedrock_format: (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
156
+ # : (Riffer::Messages::User::FilePart, Array[String]) -> Hash[Symbol, untyped]
157
+ def convert_file_part_to_bedrock_format: (Riffer::Messages::User::FilePart, Array[String]) -> Hash[Symbol, untyped]
158
+
159
+ DOCUMENT_NAME_LIMIT: Integer
160
+
161
+ # Converse allows only alphanumerics, single whitespace, hyphens, parentheses
162
+ # and square brackets in a document name, up to 200 characters, so
163
+ # +invoice.pdf+ is sent as +invoice+ and a repeated name gets a counter:
164
+ # +invoice (2)+.
165
+ # --
166
+ # : (String?, Array[String]) -> String
167
+ def document_name: (String?, Array[String]) -> String
156
168
 
157
169
  BEDROCK_FORMAT_MAP: Hash[String, String]
158
170
 
@@ -0,0 +1,34 @@
1
+ # Generated from lib/riffer/providers/anthropic/client.rb with RBS::Inline
2
+
3
+ class Riffer::Providers::Anthropic::Client < Riffer::HTTP::Client
4
+ @api_key: String
5
+
6
+ @base_url: String
7
+
8
+ DEFAULT_BASE_URL: String
9
+
10
+ # Override with an anthropic-version entry in +headers+.
11
+ DEFAULT_ANTHROPIC_VERSION: String
12
+
13
+ # --
14
+ # : (api_key: String, ?base_url: String, ?headers: Hash[String, String], ?connection: Faraday::Connection?) -> void
15
+ def initialize: (api_key: String, ?base_url: String, ?headers: Hash[String, String], ?connection: Faraday::Connection?) -> void
16
+
17
+ private
18
+
19
+ # --
20
+ # : (String) -> String
21
+ def url_for: (String) -> String
22
+
23
+ # --
24
+ # : () -> Hash[String, String]
25
+ def headers: () -> Hash[String, String]
26
+
27
+ # --
28
+ # : () -> String
29
+ def error_label: () -> String
30
+
31
+ # --
32
+ # : (Hash[Symbol, untyped], String) -> String
33
+ def error_message: (Hash[Symbol, untyped], String) -> String
34
+ end
@@ -1,140 +1,21 @@
1
1
  # Generated from lib/riffer/providers/anthropic.rb with RBS::Inline
2
2
 
3
- class Riffer::Providers::Anthropic < Riffer::Providers::Base
4
- WEB_SEARCH_TOOL_TYPE: String
5
-
6
- FINISH_REASONS: Hash[String, Symbol]
7
-
8
- # Only parts carrying this tag are replayed, so reasoning captured by another
9
- # adapter, whose signatures the Messages API may not accept, never reaches the
10
- # request.
11
- REASONING_FORMAT: String
12
-
13
- # --
14
- # : (?String?) -> singleton(Riffer::Skills::Adapter)
15
- def self.skills_adapter: (?String?) -> singleton(Riffer::Skills::Adapter)
16
-
3
+ class Riffer::Providers::Anthropic < Riffer::Providers::AnthropicCompatible::MessagesAPI
17
4
  # --
18
5
  # : () -> String
19
6
  def self.semconv_provider_name: () -> String
20
7
 
21
- # --
22
- # : () -> void
23
- def initialize: () -> void
24
-
25
8
  private
26
9
 
27
10
  # --
28
11
  # : () -> untyped
29
- def global_client: () -> untyped
12
+ def client: () -> untyped
30
13
 
31
14
  # --
32
15
  # : () -> untyped
33
- def build_client: () -> untyped
34
-
35
- # --
36
- # : (Symbol) -> Hash[Symbol, untyped]
37
- def default_reasoning_options: (Symbol) -> Hash[Symbol, untyped]
38
-
39
- # --
40
- # : (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
41
- def build_request_params: (Array[Riffer::Messages::Base], String?, Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
42
-
43
- # --
44
- # : (Hash[Symbol, untyped]) -> untyped
45
- def execute_generate: (Hash[Symbol, untyped]) -> untyped
46
-
47
- # --
48
- # : (untyped) -> Riffer::Providers::TokenUsage?
49
- def extract_token_usage: (untyped) -> Riffer::Providers::TokenUsage?
50
-
51
- # --
52
- # : (untyped) -> Riffer::Providers::FinishReason?
53
- def extract_finish_reason: (untyped) -> Riffer::Providers::FinishReason?
54
-
55
- # --
56
- # : (untyped) -> Riffer::Providers::FinishReason?
57
- def build_finish_reason: (untyped) -> Riffer::Providers::FinishReason?
58
-
59
- # --
60
- # : (untyped) -> Riffer::Providers::TokenUsage
61
- def build_token_usage: (untyped) -> Riffer::Providers::TokenUsage
62
-
63
- # --
64
- # : (untyped) -> String
65
- def extract_content: (untyped) -> String
66
-
67
- # --
68
- # : (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
69
- def extract_tool_calls: (untyped) -> Array[Riffer::Messages::Assistant::ToolCall]
70
-
71
- # --
72
- # : (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
73
- def extract_reasoning: (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
74
-
75
- # --
76
- # : (untyped) -> Riffer::Messages::Assistant::ReasoningPart?
77
- def build_reasoning_part: (untyped) -> Riffer::Messages::Assistant::ReasoningPart?
78
-
79
- # --
80
- # : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
81
- def execute_stream: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
82
-
83
- # --
84
- # : (untyped, state: Hash[Symbol, untyped]) -> void
85
- def handle_raw_content_block_start: (untyped, state: Hash[Symbol, untyped]) -> void
86
-
87
- # --
88
- # : (untyped, state: Hash[Symbol, untyped]) -> void
89
- def handle_raw_content_block_delta: (untyped, state: Hash[Symbol, untyped]) -> void
90
-
91
- # --
92
- # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
93
- def handle_text_event: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
94
-
95
- # --
96
- # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
97
- def handle_input_json_event: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
98
-
99
- # --
100
- # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
101
- def handle_content_block_stop_tool_use: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
102
-
103
- # The SDK's accumulated block already carries the full thinking text and the
104
- # signature from its trailing signature_delta.
105
- # --
106
- # : (untyped, yielder: Riffer::Providers::_EventSink) -> void
107
- def handle_content_block_stop_reasoning: (untyped, yielder: Riffer::Providers::_EventSink) -> void
108
-
109
- # --
110
- # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
111
- def handle_content_block_stop_server_tool_use: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
112
-
113
- # --
114
- # : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
115
- def handle_content_block_stop_web_search_result: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
116
-
117
- # --
118
- # : (untyped, state: Hash[Symbol, untyped], accumulated_message: untyped, yielder: Riffer::Providers::_EventSink) -> void
119
- def handle_message_stop: (untyped, state: Hash[Symbol, untyped], accumulated_message: untyped, yielder: Riffer::Providers::_EventSink) -> void
120
-
121
- # --
122
- # : (Array[Riffer::Messages::Base]) -> Hash[Symbol, untyped]
123
- def partition_messages: (Array[Riffer::Messages::Base]) -> Hash[Symbol, untyped]
124
-
125
- # --
126
- # : (Riffer::Messages::Assistant) -> Hash[Symbol, untyped]
127
- def convert_assistant_to_anthropic_format: (Riffer::Messages::Assistant) -> Hash[Symbol, untyped]
128
-
129
- # --
130
- # : (Riffer::Messages::Assistant::ReasoningPart) -> Hash[Symbol, untyped]
131
- def convert_reasoning_part_to_anthropic_format: (Riffer::Messages::Assistant::ReasoningPart) -> Hash[Symbol, untyped]
132
-
133
- # --
134
- # : (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
135
- def convert_file_part_to_anthropic_format: (Riffer::Messages::User::FilePart) -> Hash[Symbol, untyped]
16
+ def global_client: () -> untyped
136
17
 
137
18
  # --
138
- # : (singleton(Riffer::Tool)) -> Hash[Symbol, untyped]
139
- def convert_tool_to_anthropic_format: (singleton(Riffer::Tool)) -> Hash[Symbol, untyped]
19
+ # : () -> Riffer::Providers::Anthropic::Client
20
+ def build_client: () -> Riffer::Providers::Anthropic::Client
140
21
  end
@@ -0,0 +1,81 @@
1
+ # Generated from lib/riffer/providers/anthropic_compatible/messages_api/stream.rb with RBS::Inline
2
+
3
+ class Riffer::Providers::AnthropicCompatible::MessagesAPI::Stream
4
+ @completed: bool
5
+
6
+ @web_search_query: String?
7
+
8
+ @partial_json: Hash[Integer, String]
9
+
10
+ @message: Hash[Symbol, untyped]
11
+
12
+ @tools: Array[singleton(Riffer::Tool)]
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
+
20
+ # --
21
+ # : (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ReasoningPart?
22
+ def self.reasoning_part: (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ReasoningPart?
23
+
24
+ # --
25
+ # : (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ServerToolPart
26
+ def self.server_tool_part: (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ServerToolPart
27
+
28
+ # --
29
+ # : (tools: Array[singleton(Riffer::Tool)]) -> void
30
+ def initialize: (tools: Array[singleton(Riffer::Tool)]) -> void
31
+
32
+ # Raises Riffer::APIError on a stream +error+ event.
33
+ # --
34
+ # : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
35
+ def handle: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
36
+
37
+ # The caller reads finish reason and usage from here so it can price the usage.
38
+ # --
39
+ # : () -> Hash[Symbol, untyped]
40
+ def finish!: () -> Hash[Symbol, untyped]
41
+
42
+ private
43
+
44
+ # --
45
+ # : (Hash[Symbol, untyped]) -> void
46
+ def start_message: (Hash[Symbol, untyped]) -> void
47
+
48
+ # --
49
+ # : (Hash[Symbol, untyped]) -> void
50
+ def start_block: (Hash[Symbol, untyped]) -> void
51
+
52
+ # --
53
+ # : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
54
+ def apply_delta: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
55
+
56
+ # --
57
+ # : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
58
+ def stop_block: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
59
+
60
+ # --
61
+ # : (Hash[Symbol, untyped]) -> void
62
+ def apply_message_delta: (Hash[Symbol, untyped]) -> void
63
+
64
+ # --
65
+ # : (Riffer::Providers::_EventSink) -> void
66
+ def stop_message: (Riffer::Providers::_EventSink) -> void
67
+
68
+ # --
69
+ # : (Hash[Symbol, untyped]) -> void
70
+ def raise_stream_error: (Hash[Symbol, untyped]) -> void
71
+
72
+ # A response cut off by max_tokens can end a block mid-input, leaving JSON
73
+ # that does not parse.
74
+ # --
75
+ # : (String) -> Hash[String, untyped]?
76
+ def parse_input: (String) -> Hash[String, untyped]?
77
+
78
+ # --
79
+ # : (Hash[Symbol, untyped]) -> Array[Hash[Symbol, String?]]
80
+ def web_search_sources: (Hash[Symbol, untyped]) -> Array[Hash[Symbol, String?]]
81
+ end