riffer-rig 0.5.0 → 0.6.0

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

@@ -1,56 +1,85 @@
 # Generated from lib/riffer/rig/credentials.rb with RBS::Inline
 
-# Reads and writes API keys for each supported provider in
-# <tt>~/.riffer/auth.json</tt>.
-#
-# Keys are stored under the provider name, e.g.:
-#
-#   {
-#     "anthropic": "sk-ant-...",
-#     "openai": "sk-...",
-#     "gemini": "...",
-#     "openrouter": "sk-or-..."
-#   }
-#
-# The environment variable checked per provider:
-#
-#   anthropic  → ANTHROPIC_API_KEY
-#   openai     → OPENAI_API_KEY
-#   gemini     → GEMINI_API_KEY
-#   openrouter → OPENROUTER_API_KEY
 module Riffer::Rig::Credentials
   PATH: String
 
-  PROVIDER_ENV_VARS: Hash[String, String]
+  ENTRY_TYPE: ::String
 
-  # Returns the API key for +provider+, checking the environment variable first,
-  # then the stored file. Returns +nil+ if no key is available.
-  #
-  # @rbs provider: String?
-  # @rbs path: String
-  # @rbs return: String?
-  def api_key_for: (String? provider, ?path: String) -> String?
+  # @rbs identifier: String | Symbol
+  # @rbs host: Riffer::Rig::Hosts::Base
+  # @rbs setup: Riffer::Rig::ProviderSetup
+  # @rbs env: Riffer::Rig::Env
+  # @rbs auth_path: String
+  # @rbs settings_path: String
+  # @rbs return: Resolution
+  def resolve: (String | Symbol identifier, host: Riffer::Rig::Hosts::Base, ?setup: Riffer::Rig::ProviderSetup, ?env: Riffer::Rig::Env, ?auth_path: String, ?settings_path: String) -> Resolution
 
-  # Saves an API key for +provider+ to the auth file with 0600 permissions.
-  #
-  # @rbs provider: String
-  # @rbs key: String
-  # @rbs path: String
-  # @rbs return: String
-  def save_api_key: (String provider, String key, ?path: String) -> String
+  # @rbs identifier: String | Symbol
+  # @rbs values: Hash[Symbol, String]
+  # @rbs config: Riffer::Config
+  # @rbs return: void
+  def apply: (String | Symbol identifier, Hash[Symbol, String] values, ?config: Riffer::Config) -> void
+
+  # @rbs identifier: String | Symbol
+  # @rbs values: Hash[Symbol, String]
+  # @rbs setup: Riffer::Rig::ProviderSetup
+  # @rbs auth_path: String
+  # @rbs settings_path: String
+  # @rbs return: void
+  def store: (String | Symbol identifier, Hash[Symbol, String] values, ?setup: Riffer::Rig::ProviderSetup, ?auth_path: String, ?settings_path: String) -> void
+
+  # @rbs identifier: String | Symbol
+  # @rbs auth_path: String
+  # @rbs settings_path: String
+  # @rbs return: void
+  def remove: (String | Symbol identifier, ?auth_path: String, ?settings_path: String) -> void
+
+  # @rbs identifier: String | Symbol
+  # @rbs setup: Riffer::Rig::ProviderSetup
+  # @rbs env: Riffer::Rig::Env
+  # @rbs auth_path: String
+  # @rbs return: :env | :stored | :chain | :missing
+  def status: (String | Symbol identifier, ?setup: Riffer::Rig::ProviderSetup, ?env: Riffer::Rig::Env, ?auth_path: String) -> (:env | :stored | :chain | :missing)
 
   private
 
