legionio 1.4.101 → 1.4.102

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a5e67604f3f5f8bf4b49bea289800d891fc4073ac2947adef44760cf1eca2ff
-  data.tar.gz: af9fc49a94f6babfde4a69905d3c1da3c3d4cac2856ba71429a4720daadc0334
+  metadata.gz: 4d271552f43fd7cd244b7e22845d5f08b0a8adba77c159ae6054ab913f2cbea1
+  data.tar.gz: 761a64ecc11ca421b45c8d618e8d2e7dc4dcf7d53c231b79e9bae805580d0ce5
 SHA512:
-  metadata.gz: 2e64d067a8e1dcc4005b2c7640aaf04112b94b0499a661003a8bcd56b80023e7543a6bfcfd81f3642f74fe041ef77bcb3a8dead6216873f94329e3e2c72b32fd
-  data.tar.gz: ffe6519b87c9ff5e891ddfeb8f785ace26729f48e840c3bc5fad409dae8b2997b5cd6b074bfb6171447625ea72b1f11a4a31a23747c187171c2c8b750ff7fe21
+  metadata.gz: 6fa6a1c07d50d1283608f175016ff4833f6518269bb5a5b5c9e0a5b8484bb5784918115648fd8ec64762a05676b3593f5c5fc27585ba5f6d1940b39bfc0466e7
+  data.tar.gz: 03ab72c8a44c4c2a83146d343c8824bd9eaae5cd3cd4eb1bd6e31c843f9e2622e7e4dce306c19d34769e3e703ab6315cf469336c2a0515fcc7e604b0b7ab33fd

data/.rubocop.yml

@@ -42,6 +42,7 @@ Metrics/BlockLength:
     - 'lib/legion/cli/auth_command.rb'
     - 'lib/legion/cli/detect_command.rb'
     - 'lib/legion/cli/prompt_command.rb'
+    - 'lib/legion/cli/image_command.rb'
     - 'lib/legion/api/acp.rb'
 
 Metrics/AbcSize:

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Legion Changelog
 
+## [1.4.102] - 2026-03-21
+
+### Added
+- `legion image analyze PATH` — analyze an image file via LLM; supports `--prompt`, `--model`, `--provider`, `--format text|json`
+- `legion image compare PATH1 PATH2` — compare two images side by side via LLM with same options
+- Supports png, jpg, jpeg, gif, webp; base64-encodes image data and builds multimodal content blocks for the LLM message
+
 ## [1.4.101] - 2026-03-21
 
 ### Fixed

