riffer-rig 0.2.1 → 0.4.0

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

@@ -0,0 +1,76 @@
+# Generated from lib/riffer/rig/ui/animator.rb with RBS::Inline
+
+# Animated output is gated behind an interactive, colour-enabled TTY, so piped
+# or tested runs stay silent and escape-free.
+class Riffer::Rig::UI::Animator
+  REVEAL_FRAME_SECONDS: Float
+
+  SPINNER_FRAME_SECONDS: Float
+
+  EQ_LEVELS: Array[String]
+
+  EQ_BARS: Integer
+
+  NEUTRAL_LABEL: String
+
+  REASONING_PHRASES: Array[String]
+
+  REASONING_TICK_RANGE: Range[Integer]
+
+  @stop: bool
+
+  @phrase: String?
+
+  @mode: Symbol
+
+  @thread: Thread?
+
+  @theme: Riffer::Rig::UI::Theme
+
+  @io: untyped
+
+  # @rbs io: untyped
+  # @rbs ?theme: Riffer::Rig::UI::Theme
+  # @rbs return: void
+  def initialize: (?io: untyped, ?theme: untyped) -> void
+
+  # When not on a TTY, prints the final frame once instead of animating.
+  #
+  # @rbs frames: Array[Array[String]]
+  # @rbs return: void
+  def reveal: (Array[Array[String]] frames) -> void
+
+  # @rbs ?mode: Symbol
+  # @rbs return: void
+  def start: (?untyped mode) -> void
+
+  # @rbs return: void
+  def stop: () -> void
+
+  # @rbs tick: Integer
+  # @rbs ?label: String
+  # @rbs return: String
+  def equalizer: (Integer tick, ?untyped label) -> String
+
+  private
+
+  # @rbs return: void
+  def animate: () -> void
+
+  # Re-rolls both phrase and duration whenever the reasoning tick expires.
+  #
+  # @rbs roll_at: Float
+  # @rbs return: Float
+  def roll_phrase: (Float roll_at) -> Float
+
+  # Range rand returns nil for an empty range; this one is a non-empty constant.
+  #
+  # @rbs return: Integer
+  def roll_rand: () -> Integer
+
+  # @rbs return: String
+  def label: () -> String
+
+  # @rbs return: bool
+  def enabled?: () -> bool
+end

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

@@ -0,0 +1,42 @@
+# Generated from lib/riffer/rig/ui/banner.rb with RBS::Inline
+
+module Riffer::Rig::UI::Banner
+  WORDMARK: Array[String]
+
+  ROW_COLOURS: Array[Array[Integer]]
+
+  INFO_LABEL_WIDTH: Integer
+
+  INDENT: String
+
+  # @rbs theme: Riffer::Rig::UI::Theme
+  # @rbs model: String
+  # @rbs cwd: String
+  # @rbs context: String
+  # @rbs skills: String
+  # @rbs version: String
+  # @rbs return: String
+  def call: (Riffer::Rig::UI::Theme theme, model: String, cwd: String, context: String, skills: String, version: String) -> String
+
+  # @rbs theme: Riffer::Rig::UI::Theme
+  # @rbs model: String
+  # @rbs cwd: String
+  # @rbs context: String
+  # @rbs skills: String
+  # @rbs version: String
+  # @rbs return: Array[String]
+  def lines: (Riffer::Rig::UI::Theme theme, model: String, cwd: String, context: String, skills: String, version: String) -> Array[String]
+
+  # @rbs theme: Riffer::Rig::UI::Theme
+  # @rbs return: Array[String]
+  def art: (Riffer::Rig::UI::Theme theme) -> Array[String]
+
+  # @rbs theme: Riffer::Rig::UI::Theme
+  # @rbs model: String
+  # @rbs cwd: String
+  # @rbs context: String
+  # @rbs skills: String
+  # @rbs version: String
+  # @rbs return: Array[String]
+  def info: (Riffer::Rig::UI::Theme theme, model: String, cwd: String, context: String, skills: String, version: String) -> Array[String]
+end

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

