riffer-rig 0.3.0 → 0.5.0

data/sig/generated/riffer/rig/ui/renderer.rbs

@@ -3,42 +3,96 @@
 class Riffer::Rig::UI::Renderer
   RESULT_PREVIEW_LIMIT: Integer
 
-  @io: untyped
+  @prose_gap_pending: bool
 
-  @theme: Riffer::Rig::UI::Theme
+  @deferred_usage: Riffer::Providers::TokenUsage?
+
+  @smoother: Riffer::Rig::UI::Smoother | PassThroughSmoother?
 
   @tally: Riffer::Rig::TokenTally?
 
-  @smoother: Riffer::Rig::UI::Smoother | PassThroughSmoother?
+  @theme: Riffer::Rig::UI::Theme
+
+  @io: IO
 
-  # @rbs io: untyped
-  # @rbs ?theme: Riffer::Rig::UI::Theme
-  # @rbs ?tally: Riffer::Rig::TokenTally?
-  # @rbs ?smoother: Riffer::Rig::UI::Smoother | PassThroughSmoother?
+  # @rbs io: IO
+  # @rbs theme: Riffer::Rig::UI::Theme
+  # @rbs tally: Riffer::Rig::TokenTally?
+  # @rbs smoother: Riffer::Rig::UI::Smoother | PassThroughSmoother?
   # @rbs return: void
-  def initialize: (?io: untyped, ?theme: untyped, ?tally: untyped, ?smoother: untyped) -> void
+  def initialize: (?io: IO, ?theme: Riffer::Rig::UI::Theme, ?tally: Riffer::Rig::TokenTally?, ?smoother: Riffer::Rig::UI::Smoother | PassThroughSmoother?) -> void
 
   # @rbs event: Riffer::StreamEvents::Base
   # @rbs return: void
   def render: (Riffer::StreamEvents::Base event) -> void
 
+  # The prompt holds the line open for typed input, so unlike render_block it
+  # ends without a newline. It sits at the renderer so a tool group left open by
+  # the previous turn closes here, and the next turn's blocks open cleanly.
+  #
+  # @rbs return: void
+  def prompt: () -> void
+
+  # Usage arrives per model call but tool results arrive via the session
+  # callback after each call's stream ends, so rendering inline would print the
+  # stats above the results they belong with. Held until the turn's output is
+  # done, then printed as one line below it.
+  #
+  # @rbs return: void
+  def flush_usage: () -> void
+
   # @rbs message: Riffer::Messages::Base
   # @rbs return: void
   def render_tool_result: (Riffer::Messages::Base message) -> void
 
   private
 
+  # Rule 2 for one-off blocks (skill line, interrupt, stats): one blank line
+  # above, no indent. The smoother drains first so any pending partial prose
+  # block ends cleanly before the gap is written, and any open tool group closes
+  # so the next group opens with its own gap.
+  #
+  # @rbs indent: Integer
+  # @rbs &block: () -> String
+  # @rbs return: void
+  def render_block: (Integer indent) { () -> String } -> void
+
+  # The blank line above a prose block is written at the first delta after a
+  # non-prose block. Streaming makes "which block is first?" a stateful
+  # question, so the answer is tracked rather than embedded at each render site.
+  #
+  # @rbs content: String
+  # @rbs return: void
+  def render_prose: (String content) -> void
+
+  # @rbs indent: Integer
+  # @rbs &block: () -> String
+  # @rbs return: void
+  def render_tool_activity: (Integer indent) { () -> String } -> void
+
+  # Tool-activity lines (⚙ calls, ↳ results) share one blank line above the
+  # group instead of one between each line — the gap goes between groups, not
+  # inside a pair. The group stays open so prose after it pays the closing gap.
+  #
+  # @rbs return: void
+  def open_tool_activity: () -> void
+
+  # @rbs usage: Riffer::Providers::TokenUsage
+  # @rbs tally: Riffer::Rig::TokenTally
+  # @rbs return: String
+  def usage_line: (Riffer::Providers::TokenUsage usage, Riffer::Rig::TokenTally tally) -> String
+
   # @rbs return: Riffer::Rig::UI::Smoother | PassThroughSmoother
   def smoother: () -> (Riffer::Rig::UI::Smoother | PassThroughSmoother)
 
   # Stand-in when no smoother is injected, so a bare Riffer::Rig::UI::Renderer still prints
   # synchronously.
   class PassThroughSmoother
-    @io: untyped
+    @io: IO
 
-    # @rbs io: untyped
+    # @rbs io: IO
     # @rbs return: void
-    def initialize: (untyped io) -> void
+    def initialize: (IO io) -> void
 
     # @rbs content: String
     # @rbs return: self
@@ -54,10 +108,6 @@ class Riffer::Rig::UI::Renderer
   # @rbs return: void
   def drain_smoother: () -> void
 
-  # @rbs usage: Riffer::Providers::TokenUsage
-  # @rbs return: void
-  def render_token_usage: (Riffer::Providers::TokenUsage usage) -> void
-
   # @rbs arguments: String
   # @rbs return: String
   def format_arguments: (String arguments) -> String

data/sig/generated/riffer/rig/ui/smoother.rbs

@@ -16,6 +16,8 @@ class Riffer::Rig::UI::Smoother
 
   MIN_CHARS_PER_TICK: Rational
 
+  @newline_pending: bool
+
   @stop: bool
 
   @thread: Thread?
@@ -30,13 +32,13 @@ class Riffer::Rig::UI::Smoother
 
   @theme: Riffer::Rig::UI::Theme
 
-  @io: untyped
+  @io: IO
 