-  # @rbs provider: String?
-  # @rbs path: String
+  # @rbs fields: Array[Riffer::Rig::ProviderSetup::Field]
+  # @rbs identifier: String | Symbol
+  # @rbs host: Riffer::Rig::Hosts::Base
+  # @rbs return: Hash[Symbol, String]
+  def ask_for: (Array[Riffer::Rig::ProviderSetup::Field] fields, String | Symbol identifier, Riffer::Rig::Hosts::Base host) -> Hash[Symbol, String]
+
+  # @rbs field: Riffer::Rig::ProviderSetup::Field
+  # @rbs secrets: Hash[String, String]
+  # @rbs plain: Hash[String, String]
+  # @rbs env: Riffer::Rig::Env
+  # @rbs return: String?
+  def stored_value: (Riffer::Rig::ProviderSetup::Field field, Hash[String, String] secrets, Hash[String, String] plain, Riffer::Rig::Env env) -> String?
+
+  # @rbs value: String?
+  # @rbs env: Riffer::Rig::Env
+  # @rbs return: String?
+  def expand: (String? value, Riffer::Rig::Env env) -> String?
+
+  # @rbs command: String
+  # @rbs return: String?
+  def run: (String command) -> String?
+
+  # @rbs value: String?
   # @rbs return: String?
-  def key_from_file: (String? provider, String path) -> String?
+  def presence: (String? value) -> String?
 
-  # The parsed auth file, or an empty hash when the file is absent or
-  # malformed. Non-string values can't be keys, so they're dropped here rather
-  # than re-checked by every reader.
-  #
+  # @rbs identifier: String | Symbol
   # @rbs path: String
   # @rbs return: Hash[String, String]
-  def read: (String path) -> Hash[String, String]
+  def stored_secrets: (String | Symbol identifier, String path) -> Hash[String, String]
+
+  # @rbs path: String
+  # @rbs return: Hash[String, Hash[String, String]]
+  def read_auth: (String path) -> Hash[String, Hash[String, String]]
+
+  # @rbs path: String
+  # @rbs entries: Hash[String, Hash[String, String]]
+  # @rbs return: void
+  def write_auth: (String path, Hash[String, Hash[String, String]] entries) -> void
 end

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

@@ -0,0 +1,20 @@
+# Generated from lib/riffer/rig/env.rb with RBS::Inline
+
+class Riffer::Rig::Env
+  @source: Hash[String, String]
+
+  # @dynamic no_color
+  attr_reader no_color: bool
+
+  # @rbs source: Hash[String, String]
+  # @rbs return: void
+  def initialize: (?Hash[String, String] source) -> void
+
+  # @rbs name: String
+  # @rbs return: String?
+  def []: (String name) -> String?
+
+  # @rbs field: Riffer::Rig::ProviderSetup::Field
+  # @rbs return: String?
+  def value_for: (Riffer::Rig::ProviderSetup::Field field) -> String?
+end

data/sig/generated/riffer/rig/events/command_output.rbs

@@ -0,0 +1,19 @@
+# Generated from lib/riffer/rig/events/command_output.rb with RBS::Inline
+
+class Riffer::Rig::Events::CommandOutput < Riffer::Rig::Events::Event
+  # @dynamic command, text
+  attr_reader command: String
+
+  attr_reader text: String
+
+  # @rbs command: String
+  # @rbs text: String
+  # @rbs return: void
+  def initialize: (String command, String text) -> void
+
+  # @rbs return: Symbol
+  def type: () -> Symbol
+
+  # @rbs return: Hash[Symbol, untyped]
+  def to_h: () -> Hash[Symbol, untyped]
+end

data/sig/generated/riffer/rig/events/event.rbs

@@ -0,0 +1,20 @@
+# Generated from lib/riffer/rig/events/event.rb with RBS::Inline
+
+class Riffer::Rig::Events::Event
+  # @rbs return: Symbol
+  def type: () -> Symbol
+
+  # @rbs return: Hash[Symbol, untyped]
+  def to_h: () -> Hash[Symbol, untyped]
+
+  # @rbs other: untyped
+  # @rbs return: bool
+  def ==: (untyped other) -> bool
+
+  # @rbs return: Integer
+  def hash: () -> Integer
+
+  # @rbs other: untyped
+  # @rbs return: bool
+  def eql?: (untyped other) -> bool
+end

data/sig/generated/riffer/rig/events/notify.rbs

@@ -0,0 +1,19 @@
+# Generated from lib/riffer/rig/events/notify.rb with RBS::Inline
+
+class Riffer::Rig::Events::Notify < Riffer::Rig::Events::Event
+  # @dynamic message, level
+  attr_reader message: String?
+
+  attr_reader level: Symbol
+
+  # @rbs message: String?
+  # @rbs level: Symbol
+  # @rbs return: void
+  def initialize: (String? message, Symbol level) -> void
+
+  # @rbs return: Symbol
+  def type: () -> Symbol
+
+  # @rbs return: Hash[Symbol, untyped]
+  def to_h: () -> Hash[Symbol, untyped]
+end