@@ -0,0 +1,33 @@
+# Generated from lib/riffer/rig/ui/cursor.rb with RBS::Inline
+
+# Hides the terminal cursor while a turn is in flight: a hidden cursor can't
+# flicker against the animator's erase-and-redraw churn.
+class Riffer::Rig::UI::Cursor
+  HIDE: String
+
+  SHOW: String
+
+  @io: untyped
+
+  @theme: Riffer::Rig::UI::Theme
+
+  # @rbs io: untyped
+  # @rbs ?theme: Riffer::Rig::UI::Theme
+  # @rbs return: void
+  def initialize: (?io: untyped, ?theme: untyped) -> void
+
+  # @rbs return: void
+  def hide: () -> void
+
+  # @rbs return: void
+  def show: () -> void
+
+  private
+
+  # @rbs sequence: String
+  # @rbs return: void
+  def write: (String sequence) -> void
+
+  # @rbs return: bool
+  def enabled?: () -> bool
+end

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

@@ -0,0 +1,17 @@
+# Generated from lib/riffer/rig/ui/palette.rb with RBS::Inline
+
+module Riffer::Rig::UI::Palette
+  PINK: Array[Integer]
+
+  MAGENTA: Array[Integer]
+
+  PURPLE: Array[Integer]
+
+  BLUE: Array[Integer]
+
+  CYAN: Array[Integer]
+
+  GREY: Array[Integer]
+
+  RED: Array[Integer]
+end

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

@@ -0,0 +1,116 @@
+# Generated from lib/riffer/rig/ui/renderer.rb with RBS::Inline
+
+class Riffer::Rig::UI::Renderer
+  RESULT_PREVIEW_LIMIT: Integer
+
+  @prose_gap_pending: bool
+
+  @deferred_usage: Riffer::Providers::TokenUsage?
+
+  @smoother: Riffer::Rig::UI::Smoother | PassThroughSmoother?
+
+  @tally: Riffer::Rig::TokenTally?
+
+  @theme: Riffer::Rig::UI::Theme
+
+  @io: untyped
+
+  # @rbs io: untyped
+  # @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
+
+  # @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 return: void
+  def render_block: (Integer indent) ?{ (?) -> untyped } -> 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 return: void
+  def render_tool_activity: (Integer indent) ?{ (?) -> untyped } -> 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
+
+    # @rbs io: untyped
+    # @rbs return: void
+    def initialize: (untyped io) -> void
+
+    # @rbs content: String
+    # @rbs return: self
+    def <<: (String content) -> self
+
+    # @rbs return: nil
+    def drain: () -> nil
+
+    # @rbs return: nil
+    def finish: () -> nil
+  end
+
+  # @rbs return: void
+  def drain_smoother: () -> void
+
+  # @rbs arguments: String
+  # @rbs return: String
+  def format_arguments: (String arguments) -> String
+
+  # @rbs content: String
+  # @rbs return: String
+  def preview: (String content) -> String
+end

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

@@ -0,0 +1,72 @@
+# Generated from lib/riffer/rig/ui/smoother.rb with RBS::Inline
+
+# Paces streamed text onto a 60fps cadence so API bursts read as continuous
+# typing. On a non-TTY output it is transparent: writes pass through
+# synchronously and no thread ever runs.
+class Riffer::Rig::UI::Smoother
+  TICK_SECONDS: Float
+
+  # A frame removes only a sixtieth of the remaining backlog — an exponential
+  # decay whose tail keeps text flowing for a second or more, so the reveal
+  # never visibly stops between chunks. The carry accrues sub-character
+  # releases so the effective rate can settle at the provider's throughput;
+  # the floor is fractional (10 chars/s) so it can't over-drain a backlog
+  # that's trickling in slower than 60 chars/s.
+  BACKLOG_FRACTION_PER_TICK: Rational
+
+  MIN_CHARS_PER_TICK: Rational
+
+  @newline_pending: bool
+
+  @stop: bool
+
+  @thread: Thread?
+
+  @mutex: Mutex
+
+  @carry: Rational
+
+  @backlog: String
+
+  @clock: singleton(Kernel)
+
+  @theme: Riffer::Rig::UI::Theme
+
+  @io: untyped
+
+  # @rbs io: untyped
+  # @rbs ?theme: Riffer::Rig::UI::Theme
+  # @rbs clock: singleton(Kernel)
+  # @rbs return: void
+  def initialize: (?io: untyped, ?theme: untyped, ?clock: singleton(Kernel)) -> void
+
+  # @rbs return: void
+  def start: () -> void
+
+  # @rbs content: String
+  # @rbs return: self
+  def <<: (String content) -> self
+
+  # The write sits inside the mutex so a concurrent tick can't reorder a drain.
+  #
+  # @rbs return: void
+  def tick: () -> void
+
+  # 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
+
+  # Idempotent: the REPL's ensure path runs it even after a happy-path finish.
+  #
+  # @rbs return: void
+  def finish: () -> void
+
+  private
+
+  # @rbs return: bool
+  def enabled?: () -> bool
+end

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

