riffer 0.55.0 → 0.57.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/.release-please-manifest.json +1 -1
- data/CHANGELOG.md +37 -0
- data/README.md +3 -2
- data/UPGRADING.md +3 -0
- data/docs/AGENTS.md +105 -50
- data/docs/AGENT_LIFECYCLE.md +2 -2
- data/docs/CONFIGURATION.md +54 -3
- data/docs/EVALS.md +2 -0
- data/docs/GUARDRAILS.md +2 -0
- data/docs/MCP.md +36 -0
- data/docs/MESSAGES.md +125 -15
- data/docs/OVERVIEW.md +7 -7
- data/docs/SERIALIZATION.md +12 -2
- data/docs/SKILLS.md +1 -1
- data/docs/STABILITY.md +32 -0
- data/docs/STREAM_EVENTS.md +16 -0
- data/docs/TESTING.md +22 -1
- data/docs/TOOLS.md +93 -37
- data/docs/TOOL_ADVANCED.md +7 -0
- data/docs/providers/AMAZON_BEDROCK.md +7 -3
- data/docs/providers/ANTHROPIC.md +53 -16
- data/docs/providers/AZURE_OPENAI.md +9 -3
- data/docs/providers/CUSTOM_PROVIDERS.md +43 -0
- data/docs/providers/GEMINI.md +9 -5
- data/docs/providers/GOOGLE_CLOUD.md +10 -5
- data/docs/providers/MOCK_PROVIDER.md +4 -0
- data/docs/providers/OPENAI.md +28 -4
- data/docs/providers/OPENROUTER.md +11 -3
- data/docs/providers/PROVIDERS.md +1 -1
- data/docs-site/index.html.erb +1 -1
- data/docs-site/manifest.yml +3 -0
- data/lib/riffer/agent/config.rb +21 -0
- data/lib/riffer/agent/context.rb +36 -18
- data/lib/riffer/agent/run.rb +82 -21
- data/lib/riffer/agent/serializer.rb +5 -0
- data/lib/riffer/agent/session.rb +34 -10
- data/lib/riffer/agent.rb +43 -0
- data/lib/riffer/config/future.rb +53 -0
- data/lib/riffer/config/mcp.rb +17 -0
- data/lib/riffer/config/pricing.rb +5 -15
- data/lib/riffer/config.rb +28 -1
- data/lib/riffer/deprecation/event.rb +25 -0
- data/lib/riffer/deprecation.rb +60 -0
- data/lib/riffer/evals/evaluator.rb +8 -1
- data/lib/riffer/evals/evaluator_runner.rb +1 -0
- data/lib/riffer/evals/judge.rb +2 -2
- data/lib/riffer/evals.rb +2 -0
- data/lib/riffer/mcp/search_tool.rb +1 -1
- data/lib/riffer/mcp.rb +7 -0
- 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/messages/tool.rb +6 -2
- data/lib/riffer/params/any_of.rb +5 -8
- data/lib/riffer/params/boolean.rb +1 -1
- data/lib/riffer/params/param.rb +96 -67
- data/lib/riffer/params.rb +50 -71
- data/lib/riffer/providers/anthropic_compatible/messages_api/stream.rb +28 -11
- data/lib/riffer/providers/anthropic_compatible/messages_api.rb +136 -38
- data/lib/riffer/providers/base.rb +57 -12
- data/lib/riffer/providers/deferred_tool_gateway/sink.rb +54 -0
- data/lib/riffer/providers/deferred_tool_gateway/tool.rb +17 -0
- data/lib/riffer/providers/deferred_tool_gateway.rb +150 -0
- data/lib/riffer/providers/gemini.rb +5 -5
- data/lib/riffer/providers/mock.rb +6 -0
- data/lib/riffer/providers/open_ai.rb +59 -26
- data/lib/riffer/skills/activate_tool.rb +1 -1
- data/lib/riffer/stream_events/server_tool_done.rb +21 -0
- data/lib/riffer/testing.rb +6 -0
- data/lib/riffer/tool.rb +92 -2
- data/lib/riffer/tools/response.rb +11 -2
- data/lib/riffer/version.rb +1 -1
- data/lib/riffer.rb +2 -0
- data/sig/generated/riffer/agent/config.rbs +13 -1
- data/sig/generated/riffer/agent/context.rbs +16 -0
- data/sig/generated/riffer/agent/run.rbs +19 -2
- data/sig/generated/riffer/agent/session.rbs +6 -0
- data/sig/generated/riffer/agent.rbs +13 -0
- data/sig/generated/riffer/config/future.rbs +29 -0
- data/sig/generated/riffer/config/mcp.rbs +7 -0
- data/sig/generated/riffer/config/pricing.rbs +0 -9
- data/sig/generated/riffer/config.rbs +13 -1
- data/sig/generated/riffer/deprecation/event.rbs +17 -0
- data/sig/generated/riffer/deprecation.rbs +27 -0
- data/sig/generated/riffer/evals/evaluator.rbs +4 -0
- data/sig/generated/riffer/evals.rbs +1 -0
- data/sig/generated/riffer/mcp.rbs +1 -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/messages/tool.rbs +4 -2
- data/sig/generated/riffer/params/any_of.rbs +4 -4
- data/sig/generated/riffer/params/boolean.rbs +1 -1
- data/sig/generated/riffer/params/param.rbs +28 -14
- data/sig/generated/riffer/params.rbs +20 -20
- data/sig/generated/riffer/providers/anthropic_compatible/messages_api/stream.rbs +12 -5
- data/sig/generated/riffer/providers/anthropic_compatible/messages_api.rbs +50 -9
- data/sig/generated/riffer/providers/base.rbs +18 -0
- data/sig/generated/riffer/providers/deferred_tool_gateway/sink.rbs +23 -0
- data/sig/generated/riffer/providers/deferred_tool_gateway/tool.rbs +4 -0
- data/sig/generated/riffer/providers/deferred_tool_gateway.rbs +58 -0
- data/sig/generated/riffer/providers/mock.rbs +4 -0
- data/sig/generated/riffer/providers/open_ai.rbs +23 -6
- data/sig/generated/riffer/stream_events/server_tool_done.rbs +15 -0
- data/sig/generated/riffer/testing.rbs +4 -0
- data/sig/generated/riffer/tool.rbs +48 -2
- data/sig/generated/riffer/tools/response.rbs +9 -2
- data/sig/generated/riffer.rbs +3 -0
- data/sig/manual/riffer/deprecation.rbs +5 -0
- data/sig/manual/riffer/providers/deferred_tool_gateway.rbs +5 -0
- metadata +23 -3
- data/lib/riffer/tools/toolable.rb +0 -113
- data/sig/generated/riffer/tools/toolable.rbs +0 -66
|
@@ -10,12 +10,12 @@ class Riffer::Params::AnyOf
|
|
|
10
10
|
def initialize: (Symbol) -> void
|
|
11
11
|
|
|
12
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
|
|
13
|
+
# : (?(Symbol | Module)?, ?description: String?, ?enum: Array[untyped]?, ?format: String?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
14
|
+
def variant: (?(Symbol | Module)?, ?description: String?, ?enum: Array[untyped]?, ?format: String?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
15
15
|
|
|
16
16
|
private
|
|
17
17
|
|
|
18
18
|
# --
|
|
19
|
-
# : (Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
|
|
20
|
-
def primitive: (Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
|
|
19
|
+
# : (Symbol | Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
|
|
20
|
+
def primitive: (Symbol | Module, String?, Array[untyped]?, String?) -> Riffer::Params::Param
|
|
21
21
|
end
|
|
@@ -1,15 +1,17 @@
|
|
|
1
1
|
# Generated from lib/riffer/params/param.rb with RBS::Inline
|
|
2
2
|
|
|
3
3
|
class Riffer::Params::Param
|
|
4
|
-
|
|
4
|
+
PRIMITIVE_TYPES: Array[Symbol]
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
TYPES: Array[Symbol]
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
CLASS_TYPES: Hash[Module, Symbol]
|
|
9
|
+
|
|
10
|
+
JSON_TYPE_MAPPINGS: Hash[String, Symbol]
|
|
9
11
|
|
|
10
12
|
attr_reader name: Symbol
|
|
11
13
|
|
|
12
|
-
attr_reader type:
|
|
14
|
+
attr_reader type: Symbol
|
|
13
15
|
|
|
14
16
|
attr_reader required: bool
|
|
15
17
|
|
|
@@ -21,7 +23,7 @@ class Riffer::Params::Param
|
|
|
21
23
|
|
|
22
24
|
attr_reader default: untyped
|
|
23
25
|
|
|
24
|
-
attr_reader item_type:
|
|
26
|
+
attr_reader item_type: Symbol?
|
|
25
27
|
|
|
26
28
|
attr_reader dimensions: Integer
|
|
27
29
|
|
|
@@ -29,6 +31,18 @@ class Riffer::Params::Param
|
|
|
29
31
|
|
|
30
32
|
attr_reader variants: Array[Riffer::Params | Riffer::Params::Param]?
|
|
31
33
|
|
|
34
|
+
# --
|
|
35
|
+
# : (untyped) -> Symbol?
|
|
36
|
+
def self.resolve_type: (untyped) -> Symbol?
|
|
37
|
+
|
|
38
|
+
# --
|
|
39
|
+
# : (untyped, String, Array[Symbol]) -> Symbol
|
|
40
|
+
def self.resolve_type!: (untyped, String, Array[Symbol]) -> Symbol
|
|
41
|
+
|
|
42
|
+
# --
|
|
43
|
+
# : (Symbol, untyped) -> bool
|
|
44
|
+
def self.value_of_type?: (Symbol, untyped) -> bool
|
|
45
|
+
|
|
32
46
|
# --
|
|
33
47
|
# : (Symbol, Hash[Symbol, untyped], required: bool) -> Riffer::Params::Param
|
|
34
48
|
def self.from_json_schema: (Symbol, Hash[Symbol, untyped], required: bool) -> Riffer::Params::Param
|
|
@@ -38,20 +52,20 @@ class Riffer::Params::Param
|
|
|
38
52
|
def self.resolve_variants: (Symbol, Array[Hash[Symbol, untyped]]) -> Array[Riffer::Params | Riffer::Params::Param]
|
|
39
53
|
|
|
40
54
|
# --
|
|
41
|
-
# : (
|
|
42
|
-
def self.resolve_nested_params: (
|
|
55
|
+
# : (Symbol, Hash[Symbol, untyped]) -> Riffer::Params?
|
|
56
|
+
def self.resolve_nested_params: (Symbol, Hash[Symbol, untyped]) -> Riffer::Params?
|
|
43
57
|
|
|
44
58
|
# --
|
|
45
|
-
# : (Hash[Symbol, untyped]) -> [
|
|
46
|
-
def self.resolve_typed_items: (Hash[Symbol, untyped]) -> [
|
|
59
|
+
# : (Hash[Symbol, untyped]) -> [Symbol, Integer, Hash[Symbol, untyped]]?
|
|
60
|
+
def self.resolve_typed_items: (Hash[Symbol, untyped]) -> [ Symbol, Integer, Hash[Symbol, untyped] ]?
|
|
47
61
|
|
|
48
62
|
# --
|
|
49
|
-
# : (untyped) ->
|
|
50
|
-
def self.
|
|
63
|
+
# : (untyped) -> Symbol
|
|
64
|
+
def self.json_type: (untyped) -> Symbol
|
|
51
65
|
|
|
52
66
|
# --
|
|
53
|
-
# : (name: Symbol, type:
|
|
54
|
-
def initialize: (name: Symbol, type:
|
|
67
|
+
# : (name: Symbol, type: Symbol, required: bool, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?item_type: Symbol?, ?dimensions: Integer, ?nested_params: Riffer::Params?, ?variants: Array[Riffer::Params | Riffer::Params::Param]?) -> void
|
|
68
|
+
def initialize: (name: Symbol, type: Symbol, required: bool, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?item_type: Symbol?, ?dimensions: Integer, ?nested_params: Riffer::Params?, ?variants: Array[Riffer::Params | Riffer::Params::Param]?) -> void
|
|
55
69
|
|
|
56
70
|
# --
|
|
57
71
|
# : (untyped) -> bool
|
|
@@ -74,7 +88,7 @@ class Riffer::Params::Param
|
|
|
74
88
|
# : (Riffer::Params::Param) -> void
|
|
75
89
|
def initialize_copy: (Riffer::Params::Param) -> void
|
|
76
90
|
|
|
77
|
-
# The first matching variant wins, and a
|
|
91
|
+
# The first matching variant wins, and a :number variant without an enum accepts any number.
|
|
78
92
|
# --
|
|
79
93
|
# : () -> void
|
|
80
94
|
def validate_variant_order!: () -> void
|
|
@@ -14,16 +14,16 @@ class Riffer::Params
|
|
|
14
14
|
def self.from_json_schema: (Hash[Symbol, untyped]) -> Riffer::Params
|
|
15
15
|
|
|
16
16
|
# --
|
|
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
|
|
17
|
+
# : (Symbol, :any_of | singleton(Riffer::Params::AnyOf), ?description: String?) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
18
|
+
# : (Symbol, Symbol | Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?of: (Symbol | Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
19
|
+
def required: (Symbol, :any_of | singleton(Riffer::Params::AnyOf), ?description: String?) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
20
|
+
| (Symbol, Symbol | Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?of: (Symbol | Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
21
21
|
|
|
22
22
|
# --
|
|
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
|
+
# : (Symbol, :any_of | singleton(Riffer::Params::AnyOf), ?description: String?, ?default: untyped) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
24
|
+
# : (Symbol, Symbol | Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?of: (Symbol | Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
25
|
+
def optional: (Symbol, :any_of | singleton(Riffer::Params::AnyOf), ?description: String?, ?default: untyped) { (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> void
|
|
26
|
+
| (Symbol, Symbol | Module, ?description: String?, ?enum: Array[untyped]?, ?format: String?, ?default: untyped, ?of: (Symbol | Module | Array[untyped])?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> void
|
|
27
27
|
|
|
28
28
|
# --
|
|
29
29
|
# : (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
|
|
@@ -42,16 +42,20 @@ class Riffer::Params
|
|
|
42
42
|
def initialize_copy: (Riffer::Params) -> void
|
|
43
43
|
|
|
44
44
|
# --
|
|
45
|
-
# : ((Module | Array[untyped])
|
|
46
|
-
def
|
|
45
|
+
# : (Symbol, untyped, required: bool, description: String?, enum: Array[untyped]?, format: String?, ?default: untyped, of: (Symbol | Module | Array[untyped])?) ?{ (untyped) [self: untyped] -> void } -> void
|
|
46
|
+
def add_param: (Symbol, untyped, required: bool, description: String?, enum: Array[untyped]?, format: String?, of: (Symbol | Module | Array[untyped])?, ?default: untyped) ?{ (untyped) [self: untyped] -> void } -> void
|
|
47
47
|
|
|
48
48
|
# --
|
|
49
|
-
# : (
|
|
50
|
-
def
|
|
49
|
+
# : ((Symbol | Module | Array[untyped])?, ?Integer) -> [(Symbol | Module)?, Integer]
|
|
50
|
+
def unwrap_of: ((Symbol | Module | Array[untyped])?, ?Integer) -> [ (Symbol | Module)?, Integer ]
|
|
51
51
|
|
|
52
52
|
# --
|
|
53
|
-
# : (Symbol,
|
|
54
|
-
def
|
|
53
|
+
# : (Symbol, Symbol?, Array[untyped]?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
|
|
54
|
+
def build_nested: (Symbol, Symbol?, Array[untyped]?) ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
|
|
55
|
+
|
|
56
|
+
# --
|
|
57
|
+
# : (Symbol, (Symbol | Module | Array[untyped])?, Array[untyped]?) ?{ (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> Array[Riffer::Params | Riffer::Params::Param]
|
|
58
|
+
def build_variants: (Symbol, (Symbol | Module | Array[untyped])?, Array[untyped]?) ?{ (Riffer::Params::AnyOf) [self: Riffer::Params::AnyOf] -> void } -> Array[Riffer::Params | Riffer::Params::Param]
|
|
55
59
|
|
|
56
60
|
# --
|
|
57
61
|
# : (Riffer::Params::Param, untyped) -> String?
|
|
@@ -84,10 +88,6 @@ class Riffer::Params
|
|
|
84
88
|
def validate_typed_array: (Riffer::Params::Param, Array[untyped], Array[String], ?String, ?Integer) -> Array[untyped]
|
|
85
89
|
|
|
86
90
|
# --
|
|
87
|
-
# : (
|
|
88
|
-
def
|
|
89
|
-
|
|
90
|
-
# --
|
|
91
|
-
# : (Module, untyped) -> untyped
|
|
92
|
-
def coerce_value: (Module, untyped) -> untyped
|
|
91
|
+
# : (Symbol, untyped) -> untyped
|
|
92
|
+
def coerce_value: (Symbol, untyped) -> untyped
|
|
93
93
|
end
|
|
@@ -11,10 +11,20 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI::Stream
|
|
|
11
11
|
|
|
12
12
|
@tools: Array[singleton(Riffer::Tool)]
|
|
13
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
|
+
|
|
14
20
|
# --
|
|
15
21
|
# : (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ReasoningPart?
|
|
16
22
|
def self.reasoning_part: (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ReasoningPart?
|
|
17
23
|
|
|
24
|
+
# --
|
|
25
|
+
# : (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ServerToolPart
|
|
26
|
+
def self.server_tool_part: (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::ServerToolPart
|
|
27
|
+
|
|
18
28
|
# --
|
|
19
29
|
# : (tools: Array[singleton(Riffer::Tool)]) -> void
|
|
20
30
|
def initialize: (tools: Array[singleton(Riffer::Tool)]) -> void
|
|
@@ -24,7 +34,8 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI::Stream
|
|
|
24
34
|
# : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
|
|
25
35
|
def handle: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
|
|
26
36
|
|
|
27
|
-
# The caller reads finish reason and usage from here
|
|
37
|
+
# The caller reads the text, finish reason and usage from here, since one turn
|
|
38
|
+
# can take several streams.
|
|
28
39
|
# --
|
|
29
40
|
# : () -> Hash[Symbol, untyped]
|
|
30
41
|
def finish!: () -> Hash[Symbol, untyped]
|
|
@@ -51,10 +62,6 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI::Stream
|
|
|
51
62
|
# : (Hash[Symbol, untyped]) -> void
|
|
52
63
|
def apply_message_delta: (Hash[Symbol, untyped]) -> void
|
|
53
64
|
|
|
54
|
-
# --
|
|
55
|
-
# : (Riffer::Providers::_EventSink) -> void
|
|
56
|
-
def stop_message: (Riffer::Providers::_EventSink) -> void
|
|
57
|
-
|
|
58
65
|
# --
|
|
59
66
|
# : (Hash[Symbol, untyped]) -> void
|
|
60
67
|
def raise_stream_error: (Hash[Symbol, untyped]) -> void
|
|
@@ -5,15 +5,21 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI < Riffer::Providers::B
|
|
|
5
5
|
|
|
6
6
|
FINISH_REASONS: Hash[String, Symbol]
|
|
7
7
|
|
|
8
|
+
PAUSE_TURN_CONTINUATIONS: Integer
|
|
9
|
+
|
|
8
10
|
# Only parts carrying this tag are replayed, so reasoning captured by another
|
|
9
11
|
# adapter, whose signatures the Messages API may not accept, never reaches the
|
|
10
|
-
# request.
|
|
12
|
+
# request. Server tool parts and text parts that keep their block carry it too.
|
|
11
13
|
REASONING_FORMAT: String
|
|
12
14
|
|
|
13
15
|
# --
|
|
14
16
|
# : (?String?) -> singleton(Riffer::Skills::Adapter)
|
|
15
17
|
def self.skills_adapter: (?String?) -> singleton(Riffer::Skills::Adapter)
|
|
16
18
|
|
|
19
|
+
# --
|
|
20
|
+
# : () -> bool
|
|
21
|
+
def self.supports_deferred_tools?: () -> bool
|
|
22
|
+
|
|
17
23
|
private
|
|
18
24
|
|
|
19
25
|
# --
|
|
@@ -33,21 +39,39 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI < Riffer::Providers::B
|
|
|
33
39
|
# : (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
|
|
34
40
|
def execute_generate: (Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
|
|
35
41
|
|
|
42
|
+
# The done events cover the whole turn, so they wait until every paused
|
|
43
|
+
# response has been continued.
|
|
36
44
|
# --
|
|
37
45
|
# : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
|
|
38
46
|
def execute_stream: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> void
|
|
39
47
|
|
|
40
48
|
# --
|
|
41
|
-
# : (Hash[Symbol, untyped]) ->
|
|
42
|
-
def
|
|
49
|
+
# : (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> Hash[Symbol, untyped]
|
|
50
|
+
def stream_message: (Hash[Symbol, untyped], Riffer::Providers::_EventSink) -> Hash[Symbol, untyped]
|
|
51
|
+
|
|
52
|
+
# To resume a paused turn, resend the same request with the paused response's
|
|
53
|
+
# content array appended as an assistant message, copied as-is and with nothing after it.
|
|
54
|
+
# --
|
|
55
|
+
# : (Hash[Symbol, untyped]) { (Hash[Symbol, untyped]) -> Hash[Symbol, untyped] } -> Hash[Symbol, untyped]
|
|
56
|
+
def continue_paused_turn: (Hash[Symbol, untyped]) { (Hash[Symbol, untyped]) -> Hash[Symbol, untyped] } -> Hash[Symbol, untyped]
|
|
57
|
+
|
|
58
|
+
# Each request is billed for its own input and output, so the counts add up.
|
|
59
|
+
# A nil count in the later response would replace the running total, so it's dropped.
|
|
60
|
+
# --
|
|
61
|
+
# : (Hash[Symbol, untyped]?, Hash[Symbol, untyped]?) -> Hash[Symbol, untyped]?
|
|
62
|
+
def merge_usage: (Hash[Symbol, untyped]?, Hash[Symbol, untyped]?) -> Hash[Symbol, untyped]?
|
|
43
63
|
|
|
64
|
+
# Claude signs each thinking block over every block before it in the turn, so
|
|
65
|
+
# the blocks go back in the order they came.
|
|
44
66
|
# --
|
|
45
|
-
# : (Hash[Symbol, untyped]) -> Array[Riffer::Messages::Assistant::ToolCall]
|
|
46
|
-
def
|
|
67
|
+
# : (Hash[Symbol, untyped]) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
|
|
68
|
+
def extract_parts: (Hash[Symbol, untyped]) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
|
|
47
69
|
|
|
70
|
+
# The block is kept only when it carries citations, which point into the
|
|
71
|
+
# search results and go back with the text.
|
|
48
72
|
# --
|
|
49
|
-
# : (Hash[Symbol, untyped]) ->
|
|
50
|
-
def
|
|
73
|
+
# : (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::TextPart
|
|
74
|
+
def text_part: (Hash[Symbol, untyped]) -> Riffer::Messages::Assistant::TextPart
|
|
51
75
|
|
|
52
76
|
# --
|
|
53
77
|
# : (Hash[Symbol, untyped]) -> Riffer::Providers::TokenUsage?
|
|
@@ -78,13 +102,30 @@ class Riffer::Providers::AnthropicCompatible::MessagesAPI < Riffer::Providers::B
|
|
|
78
102
|
def structured_output_config: (Riffer::Agent::StructuredOutput) -> Hash[Symbol, untyped]
|
|
79
103
|
|
|
80
104
|
# --
|
|
81
|
-
# : (Array[Riffer::Messages::Base]) -> Hash[Symbol, untyped]
|
|
82
|
-
def partition_messages: (Array[Riffer::Messages::Base]) -> Hash[Symbol, untyped]
|
|
105
|
+
# : (Array[Riffer::Messages::Base], Array[singleton(Riffer::Tool)]) -> Hash[Symbol, untyped]
|
|
106
|
+
def partition_messages: (Array[Riffer::Messages::Base], Array[singleton(Riffer::Tool)]) -> Hash[Symbol, untyped]
|
|
107
|
+
|
|
108
|
+
# A load goes as tool_reference blocks alone, since the API rejects them mixed
|
|
109
|
+
# with text. Only this request's deferred tools are referenced: the API rejects
|
|
110
|
+
# a reference to a tool missing from +tools+, and a restored history may name
|
|
111
|
+
# tools the agent no longer defers.
|
|
112
|
+
# --
|
|
113
|
+
# : (Riffer::Messages::Tool, Array[String]) -> (String | Array[Hash[Symbol, untyped]])
|
|
114
|
+
def tool_result_content: (Riffer::Messages::Tool, Array[String]) -> (String | Array[Hash[Symbol, untyped]])
|
|
83
115
|
|
|
84
116
|
# --
|
|
85
117
|
# : (Riffer::Messages::Assistant) -> Hash[Symbol, untyped]
|
|
86
118
|
def convert_assistant: (Riffer::Messages::Assistant) -> Hash[Symbol, untyped]
|
|
87
119
|
|
|
120
|
+
# --
|
|
121
|
+
# : (Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart) -> Hash[Symbol, untyped]?
|
|
122
|
+
def convert_part: (Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart) -> Hash[Symbol, untyped]?
|
|
123
|
+
|
|
124
|
+
# The API rejects text blocks that are empty or only whitespace.
|
|
125
|
+
# --
|
|
126
|
+
# : (Riffer::Messages::Assistant::TextPart) -> Hash[Symbol, untyped]?
|
|
127
|
+
def convert_text_part: (Riffer::Messages::Assistant::TextPart) -> Hash[Symbol, untyped]?
|
|
128
|
+
|
|
88
129
|
# --
|
|
89
130
|
# : (Riffer::Messages::Assistant::ReasoningPart) -> Hash[Symbol, untyped]
|
|
90
131
|
def convert_reasoning_part: (Riffer::Messages::Assistant::ReasoningPart) -> Hash[Symbol, untyped]
|
|
@@ -15,6 +15,10 @@ class Riffer::Providers::Base
|
|
|
15
15
|
# : (?String?) -> singleton(Riffer::Skills::Adapter)
|
|
16
16
|
def self.skills_adapter: (?String?) -> singleton(Riffer::Skills::Adapter)
|
|
17
17
|
|
|
18
|
+
# --
|
|
19
|
+
# : () -> bool
|
|
20
|
+
def self.supports_deferred_tools?: () -> bool
|
|
21
|
+
|
|
18
22
|
# --
|
|
19
23
|
# : () -> String
|
|
20
24
|
def self.semconv_provider_name: () -> String
|
|
@@ -48,6 +52,15 @@ class Riffer::Providers::Base
|
|
|
48
52
|
# : () -> untyped
|
|
49
53
|
def build_client: () -> untyped
|
|
50
54
|
|
|
55
|
+
# The model calls a loaded deferred tool, and the gateway, by its wire name too.
|
|
56
|
+
# --
|
|
57
|
+
# : (Hash[Symbol, untyped]) -> Array[singleton(Riffer::Tool)]
|
|
58
|
+
def decodable_tools: (Hash[Symbol, untyped]) -> Array[singleton(Riffer::Tool)]
|
|
59
|
+
|
|
60
|
+
# --
|
|
61
|
+
# : (Hash[Symbol, untyped]) -> Array[singleton(Riffer::Tool)]
|
|
62
|
+
def gateway_deferred_tools: (Hash[Symbol, untyped]) -> Array[singleton(Riffer::Tool)]
|
|
63
|
+
|
|
51
64
|
# --
|
|
52
65
|
# : (String) -> String
|
|
53
66
|
def encode_tool_name: (String) -> String
|
|
@@ -103,6 +116,11 @@ class Riffer::Providers::Base
|
|
|
103
116
|
# : (untyped) -> Riffer::Providers::FinishReason?
|
|
104
117
|
def extract_finish_reason: (untyped) -> Riffer::Providers::FinishReason?
|
|
105
118
|
|
|
119
|
+
# Override when the provider interleaves blocks in one turn and needs them back in that order.
|
|
120
|
+
# --
|
|
121
|
+
# : (untyped) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
|
|
122
|
+
def extract_parts: (untyped) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
|
|
123
|
+
|
|
106
124
|
# --
|
|
107
125
|
# : (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
|
|
108
126
|
def extract_reasoning: (untyped) -> Array[Riffer::Messages::Assistant::ReasoningPart]
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Generated from lib/riffer/providers/deferred_tool_gateway/sink.rb with RBS::Inline
|
|
2
|
+
|
|
3
|
+
class Riffer::Providers::DeferredToolGateway::Sink
|
|
4
|
+
@sink: Riffer::Providers::_EventSink
|
|
5
|
+
|
|
6
|
+
@deferred_tools: Array[singleton(Riffer::Tool)]
|
|
7
|
+
|
|
8
|
+
@gateway_item_ids: Array[String]
|
|
9
|
+
|
|
10
|
+
# --
|
|
11
|
+
# : (Riffer::Providers::_EventSink, deferred_tools: Array[singleton(Riffer::Tool)]) -> void
|
|
12
|
+
def initialize: (Riffer::Providers::_EventSink, deferred_tools: Array[singleton(Riffer::Tool)]) -> void
|
|
13
|
+
|
|
14
|
+
# --
|
|
15
|
+
# : (Riffer::StreamEvents::Base) -> self
|
|
16
|
+
def <<: (Riffer::StreamEvents::Base) -> self
|
|
17
|
+
|
|
18
|
+
private
|
|
19
|
+
|
|
20
|
+
# --
|
|
21
|
+
# : (Riffer::StreamEvents::ToolCallDone) -> Riffer::StreamEvents::ToolCallDone
|
|
22
|
+
def unwrap: (Riffer::StreamEvents::ToolCallDone) -> Riffer::StreamEvents::ToolCallDone
|
|
23
|
+
end
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# Generated from lib/riffer/providers/deferred_tool_gateway.rb with RBS::Inline
|
|
2
|
+
|
|
3
|
+
module Riffer::Providers::DeferredToolGateway
|
|
4
|
+
# +deferred_tools+ are the ones the gateway carries for the request. With none there is no gateway, and every
|
|
5
|
+
# function here returns its input.
|
|
6
|
+
# --
|
|
7
|
+
# : (Array[Riffer::Messages::Base], Array[singleton(Riffer::Tool)]) -> Array[Riffer::Messages::Base]
|
|
8
|
+
def wrap_messages: (Array[Riffer::Messages::Base], Array[singleton(Riffer::Tool)]) -> Array[Riffer::Messages::Base]
|
|
9
|
+
|
|
10
|
+
# --
|
|
11
|
+
# : (Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart], Array[singleton(Riffer::Tool)]) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
|
|
12
|
+
def unwrap_parts: (Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart], Array[singleton(Riffer::Tool)]) -> Array[Riffer::Messages::Assistant::TextPart | Riffer::Messages::Assistant::ReasoningPart | Riffer::Messages::Assistant::ToolCall | Riffer::Messages::Assistant::ServerToolPart]
|
|
13
|
+
|
|
14
|
+
# A gateway call without a string name and string arguments, or naming a tool that isn't deferred, stays a call to
|
|
15
|
+
# the gateway, which is never one of the agent's tools, so the model gets an +:unknown_tool+ error result. Only a
|
|
16
|
+
# deferred tool's call is wrapped again on the way out, so unwrapping any other name would replay its arguments
|
|
17
|
+
# to the provider as they came, unparseable JSON included.
|
|
18
|
+
# --
|
|
19
|
+
# : (Riffer::Messages::Assistant::ToolCall, Array[singleton(Riffer::Tool)]) -> Riffer::Messages::Assistant::ToolCall
|
|
20
|
+
def unwrap_tool_call: (Riffer::Messages::Assistant::ToolCall, Array[singleton(Riffer::Tool)]) -> Riffer::Messages::Assistant::ToolCall
|
|
21
|
+
|
|
22
|
+
# --
|
|
23
|
+
# : (Riffer::Providers::_EventSink, Array[singleton(Riffer::Tool)]) -> Riffer::Providers::_EventSink
|
|
24
|
+
def unwrapping_sink: (Riffer::Providers::_EventSink, Array[singleton(Riffer::Tool)]) -> Riffer::Providers::_EventSink
|
|
25
|
+
|
|
26
|
+
private
|
|
27
|
+
|
|
28
|
+
# --
|
|
29
|
+
# : (String) -> [String, String]?
|
|
30
|
+
def parse_gateway_arguments: (String) -> [ String, String ]?
|
|
31
|
+
|
|
32
|
+
# --
|
|
33
|
+
# : (Riffer::Messages::Assistant, Array[String]) -> Riffer::Messages::Assistant
|
|
34
|
+
def wrap_assistant: (Riffer::Messages::Assistant, Array[String]) -> Riffer::Messages::Assistant
|
|
35
|
+
|
|
36
|
+
# --
|
|
37
|
+
# : (Riffer::Messages::Assistant::ToolCall, Array[String]) -> Riffer::Messages::Assistant::ToolCall
|
|
38
|
+
def wrap_tool_call: (Riffer::Messages::Assistant::ToolCall, Array[String]) -> Riffer::Messages::Assistant::ToolCall
|
|
39
|
+
|
|
40
|
+
# A result for a deferred tool is renamed along with its call, since Gemini sends the name with a function
|
|
41
|
+
# response and rejects one that names no declared function.
|
|
42
|
+
# --
|
|
43
|
+
# : (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Riffer::Messages::Tool
|
|
44
|
+
def wrap_tool_result: (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Riffer::Messages::Tool
|
|
45
|
+
|
|
46
|
+
# --
|
|
47
|
+
# : (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
|
|
48
|
+
def loaded_deferred_tools: (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
|
|
49
|
+
|
|
50
|
+
# Deterministic, so an earlier tool result reads the same on every request and the prompt cache holds.
|
|
51
|
+
# --
|
|
52
|
+
# : (Array[singleton(Riffer::Tool)]) -> String
|
|
53
|
+
def describe_loaded_tools: (Array[singleton(Riffer::Tool)]) -> String
|
|
54
|
+
|
|
55
|
+
# --
|
|
56
|
+
# : () -> String
|
|
57
|
+
def loaded_tools_header: () -> String
|
|
58
|
+
end
|
|
@@ -11,6 +11,10 @@ class Riffer::Providers::Mock < Riffer::Providers::Base
|
|
|
11
11
|
# : (?String?) -> singleton(Riffer::Skills::Adapter)
|
|
12
12
|
def self.skills_adapter: (?String?) -> singleton(Riffer::Skills::Adapter)
|
|
13
13
|
|
|
14
|
+
# --
|
|
15
|
+
# : () -> bool
|
|
16
|
+
def self.supports_deferred_tools?: () -> bool
|
|
17
|
+
|
|
14
18
|
# --
|
|
15
19
|
# : () -> String
|
|
16
20
|
def self.semconv_provider_name: () -> String
|
|
@@ -3,10 +3,17 @@
|
|
|
3
3
|
class Riffer::Providers::OpenAI < Riffer::Providers::Base
|
|
4
4
|
WEB_SEARCH_TOOL_TYPE: String
|
|
5
5
|
|
|
6
|
+
# Without this include, a web_search_call's search action carries no sources.
|
|
7
|
+
WEB_SEARCH_SOURCES_INCLUDE: String
|
|
8
|
+
|
|
6
9
|
# The Responses API has no finish_reason field, and an +incomplete+ status is only meaningful
|
|
7
10
|
# together with <tt>incomplete_details.reason</tt>.
|
|
8
11
|
FINISH_REASONS: Hash[String, Symbol | Hash[String, Symbol]]
|
|
9
12
|
|
|
13
|
+
# --
|
|
14
|
+
# : () -> bool
|
|
15
|
+
def self.supports_deferred_tools?: () -> bool
|
|
16
|
+
|
|
10
17
|
# --
|
|
11
18
|
# : () -> String
|
|
12
19
|
def self.semconv_provider_name: () -> String
|
|
@@ -109,9 +116,11 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
|
|
|
109
116
|
# : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
|
|
110
117
|
def handle_function_call_arguments_delta: (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
|
|
111
118
|
|
|
119
|
+
# Emitted from the finished item rather than function_call_arguments.done, because only the
|
|
120
|
+
# item's status marks a call cut off by max_output_tokens, whose arguments can't be run.
|
|
112
121
|
# --
|
|
113
|
-
# : (untyped,
|
|
114
|
-
def
|
|
122
|
+
# : (untyped, yielder: Riffer::Providers::_EventSink) -> void
|
|
123
|
+
def handle_output_item_done_function_call: (untyped, yielder: Riffer::Providers::_EventSink) -> void
|
|
115
124
|
|
|
116
125
|
# --
|
|
117
126
|
# : (untyped, state: Hash[Symbol, untyped], yielder: Riffer::Providers::_EventSink) -> void
|
|
@@ -130,12 +139,20 @@ class Riffer::Providers::OpenAI < Riffer::Providers::Base
|
|
|
130
139
|
def handle_output_item_done_reasoning: (untyped, yielder: Riffer::Providers::_EventSink) -> void
|
|
131
140
|
|
|
132
141
|
# --
|
|
133
|
-
# : (Array[Riffer::Messages::Base]) -> Array[Hash[Symbol, untyped]]
|
|
134
|
-
def convert_messages_to_openai_format: (Array[Riffer::Messages::Base]) -> Array[Hash[Symbol, untyped]]
|
|
142
|
+
# : (Array[Riffer::Messages::Base], deferred_tools: Array[singleton(Riffer::Tool)]) -> Array[Hash[Symbol, untyped]]
|
|
143
|
+
def convert_messages_to_openai_format: (Array[Riffer::Messages::Base], deferred_tools: Array[singleton(Riffer::Tool)]) -> Array[Hash[Symbol, untyped]]
|
|
144
|
+
|
|
145
|
+
# --
|
|
146
|
+
# : (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
|
|
147
|
+
def loaded_deferred_tools: (Riffer::Messages::Tool, Array[singleton(Riffer::Tool)]) -> Array[singleton(Riffer::Tool)]
|
|
148
|
+
|
|
149
|
+
# --
|
|
150
|
+
# : (Array[singleton(Riffer::Tool)]) -> Hash[Symbol, untyped]
|
|
151
|
+
def convert_additional_tools_to_openai_format: (Array[singleton(Riffer::Tool)]) -> Hash[Symbol, untyped]
|
|
135
152
|
|
|
136
153
|
# --
|
|
137
|
-
# : (Riffer::Messages::Assistant) -> Array[Hash[Symbol, untyped]]
|
|
138
|
-
def convert_assistant_to_openai_format: (Riffer::Messages::Assistant) -> Array[Hash[Symbol, untyped]]
|
|
154
|
+
# : (Riffer::Messages::Assistant, deferred_tools: Array[singleton(Riffer::Tool)]) -> Array[Hash[Symbol, untyped]]
|
|
155
|
+
def convert_assistant_to_openai_format: (Riffer::Messages::Assistant, deferred_tools: Array[singleton(Riffer::Tool)]) -> Array[Hash[Symbol, untyped]]
|
|
139
156
|
|
|
140
157
|
# --
|
|
141
158
|
# : (Array[Riffer::Messages::Assistant::ReasoningPart]) -> Array[Hash[Symbol, untyped]]
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Generated from lib/riffer/stream_events/server_tool_done.rb with RBS::Inline
|
|
2
|
+
|
|
3
|
+
# Carries a server tool block for replay. WebSearchStatus and WebSearchDone are the events to
|
|
4
|
+
# display.
|
|
5
|
+
class Riffer::StreamEvents::ServerToolDone < Riffer::StreamEvents::Base
|
|
6
|
+
attr_reader part: Riffer::Messages::Assistant::ServerToolPart
|
|
7
|
+
|
|
8
|
+
# --
|
|
9
|
+
# : (Riffer::Messages::Assistant::ServerToolPart, ?role: Symbol) -> void
|
|
10
|
+
def initialize: (Riffer::Messages::Assistant::ServerToolPart, ?role: Symbol) -> void
|
|
11
|
+
|
|
12
|
+
# --
|
|
13
|
+
# : () -> Hash[Symbol, untyped]
|
|
14
|
+
def to_h: () -> Hash[Symbol, untyped]
|
|
15
|
+
end
|
|
@@ -13,6 +13,10 @@ module Riffer::Testing
|
|
|
13
13
|
# : (?(String | Symbol)?, ?base: singleton(Riffer::Tool)) ?{ () [self: singleton(Riffer::Tool)] -> void } -> singleton(Riffer::Tool)
|
|
14
14
|
def stub_tool: (?(String | Symbol)?, ?base: singleton(Riffer::Tool)) ?{ () [self: singleton(Riffer::Tool)] -> void } -> singleton(Riffer::Tool)
|
|
15
15
|
|
|
16
|
+
# --
|
|
17
|
+
# : [T] () { () -> T } -> T
|
|
18
|
+
def allow_deprecations: [T] () { () -> T } -> T
|
|
19
|
+
|
|
16
20
|
# --
|
|
17
21
|
# : () -> void
|
|
18
22
|
def reset!: () -> void
|
|
@@ -1,10 +1,52 @@
|
|
|
1
1
|
# Generated from lib/riffer/tool.rb with RBS::Inline
|
|
2
2
|
|
|
3
3
|
class Riffer::Tool
|
|
4
|
-
extend Riffer::Tools::Toolable
|
|
5
|
-
|
|
6
4
|
extend Riffer::Registrable
|
|
7
5
|
|
|
6
|
+
self.@description: String?
|
|
7
|
+
|
|
8
|
+
self.@identifier: String?
|
|
9
|
+
|
|
10
|
+
self.@timeout: (Integer | Float)?
|
|
11
|
+
|
|
12
|
+
self.@params_builder: Riffer::Params?
|
|
13
|
+
|
|
14
|
+
DEFAULT_TIMEOUT: Integer
|
|
15
|
+
|
|
16
|
+
# --
|
|
17
|
+
# : (?String?) -> String?
|
|
18
|
+
def self.description: (?String?) -> String?
|
|
19
|
+
|
|
20
|
+
# --
|
|
21
|
+
# : (?String?) -> String
|
|
22
|
+
def self.identifier: (?String?) -> String
|
|
23
|
+
|
|
24
|
+
# --
|
|
25
|
+
# : (?String?) -> String
|
|
26
|
+
def self.name: (?String?) -> String
|
|
27
|
+
|
|
28
|
+
# --
|
|
29
|
+
# : (?(Integer | Float)?) -> (Integer | Float)
|
|
30
|
+
def self.timeout: (?(Integer | Float)?) -> (Integer | Float)
|
|
31
|
+
|
|
32
|
+
# --
|
|
33
|
+
# : () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
|
|
34
|
+
def self.params: () ?{ (Riffer::Params) [self: Riffer::Params] -> void } -> Riffer::Params?
|
|
35
|
+
|
|
36
|
+
# --
|
|
37
|
+
# : (?strict: bool) -> Hash[Symbol, untyped]
|
|
38
|
+
def self.parameters_schema: (?strict: bool) -> Hash[Symbol, untyped]
|
|
39
|
+
|
|
40
|
+
# --
|
|
41
|
+
# : (?strict: bool) -> Hash[Symbol, untyped]
|
|
42
|
+
def self.to_tool_schema: (?strict: bool) -> Hash[Symbol, untyped]
|
|
43
|
+
|
|
44
|
+
# --
|
|
45
|
+
# : () -> true
|
|
46
|
+
def self.validate_as_tool!: () -> true
|
|
47
|
+
|
|
48
|
+
private def self.empty_schema: () -> untyped
|
|
49
|
+
|
|
8
50
|
# --
|
|
9
51
|
# : (context: Riffer::Agent::Context?, **untyped) -> Riffer::Tools::Response
|
|
10
52
|
def call: (context: Riffer::Agent::Context?, **untyped) -> Riffer::Tools::Response
|
|
@@ -17,6 +59,10 @@ class Riffer::Tool
|
|
|
17
59
|
# : (untyped) -> Riffer::Tools::Response
|
|
18
60
|
def json: (untyped) -> Riffer::Tools::Response
|
|
19
61
|
|
|
62
|
+
# --
|
|
63
|
+
# : (Array[singleton(Riffer::Tool)]) -> Riffer::Tools::Response
|
|
64
|
+
def load_tools: (Array[singleton(Riffer::Tool)]) -> Riffer::Tools::Response
|
|
65
|
+
|
|
20
66
|
# --
|
|
21
67
|
# : (String, ?type: Symbol) -> Riffer::Tools::Response
|
|
22
68
|
def error: (String, ?type: Symbol) -> Riffer::Tools::Response
|
|
@@ -12,6 +12,8 @@ class Riffer::Tools::Response
|
|
|
12
12
|
|
|
13
13
|
attr_reader error_type: Symbol?
|
|
14
14
|
|
|
15
|
+
attr_reader loaded_tools: Array[singleton(Riffer::Tool)]
|
|
16
|
+
|
|
15
17
|
# Kept out of every serialized form so it never reaches an LLM or a message
|
|
16
18
|
# payload.
|
|
17
19
|
attr_reader exception: Exception?
|
|
@@ -28,6 +30,11 @@ class Riffer::Tools::Response
|
|
|
28
30
|
# : (untyped) -> Riffer::Tools::Response
|
|
29
31
|
def self.json: (untyped) -> Riffer::Tools::Response
|
|
30
32
|
|
|
33
|
+
# No text alongside: Anthropic rejects a tool result that mixes +tool_reference+ blocks with text.
|
|
34
|
+
# --
|
|
35
|
+
# : (Array[singleton(Riffer::Tool)]) -> Riffer::Tools::Response
|
|
36
|
+
def self.load_tools: (Array[singleton(Riffer::Tool)]) -> Riffer::Tools::Response
|
|
37
|
+
|
|
31
38
|
# --
|
|
32
39
|
# : (String, ?type: Symbol, ?exception: Exception?) -> Riffer::Tools::Response
|
|
33
40
|
def self.error: (String, ?type: Symbol, ?exception: Exception?) -> Riffer::Tools::Response
|
|
@@ -47,6 +54,6 @@ class Riffer::Tools::Response
|
|
|
47
54
|
private
|
|
48
55
|
|
|
49
56
|
# --
|
|
50
|
-
# : (content: String, success: bool, ?error_message: String?, ?error_type: Symbol?, ?exception: Exception?) -> void
|
|
51
|
-
def initialize: (content: String, success: bool, ?error_message: String?, ?error_type: Symbol?, ?exception: Exception?) -> void
|
|
57
|
+
# : (content: String, success: bool, ?error_message: String?, ?error_type: Symbol?, ?exception: Exception?, ?loaded_tools: Array[singleton(Riffer::Tool)]) -> void
|
|
58
|
+
def initialize: (content: String, success: bool, ?error_message: String?, ?error_type: Symbol?, ?exception: Exception?, ?loaded_tools: Array[singleton(Riffer::Tool)]) -> void
|
|
52
59
|
end
|