data/sig/generated/riffer/rig/events/session_end.rbs

@@ -0,0 +1,16 @@
+# Generated from lib/riffer/rig/events/session_end.rb with RBS::Inline
+
+class Riffer::Rig::Events::SessionEnd < Riffer::Rig::Events::Event
+  # @dynamic reason
+  attr_reader reason: Symbol
+
+  # @rbs reason: Symbol
+  # @rbs return: void
+  def initialize: (Symbol reason) -> void
+
+  # @rbs return: Symbol
+  def type: () -> Symbol
+
+  # @rbs return: Hash[Symbol, untyped]
+  def to_h: () -> Hash[Symbol, untyped]
+end

data/sig/generated/riffer/rig/events/session_start.rbs

@@ -0,0 +1,19 @@
+# Generated from lib/riffer/rig/events/session_start.rb with RBS::Inline
+
+class Riffer::Rig::Events::SessionStart < Riffer::Rig::Events::Event
+  # @dynamic id, reason
+  attr_reader id: String
+
+  attr_reader reason: Symbol
+
+  # @rbs id: String
+  # @rbs reason: Symbol
+  # @rbs return: void
+  def initialize: (String id, Symbol reason) -> void
+
+  # @rbs return: Symbol
+  def type: () -> Symbol
+
+  # @rbs return: Hash[Symbol, untyped]
+  def to_h: () -> Hash[Symbol, untyped]
+end

data/sig/generated/riffer/rig/events/skill_activated.rbs

@@ -0,0 +1,16 @@
+# Generated from lib/riffer/rig/events/skill_activated.rb with RBS::Inline
+
+class Riffer::Rig::Events::SkillActivated < Riffer::Rig::Events::Event
+  # @dynamic name
+  attr_reader name: String
+
+  # @rbs name: String
+  # @rbs return: void
+  def initialize: (String name) -> void
+
+  # @rbs return: Symbol
+  def type: () -> Symbol
+
+  # @rbs return: Hash[Symbol, untyped]
+  def to_h: () -> Hash[Symbol, untyped]
+end

data/sig/generated/riffer/rig/events/turn_end.rbs

@@ -0,0 +1,22 @@
+# Generated from lib/riffer/rig/events/turn_end.rb with RBS::Inline
+
+class Riffer::Rig::Events::TurnEnd < Riffer::Rig::Events::Event
+  # @dynamic stop_reason, usage
+  attr_reader stop_reason: Symbol
+
+  attr_reader usage: ::Riffer::Providers::TokenUsage?
+
+  # @rbs stop_reason: Symbol
+  # @rbs usage: ::Riffer::Providers::TokenUsage?
+  # @rbs return: void
+  def initialize: (Symbol stop_reason, ::Riffer::Providers::TokenUsage? usage) -> void
+
+  # @rbs return: Float?
+  def cost: () -> Float?
+
+  # @rbs return: Symbol
+  def type: () -> Symbol
+
+  # @rbs return: Hash[Symbol, untyped]
+  def to_h: () -> Hash[Symbol, untyped]
+end

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

@@ -0,0 +1,4 @@
+# Generated from lib/riffer/rig/events.rb with RBS::Inline
+
+module Riffer::Rig::Events
+end

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

@@ -1,9 +1,5 @@
 # Generated from lib/riffer/rig/extension.rb with RBS::Inline
 
-# An extension recorded by <tt>Riffer::Rig.extension</tt>: a name, an optional
-# Gem::Requirement on riffer-rig, and the block that runs against a Runtime's
-# registrar. The process registry holds these objects; Runtime.new runs their
-# blocks.
 class Riffer::Rig::Extension
   @name: String
 

data/sig/generated/riffer/rig/hosts/base.rbs