@@ -0,0 +1,60 @@
+# Generated from lib/riffer/rig/ui/theme.rb with RBS::Inline
+
+# +enabled+ gates every escape so the same code path emits plain, escape-free
+# text when piped or tested.
+class Riffer::Rig::UI::Theme
+  @enabled: bool
+
+  # @rbs return: bool
+  # @dynamic enabled
+  attr_reader enabled: bool
+
+  # @rbs enabled: bool
+  # @rbs return: void
+  def initialize: (enabled: bool) -> void
+
+  # @rbs io: untyped
+  # @rbs return: Riffer::Rig::UI::Theme
+  def self.for: (untyped io) -> Riffer::Rig::UI::Theme
+
+  # @rbs text: String
+  # @rbs rgb: Array[Integer]
+  # @rbs return: String
+  def paint: (String text, Array[Integer] rgb) -> String
+
+  # @rbs text: String
+  # @rbs return: String
+  def pink: (String text) -> String
+
+  # @rbs text: String
+  # @rbs return: String
+  def magenta: (String text) -> String
+
+  # @rbs text: String
+  # @rbs return: String
+  def purple: (String text) -> String
+
+  # @rbs text: String
+  # @rbs return: String
+  def blue: (String text) -> String
+
+  # @rbs text: String
+  # @rbs return: String
+  def cyan: (String text) -> String
+
+  # @rbs text: String
+  # @rbs return: String
+  def grey: (String text) -> String
+
+  # @rbs text: String
+  # @rbs return: String
+  def red: (String text) -> String
+
+  # @rbs text: String
+  # @rbs return: String
+  def dim: (String text) -> String
+
+  # @rbs text: String
+  # @rbs return: String
+  def bold: (String text) -> String
+end

data/sig/generated/riffer/rig/version.rbs

@@ -0,0 +1,7 @@
+# Generated from lib/riffer/rig/version.rb with RBS::Inline
+
+module Riffer
+  module Rig
+    VERSION: ::String
+  end
+end

data/sig/generated/riffer/rig.rbs

@@ -0,0 +1,2 @@
+# Generated from lib/riffer/rig.rb with RBS::Inline
+

data/sig/manual/riffer/rig/cli.rbs

@@ -0,0 +1,8 @@
+# rbs-inline does not emit `extend self` for modules that use it, so their
+# instance methods aren't visible as singleton methods (e.g.
+# `Riffer::Rig::CLI.list_providers`). Reopening the module here to `extend`
+# itself restores that, matching the runtime behaviour.
+
+module Riffer::Rig::CLI
+  extend ::Riffer::Rig::CLI
+end

data/sig/manual/riffer/rig/credentials.rbs

@@ -0,0 +1,8 @@
+# rbs-inline does not emit `extend self` for modules that use it, so their
+# instance methods aren't visible as singleton methods (e.g.
+# `Riffer::Rig::Credentials.anthropic_api_key`). Reopening the module here to
+# `extend` itself restores that, matching the runtime behaviour.
+
+module Riffer::Rig::Credentials
+  extend ::Riffer::Rig::Credentials
+end

