ace-llm 0.32.1 → 0.36.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d2199db9c575bab6a4e80d9537115bbd643cdcf3ae9925b7af6469ec9fd0b0e
-  data.tar.gz: e20d96efca816db66196dd4c907f9814ab8d7c0cb759e33d1d11cfb5f98e6326
+  metadata.gz: 1d92ed4d8cab8d260ef4235ecf94f612af751abbf4d1f4a4cdd30951d8c33388
+  data.tar.gz: dd6ff444bed65aa46801197857f39c008087a41da8e01c6cafcfc3c88d781a43
 SHA512:
-  metadata.gz: 72d45697b419523ec93028ff004cc840c641336dcfdd985d13a18f4468ad0d1b2abede096887309c02c39bbbd10f6e0909afb7c92ac7d379b805ad52ef30560e
-  data.tar.gz: a92cce87e5212b2d8c201aa04265e2255e6f6d7022315622f53c70f2c24cfe704d890d07379ae2b86fb4889e6fb66f30e1b3aa025b77b28ae0e756a620a1290a
+  metadata.gz: 66a5720b86973458a565c63fb36a37061d1e201b1f0be9b43cc3d6f4ecedad6785117d96ec8a53819ab35aacc70246c68780af5d82c24f8c52067a94b1714b69
+  data.tar.gz: b107b41c5221dcfda405a2073996184edf6f52b075a97f90c753b36eb283ce07403942c96e8f3116dfc2cbab3d58faa61c2630b378718c5a31aaf1c5ec8db304

data/.ace-defaults/llm/config.yml

@@ -98,9 +98,9 @@ llm:
     # --- Utility ---
     prompt-enhance: *utility-lite
     commit:
+      - google:lite
       - codex:mini
       - claude:haiku
-      - gemini:flash-latest
     docs-analysis: *utility-lite
     idea-enhance:
       - gemini:flash-latest

data/CHANGELOG.md