@@ -0,0 +1,26 @@
+# Generated from lib/riffer/rig/hosts/base.rb with RBS::Inline
+
+class Riffer::Rig::Hosts::Base
+  # @rbs return: Set[Symbol]
+  def capabilities: () -> Set[Symbol]
+
+  # @rbs question: String?
+  # @rbs options: Array[String]?
+  # @rbs secret: bool
+  # @rbs return: String?
+  def ask: (?String? question, ?options: Array[String]?, ?secret: bool) -> String?
+
+  # @rbs question: String?
+  # @rbs return: bool
+  def confirm: (?String? question) -> bool
+
+  # @rbs message: String?
+  # @rbs level: Symbol
+  # @rbs return: void
+  def notify: (?String? message, ?level: Symbol) -> void
+
+  # @rbs label: String?
+  # @rbs &: ? () -> void
+  # @rbs return: void
+  def progress: (?String? label) ?{ () -> void } -> void
+end

data/sig/generated/riffer/rig/hosts/mirror.rbs

@@ -0,0 +1,41 @@
+# Generated from lib/riffer/rig/hosts/mirror.rb with RBS::Inline
+
+class Riffer::Rig::Hosts::Mirror < Riffer::Rig::Hosts::Base
+  @host: Riffer::Rig::Hosts::Base
+
+  @queue: Array[Riffer::Rig::Events::Event]
+
+  # @dynamic capabilities
+  attr_reader capabilities: Set[Symbol]
+
+  # @rbs host: Riffer::Rig::Hosts::Base
+  # @rbs return: void
+  def initialize: (Riffer::Rig::Hosts::Base host) -> void
+
+  # @rbs question: String?
+  # @rbs options: Array[String]?
+  # @rbs secret: bool
+  # @rbs return: String?
+  def ask: (?String? question, ?options: Array[String]?, ?secret: bool) -> String?
+
+  # @rbs question: String?
+  # @rbs return: bool
+  def confirm: (?String? question) -> bool
+
+  # @rbs message: String?
+  # @rbs level: Symbol
+  # @rbs return: void
+  def notify: (?String? message, ?level: Symbol) -> void
+
+  # @rbs label: String?
+  # @rbs &block: ? () -> void
+  # @rbs return: void
+  def progress: (?String? label) ?{ () -> void } -> void
+
+  # @rbs event: Riffer::Rig::Events::Event
+  # @rbs return: void
+  def queue: (Riffer::Rig::Events::Event event) -> void
+
+  # @rbs return: Array[Riffer::Rig::Events::Event]
+  def drain: () -> Array[Riffer::Rig::Events::Event]
+end

data/sig/generated/riffer/rig/hosts/null.rbs

@@ -0,0 +1,26 @@
+# Generated from lib/riffer/rig/hosts/null.rb with RBS::Inline
+
+class Riffer::Rig::Hosts::Null < Riffer::Rig::Hosts::Base
+  # @rbs return: Set[Symbol]
+  def capabilities: () -> Set[Symbol]
+
+  # @rbs question: String?
+  # @rbs options: Array[String]?
+  # @rbs secret: bool
+  # @rbs return: String?
+  def ask: (?String? question, ?options: Array[String]?, ?secret: bool) -> String?
+
+  # @rbs question: String?
+  # @rbs return: bool
+  def confirm: (?String? question) -> bool
+
+  # @rbs message: String?
+  # @rbs level: Symbol
+  # @rbs return: void
+  def notify: (?String? message, ?level: Symbol) -> void
+
+  # @rbs label: String?
+  # @rbs &block: ? () -> void
+  # @rbs return: void
+  def progress: (?String? label) ?{ () -> void } -> void
+end

data/sig/generated/riffer/rig/provider_setup/field.rbs

@@ -0,0 +1,22 @@
+# Generated from lib/riffer/rig/provider_setup/field.rb with RBS::Inline
+
+class Riffer::Rig::ProviderSetup::Field
+  # @dynamic name, env, secret, required, fallback
+  attr_reader name: Symbol
+
+  attr_reader env: Array[String]
+
+  attr_reader secret: bool
+
+  attr_reader required: bool
+
+  attr_reader fallback: (^() -> String?)?
+
+  # @rbs name: Symbol
+  # @rbs env: Array[String]
+  # @rbs secret: bool
+  # @rbs required: bool
+  # @rbs fallback: (^() -> String?)?
+  # @rbs return: void
+  def initialize: (name: Symbol, env: Array[String], secret: bool, required: bool, ?fallback: (^() -> String?)?) -> void
+end

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