data/sig/manual/riffer/rig/settings.rbs

@@ -0,0 +1,8 @@
+# rbs-inline does not emit `extend self` for modules that use it, so their
+# instance methods aren't visible as singleton methods (e.g.
+# `Riffer::Rig::Settings.load`). Reopening the module here to `extend` itself
+# restores that, matching the runtime behaviour.
+
+module Riffer::Rig::Settings
+  extend ::Riffer::Rig::Settings
+end

data/sig/manual/riffer/rig/tools.rbs

@@ -0,0 +1,5 @@
+# Zeitwerk autovivifies this namespace module in Ruby; RBS needs it declared
+# explicitly so the compact `Riffer::Rig::Tools::*` signatures resolve.
+
+module Riffer::Rig::Tools
+end

data/sig/manual/riffer/rig/ui/banner.rbs

@@ -0,0 +1,8 @@
+# rbs-inline does not emit `extend self` for modules that use it, so their
+# instance methods aren't visible as singleton methods (e.g.
+# `Riffer::Rig::UI::Banner.render`). Reopening the module here to `extend`
+# itself restores that, matching the runtime behaviour.
+
+module Riffer::Rig::UI::Banner
+  extend ::Riffer::Rig::UI::Banner
+end

data/sig/manual/riffer/rig/ui.rbs

@@ -0,0 +1,5 @@
+# Zeitwerk autovivifies this namespace module in Ruby; RBS needs it declared
+# explicitly so the compact `Riffer::Rig::UI::*` signatures resolve.
+
+module Riffer::Rig::UI
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: riffer-rig
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Jake Bottrall
@@ -79,8 +79,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:
@@ -97,6 +97,7 @@ files:
 - lib/riffer/rig/credentials.rb
 - lib/riffer/rig/repl.rb
 - lib/riffer/rig/settings.rb
+- lib/riffer/rig/settings/pricing.rb
 - lib/riffer/rig/token_tally.rb
 - lib/riffer/rig/tools/bash.rb
 - lib/riffer/rig/tools/edit.rb
@@ -110,6 +111,32 @@ files:
 - lib/riffer/rig/ui/smoother.rb
 - lib/riffer/rig/ui/theme.rb
 - lib/riffer/rig/version.rb
+- sig/generated/riffer/rig.rbs
+- sig/generated/riffer/rig/cli.rbs
+- sig/generated/riffer/rig/coding_agent.rbs
+- sig/generated/riffer/rig/credentials.rbs
+- sig/generated/riffer/rig/repl.rbs
+- sig/generated/riffer/rig/settings.rbs
+- sig/generated/riffer/rig/settings/pricing.rbs
+- sig/generated/riffer/rig/token_tally.rbs
+- sig/generated/riffer/rig/tools/bash.rbs
+- sig/generated/riffer/rig/tools/edit.rbs
+- sig/generated/riffer/rig/tools/read.rbs
+- sig/generated/riffer/rig/tools/write.rbs
+- sig/generated/riffer/rig/ui/animator.rbs
+- sig/generated/riffer/rig/ui/banner.rbs
+- sig/generated/riffer/rig/ui/cursor.rbs
+- sig/generated/riffer/rig/ui/palette.rbs
+- sig/generated/riffer/rig/ui/renderer.rbs
+- sig/generated/riffer/rig/ui/smoother.rbs
+- sig/generated/riffer/rig/ui/theme.rbs
+- sig/generated/riffer/rig/version.rbs
+- sig/manual/riffer/rig/cli.rbs
+- sig/manual/riffer/rig/credentials.rbs
+- sig/manual/riffer/rig/settings.rbs
+- sig/manual/riffer/rig/tools.rbs
+- sig/manual/riffer/rig/ui.rbs
+- sig/manual/riffer/rig/ui/banner.rbs
 homepage: https://github.com/bottrall/riffer-rig
 licenses:
 - MIT
@@ -131,7 +158,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: A dead-simple terminal coding agent built on riffer.
 test_files: []