@@ -7,6 +7,111 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.36.3] - 2026-04-19
+
+### Fixed
+- Fixed `ace-llm --interactive` startup for Codex aliases so the `/as-onboard` and related interactive alias prompts are launched with a valid subprocess command shape instead of aborting with a missing keyword.
+
+## [0.36.2] - 2026-04-19
+
+### Fixed
+- Refreshed Codex model examples in README, usage, getting-started, demo, and help output from stale `codex:gpt-5` forms to the current stable `codex:gpt` alias and updated current provider alias guidance.
+
+## [0.36.1] - 2026-04-16
+
+### Fixed
+- Switched the fresh-default `commit` role to prefer `google:lite` before CLI fallbacks so new `ace-config init` projects keep generated commit messages working when stale CLI aliases or unavailable local CLIs would otherwise break message generation.
+
+## [0.36.0] - 2026-04-15
+
+### Changed
+- Reworked `TS-LLM-001` to public-surface goal style by tightening model-routing evidence checks, adding `TC-003` output-file-contract coverage, and prioritizing end-state/output artifacts over helper-only signals.
+- Added `TS-LLM-002` provider-discovery coverage for `ace-llm --list-providers` so public setup-hint and provider-list output behavior is verified as a first-class E2E journey.
+
+### Technical
+- Updated runtime dependency constraint to `ace-support-models ~> 0.11` after the coordinated support-models minor release.
+
+## [0.35.1] - 2026-04-15
+
+### Fixed
+- Updated the `cli_args` threading feature tests to match the normalized array contract and stub provider preset loading directly, so `ace-test ace-llm` no longer fails on stale scalar expectations or package-local preset lookup assumptions.
+
+## [0.35.0] - 2026-04-15
+
+### Fixed
+- Merged preset CLI args with explicit `--cli-args` so interactive launches keep provider autonomy presets such as `@yolo` while still accepting additional flags like `--no-alt-screen`.
+
+### Technical
+- Threaded the current working directory and subprocess environment explicitly through `ace-llm --interactive` so provider-side startup policy hooks can make launch decisions from the real execution context.
+
+## [0.34.0] - 2026-04-15
+
+### Added
+- Added `ace-llm --interactive` for supported CLI-backed providers so alias resolution, presets, thinking levels, and canonical skill handoff translation can launch the provider's native interactive terminal UI in one call.
+
+### Changed
+- Documented interactive launch usage in the README, getting-started guide, and usage guide, including the tmux fork handoff pattern built around `/as-assign-drive <assignment>@<root>`.
+
+## [0.33.6] - 2026-04-13
+
+### Fixed
+- Switched `TS-LLM-001` basic-query coverage to the explicit `--prompt` form so the scenario executes with canonical prompt input and no longer misclassifies dropped positional input as provider behavior.
+
+## [0.33.5] - 2026-04-13
+
+### Fixed
+- Hardened `TS-LLM-001` basic-query execution by persisting the exact prompt and command artifacts so empty-input/provider-contract failures are distinguished from valid model responses.
+
+## [0.33.4] - 2026-04-13
+
+### Fixed
+- Added the missing `ace-support-models` runtime dependency so `ace-llm --list-providers` no longer fails on fresh setups with `cannot load such file -- ace/support/models`.
+
+### Changed
+- Updated quick-start onboarding guidance to include `ace-llm` in the base install command used before provider verification.
+
+## [0.33.3] - 2026-04-13
+
+### Fixed
+- Added `codex:mini` as a fallback model for the `commit` role after `glite`, so role-based commit-message generation tries a secondary model instead of failing when `glite` is unavailable.
+
+
+### Technical
+- Tightened the package version contract test to require a full semantic-version match instead of accepting partial matches.
+## [0.33.2] - 2026-04-13
+
+### Fixed
+- Fixed provider credential availability checks so role-based model selection no longer crashes when a provider relies on fallback environment keys.
+
+### Technical
+- Added regression coverage for `ClientRegistry#provider_api_key_present?` using Google fallback API key resolution.
+
+## [0.33.1] - 2026-04-13
+
+### Changed
+- Completed the batch i05 migration follow-through for this package and aligned it with the restarted `fast` / `feat` / `e2e` verification model.
+
+### Technical
+- Included in the coordinated assignment-driven patch release for batch i05 package updates.
+
+
+## [0.33.0] - 2026-04-12
+
+### Changed
+- Migrated package tests to the restarted `fast` / `feat` / `e2e` contract:
+  - moved deterministic test suites from legacy top-level folders into `test/fast/`
+  - moved legacy `test/integration/` coverage into `test/feat/`
+  - reduced `TS-LLM-001` E2E scenario from 3 to 2 TCs and added an E2E decision record
+- Updated README and package docs to teach only `ace-test ace-llm`, `ace-test ace-llm feat`, `ace-test ace-llm all`, and `ace-test-e2e ace-llm`.
+
+### Fixed
+- Preserved full fallback target selectors (including provider/model + suffix context) across fallback attempts and rebuilt generation options per target instead of reusing stale primary-provider options.
+
+## [0.32.2] - 2026-04-10
+
+### Changed
+- Updated the shared role catalog for restarted E2E execution with explicit `e2e-runner`, `e2e-verifier`, and `e2e-reporter` roles in the project-owned LLM configuration surface.
+
 ## [0.32.1] - 2026-04-01
 
 ### Fixed

data/README.md

@@ -18,7 +18,20 @@
 
 ![ace-llm demo](docs/demo/ace-llm-getting-started.gif)
 
-`ace-llm` gives developers and coding agents one command surface for querying any LLM provider. Address models by alias (`gflash`, `sonnet`), explicit `provider:model` notation, or with thinking levels (`codex:gpt-5:high`) and execution presets (`cc@ro`). Pass prompts and system instructions inline or as file paths. Fallback routing and retry behavior keep prompt workflows resilient.
+`ace-llm` gives developers and coding agents one command surface for querying any LLM provider. Address models by alias (`gflash`, `sonnet`), explicit `provider:model` notation, or with thinking levels (`codex:gpt:high`) and execution presets (`cc@ro`). Pass prompts and system instructions inline or as file paths, or start supported CLI providers in native interactive mode with `--interactive`. Fallback routing and retry behavior keep prompt workflows resilient.
+
+## Testing
+
+Package-local verification contract:
+
+```bash
+ace-test ace-llm
+ace-test ace-llm feat
+ace-test ace-llm all
+ace-test-e2e ace-llm
+```
+
+Deterministic coverage lives in `test/fast/` and `test/feat/`. Scenario assets stay in `test/e2e/`.
 
 ## How It Works
 
