riffer 0.29.0 → 0.30.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer
 version: !ruby/object:Gem::Version
-  version: 0.29.0
+  version: 0.30.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -277,6 +277,7 @@ files:
 - docs/12_GUARDRAILS.md
 - docs/13_SKILLS.md
 - docs/14_MCP.md
+- docs/15_SERIALIZATION.md
 - docs/providers/01_PROVIDERS.md
 - docs/providers/02_AMAZON_BEDROCK.md
 - docs/providers/03_ANTHROPIC.md
@@ -292,6 +293,7 @@ files:
 - lib/riffer/agent/context.rb
 - lib/riffer/agent/response.rb
 - lib/riffer/agent/run.rb
+- lib/riffer/agent/serializer.rb
 - lib/riffer/agent/session.rb
 - lib/riffer/agent/session/repair.rb
 - lib/riffer/agent/structured_output.rb
@@ -381,12 +383,24 @@ files:
 - lib/riffer/tools/runtime/threaded.rb
 - lib/riffer/tools/toolable.rb
 - lib/riffer/version.rb
+- sig/_private/anthropic.rbs
+- sig/_private/async.rbs
+- sig/_private/aws-sdk-core/seahorse_request_context.rbs
+- sig/_private/aws-sdk-core/static_token_provider.rbs
+- sig/_private/mcp.rbs
+- sig/_private/openai.rbs
+- sig/_private/riffer/providers/amazon_bedrock.rbs
+- sig/_private/riffer/providers/anthropic.rbs
+- sig/_private/riffer/providers/open_ai.rbs
+- sig/_private/riffer/providers/open_router.rbs
+- sig/_private/zeitwerk.rbs
 - sig/generated/riffer.rbs
 - sig/generated/riffer/agent.rbs
 - sig/generated/riffer/agent/config.rbs
 - sig/generated/riffer/agent/context.rbs
 - sig/generated/riffer/agent/response.rbs
 - sig/generated/riffer/agent/run.rbs
+- sig/generated/riffer/agent/serializer.rbs
 - sig/generated/riffer/agent/session.rbs
 - sig/generated/riffer/agent/session/repair.rbs
 - sig/generated/riffer/agent/structured_output.rbs
@@ -476,16 +490,11 @@ files:
 - sig/generated/riffer/tools/runtime/threaded.rbs
 - sig/generated/riffer/tools/toolable.rbs
 - sig/generated/riffer/version.rbs
-- sig/stubs/agent_ivars.rbs
-- sig/stubs/async.rbs
-- sig/stubs/aws-sdk-core/seahorse_request_context.rbs
-- sig/stubs/aws-sdk-core/static_token_provider.rbs
-- sig/stubs/extend_self.rbs
-- sig/stubs/lib_ivars.rbs
-- sig/stubs/mcp_sdk.rbs
-- sig/stubs/provider_ivars.rbs
-- sig/stubs/provider_sdk_methods.rbs
-- sig/stubs/zeitwerk.rbs
+- sig/manifest.yaml
+- sig/manual/riffer/agent/run.rbs
+- sig/manual/riffer/agent/serializer.rbs
+- sig/manual/riffer/helpers/call_or_value.rbs
+- sig/manual/riffer/tools/toolable.rbs
 homepage: https://riffer.ai
 licenses:
 - MIT

data/sig/stubs/agent_ivars.rbs

@@ -1,7 +0,0 @@
-# Class-level instance variable declarations for Riffer::Agent.
-#
-# The `#:` inline syntax used in lib/ can't declare class-level ivars, so we
-# stub them here instead.
-class Riffer::Agent
-  self.@config: Riffer::Agent::Config?
-end

data/sig/stubs/extend_self.rbs

@@ -1,11 +0,0 @@
-# rbs-inline does not emit `extend self` for modules that use it, so their
-# instance methods aren't visible as singleton methods. Reopening each module
-# here to `extend` itself restores that, matching the runtime behaviour.
-
-module Riffer::Helpers::CallOrValue
-  extend ::Riffer::Helpers::CallOrValue
-end
-
-module Riffer::Agent::Run
-  extend ::Riffer::Agent::Run
-end

data/sig/stubs/lib_ivars.rbs

