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,31 @@
1
+ # frozen_string_literal: true
2
+ # rbs_inline: enabled
3
+
4
+ require "json"
5
+
6
+ module Riffer::Wire
7
+ extend self
8
+
9
+ TOOL_NAME_SEPARATOR = "__" #: String
10
+
11
+ #--
12
+ #: (String) -> String
13
+ def encode_tool_name(name)
14
+ name.gsub("/", TOOL_NAME_SEPARATOR)
15
+ end
16
+
17
+ #--
18
+ #: (String, tools: Array[singleton(Riffer::Tool)]) -> String
19
+ def decode_tool_name(wire_name, tools:)
20
+ tool = tools.find { |t| encode_tool_name(t.name) == wire_name }
21
+ tool ? tool.name : wire_name
22
+ end
23
+
24
+ #--
25
+ #: (String) -> Hash[String, untyped]
26
+ def parse_tool_arguments(arguments)
27
+ return {} if arguments.empty?
28
+
29
+ JSON.parse(arguments)
30
+ end
31
+ end
data/lib/riffer.rb CHANGED
@@ -8,6 +8,9 @@ loader.inflector.inflect(
8
8
  "open_ai" => "OpenAI",
9
9
  "azure_open_ai" => "AzureOpenAI",
10
10
  "open_router" => "OpenRouter",
11
+ "sse" => "SSE",
12
+ "http" => "HTTP",
13
+ "messages_api" => "MessagesAPI",
11
14
  )
12
15
  # Test-framework wiring a consumer requires by hand; neither file defines the
13
16
  # constant its path implies, and both reference framework constants riffer
@@ -29,6 +32,21 @@ module Riffer
29
32
 
30
33
  class ValidationError < Error; end
31
34
 
35
+ # A provider answered with a non-success status, or sent an in-stream error
36
+ # event (+status+ is nil then). +body+ is the raw response text.
37
+ class APIError < Error
38
+ attr_reader :status #: Integer? # @dynamic status
39
+ attr_reader :body #: String? # @dynamic body
40
+
41
+ #--
42
+ #: (?String?, ?status: Integer?, ?body: String?) -> void
43
+ def initialize(message = nil, status: nil, body: nil)
44
+ super(message)
45
+ @status = status
46
+ @body = body
47
+ end
48
+ end
49
+
32
50
  # Rescue it in the tool to clean up; otherwise it becomes a
33
51
  # +:timeout_error+ response.
34
52
  class TimeoutError < Error; end
@@ -9,10 +9,6 @@ gems:
9
9
  revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
10
10
  remote: https://github.com/ruby/gem_rbs_collection.git
11
11
  repo_dir: gems
12
- - name: anthropic
13
- version: 1.76.0
14
- source:
15
- type: rubygems
16
12
  - name: ast
17
13
  version: '2.4'
18
14
  source:
@@ -77,6 +73,10 @@ gems:
77
73
  revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
78
74
  remote: https://github.com/ruby/gem_rbs_collection.git
79
75
  repo_dir: gems
76
+ - name: date
77
+ version: '0'
78
+ source:
79
+ type: stdlib
80
80
  - name: dbm
81
81
  version: '0'
82
82
  source:
@@ -113,6 +113,14 @@ gems:
113
113
  version: '0'
114
114
  source:
115
115
  type: stdlib
116
+ - name: googleauth
117
+ version: '1.11'
118
+ source:
119
+ type: git
120
+ name: ruby/gem_rbs_collection
121
+ revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
122
+ remote: https://github.com/ruby/gem_rbs_collection.git
123
+ repo_dir: gems
116
124
  - name: hashdiff
117
125
  version: '1.1'
118
126
  source:
@@ -125,10 +133,22 @@ gems:
125
133
  version: '0'
126
134
  source:
127
135
  type: stdlib
136
+ - name: ipaddr
137
+ version: '0'
138
+ source:
139
+ type: stdlib
128
140
  - name: json
129
141
  version: '0'
130
142
  source:
131
143
  type: stdlib
144
+ - name: jwt
145
+ version: '2.5'
146
+ source:
147
+ type: git
148
+ name: ruby/gem_rbs_collection
149
+ revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
150
+ remote: https://github.com/ruby/gem_rbs_collection.git
151
+ repo_dir: gems
132
152
  - name: language_server-protocol