@@ -30,10 +43,12 @@
 
 **Switch providers with aliases** - use short names like `gflash`, `sonnet`, `opus` instead of full `provider:model` notation. Aliases resolve through versioned YAML in [`.ace-defaults/`](docs/usage.md).
 
-**Control reasoning depth** - append a thinking level (`codex:gpt-5:high`, `claude:sonnet:low`) to tune reasoning budgets. Supported CLI providers: `claude`, `codex` (levels: `low`, `medium`, `high`, `xhigh`).
+**Control reasoning depth** - append a thinking level (`codex:gpt:high`, `claude:sonnet:low`) to tune reasoning budgets. Supported CLI providers: `claude`, `codex` (levels: `low`, `medium`, `high`, `xhigh`).
 
 **Run preset-driven prompts** - apply execution profiles with `@preset` or `--preset`. Built-in presets for CLI providers: `@ro` (read-only), `@rw` (read-write), `@yolo` (full autonomy). Supported by: `claude`, `codex`, `gemini`, `opencode`, `pi`.
 
+**Launch real interactive agents** - use `--interactive` for supported CLI providers so alias resolution, presets, and skill translation still flow through `ace-llm`, but the provider starts its native terminal UI instead of one-shot print mode.
+
 **Build resilient prompt workflows** - configure fallback chains and retry behavior through the [config cascade](.ace-defaults/llm/config.yml) so transient provider issues do not block work.
 
 **Power LLM-enhanced flows in sibling packages** - serve as the execution backend for [ace-git-commit](../ace-git-commit), [ace-idea](../ace-idea), [ace-review](../ace-review), [ace-sim](../ace-sim), [ace-prompt-prep](../ace-prompt-prep), and more.

data/lib/ace/llm/cli/commands/query.rb

@@ -32,6 +32,7 @@ module Ace
           option :model, type: :string, desc: "Model name (overrides PROVIDER[:MODEL])"
           option :prompt, type: :string, desc: "Prompt text (overrides positional PROMPT)"
           option :force, type: :boolean, default: false, desc: "Force overwrite existing files"
+          option :interactive, type: :boolean, default: false, desc: "Start an interactive CLI session instead of one-shot query"
 
           option :version, type: :boolean, desc: "Show version information"
           option :list_providers, type: :boolean, desc: "List available LLM providers"
@@ -88,6 +89,7 @@ module Ace
             puts "      --timeout SECONDS          Request timeout in seconds"
             puts "      --model MODEL              Model name (overrides PROVIDER[:MODEL])"
             puts "      --prompt PROMPT            Prompt text (overrides positional PROMPT)"
+            puts "      --interactive              Start an interactive CLI session"
             puts "      --force                    Force overwrite existing files"
             puts "  -q, --quiet                    Suppress config summary output"
             puts "  -d, --debug                    Enable debug output"
@@ -97,17 +99,19 @@ module Ace
             puts '  ace-llm google:gemini-2.5-flash "What is Ruby?"'
             puts '  ace-llm gflash "Quick question" # using alias'
             puts '  ace-llm gflash@ro "Summarize this diff"'
-            puts '  ace-llm codex:gpt-5:high@ro "Review this code"'
+            puts '  ace-llm codex:gpt:high@ro "Review this code"'
             puts '  ace-llm claude:sonnet "Summarize this diff" --preset rw'
             puts '  ace-llm claude:sonnet "Hi" --cli-args "dangerously-skip-permissions"'
             puts '  ace-llm claude:sonnet "Hi" --cli-args "--model=claude-sonnet-4-0 --verbose"'
