legionio 1.4.94 → 1.4.95

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72bd61b58a41c643d7570541ccd32493cc6357e32db64c3649275d7b7a1c159f
-  data.tar.gz: 05b98ee5d6ee262bdb7909842c827d43f73bca4bc245cfb4e3e453a57939d45c
+  metadata.gz: a110098f876265aa1233e4ca1e60baf30f5a23340b8d9de1f4a9c942ea0128fd
+  data.tar.gz: 3144aab6b5cab4ed042fee55d344cd2a8493ac48284a74ef431238643d91a863
 SHA512:
-  metadata.gz: c339580f9b229475d21752fa56bfcb90c7213c177dd83dc713220e1d872dbbe13ad690122abc5f4c620416a45bbda960c11dc355fe048b756ea5224259576647
-  data.tar.gz: 2f738e376dc5b147a8e3b4dcc71013fce20cc39b1ec24bbdac922080df327be7f8f743e860a62ee21ab6b935b0d9e7d23b48703adc1ccf274bf5ff713d4f90b3
+  metadata.gz: 8a5a7090df59bcf09e9bc2dc5cd2c60a7e774b7551b2cc7583d2eb1afdc5f6b3319ec911a8cce0130c0dc93679260ac83cf57e5c598b17c6d6ccb4ba229058ac
+  data.tar.gz: f6a2135e2ce480e7bce8f80eec8ab6e467c9e531ea10960470f2d2e7c3fb7325b84d3b9f256247255cd5c00220d21f53da8520c5b3e3045a6f446ce75f1600d8

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Legion Changelog
 
+## [1.4.95] - 2026-03-20
+
+### Added
+- `GET /api/prompts` — list all prompt templates via lex-prompt Client
+- `GET /api/prompts/:name` — show prompt details for the latest version
+- `POST /api/prompts/:name/run` — render a prompt template with variables and run it through Legion::LLM; returns rendered_prompt, response, usage, model, version
+- 503 guard for missing lex-prompt dependency (LoadError rescue in `prompt_client` helper)
+- 503 guard for LLM subsystem unavailable on the `/run` endpoint
+- 404 on prompt not found, 422 on version not found for `/run`
+- 32 new specs in `spec/legion/api/prompts_spec.rb` covering all routes and error paths
+
 ## [1.4.94] - 2026-03-20
 
 ### Added

data/lib/legion/api/prompts.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+module Legion
+  class API < Sinatra::Base
+    module Routes
+      module Prompts
+        def self.registered(app)
+          app.helpers do
+            define_method(:require_llm!) do
+              return if defined?(Legion::LLM) &&
+                        Legion::LLM.respond_to?(:started?) &&
+                        Legion::LLM.started?
+
+              halt 503, json_error('llm_unavailable', 'LLM subsystem is not available', status_code: 503)
+            end
+
+            define_method(:prompt_client) do
+              require 'legion/extensions/prompt/client'
+              Legion::Extensions::Prompt::Client.new
+            rescue LoadError
+              halt 503, json_error('prompt_unavailable', 'lex-prompt is not loaded', status_code: 503)
+            end
+          end
+
+          register_list(app)
+          register_show(app)
+          register_run(app)
+        end
+
+        def self.register_list(app)
+          app.get '/api/prompts' do
+            client = prompt_client
+            result = client.list_prompts
+            json_response(result)
+          rescue StandardError => e
+            Legion::Logging.error "API prompts list error: #{e.message}"
+            json_error('execution_error', e.message, status_code: 500)
+          end
+        end
+
+        def self.register_show(app)
+          app.get '/api/prompts/:name' do
+            name = params[:name]
+            client = prompt_client
+            result = client.get_prompt(name: name)
+
+            halt 404, json_error('not_found', "prompt '#{name}' not found", status_code: 404) if result[:error]
+
+            json_response(result)
+          rescue StandardError => e
+            Legion::Logging.error "API prompts show error: #{e.message}"
+            json_error('execution_error', e.message, status_code: 500)
+          end
+        end
+
+        def self.register_run(app)
+          app.post '/api/prompts/:name/run' do
+            require_llm!
+
+            name      = params[:name]
+            body      = parse_request_body
+            variables = body[:variables] || {}
+            version   = body[:version]
+            model     = body[:model]
+            provider  = body[:provider]
+
+            client = prompt_client
+            rendered = client.render_prompt(name: name, variables: variables, version: version)
+
+            if rendered[:error]
+              code = rendered[:error] == 'not_found' ? 404 : 422
+              halt code, json_error(rendered[:error], "prompt '#{name}' #{rendered[:error].tr('_', ' ')}", status_code: code)
+            end
+
+            session  = Legion::LLM.chat_direct(model: model, provider: provider)
+            response = session.ask(rendered[:rendered])
+
+            prompt_version = rendered[:prompt_version]
+            model_used     = session.model.to_s
+
+            usage = {
+              input_tokens:  response.respond_to?(:input_tokens) ? response.input_tokens : nil,
+              output_tokens: response.respond_to?(:output_tokens) ? response.output_tokens : nil
+            }
+
+            json_response({
+                            name:            name,
+                            version:         prompt_version,
+                            rendered_prompt: rendered[:rendered],
+                            response:        response.content,
+                            usage:           usage,
+                            model:           model_used,
+                            provider:        provider
+                          })
+          rescue StandardError => e
+            Legion::Logging.error "API prompts run error: #{e.message}"
+            json_error('execution_error', e.message, status_code: 500)
+          end
+        end
+
+        class << self
+          private :register_list, :register_show, :register_run
+        end
+      end
+    end
+  end
+end

data/lib/legion/api.rb

@@ -38,6 +38,7 @@ require_relative 'api/org_chart'
 require_relative 'api/workflow'
 require_relative 'api/governance'
 require_relative 'api/acp'
+require_relative 'api/prompts'
 
 module Legion
   class API < Sinatra::Base
@@ -120,6 +121,7 @@ module Legion
     register Routes::OrgChart
     register Routes::Governance
     register Routes::Acp
+    register Routes::Prompts
 
     use Legion::Rbac::Middleware if defined?(Legion::Rbac::Middleware)
 

data/lib/legion/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 1.4.94
+  version: 1.4.95
 platform: ruby
 authors:
 - Esity
@@ -379,6 +379,7 @@ files:
 - lib/legion/api/nodes.rb
 - lib/legion/api/openapi.rb
 - lib/legion/api/org_chart.rb
+- lib/legion/api/prompts.rb
 - lib/legion/api/rbac.rb
 - lib/legion/api/relationships.rb
 - lib/legion/api/schedules.rb