@@ -0,0 +1,30 @@
+# Generated from lib/riffer/rig/provider_setup.rb with RBS::Inline
+
+class Riffer::Rig::ProviderSetup
+  # @dynamic url, chain, fields
+  attr_reader url: String?
+
+  attr_reader chain: bool
+
+  attr_reader fields: Array[Riffer::Rig::ProviderSetup::Field]
+
+  # @rbs fields: Array[Riffer::Rig::ProviderSetup::Field]
+  # @rbs url: String?
+  # @rbs chain: bool
+  # @rbs return: void
+  def initialize: (fields: Array[Riffer::Rig::ProviderSetup::Field], ?url: String?, ?chain: bool) -> void
+
+  AWS_SHARED_CONFIG_REGION: ^() -> String?
+
+  # Upstream candidate: each riffer provider could declare its own credential
+  # fields, and this table would go.
+  TABLE: Hash[Symbol, Riffer::Rig::ProviderSetup]
+
+  # @rbs identifier: String | Symbol
+  # @rbs return: Riffer::Rig::ProviderSetup?
+  def self.[]: (String | Symbol identifier) -> Riffer::Rig::ProviderSetup?
+
+  # @rbs identifier: String | Symbol
+  # @rbs return: Riffer::Rig::ProviderSetup
+  def self.for: (String | Symbol identifier) -> Riffer::Rig::ProviderSetup
+end

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

@@ -1,10 +1,10 @@
 # Generated from lib/riffer/rig/registrar.rb with RBS::Inline
 
-# The per-Runtime registrar extension blocks run against. Seams are added one
-# at a time; today only #tool exists.
 class Riffer::Rig::Registrar
   @tools: Array[singleton(Riffer::Tool)]
 
+  @prompts: Hash[Symbol, ^(Riffer::Rig::Runtime) -> String?]
+
   # @rbs return: void
   def initialize: () -> void
 
@@ -12,6 +12,14 @@ class Riffer::Rig::Registrar
   # @rbs return: void
   def tool: (singleton(Riffer::Tool) klass) -> void
 
+  # @rbs name: Symbol
+  # @rbs &block: (Riffer::Rig::Runtime) -> String?
+  # @rbs return: void
+  def prompt: (Symbol name) { (Riffer::Rig::Runtime) -> String? } -> void
+
   # @rbs return: Array[singleton(Riffer::Tool)]
   def tools: () -> Array[singleton(Riffer::Tool)]
+
+  # @rbs return: Hash[Symbol, ^(Riffer::Rig::Runtime) -> String?]
+  def prompts: () -> Hash[Symbol, ^(Riffer::Rig::Runtime) -> String?]
 end

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

@@ -55,10 +55,6 @@ class Riffer::Rig::REPL
   # @rbs return: String
   def skill_block: (String name, String body) -> String
 
-  # Chrome lines that never pass through the renderer (errors, exit line) end
-  # their line with a newline but leave the renderer's tool-group state alone —
-  # they can only follow prose, never mid-group.
-  #
   # @rbs &block: () -> String
   # @rbs return: void
   def print_block: () { () -> String } -> void
@@ -67,10 +63,6 @@ class Riffer::Rig::REPL
   # @rbs return: void
   def render_tool_result: (Riffer::Messages::Base message) -> void
 
-  # Every animator start sits behind a smoother drain: the smoother's backlog
-  # may still be trickling out from streamed prose, and spinner frames drawn
-  # mid-drain would carve `\r…\e[K` through a half-printed sentence.
-  #
   # @rbs mode: Symbol
   # @rbs return: void
   def start_animator: (?Symbol mode) -> void

data/sig/generated/riffer/rig/runtime/cancel_flag.rbs

@@ -0,0 +1,19 @@
+# Generated from lib/riffer/rig/runtime/cancel_flag.rb with RBS::Inline
+
+class Riffer::Rig::Runtime::CancelFlag
+  @mutex: Thread::Mutex
+
+  @set: bool
+
+  # @rbs return: void
+  def initialize: () -> void
+
+  # @rbs return: void
+  def set: () -> void
+
+  # @rbs return: void
+  def clear: () -> void
+
+  # @rbs return: bool
+  def set?: () -> bool
+end