+            puts '  ace-llm codex:gpt@yolo "/as-assign-drive abc123@010" --interactive'
             puts ""
             puts "Provider Aliases:"
             puts "  Short aliases for common provider:MODEL combinations:"
-            puts "    gflash    → google:gemini-2.5-flash"
-            puts "    glite     → google:gemini-2.0-flash-lite"
-            puts "    gpt4      → openai:gpt-4"
-            puts "    claude    → anthropic:claude-3-5-sonnet"
+            puts "    gflash    → google:gemini-flash-latest"
+            puts "    glite     → google:gemini-flash-lite-latest"
+            puts "    codex:gpt → codex:gpt-5.4"
+            puts "    cc        → claude:sonnet"
+            puts "    sonnet    → anthropic:claude-sonnet-4-5"
           end
 
           def show_provider_help
@@ -150,6 +154,23 @@ module Ace
             system_append_text = options[:system_append] ? file_handler.read_content(options[:system_append]) : nil
             normalized_timeout = normalize_timeout(options[:timeout])
 
+            if options[:interactive]
+              validate_interactive_options!(options)
+              invocation = Ace::LLM::Molecules::InteractiveCommandBuilder.new.build(
+                provider_model: @provider_model,
+                prompt: prompt_text,
+                system: system_text,
+                cli_args: options[:cli_args],
+                system_append: system_append_text,
+                preset: options[:preset],
+                model: (@model_from_option ? nil : options[:model]),
+                working_dir: Dir.pwd,
+                subprocess_env: ENV.to_h
+              )
+              execute_interactive_invocation(invocation)
+              return
+            end
+
             resolved_model_override = @model_from_option ? nil : options[:model]
             response = Ace::LLM::QueryInterface.query(
               @provider_model,
@@ -178,6 +199,26 @@ module Ace
             raise
           end
 
+          def validate_interactive_options!(options)
+            conflicts = []
+            conflicts << "--output" if options[:output]
+            conflicts << "--force" if options[:force]
+            conflicts << "--temperature" unless options[:temperature].nil?
+            conflicts << "--max-tokens" unless options[:max_tokens].nil?
+            explicit_format = options[:format]
+            conflicts << "--format" if explicit_format && explicit_format != "text"
+            return if conflicts.empty?
+
+            raise Ace::Support::Cli::Error, "Interactive mode does not support #{conflicts.join(', ')}"
+          end
+
+          def execute_interactive_invocation(invocation)
+            env = invocation[:env].respond_to?(:to_h) ? invocation[:env].to_h : {}
+            command = invocation[:command]
+            working_dir = invocation[:working_dir]
+            Kernel.exec(env, *command, chdir: working_dir)
+          end
+
           def output_response(response, options)
             format = options[:format] || "text"
             handler = Ace::LLM::Molecules::FormatHandlers.get_handler(format)

data/lib/ace/llm/molecules/client_registry.rb

@@ -142,7 +142,8 @@ module Ace
           provider = get_provider(provider_name)
           return false unless provider
 
-          api_key_present?(provider["api_key"])
+          normalized_name = normalize_provider_name(provider["name"] || provider_name)
+          credential_status(provider, normalized_name)[:present]
         end
 
         # Reload all configurations

data/lib/ace/llm/molecules/fallback_orchestrator.rb

@@ -2,6 +2,7 @@
 
 require_relative "../atoms/error_classifier"
 require_relative "../models/fallback_config"
+require_relative "provider_model_parser"
 
 module Ace
   module LLM
@@ -35,10 +36,12 @@ module Ace
           @visited_providers.clear
 
           # If fallback disabled, just execute with primary
-          return yield get_client(primary_provider, registry) if @config.disabled?
+          return yield(get_client(primary_provider, registry), primary_provider) if @config.disabled?
 
           # Try primary provider with retries
-          result = try_provider_with_retry(primary_provider, registry) { |client| yield client }
+          result = try_provider_with_retry(primary_provider, registry) do |client, provider_name|
+            yield client, provider_name
+          end
           return result if result
 
           # Try fallback providers in order (per-provider chain or default)
@@ -54,7 +57,9 @@ module Ace
 
             report_status("ℹ Trying fallback provider #{fallback_provider}...")
 
-            result = try_provider_with_retry(fallback_provider, registry) { |client| yield client }
+            result = try_provider_with_retry(fallback_provider, registry) do |client, provider_name|
+              yield client, provider_name
+            end
             return result if result
           end
 
@@ -77,7 +82,7 @@ module Ace
 
           loop do
             client = get_client(provider_name, registry)
-            return yield client
+            return yield client, provider_name
           rescue => error
             last_error = error
 
@@ -145,10 +150,11 @@ module Ace
           opts = {}
           opts[:timeout] = @timeout if @timeout
 
-          # Parse provider:model format if present
-          if provider_name.include?(":")
-            provider, model = provider_name.split(":", 2)
-            registry.get_client(provider, model: model, **opts)
+          parser = ProviderModelParser.new(registry: registry)
+          parsed = parser.parse(provider_name.to_s)
+
+          if parsed.valid?
+            registry.get_client(parsed.provider, model: parsed.model, **opts)
           else
             registry.get_client(provider_name, **opts)
           end

data/lib/ace/llm/molecules/interactive_command_builder.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Ace
+  module LLM
+    module Molecules
+      class InteractiveCommandBuilder
+        def initialize(registry: ClientRegistry.new)
+          @registry = registry
+          @parser = ProviderModelParser.new(registry: registry)
+        end
+
+        def build(provider_model:, prompt:, model: nil, preset: nil, system: nil, cli_args: nil,
+          system_append: nil, sandbox: nil, working_dir: nil, subprocess_env: nil)
+          parse_result = @parser.parse(provider_model)
+          raise Error, parse_result.error unless parse_result.valid?
+
+          resolved_preset = QueryInterface.send(:resolve_preset_name, parse_result.preset, preset)
+          final_model = model || parse_result.model
+          if final_model.nil? || final_model.empty?
+            raise Error, "No model specified and no default available for #{parse_result.provider}"
+          end
+
+          final_prompt = prompt.to_s
+          raise Error, "No prompt specified. Use positional prompt or --prompt." if final_prompt.empty?
+
+        generation_opts = QueryInterface.send(
+            :build_generation_opts,
+            provider: parse_result.provider,
+            preset: resolved_preset,
+            thinking_level: parse_result.thinking_level,
+            temperature: nil,
+            max_tokens: nil,
+            system_file: nil,
+            prompt_file: nil,
+            cli_args: cli_args,
+            system_append: system_append,
+            sandbox: sandbox,
+            working_dir: working_dir,
+            subprocess_env: subprocess_env,
+            subprocess_command_prefix: nil,
+            last_message_file: nil
+          )
+
+          client = @registry.get_client(parse_result.provider, model: final_model)
+          unless client.respond_to?(:interactive_supported?) && client.interactive_supported?
+            raise Error, "Provider '#{parse_result.provider}' does not support interactive mode"
+          end
+
+          messages = []
+          messages << {role: "system", content: system} if system && !system.empty?
+          messages << {role: "user", content: final_prompt}
+
+          invocation = client.build_interactive_invocation(messages, **generation_opts)
+          invocation.merge(
+            provider: parse_result.provider,
+            model: final_model,
+            preset: resolved_preset,
+            thinking_level: parse_result.thinking_level
+          )
+        end
+      end
+    end
+  end
+end

data/lib/ace/llm/molecules/role_resolver.rb

@@ -60,7 +60,6 @@ module Ace
           return false if provider.nil? || provider.empty?
           return false if @configuration.provider_inactive?(provider)
           return false unless @registry.provider_available?(provider)
-          return false if @registry.provider_api_key_required?(provider) && !@registry.provider_api_key_present?(provider)
 
           true
         end

data/lib/ace/llm/query_interface.rb

@@ -35,6 +35,7 @@ module Ace
         sandbox: nil,
         working_dir: nil,
         subprocess_env: nil,
+        subprocess_command_prefix: nil,
         last_message_file: nil)
         registry = Molecules::ClientRegistry.new
         parser = Molecules::ProviderModelParser.new(registry: registry)