@@ -1,101 +0,0 @@
-# Instance/module variable declarations for non-provider lib/ classes.
-#
-# rbs-inline's `#:` syntax types an assignment expression (a Steep assertion)
-# but doesn't declare the instance variable itself, so we stub the ivar types
-# here instead (mirrors sig/stubs/agent_ivars.rbs and provider_ivars.rbs).
-
-class Riffer::Mcp::Registration
-  @cancelled: bool
-  @tools: Array[singleton(Riffer::Tool)]
-  @mutex: Thread::Mutex
-end
-
-module Riffer::Mcp::Registry
-  self.@mutex: Thread::Mutex
-  self.@store: Hash[String, Riffer::Mcp::Registration]
-end
-
-class Riffer::Mcp::Client
-  @client: untyped
-end
-
-# Toolable is extended onto tool classes; its instance methods run as class
-# methods on the extender, which is also extended with ClassNameConverter
-# (see Toolable.extended). The include models that method availability for Steep.
-module Riffer::Tools::Toolable
-  include Riffer::Helpers::ClassNameConverter
-
-  self.@extenders: Array[Module]?
-  @description: String?
-  @identifier: String?
-  @timeout: (Integer | Float)?
-  @params_builder: Riffer::Params?
-  @kind: Symbol?
-end
-
-class Riffer::Evals::Judge
-  @provider_options: Hash[Symbol, untyped]
-  @provider_instance: Riffer::Providers::Base?
-  @provider_name: String?
-  @model_name: String?
-end
-
-class Riffer::Evals::Evaluator
-  self.@instructions: String?
-  self.@higher_is_better: bool?
-  self.@judge_model: String?
-  @judge: Riffer::Evals::Judge?
-end
-
-class Riffer::Skills::Context
-  @backend: Riffer::Skills::Backend
-  @activated: Hash[String, String]
-end
-
-class Riffer::Skills::Config
-  @backend: (Riffer::Skills::Backend | Proc)?
-  @adapter: singleton(Riffer::Skills::Adapter)?
-  @activate: (Array[String] | Proc)?
-  @activate_tool: singleton(Riffer::Tool)?
-end
-
-class Riffer::Skills::FilesystemBackend
-  @paths: Array[String]
-  @skills_cache: Hash[String, String]?
-end
-
-module Riffer
-  self.@config: Riffer::Config?
-end
-
-class Riffer::Agent::Session
-  @callbacks: Array[^(Riffer::Messages::Base) -> void]
-end
-
-class Riffer::Agent::Context
-  @data: Hash[Symbol, untyped]
-end
-
-class Riffer::Agent::Response
-  @interrupted: bool
-end
-
-class Riffer::Tools::Response
-  @success: bool
-end
-
-class Riffer::Tools::Runtime
-  @runner: Riffer::Runner
-end
-
-class Riffer::Runner::Threaded
-  @max_concurrency: Integer
-end
-
-class Riffer::Runner::Fibers
-  @max_concurrency: Integer?
-end
-
-class Riffer::Messages::FilePart
-  @url_string: String?
-end

data/sig/stubs/provider_ivars.rbs

@@ -1,36 +0,0 @@
-# Instance variable declarations for the provider adapters.
-#
-# rbs-inline's `#:` syntax types an assignment expression (a Steep assertion)
-# but doesn't declare the instance variable itself, so we stub the ivar types
-# here instead.
-class Riffer::Providers::Base
-  @current_tools: Array[singleton(Riffer::Tool)]
-end
-
-class Riffer::Providers::Anthropic
-  @client: ::Anthropic::Client
-end
-
-class Riffer::Providers::OpenAI
-  @client: ::OpenAI::Client
-end
-
-class Riffer::Providers::OpenRouter
-  @client: ::OpenAI::Client
-end
-
-class Riffer::Providers::AmazonBedrock
-  @client: ::Aws::BedrockRuntime::Client
-end
-
-class Riffer::Providers::Gemini
-  @api_key: String?
-  @open_timeout: Integer
-  @read_timeout: Integer
-end
-
-class Riffer::Providers::Mock
-  @responses: Array[Hash[Symbol, untyped]]
-  @current_index: Integer
-  @stubbed_responses: Array[Hash[Symbol, untyped]]
-end

data/sig/stubs/provider_sdk_methods.rbs

@@ -1,50 +0,0 @@
-# Accurate signatures for SDK resource methods whose shipped RBS doesn't match
-# the real API.
-#
-# The OpenAI and Anthropic gems implement these as positional `def x(params)`
-# methods (a single options hash), but their generated RBS advertises
-# keyword-only signatures — and the Anthropic gem omits `Messages#stream`
-# altogether. The providers call them with a positional hash (`x(params)`) or a
-# keyword splat (`x(**params)`); both reach the same positional parameter at
-# runtime, so we accept either here (`| ...` extends the gem's existing
-# overloads). Streaming methods are typed to return `untyped`: the event
-# objects are a ~60-member union dispatched dynamically on `#type`, which the
-# providers (and their `untyped` event handlers) already treat as dynamic.
-module OpenAI
-  module Resources
-    class Responses
-      def create: (Hash[Symbol, untyped] params) -> OpenAI::Models::Responses::Response
-                | (**untyped) -> OpenAI::Models::Responses::Response
-                | ...
-      def stream: (Hash[Symbol, untyped] params) -> untyped
-                | (**untyped) -> untyped
-                | ...
-    end
-
-    class Chat
-      class Completions
-        def create: (Hash[Symbol, untyped] params) -> OpenAI::Models::Chat::ChatCompletion
-                  | (**untyped) -> OpenAI::Models::Chat::ChatCompletion
-                  | ...
-        def stream_raw: (Hash[Symbol, untyped] params) -> untyped
-                      | (**untyped) -> untyped
-                      | ...
-      end
-    end
-  end
-end
-
-module Anthropic
-  module Resources
-    class Messages
-      def create: (Hash[Symbol, untyped] params) -> Anthropic::Models::Message
-                | (**untyped) -> Anthropic::Models::Message
-                | ...
-
-      # Omitted from the gem's RBS; present at runtime (returns a MessageStream
-      # helper iterated with `#each` / `#accumulated_message` / `#close`).
-      def stream: (Hash[Symbol, untyped] params) -> untyped
-                | (**untyped) -> untyped
-    end
-  end
-end