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.
- checksums.yaml +4 -4
- data/.claude/rules/rbs-inline.md +6 -6
- data/.release-please-manifest.json +1 -1
- data/.ruby-version +1 -1
- data/CHANGELOG.md +46 -0
- data/README.md +26 -1
- data/Steepfile +2 -2
- data/UPGRADING.md +3 -0
- data/docs/AGENTS.md +37 -12
- data/docs/AGENT_LIFECYCLE.md +1 -1
- data/docs/CATALOG.md +8 -8
- data/docs/CONFIGURATION.md +95 -17
- data/docs/GUARDRAILS.md +2 -0
- data/docs/MCP.md +3 -4
- data/docs/MESSAGES.md +112 -15
- data/docs/STABILITY.md +32 -0
- data/docs/STREAM_EVENTS.md +17 -1
- data/docs/TESTING.md +22 -1
- data/docs/TOOLS.md +11 -11
- data/docs/TRACING.md +1 -1
- data/docs/providers/AMAZON_BEDROCK.md +3 -1
- data/docs/providers/ANTHROPIC.md +44 -44
- data/docs/providers/CUSTOM_PROVIDERS.md +59 -0
- data/docs/providers/GEMINI.md +76 -26
- data/docs/providers/GOOGLE_CLOUD.md +363 -0
- data/docs/providers/MOCK_PROVIDER.md +2 -0
- data/docs/providers/OPENAI.md +3 -1
- data/docs/providers/PROVIDERS.md +30 -18
- data/docs-site/manifest.yml +6 -0
- data/lib/riffer/agent/run.rb +28 -13
- data/lib/riffer/agent/session.rb +33 -10
- data/lib/riffer/agent/structured_output.rb +6 -1
- data/lib/riffer/config/anthropic.rb +9 -0
- data/lib/riffer/config/future.rb +53 -0
- data/lib/riffer/config/gemini.rb +9 -0
- data/lib/riffer/config/google_cloud.rb +38 -0
- data/lib/riffer/config/pricing.rb +5 -15
- data/lib/riffer/config.rb +19 -0
- data/lib/riffer/deprecation/event.rb +25 -0
- data/lib/riffer/deprecation.rb +60 -0
- data/lib/riffer/http/client.rb +141 -0
- data/lib/riffer/http.rb +5 -0
- data/lib/riffer/mcp/client.rb +0 -1
- data/lib/riffer/messages/assistant/server_tool_part.rb +73 -0
- data/lib/riffer/messages/assistant/text_part.rb +52 -0
- data/lib/riffer/messages/assistant.rb +64 -17
- data/lib/riffer/params/any_of.rb +37 -9
- data/lib/riffer/params/param.rb +35 -14
- data/lib/riffer/params.rb +34 -19
- data/lib/riffer/providers/amazon_bedrock.rb +38 -5
- data/lib/riffer/providers/anthropic/client.rb +49 -0
- data/lib/riffer/providers/anthropic.rb +19 -452
- data/lib/riffer/providers/anthropic_compatible/messages_api/stream.rb +219 -0
- data/lib/riffer/providers/anthropic_compatible/messages_api.rb +315 -0
- data/lib/riffer/providers/anthropic_compatible.rb +5 -0
- data/lib/riffer/providers/anthropic_vertex.rb +66 -0
- data/lib/riffer/providers/base.rb +19 -13
- data/lib/riffer/providers/gemini/client.rb +17 -85
- data/lib/riffer/providers/gemini.rb +213 -81
- data/lib/riffer/providers/google_cloud/client.rb +106 -0
- data/lib/riffer/providers/google_cloud.rb +99 -0
- data/lib/riffer/providers/open_ai.rb +21 -16
- data/lib/riffer/providers/repository.rb +2 -0
- data/lib/riffer/stream_events/server_tool_done.rb +21 -0
- data/lib/riffer/testing.rb +6 -0
- data/lib/riffer/version.rb +1 -1
- data/lib/riffer/wire/sse.rb +51 -0
- data/lib/riffer/wire.rb +31 -0
- data/lib/riffer.rb +20 -0
- data/rbs_collection.lock.yaml +24 -4
- data/sig/_private/faraday.rbs +8 -0
- data/sig/_private/googleauth.rbs +7 -0
- data/sig/generated/riffer/agent/run.rbs +5 -0
- data/sig/generated/riffer/agent/session.rbs +6 -0
- data/sig/generated/riffer/config/anthropic.rbs +6 -0
- data/sig/generated/riffer/config/future.rbs +29 -0
- data/sig/generated/riffer/config/gemini.rbs +6 -0
- data/sig/generated/riffer/config/google_cloud.rbs +28 -0
- data/sig/generated/riffer/config/pricing.rbs +0 -9
- data/sig/generated/riffer/config.rbs +10 -0
- data/sig/generated/riffer/deprecation/event.rbs +17 -0
- data/sig/generated/riffer/deprecation.rbs +27 -0
- data/sig/generated/riffer/http/client.rbs +59 -0
- data/sig/generated/riffer/http.rbs +4 -0
- data/sig/generated/riffer/messages/assistant/server_tool_part.rbs +44 -0
- data/sig/generated/riffer/messages/assistant/text_part.rbs +35 -0
- data/sig/generated/riffer/messages/assistant.rbs +24 -11
- data/sig/generated/riffer/params/any_of.rbs +13 -5
- data/sig/generated/riffer/params/param.rbs +10 -5
- data/sig/generated/riffer/params.rbs +8 -4
- data/sig/generated/riffer/providers/amazon_bedrock.rbs +14 -2
- data/sig/generated/riffer/providers/anthropic/client.rbs +34 -0
- data/sig/generated/riffer/providers/anthropic.rbs +5 -124
- data/sig/generated/riffer/providers/anthropic_compatible/messages_api/stream.rbs +81 -0
- data/sig/generated/riffer/providers/anthropic_compatible/messages_api.rbs +108 -0
- data/sig/generated/riffer/providers/anthropic_compatible.rbs +4 -0
- data/sig/generated/riffer/providers/anthropic_vertex.rbs +45 -0
- data/sig/generated/riffer/providers/base.rbs +5 -0
- data/sig/generated/riffer/providers/gemini/client.rbs +11 -34
- data/sig/generated/riffer/providers/gemini.rbs +66 -4
- data/sig/generated/riffer/providers/google_cloud/client.rbs +71 -0
- data/sig/generated/riffer/providers/google_cloud.rbs +64 -0
- data/sig/generated/riffer/providers/open_ai.rbs +7 -2
- data/sig/generated/riffer/stream_events/server_tool_done.rbs +15 -0
- data/sig/generated/riffer/testing.rbs +4 -0
- data/sig/generated/riffer/wire/sse.rbs +23 -0
- data/sig/generated/riffer/wire.rbs +17 -0
- data/sig/generated/riffer.rbs +15 -0
- data/sig/manual/riffer/deprecation.rbs +5 -0
- data/sig/manual/riffer/providers/anthropic_compatible/messages_api.rbs +8 -0
- data/sig/manual/riffer/providers/gemini.rbs +8 -0
- data/sig/manual/riffer/providers/google_cloud.rbs +8 -0
- data/sig/manual/riffer/wire.rbs +5 -0
- metadata +76 -5
- data/sig/_private/anthropic.rbs +0 -17
- data/sig/_private/riffer/providers/anthropic.rbs +0 -6
- 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,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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
# : (
|
|
12
|
-
def
|
|
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,
|
|
66
|
-
def validate_any_of: (Riffer::Params::Param,
|
|
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::
|
|
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
|
|
12
|
+
def client: () -> untyped
|
|
30
13
|
|
|
31
14
|
# --
|
|
32
15
|
# : () -> untyped
|
|
33
|
-
def
|
|
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
|
-
# : (
|
|
139
|
-
def
|
|
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
|