@@ -43,12 +44,6 @@ module Ace
         raise Error, parse_result.error unless parse_result.valid?
 
         resolved_preset = resolve_preset_name(parse_result.preset, preset)
-        execution_overrides = load_execution_overrides(
-          provider: parse_result.provider,
-          preset: resolved_preset,
-          thinking_level: parse_result.thinking_level
-        )
-
         final_model = model || parse_result.model
         if final_model.nil? || final_model.empty?
           raise Error, "No model specified and no default available for #{parse_result.provider}"
@@ -63,38 +58,41 @@ module Ace
         messages << {role: "system", content: system} if system && !system.empty?
         messages << {role: "user", content: final_prompt}
 
-        generation_opts = {}
-        resolved_temperature = first_non_nil(temperature, execution_overrides["temperature"])
-        resolved_max_tokens = first_non_nil(max_tokens, execution_overrides["max_tokens"])
-        resolved_cli_args = first_non_nil(cli_args, execution_overrides["cli_args"])
-        resolved_system_append = first_non_empty(system_append, execution_overrides["system_append"])
-        resolved_sandbox = first_non_nil(sandbox, execution_overrides["sandbox"])
-        resolved_working_dir = first_non_nil(working_dir, execution_overrides["working_dir"])
-        resolved_subprocess_env = merge_hash_values(execution_overrides["subprocess_env"], subprocess_env)
-
-        generation_opts[:temperature] = resolved_temperature unless resolved_temperature.nil?
-        generation_opts[:max_tokens] = resolved_max_tokens unless resolved_max_tokens.nil?
-        generation_opts[:system_file] = system_file if system_file
-        generation_opts[:prompt_file] = prompt_file if prompt_file
-        generation_opts[:cli_args] = resolved_cli_args unless blank_value?(resolved_cli_args)
-        generation_opts[:system_append] = resolved_system_append unless blank_value?(resolved_system_append)
-        generation_opts[:sandbox] = resolved_sandbox if resolved_sandbox
-        generation_opts[:working_dir] = resolved_working_dir unless blank_value?(resolved_working_dir)
-        generation_opts[:subprocess_env] = resolved_subprocess_env unless resolved_subprocess_env.nil?
-        generation_opts[:last_message_file] = last_message_file if last_message_file
+        generation_opts = build_generation_opts(
+          provider: parse_result.provider,
+          preset: resolved_preset,
+          thinking_level: parse_result.thinking_level,
+          temperature: temperature,
+          max_tokens: max_tokens,
+          system_file: system_file,
+          prompt_file: prompt_file,
+          cli_args: cli_args,
+          system_append: system_append,
+          sandbox: sandbox,
+          working_dir: working_dir,
+          subprocess_env: subprocess_env,
+          subprocess_command_prefix: subprocess_command_prefix,
+          last_message_file: last_message_file
+        )
+        execution_overrides = load_execution_overrides(
+          provider: parse_result.provider,
+          preset: resolved_preset,
+          thinking_level: parse_result.thinking_level
+        )
 
         if debug
           warn "Provider: #{parse_result.provider}"
           warn "Model: #{final_model}"
           warn "Preset: #{resolved_preset}" if resolved_preset
           warn "Thinking level: #{parse_result.thinking_level}" if parse_result.thinking_level