data/lib/legion/cli/image_command.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+require 'thor'
+require 'base64'
+
+module Legion
+  module CLI
+    class Image < Thor
+      def self.exit_on_failure?
+        true
+      end
+
+      SUPPORTED_TYPES = %w[png jpg jpeg gif webp].freeze
+
+      MIME_TYPES = {
+        'png'  => 'image/png',
+        'jpg'  => 'image/jpeg',
+        'jpeg' => 'image/jpeg',
+        'gif'  => 'image/gif',
+        'webp' => 'image/webp'
+      }.freeze
+
+      class_option :json,       type: :boolean, default: false, desc: 'Output as JSON'
+      class_option :no_color,   type: :boolean, default: false, desc: 'Disable color output'
+      class_option :verbose,    type: :boolean, default: false, aliases: ['-V'], desc: 'Verbose logging'
+      class_option :config_dir, type: :string,                  desc: 'Config directory path'
+
+      desc 'analyze PATH', 'Analyze an image file using an LLM'
+      option :prompt,    type: :string, aliases: ['-p'],
+                         desc: 'Custom question to ask about the image',
+                         default: 'Describe this image in detail'
+      option :model,     type: :string, aliases: ['-m'], desc: 'LLM model override'
+      option :provider,  type: :string,                  desc: 'LLM provider override'
+      option :format,    type: :string, default: 'text', desc: 'Output format: text or json'
+      def analyze(path)
+        out = formatter
+        setup_connection(out)
+
+        image_data = load_image(path, out)
+        return unless image_data
+
+        messages = [build_image_message([image_data], options[:prompt])]
+        response = call_llm(messages, out)
+        return unless response
+
+        render_response(out, response, { path: path, prompt: options[:prompt] })
+      rescue CLI::Error => e
+        formatter.error(e.message)
+        raise SystemExit, 1
+      ensure
+        Connection.shutdown
+      end
+
+      desc 'compare PATH1 PATH2', 'Compare two images side by side using an LLM'
+      option :prompt,    type: :string, aliases: ['-p'],
+                         desc: 'Custom comparison question',
+                         default: 'Compare these two images and describe the differences'
+      option :model,     type: :string, aliases: ['-m'], desc: 'LLM model override'
+      option :provider,  type: :string,                  desc: 'LLM provider override'
+      option :format,    type: :string, default: 'text', desc: 'Output format: text or json'
+      def compare(path1, path2)
+        out = formatter
+        setup_connection(out)
+
+        image1 = load_image(path1, out)
+        return unless image1
+
+        image2 = load_image(path2, out)
+        return unless image2
+
+        messages = [build_image_message([image1, image2], options[:prompt])]
+        response = call_llm(messages, out)
+        return unless response
+
+        render_response(out, response, { path1: path1, path2: path2, prompt: options[:prompt] })
+      rescue CLI::Error => e
+        formatter.error(e.message)
+        raise SystemExit, 1
+      ensure
+        Connection.shutdown
+      end
+
+      no_commands do
+        def formatter
+          @formatter ||= Output::Formatter.new(
+            json:  options[:json],
+            color: !options[:no_color]
+          )
+        end
+
+        def setup_connection(out)
+          Connection.config_dir = options[:config_dir] if options[:config_dir]
+          Connection.log_level  = options[:verbose] ? 'debug' : 'error'
+          Connection.ensure_llm
+        rescue CLI::Error => e
+          out.error(e.message)
+          raise SystemExit, 1
+        end
+
+        def load_image(path, out)
+          unless File.exist?(path)
+            out.error("File not found: #{path}")
+            raise SystemExit, 1
+          end
+
+          ext = File.extname(path).delete_prefix('.').downcase
+          unless SUPPORTED_TYPES.include?(ext)
+            out.error("Unsupported image type '.#{ext}'. Supported: #{SUPPORTED_TYPES.join(', ')}")
+            raise SystemExit, 1
+          end
+
+          {
+            path:      path,
+            mime_type: MIME_TYPES[ext],
+            data:      Base64.strict_encode64(File.binread(path))
+          }
+        end
+
+        def build_image_message(images, prompt_text)
+          content = images.map do |img|
+            {
+              type:   'image',
+              source: {
+                type:       'base64',
+                media_type: img[:mime_type],
+                data:       img[:data]
+              }
+            }
+          end
+          content << { type: 'text', text: prompt_text }
+          { role: 'user', content: content }
+        end
+
+        def call_llm(messages, out)
+          llm_kwargs = {}
+          llm_kwargs[:model]    = options[:model]           if options[:model]
+          llm_kwargs[:provider] = options[:provider].to_sym if options[:provider]
+
+          Legion::LLM.chat(messages: messages, **llm_kwargs)
+        rescue StandardError => e
+          out.error("LLM call failed: #{e.message}")
+          raise SystemExit, 1
+        end
+
+        def render_response(out, response, meta)
+          content = response[:content].to_s
+          usage   = response[:usage] || {}
+
+          if options[:format] == 'json' || options[:json]
+            out.json(meta.merge(response: content, usage: usage))
+          else
+            out.header('Analysis')
+            out.spacer
+            puts content
+            return if usage.nil? || usage.empty?
+
+            out.spacer
+            out.detail(usage)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/cli.rb

@@ -42,6 +42,7 @@ module Legion
     autoload :Init,       'legion/cli/init_command'
     autoload :Skill,      'legion/cli/skill_command'
     autoload :Prompt,     'legion/cli/prompt_command'
+    autoload :Image,      'legion/cli/image_command'
     autoload :Dataset,    'legion/cli/dataset_command'
     autoload :Cost,        'legion/cli/cost_command'
     autoload :Marketplace, 'legion/cli/marketplace_command'
@@ -267,6 +268,9 @@ module Legion
       desc 'observe SUBCOMMAND', 'MCP tool observation stats'
       subcommand 'observe', Legion::CLI::ObserveCommand
 
+      desc 'image SUBCOMMAND', 'Multimodal image analysis and comparison'
+      subcommand 'image', Legion::CLI::Image
+
       desc 'payroll SUBCOMMAND', 'Workforce cost and labor economics'
       subcommand 'payroll', Legion::CLI::Payroll
 

data/lib/legion/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.4.101
+  version: 1.4.102
 platform: ruby
 authors:
 - Esity
@@ -472,6 +472,7 @@ files:
 - lib/legion/cli/gaia_command.rb
 - lib/legion/cli/generate_command.rb
 - lib/legion/cli/graph_command.rb
+- lib/legion/cli/image_command.rb
 - lib/legion/cli/init/config_generator.rb
 - lib/legion/cli/init/environment_detector.rb
 - lib/legion/cli/init_command.rb