legionio 1.4.93 → 1.4.94

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 318839858d16ecbaaf6c7db4a0d9562e1641ca24d174fda914b9d359f3f91e69
-  data.tar.gz: 91e1415070e2f547bc7c71646e79312f048f8973b2cb004045a8d546a0000387
+  metadata.gz: 72bd61b58a41c643d7570541ccd32493cc6357e32db64c3649275d7b7a1c159f
+  data.tar.gz: 05b98ee5d6ee262bdb7909842c827d43f73bca4bc245cfb4e3e453a57939d45c
 SHA512:
-  metadata.gz: e5cd6e2ff71cc11db2a1e8928aae0c53104f931c18829bf470658bbcac3e2f90a18aeb7c564dcc7eb3f113fa9c65b54bb165a0f322fc3b1021a0ebf98148bf66
-  data.tar.gz: ff3c9e796fef50d7ca2e7b1970c4516a2d839031f8bee6036fc43b758f0035d85b5bc80fd631c5e55d8a83ce28fe5a7ccfa55fa69b67237b868331d1606d3d34
+  metadata.gz: c339580f9b229475d21752fa56bfcb90c7213c177dd83dc713220e1d872dbbe13ad690122abc5f4c620416a45bbda960c11dc355fe048b756ea5224259576647
+  data.tar.gz: 2f738e376dc5b147a8e3b4dcc71013fce20cc39b1ec24bbdac922080df327be7f8f743e860a62ee21ab6b935b0d9e7d23b48703adc1ccf274bf5ff713d4f90b3

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Legion Changelog
 
+## [1.4.94] - 2026-03-20
+
+### Added
+- `legion prompt play NAME` subcommand: renders a prompt template with variables and sends it to an LLM via `Legion::LLM.chat`
+- `--variables` (JSON), `--version`, `--model`, `--provider`, and `--compare` options on `play`
+- Compare mode (`--compare VERSION`): renders two prompt versions, calls LLM for each, displays side-by-side responses and diff when they differ
+- JSON output mode for `play` and compare via `--json`
+- `Connection.ensure_llm` called inside `with_prompt_client` so LLM is available to all prompt subcommands
+- 14 new specs for `play` covering single-version, compare, LLM unavailable, JSON output, and error paths
+
 ## [1.4.93] - 2026-03-20
 
 ### Added

data/lib/legion/cli/prompt_command.rb

@@ -140,6 +140,36 @@ module Legion
         end
       end
 