-          warn "Temperature: #{resolved_temperature}" unless resolved_temperature.nil?
-          warn "Max tokens: #{resolved_max_tokens}" unless resolved_max_tokens.nil?
+          warn "Temperature: #{generation_opts[:temperature]}" unless generation_opts[:temperature].nil?
+          warn "Max tokens: #{generation_opts[:max_tokens]}" unless generation_opts[:max_tokens].nil?
         end
 
         fallback_config = load_fallback_config(fallback, fallback_providers, parser: parser)
         timeout_value = first_non_nil(timeout, execution_overrides["timeout"], Molecules::ConfigLoader.get("llm.timeout"), 120)
         resolved_timeout = normalize_timeout(timeout_value)
+        parser_for_options = Molecules::ProviderModelParser.new(registry: registry)
 
         response = execute_with_fallback(
           provider: parse_result.provider,
@@ -105,7 +103,39 @@ module Ace
           fallback_config: fallback_config,
           timeout: resolved_timeout,
           debug: debug,
-          role_fallbacks: parse_result.role_fallbacks
+          role_fallbacks: parse_result.role_fallbacks,
+          preset: resolved_preset,
+          thinking_level: parse_result.thinking_level,
+          option_builder: lambda { |target_selector|
+            parsed_target = parser_for_options.parse(target_selector.to_s)
+            target_provider = parsed_target.valid? ? parsed_target.provider : parse_result.provider
+            target_preset = if parsed_target.valid? && parsed_target.preset
+              parsed_target.preset
+            else
+              resolved_preset
+            end
+            target_thinking = if parsed_target.valid?
+              parsed_target.thinking_level
+            else
+              parse_result.thinking_level
+            end
+            build_generation_opts(
+              provider: target_provider,
+              preset: target_preset,
+              thinking_level: target_thinking,
+              temperature: temperature,
+              max_tokens: max_tokens,
+              system_file: system_file,
+              prompt_file: prompt_file,
+              cli_args: cli_args,
+              system_append: system_append,
+              sandbox: sandbox,
+              working_dir: working_dir,
+              subprocess_env: subprocess_env,
+              subprocess_command_prefix: subprocess_command_prefix,
+              last_message_file: last_message_file
+            )
+          }
         )
 
         text_content = extract_text_content(response)