-  # @rbs io: untyped
-  # @rbs ?theme: Riffer::Rig::UI::Theme
+  # @rbs io: IO
+  # @rbs theme: Riffer::Rig::UI::Theme
   # @rbs clock: singleton(Kernel)
   # @rbs return: void
-  def initialize: (?io: untyped, ?theme: untyped, ?clock: singleton(Kernel)) -> void
+  def initialize: (?io: IO, ?theme: Riffer::Rig::UI::Theme, ?clock: singleton(Kernel)) -> void
 
   # @rbs return: void
   def start: () -> void
@@ -50,7 +52,10 @@ class Riffer::Rig::UI::Smoother
   # @rbs return: void
   def tick: () -> void
 
-  # Called before non-delta output so printed order matches stream order.
+  # Called before non-prose output so printed order matches stream order. The
+  # backlog is flushed, then any partial prose block the model left without a
+  # trailing newline gets one, so block spacing never depends on the model's
+  # last character.
   #
   # @rbs return: void
   def drain: () -> void

data/sig/generated/riffer/rig/ui/theme.rbs

@@ -13,9 +13,9 @@ class Riffer::Rig::UI::Theme
   # @rbs return: void
   def initialize: (enabled: bool) -> void
 
-  # @rbs io: untyped
+  # @rbs io: IO
   # @rbs return: Riffer::Rig::UI::Theme
-  def self.for: (untyped io) -> Riffer::Rig::UI::Theme
+  def self.for: (IO io) -> Riffer::Rig::UI::Theme
 
   # @rbs text: String
   # @rbs rgb: Array[Integer]

data/sig/generated/riffer/rig.rbs

@@ -1,2 +1,21 @@
 # Generated from lib/riffer/rig.rb with RBS::Inline
 
+module Riffer::Rig
+  self.@extensions: Hash[String, Riffer::Rig::Extension]
+
+  # Records an extension block in the process registry and returns the
+  # extension object. Re-recording a name replaces the block.
+  #
+  #   Riffer::Rig.extension('git') do |rig|
+  #     rig.tool GitLog
+  #   end
+  #
+  # @rbs name: String
+  # @rbs requires: String?
+  # @rbs &block: (::Riffer::Rig::Registrar) -> void
+  # @rbs return: Riffer::Rig::Extension
+  def self.extension: (String name, ?requires: String?) { (::Riffer::Rig::Registrar) -> void } -> Riffer::Rig::Extension
+
+  # @rbs return: Hash[String, Riffer::Rig::Extension]
+  def self.extensions: () -> Hash[String, Riffer::Rig::Extension]
+end

data/sig/manual/riffer/rig.rbs

@@ -0,0 +1,11 @@
+# rbs-inline emits the `def self.extension` / `def self.extensions`
+# declarations in `sig/generated/riffer/rig.rbs`, but Steep binds them to the
+# file that first declares the module in RBS (`lib/riffer/rig/version.rb`'s
+# empty reopen), so it reports MethodDefinitionMissing at that reopen. Making
+# the generated declarations visible there without duplicating them needs a
+# `...` alias per method.
+
+module Riffer::Rig
+  def self.extension: ...
+  def self.extensions: ...
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer-rig
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -55,16 +55,22 @@ dependencies:
   name: riffer
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.45'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 0.45.0
+        version: '0.48'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.45'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 0.45.0
+        version: '0.48'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -79,8 +85,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.8'
-description: An interactive terminal coding agent (read/write/edit/bash) built on
-  the riffer agentic framework.
+description: An interactive terminal agent (read/write/edit/bash) built on the riffer
+  agentic framework.
 email:
 - jakebottrall@gmail.com
 executables:
@@ -95,8 +101,13 @@ files:
 - lib/riffer/rig/cli.rb
 - lib/riffer/rig/coding_agent.rb
 - lib/riffer/rig/credentials.rb
+- lib/riffer/rig/extension.rb
+- lib/riffer/rig/host.rb
+- lib/riffer/rig/registrar.rb
 - lib/riffer/rig/repl.rb
+- lib/riffer/rig/runtime.rb
 - lib/riffer/rig/settings.rb
+- lib/riffer/rig/settings/document.rb
 - lib/riffer/rig/settings/pricing.rb
 - lib/riffer/rig/token_tally.rb
 - lib/riffer/rig/tools/bash.rb
@@ -115,8 +126,13 @@ files:
 - sig/generated/riffer/rig/cli.rbs
 - sig/generated/riffer/rig/coding_agent.rbs
 - sig/generated/riffer/rig/credentials.rbs
+- sig/generated/riffer/rig/extension.rbs
+- sig/generated/riffer/rig/host.rbs
+- sig/generated/riffer/rig/registrar.rbs
 - sig/generated/riffer/rig/repl.rbs
+- sig/generated/riffer/rig/runtime.rbs
 - sig/generated/riffer/rig/settings.rbs
+- sig/generated/riffer/rig/settings/document.rbs
 - sig/generated/riffer/rig/settings/pricing.rbs
 - sig/generated/riffer/rig/token_tally.rbs
 - sig/generated/riffer/rig/tools/bash.rbs
@@ -131,6 +147,7 @@ files:
 - sig/generated/riffer/rig/ui/smoother.rbs
 - sig/generated/riffer/rig/ui/theme.rbs
 - sig/generated/riffer/rig/version.rbs
+- sig/manual/riffer/rig.rbs
 - sig/manual/riffer/rig/cli.rbs
 - sig/manual/riffer/rig/credentials.rbs
 - sig/manual/riffer/rig/settings.rbs