133
153
  version: 3.17.0.6
134
154
  source:
@@ -257,6 +277,14 @@ gems:
257
277
  version: '0'
258
278
  source:
259
279
  type: stdlib
280
+ - name: signet
281
+ version: '0.19'
282
+ source:
283
+ type: git
284
+ name: ruby/gem_rbs_collection
285
+ revision: 3913b7dffb65bdffdfe5cb9095108f932e85433b
286
+ remote: https://github.com/ruby/gem_rbs_collection.git
287
+ repo_dir: gems
260
288
  - name: singleton
261
289
  version: '0'
262
290
  source:
data/rbs_collection.yaml CHANGED
@@ -10,3 +10,5 @@ path: .gem_rbs_collection
10
10
  gems:
11
11
  - name: yaml
12
12
  - name: cgi
13
+ - name: date
14
+ - name: ipaddr
@@ -0,0 +1,8 @@
1
+ # The collection's faraday 2.7 stubs declare Request#options= but not the
2
+ # reader that streaming needs to set on_data. Loaded only for riffer's own
3
+ # Steep run (consumers skip sig/_private).
4
+ module Faraday
5
+ class Request
6
+ def options: () -> Faraday::RequestOptions
7
+ end
8
+ end
@@ -0,0 +1,7 @@
1
+ # The `googleauth` stubs in gem_rbs_collection omit the ADC entry point.
2
+ # Loaded only for riffer's own Steep run.
3
+ module Google
4
+ module Auth
5
+ def self.get_application_default: (?untyped scope, ?Hash[untyped, untyped] options) -> untyped
6
+ end
7
+ end
@@ -25,4 +25,10 @@ class Riffer::Agent::StructuredOutput
25
25
  # --
26
26
  # : (String) -> Riffer::Agent::StructuredOutput::Result
27
27
  def parse_and_validate: (String) -> Riffer::Agent::StructuredOutput::Result
28
+
29
+ private
30
+
31
+ # --
32
+ # : (Hash[Symbol, untyped]) -> untyped
33
+ def placeholder: (Hash[Symbol, untyped]) -> untyped
28
34
  end
@@ -3,6 +3,8 @@
3
3
  class Riffer::Config::Anthropic
4
4
  attr_reader api_key: String?
5
5
 
6
+ attr_reader base_url: String?
7
+
6
8
  attr_accessor client: untyped
7
9
 
8
10
  # --
@@ -12,4 +14,8 @@ class Riffer::Config::Anthropic
12
14
  # --
13
15
  # : (untyped) -> void
14
16
  def api_key=: (untyped) -> void
17
+
18
+ # --
19
+ # : (untyped) -> void
20
+ def base_url=: (untyped) -> void
15
21
  end
@@ -3,6 +3,8 @@
3
3
  class Riffer::Config::Gemini
4
4
  attr_reader api_key: String?
5
5
 
6
+ attr_reader base_url: String?
7
+
6
8
  attr_accessor client: untyped
7
9
 
8
10
  # --
@@ -12,4 +14,8 @@ class Riffer::Config::Gemini
12
14
  # --
13
15
  # : (untyped) -> void
14
16
  def api_key=: (untyped) -> void
17
+
18
+ # --
19
+ # : (untyped) -> void
20
+ def base_url=: (untyped) -> void
15
21
  end
@@ -0,0 +1,28 @@
1
+ # Generated from lib/riffer/config/google_cloud.rb with RBS::Inline
2
+
3
+ class Riffer::Config::GoogleCloud
4
+ attr_reader project_id: String?
5
+
6
+ # The default +"global"+ endpoint routes requests to any region, so it
7
+ # carries no data-residency guarantee.
8
+ attr_reader location: String
9
+
10
+ # A googleauth credentials object; +nil+ resolves Application Default
11
+ # Credentials.
12
+ attr_accessor credentials: untyped
13
+
14
+ attr_accessor client: untyped
15
+
16
+ # --
17
+ # : () -> void
18
+ def initialize: () -> void
19
+
20
+ # --
21
+ # : (untyped) -> void
22
+ def project_id=: (untyped) -> void
23
+
24
+ # +nil+ restores the +"global"+ default.
25
+ # --
26
+ # : (untyped) -> void
27
+ def location=: (untyped) -> void
28
+ end
@@ -13,6 +13,8 @@ class Riffer::Config
13
13
 