@@ -174,6 +204,43 @@ module Ace
       end
       private_class_method :load_execution_overrides
 
+      def self.build_generation_opts(provider:, preset:, thinking_level:, temperature:, max_tokens:, system_file:,
+        prompt_file:, cli_args:, system_append:, sandbox:, working_dir:, subprocess_env:, subprocess_command_prefix:,
+        last_message_file:)
+        execution_overrides = load_execution_overrides(
+          provider: provider,
+          preset: preset,
+          thinking_level: thinking_level
+        )
+
+        generation_opts = {}
+        resolved_temperature = first_non_nil(temperature, execution_overrides["temperature"])
+        resolved_max_tokens = first_non_nil(max_tokens, execution_overrides["max_tokens"])
+        resolved_cli_args = append_cli_args(execution_overrides["cli_args"], cli_args)
+        resolved_system_append = first_non_empty(system_append, execution_overrides["system_append"])
+        resolved_sandbox = first_non_nil(sandbox, execution_overrides["sandbox"])
+        resolved_working_dir = first_non_nil(working_dir, execution_overrides["working_dir"])
+        resolved_subprocess_env = merge_hash_values(execution_overrides["subprocess_env"], subprocess_env)
+        resolved_subprocess_command_prefix = first_non_nil(
+          subprocess_command_prefix,
+          execution_overrides["subprocess_command_prefix"]
+        )
+
+        generation_opts[:temperature] = resolved_temperature unless resolved_temperature.nil?
+        generation_opts[:max_tokens] = resolved_max_tokens unless resolved_max_tokens.nil?
+        generation_opts[:system_file] = system_file if system_file
+        generation_opts[:prompt_file] = prompt_file if prompt_file
+        generation_opts[:cli_args] = resolved_cli_args unless blank_value?(resolved_cli_args)
+        generation_opts[:system_append] = resolved_system_append unless blank_value?(resolved_system_append)
+        generation_opts[:sandbox] = resolved_sandbox if resolved_sandbox
+        generation_opts[:working_dir] = resolved_working_dir unless blank_value?(resolved_working_dir)
+        generation_opts[:subprocess_env] = resolved_subprocess_env unless resolved_subprocess_env.nil?
+        generation_opts[:subprocess_command_prefix] = resolved_subprocess_command_prefix unless blank_value?(resolved_subprocess_command_prefix)
+        generation_opts[:last_message_file] = last_message_file if last_message_file
+        generation_opts
+      end
+      private_class_method :build_generation_opts
+
       def self.merge_execution_overrides(base, overlay)
         left = base.respond_to?(:to_h) ? deep_stringify_keys(base.to_h) : deep_stringify_keys(base || {})
         right = overlay.respond_to?(:to_h) ? deep_stringify_keys(overlay.to_h) : deep_stringify_keys(overlay || {})