+      desc 'play NAME', 'Run a prompt through an LLM and display the response'
+      option :variables, type: :string,  desc: 'Template variables as JSON'
+      option :version,   type: :numeric, desc: 'Prompt version'
+      option :model,     type: :string,  desc: 'LLM model override'
+      option :provider,  type: :string,  desc: 'LLM provider override'
+      option :compare,   type: :numeric, desc: 'Compare with this version'
+      def play(name)
+        out = formatter
+        with_prompt_client do |client|
+          unless defined?(Legion::LLM) && Legion::LLM.started?
+            out.error('legion-llm is not available. Install legion-llm and configure a provider.')
+            raise SystemExit, 1
+          end
+
+          vars = parse_variables(options[:variables], out)
+          return if vars.nil?
+
+          llm_kwargs = {}
+          llm_kwargs[:model]    = options[:model]    if options[:model]
+          llm_kwargs[:provider] = options[:provider] if options[:provider]
+
+          base_ctx = { name: name, vars: vars, llm_kwargs: llm_kwargs, client: client, out: out }
+          if options[:compare]
+            run_compare(base_ctx.merge(ver_a: options[:version], ver_b: options[:compare]))
+          else
+            run_single(base_ctx.merge(version: options[:version]))
+          end
+        end
+      end
+
       no_commands do
         def formatter
           @formatter ||= Output::Formatter.new(
@@ -152,6 +182,7 @@ module Legion
           Connection.config_dir = options[:config_dir] if options[:config_dir]
           Connection.log_level  = options[:verbose] ? 'debug' : 'error'
           Connection.ensure_data
+          Connection.ensure_llm
 
           begin
             require 'legion/extensions/prompt'
@@ -181,6 +212,15 @@ module Legion
           nil
         end
 
+        def parse_variables(raw, out)
+          return {} if raw.nil? || raw.empty?
+
+          ::JSON.parse(raw)
+        rescue ::JSON::ParserError => e
+          out.error("Invalid JSON for --variables: #{e.message}")
+          nil
+        end
+
         def diff_lines(old_text, new_text)
           old_lines = old_text.split("\n")
           new_lines = new_text.split("\n")
@@ -191,6 +231,102 @@ module Legion
           new_lines.each { |l| result << "+ #{l}" unless old_set.include?(l) }
           result.join("\n")
         end
+
+        def run_single(ctx)
+          name, version, vars, llm_kwargs, client, out = ctx.values_at(:name, :version, :vars, :llm_kwargs, :client, :out)
+          prompt = fetch_prompt(name, version, client, out)
+          return if prompt.nil?
+
+          rendered = render_prompt(name, version, vars, client, out)
+          return if rendered.nil?
+
+          response = Legion::LLM.chat(
+            messages: [{ role: 'user', content: rendered }],
+            **llm_kwargs
+          )
+
+          if options[:json]
+            out.json({ name: name, version: prompt[:version], rendered: rendered,
+                       response: response[:content], usage: response[:usage] })
+          else
+            out.header("Prompt: #{name} (v#{prompt[:version]})")
+            out.spacer
+            out.header('Rendered Template')
+            puts rendered
+            out.spacer
+            out.header('LLM Response')
+            puts response[:content]
+            display_usage(response[:usage], out)
+          end
+        end
+
+        def run_compare(ctx)
+          name, ver_a, ver_b, vars, llm_kwargs, client, out =
+            ctx.values_at(:name, :ver_a, :ver_b, :vars, :llm_kwargs, :client, :out)
+          prompt_a = fetch_prompt(name, ver_a, client, out)
+          return if prompt_a.nil?
+
+          prompt_b = fetch_prompt(name, ver_b, client, out)
+          return if prompt_b.nil?
+
+          rendered_a = render_prompt(name, prompt_a[:version], vars, client, out)
+          return if rendered_a.nil?
+
+          rendered_b = render_prompt(name, prompt_b[:version], vars, client, out)
+          return if rendered_b.nil?
+
+          response_a = Legion::LLM.chat(messages: [{ role: 'user', content: rendered_a }], **llm_kwargs)
+          response_b = Legion::LLM.chat(messages: [{ role: 'user', content: rendered_b }], **llm_kwargs)
+
+          if options[:json]
+            out.json({ name: name, version_a: prompt_a[:version], version_b: prompt_b[:version],
+                       rendered_a: rendered_a, rendered_b: rendered_b,
+                       response_a: response_a[:content], response_b: response_b[:content],
+                       usage_a: response_a[:usage], usage_b: response_b[:usage] })
+          else
+            out.header("Version A (v#{prompt_a[:version]})")
+            puts response_a[:content]
+            out.spacer
+            out.header("Version B (v#{prompt_b[:version]})")
+            puts response_b[:content]
+            content_a = response_a[:content].to_s
+            content_b = response_b[:content].to_s
+            if content_a != content_b
+              out.spacer
+              out.header('Diff (A vs B)')
+              puts diff_lines(content_a, content_b)
+            end
+          end
+        end
+
+        def fetch_prompt(name, version, client, out)
+          kwargs = { name: name }
+          kwargs[:version] = version if version
+          result = client.get_prompt(**kwargs)
+          if result[:error]
+            out.error("Prompt '#{name}': #{result[:error]}")
+            raise SystemExit, 1
+          end
+          result
+        end
+
+        def render_prompt(name, version, vars, client, out)
+          kwargs = { name: name, variables: vars }
+          kwargs[:version] = version if version
+          result = client.render_prompt(**kwargs)
+          if result.is_a?(Hash) && result[:error]
+            out.error("Render error for '#{name}': #{result[:error]}")
+            raise SystemExit, 1
+          end
+          result.is_a?(Hash) ? result[:rendered] : result
+        end
+
+        def display_usage(usage, out)
+          return unless usage && !usage.empty?
+
+          out.spacer
+          out.detail(usage)
+        end
       end
     end
   end

data/lib/legion/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Legion
-  VERSION = '1.4.93'
+  VERSION = '1.4.94'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.4.93
+  version: 1.4.94
 platform: ruby
 authors:
 - Esity