14
14
  attr_reader gemini: Riffer::Config::Gemini
15
15
 
16
+ attr_reader google_cloud: Riffer::Config::GoogleCloud
17
+
16
18
  attr_reader openai: Riffer::Config::OpenAI
17
19
 
18
20
  attr_reader openrouter: Riffer::Config::OpenRouter
@@ -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,21 @@
1
+ # Generated from lib/riffer/params/any_of.rb with RBS::Inline
2
+
3
+ class Riffer::Params::AnyOf
4
+ @name: Symbol
5
+
6
+ attr_reader variants: Array[Riffer::Params | Riffer::Params::Param]
7
+
8
+ # --
9
+ # : (Symbol) -> void
10
+ def initialize: (Symbol) -> void
11
+
12
+ # --
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
17
+
18
+ # --
19
+ # : (Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
20
+ def primitive: (Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
21
+ end
@@ -0,0 +1,39 @@
1
+ # Generated from lib/riffer/params/format.rb with RBS::Inline
2
+
3
+ module Riffer::Params::Format
4
+ DATE: Regexp
5
+
6
+ DATE_TIME: Regexp
7
+
8
+ # The offset is optional: Anthropic's grammar emits times without one.
9
+ TIME: Regexp
10
+
11
+ DURATION: Regexp
12
+
13
+ UUID: Regexp
14
+
15
+ # The WHATWG HTML pattern: no single pattern matches RFC 5322 exactly, so
16
+ # this one only rules out values that are clearly not an address.
17
+ EMAIL: Regexp
18
+
19
+ HOSTNAME: Regexp
20
+
21
+ # The formats OpenAI, Anthropic and Bedrock all accept. OpenAI rejects uri.
22
+ CHECKS: Hash[String, ^(String) -> bool]
23
+
24
+ NAMES: Array[String]
25
+
26
+ # --
27
+ # : (String, String) -> bool
28
+ def valid?: (String, String) -> bool
29
+
30
+ private
31
+
32
+ # --
33
+ # : (Regexp, String) -> bool
34
+ def calendar_date?: (Regexp, String) -> bool
35
+
36
+ # --
37
+ # : (String) { (IPAddr) -> bool } -> bool
38
+ def ip_address?: (String) { (IPAddr) -> bool } -> bool
39
+ end
@@ -17,27 +17,41 @@ class Riffer::Params::Param
17
17
 
18
18
  attr_reader enum: Array[untyped]?
19
19
 
20
+ attr_reader format: String?
21
+
20
22
  attr_reader default: untyped
21
23
 
22
24
  attr_reader item_type: Module?
23
25
 
26
+ attr_reader dimensions: Integer
27
+
24
28
  attr_reader nested_params: Riffer::Params?
25
29
 
30
+ attr_reader variants: Array[Riffer::Params | Riffer::Params::Param]?
31
+
26
32
  # --
27
33
  # : (Symbol, Hash[Symbol, untyped], required: bool) -> Riffer::Params::Param
28
34
  def self.from_json_schema: (Symbol, Hash[Symbol, untyped], required: bool) -> Riffer::Params::Param
29
35
 
30
36
  # --
31
- # : (Module, Hash[Symbol, untyped]) -> [Module?, Riffer::Params?]
32
- def self.resolve_nesting: (Module, Hash[Symbol, untyped]) -> [ Module?, 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
+
40
+ # --
41
+ # : (Module, Hash[Symbol, untyped]) -> Riffer::Params?
42
+ def self.resolve_nested_params: (Module, Hash[Symbol, untyped]) -> Riffer::Params?
43
+
44
+ # --
45
+ # : (Hash[Symbol, untyped]) -> [Module, Integer, Hash[Symbol, untyped]]?
46
+ def self.resolve_typed_items: (Hash[Symbol, untyped]) -> [ Module, Integer, Hash[Symbol, untyped] ]?
33
47
 
34
48
  # --
35
49
  # : (untyped) -> Module
36
50
  def self.json_type_to_ruby: (untyped) -> Module
37
51
 
38
52
  # --
39
- # : (name: Symbol, type: Module, required: bool, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?item_type: Module?, ?nested_params: Riffer::Params?) -> void
40
- def initialize: (name: Symbol, type: Module, required: bool, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?item_type: Module?, ?nested_params: 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
41
55
 
42
56
  # --
43
57
  # : (untyped) -> bool
@@ -60,6 +74,15 @@ class Riffer::Params::Param
60
74
  # : (Riffer::Params::Param) -> void
61
75
  def initialize_copy: (Riffer::Params::Param) -> void
62
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
+
82
+ # --
83
+ # : () -> void
84
+ def validate_format!: () -> void
85
+
63
86
  # --
64
87
  # : () -> void
65
88
  def validate_strict_shape!: () -> void
@@ -14,12 +14,16 @@ class Riffer::Params
14
14
  def self.from_json_schema: (Hash[Symbol, untyped]) -> Riffer::Params
15
15
 
16
16
  # --
17
- # : (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?of: Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
18
- def required: (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?of: Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
17
+ # : (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
18
+ # : (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
19
+ def required: (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
20
+ | (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
19
21
 
20
22
  # --
21
- # : (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?of: Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
22
- def optional: (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?default: untyped, ?of: Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
23
+ # : (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?, ?default: untyped) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
24
+ # : (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
25
+ def optional: (Symbol, singleton(Riffer::Params::AnyOf), ?description: String?, ?default: untyped) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
26
+ | (Symbol, Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?of: (Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
23
27
 
24
28
  # --
25
29
  # : (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
@@ -38,8 +42,20 @@ class Riffer::Params
38
42
  def initialize_copy: (Riffer::Params) -> void
39
43
 
40
44
  # --
41
- # : (Module, Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
42
- def build_nested: (Module, Module?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
45
+ # : ((Module | Array[untyped])?, ?Integer) -> [Module?, Integer]
46
+ def unwrap_of: ((Module | Array[untyped])?, ?Integer) -> [ Module?, Integer ]
47
+
48
+ # --
49
+ # : (Module, Module?, Array[untyped]?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
50
+ def build_nested: (Module, Module?, Array[untyped]?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
51
+
52
+ # --
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?
43
59
 
44
60
  # --
45
61
  # : (Riffer::Params::Param, untyped, Array[String]) -> untyped
@@ -49,13 +65,27 @@ class Riffer::Params
49
65
  # : (Riffer::Params::Param, Hash[Symbol, untyped], Array[String]) -> Hash[Symbol, untyped]
50
66
  def validate_nested_hash: (Riffer::Params::Param, Hash[Symbol, untyped], Array[String]) -> Hash[Symbol, untyped]
51
67
 
68
+ # --
69
+ # : (Riffer::Params::Param, untyped, Array[String]) -> untyped
70
+ def validate_any_of: (Riffer::Params::Param, untyped, Array[String]) -> untyped
71
+
72
+ # Validation drops keys a Params doesn't declare, at any depth, so they are
73
+ # the keys in the input that are missing from the output.
74
+ # --
75
+ # : (untyped, untyped, ?String?) -> Array[String]
76
+ def undeclared_keys: (untyped, untyped, ?String?) -> Array[String]
77
+
52
78
  # --
53
79
  # : (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
54
80
  def validate_nested_array_of_objects: (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
55
81
 
56
82
  # --
57
- # : (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
58
- def validate_typed_array: (Riffer::Params::Param, Array[untyped], Array[String]) -> Array[untyped]
83
+ # : (Riffer::Params::Param, Array[untyped], Array[String], ?String, ?Integer) -> Array[untyped]
84
+ def validate_typed_array: (Riffer::Params::Param, Array[untyped], Array[String], ?String, ?Integer) -> Array[untyped]
85
+
86
+ # --
87
+ # : (Module, untyped) -> bool
88
+ def valid_item?: (Module, untyped) -> bool
59
89
 
60
90
  # --
61
91
  # : (Module, untyped) -> untyped
@@ -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