@@ -291,7 +358,7 @@ module Ace
       end
 
       def self.execute_with_fallback(provider:, model:, messages:, generation_opts:,
-        registry:, fallback_config:, timeout:, debug:, role_fallbacks: nil)
+        registry:, fallback_config:, timeout:, debug:, role_fallbacks: nil, preset: nil, thinking_level: nil, option_builder:)
         if fallback_config.disabled?
           client = registry.get_client(provider, model: model, timeout: timeout)
           return client.generate(messages, **generation_opts)
@@ -300,9 +367,10 @@ module Ace
         primary_provider_string = model ? "#{provider}:#{model}" : provider
 
         # Inject remaining role candidates ahead of the global fallback chain
+        normalized_role_fallbacks = normalize_fallback_providers(role_fallbacks, Molecules::ProviderModelParser.new(registry: registry))
         if role_fallbacks&.any?
           existing_chain = fallback_config.providers_for(primary_provider_string)
-          merged_chain = role_fallbacks + (existing_chain - role_fallbacks)
+          merged_chain = normalized_role_fallbacks + (existing_chain - normalized_role_fallbacks)
           fallback_config = fallback_config.merge(chains: {primary_provider_string => merged_chain})
         end
 
@@ -314,8 +382,13 @@ module Ace
           timeout: timeout
         )
 
-        orchestrator.execute(primary_provider: primary_provider_string, registry: registry) do |client|
-          client.generate(messages, **generation_opts)
+        orchestrator.execute(primary_provider: primary_provider_string, registry: registry) do |client, target_selector|
+          opts = if target_selector.to_s == primary_provider_string
+            generation_opts
+          else
+            option_builder.call(target_selector)
+          end
+          client.generate(messages, **opts)
         end
       end
 
@@ -380,7 +453,7 @@ module Ace
 
           parse_result = parser.parse(provider)
           canonical_provider = if parse_result.valid?
-            "#{parse_result.provider}:#{parse_result.model}"
+            parse_result.to_s
           else
             provider
           end

data/lib/ace/llm/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module LLM
-    VERSION = '0.32.1'
+    VERSION = '0.36.3'
   end
 end

data/lib/ace/llm.rb

@@ -28,6 +28,7 @@ require_relative "llm/molecules/provider_model_parser"
 require_relative "llm/molecules/format_handlers"
 require_relative "llm/molecules/client_registry"
 require_relative "llm/molecules/fallback_orchestrator"
+require_relative "llm/molecules/interactive_command_builder"
 
 require_relative "llm/query_interface"
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-llm
 version: !ruby/object:Gem::Version
-  version: 0.32.1
+  version: 0.36.3
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-04-01 00:00:00.000000000 Z
+date: 2026-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-cli
@@ -51,6 +51,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.29'
+- !ruby/object:Gem::Dependency
+  name: ace-support-models
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
@@ -273,6 +287,7 @@ files:
 - lib/ace/llm/molecules/fallback_orchestrator.rb
 - lib/ace/llm/molecules/file_io_handler.rb
 - lib/ace/llm/molecules/format_handlers.rb
+- lib/ace/llm/molecules/interactive_command_builder.rb
 - lib/ace/llm/molecules/llm_alias_resolver.rb
 - lib/ace/llm/molecules/openai_compatible_params.rb
 - lib/ace/llm/molecules/preset_loader.rb