lex-agentic-language 0.1.10 → 0.1.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e44972f87bca2dccf617db64c48e8e3b99d2174bb45f1d21cd71a72a2489a59
-  data.tar.gz: 1e9fb62235879f874ef6c2ca07b6f58dc104fcc5fcb3d64591dcdf5d6477484f
+  metadata.gz: '0628d5ec05971b87c4538c364688f7bab530bdeebac624544f03a8e31b358c40'
+  data.tar.gz: a4f69abf5079a18fa17aa600ea42026097049309ad781700dfebe6f10b642719
 SHA512:
-  metadata.gz: aed85b23f9a856e2a26ac20bfdacd601c0ad09c8394f38bedb8195d28852fab393ee170b29d176109c83d6ab7cc426883270621c0bc629a7cab6244f94d38cc5
-  data.tar.gz: e57dbce2e2254462c9940b57b7dcac4b349e8edb3dad723e4c4d3c06bcc0dc6882cf6a4e52dfdb75bed12fdde5bd755f18c6e447c242fbd5d3fe4dcc42b5917b
+  metadata.gz: 500c995f74f282853e088ad87056f4a4fe444628d20a4aadd7536e9e42aadb01be1186e94cdecec3969a20b645649d07fbfbd22c3dfbdbd7f94724abc4e2e9b4
+  data.tar.gz: b083eab9bf653d1ed7f6117517d6ac8e5749d4a0b91e1d82340d356b7f815e25c23f5884c39aed549cee962550cf291bde1faf3becc82a746e5d99e42191ff6d

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.1.12] - 2026-06-01
+### Fixed
+- `SpeechStream#append` used `:"utt_#{@counter}"` (interpolated Symbol) causing unbounded Symbol allocation — changed to String ID
+- `Utterance#resolve_mode` and `#resolve_voice` called `to_sym` on arbitrary user input — replaced with safe string-based lookup returning only pre-existing constant Symbols
+- `InnerVoice#switch_voice` called `to_sym` on user input — added `resolve_voice` helper with same safe pattern
+- `CognitiveGrammar` runner called `.to_h` on nil when engine rejects invalid input — added nil guards returning structured error responses
+
+## [0.1.11] - 2026-05-07
+### Fixed
+- Narrator LLM enhancement now sends native chat message payloads with system/user roles while preserving legacy session fallback for older test doubles.
+- LLM narration state maps reflection `unacted_count` into pending adaptations.
+
 ## [0.1.10] - 2026-04-27
 ### Fixed
 - Narrator LLM enhancement now skips empty idle narration and rate-limits provider failure warnings without warning-level backtrace floods. Fixes #7

data/lib/legion/extensions/agentic/language/conceptual_blending/runners/conceptual_blending.rb

@@ -40,6 +40,8 @@ module Legion
               def create_blend(space_a_id:, space_b_id:, blend_type: :double_scope, **)
                 log.debug "[conceptual_blending] blend: a=#{space_a_id} b=#{space_b_id} type=#{blend_type}"
                 blend = engine.blend(space_a_id: space_a_id, space_b_id: space_b_id, blend_type: blend_type)
+                return { success: false, reason: :invalid_blend_type } unless blend
+
                 { success: true, blend: blend.to_h }
               rescue ArgumentError => e
                 log.debug "[conceptual_blending] blend failed: #{e.message}"

data/lib/legion/extensions/agentic/language/grammar/runners/cognitive_grammar.rb

@@ -17,6 +17,8 @@ module Legion
                   expression_type: expression_type,
                   domain:          domain
                 )
+                return { created: false, reason: :invalid_expression_type } unless construction
+
                 log.debug "[cognitive_grammar] created construction form=#{form} type=#{expression_type} domain=#{domain}"
                 construction.to_h
               end
@@ -34,6 +36,8 @@ module Legion
                   dynamicity:      dynamicity,
                   construction_id: construction_id
                 )
+                return { created: false, reason: :invalid_parameters } unless construal
+
                 log.debug "[cognitive_grammar] created construal scene=#{scene} figure=#{figure}"
                 construal.to_h
               end

data/lib/legion/extensions/agentic/language/inner_speech/helpers/inner_voice.rb

@@ -32,8 +32,8 @@ module Legion
               end
 
               def switch_voice(voice:)
-                sym = voice.to_sym
-                return nil unless VOICE_TYPES.include?(sym)
+                sym = resolve_voice(voice)
+                return nil unless sym
 
                 old_voice = @active_voice
                 @active_voice = sym
@@ -128,6 +128,14 @@ module Legion
 
               private
 
+              def resolve_voice(voice)
+                return voice if voice.is_a?(Symbol) && VOICE_TYPES.include?(voice)
+
+                voice_str = voice.to_s
+                index = VOICE_TYPES.map(&:to_s).index(voice_str)
+                index ? VOICE_TYPES[index] : nil
+              end
+
               def record_event(type, **details)
                 @history << { type: type, at: Time.now.utc }.merge(details)
                 @history.shift while @history.size > MAX_HISTORY

data/lib/legion/extensions/agentic/language/inner_speech/helpers/speech_stream.rb

@@ -21,7 +21,7 @@ module Legion
 
                 @counter += 1
                 utterance = Utterance.new(
-                  id:      :"utt_#{@counter}",
+                  id:      "utt_#{@counter}",
                   content: content,
                   mode:    mode,
                   **

data/lib/legion/extensions/agentic/language/inner_speech/helpers/utterance.rb

@@ -84,13 +84,19 @@ module Legion
               end
 
               def resolve_mode(mode)
-                sym = mode.to_sym
-                SPEECH_MODES.include?(sym) ? sym : :narrating
+                return mode if mode.is_a?(Symbol) && SPEECH_MODES.include?(mode)
+
+                mode_str = mode.to_s
+                index = SPEECH_MODES.map(&:to_s).index(mode_str)
+                index ? SPEECH_MODES[index] : :narrating
               end
 
               def resolve_voice(voice)
-                sym = voice.to_sym
-                VOICE_TYPES.include?(sym) ? sym : :rational
+                return voice if voice.is_a?(Symbol) && VOICE_TYPES.include?(voice)
+
+                voice_str = voice.to_s
+                index = VOICE_TYPES.map(&:to_s).index(voice_str)
+                index ? VOICE_TYPES[index] : :rational
               end
             end
           end

data/lib/legion/extensions/agentic/language/narrator/helpers/llm_enhancer.rb

@@ -51,16 +51,39 @@ module Legion
                     caller:  { extension: 'lex-agentic-language', mode: :narrator }
                   )
                   content = response&.message&.dig(:content)
-                  ::Struct.new(:content).new(content) if content
                 else
-                  chat = Legion::LLM.chat # rubocop:disable Legion/HelperMigration/DirectLlm
-                  chat.with_instructions(SYSTEM_PROMPT)
-                  chat.ask(prompt)
+                  response = Legion::LLM.chat( # rubocop:disable Legion/HelperMigration/DirectLlm
+                    message: [
+                      { role: 'system', content: SYSTEM_PROMPT },
+                      { role: 'user', content: prompt }
+                    ],
+                    caller:  { extension: 'lex-agentic-language', mode: :narrator }
+                  )
+                  content = extract_response_content(response, prompt)
                 end
+                ::Struct.new(:content).new(content) if content
               end
 
               private_class_method :llm_ask
 
+              def extract_response_content(response, prompt = nil)
+                return response.strip if response.is_a?(String)
+                return response.content if response.respond_to?(:content)
+
+                if response.respond_to?(:ask)
+                  response.with_instructions(SYSTEM_PROMPT) if response.respond_to?(:with_instructions)
+                  asked = response.ask(prompt)
+                  return extract_response_content(asked)
+                end
+                return nil unless response.is_a?(Hash)
+
+                response[:content] || response['content'] ||
+                  response.dig(:message, :content) || response.dig('message', 'content') ||
+                  response[:response] || response['response']
+              end
+
+              private_class_method :extract_response_content
+
               def pipeline_available?
                 !!(defined?(Legion::LLM::Pipeline::GaiaCaller) &&
                   Legion::LLM.respond_to?(:pipeline_enabled?) &&

data/lib/legion/extensions/agentic/language/narrator/runners/narrator.rb

@@ -187,7 +187,7 @@ module Legion
                 r = cognitive_state[:reflection] || {}
                 {
                   health:              r[:health] || 1.0,
-                  pending_adaptations: r[:pending_adaptations] || 0
+                  pending_adaptations: r[:pending_adaptations] || r[:unacted_count] || 0
                 }
               end
 

data/lib/legion/extensions/agentic/language/version.rb

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Language
-        VERSION = '0.1.10'
+        VERSION = '0.1.12'
       end
     end
   end

data/spec/legion/extensions/agentic/language/inner_speech/runners/inner_speech_spec.rb

@@ -11,7 +11,7 @@ RSpec.describe Legion::Extensions::Agentic::Language::InnerSpeech::Runners::Inne
     it 'creates an utterance' do
       result = host.inner_speak(content: 'testing', mode: :planning)
       expect(result[:success]).to be true
-      expect(result[:utterance_id]).to be_a(Symbol)
+      expect(result[:utterance_id]).to be_a(String)
       expect(result[:mode]).to eq(:planning)
     end
   end

data/spec/legion/extensions/agentic/language/narrator/helpers/llm_enhancer_spec.rb

@@ -49,27 +49,32 @@ RSpec.describe Legion::Extensions::Agentic::Language::Narrator::Helpers::LlmEnha
 
     context 'when LLM returns a response' do
       it 'returns the response content as a string' do
-        response_double = double('response', content: 'I feel alert and curious about what lies ahead.')
-        chat_double = double('chat')
-        allow(chat_double).to receive(:with_instructions)
-        allow(chat_double).to receive(:ask).and_return(response_double)
         llm_double = double('Legion::LLM', started?: true)
-        allow(llm_double).to receive(:chat).and_return(chat_double)
+        allow(llm_double).to receive(:chat).and_return(content: 'I feel alert and curious about what lies ahead.')
         stub_const('Legion::LLM', llm_double)
 
         result = described_class.narrate(sections_data: sections_data)
         expect(result).to be_a(String)
         expect(result).to eq('I feel alert and curious about what lies ahead.')
       end
+
+      it 'sends system instructions and user prompt in the native chat message payload' do
+        llm_double = double('Legion::LLM', started?: true)
+        allow(llm_double).to receive(:chat).and_return(content: 'native narrative')
+        stub_const('Legion::LLM', llm_double)
+
+        described_class.narrate(sections_data: sections_data)
+
+        expect(llm_double).to have_received(:chat)
+          .with(hash_including(message: array_including(hash_including(role: 'system'),
+                                                        hash_including(role: 'user'))))
+      end
     end
 
     context 'when LLM returns nil response' do
       it 'returns nil' do
-        chat_double = double('chat')
-        allow(chat_double).to receive(:with_instructions)
-        allow(chat_double).to receive(:ask).and_return(nil)
         llm_double = double('Legion::LLM', started?: true)
-        allow(llm_double).to receive(:chat).and_return(chat_double)
+        allow(llm_double).to receive(:chat).and_return(nil)
         stub_const('Legion::LLM', llm_double)
 
         result = described_class.narrate(sections_data: sections_data)
@@ -104,12 +109,8 @@ RSpec.describe Legion::Extensions::Agentic::Language::Narrator::Helpers::LlmEnha
 
     context 'with empty sections_data' do
       it 'does not raise and returns a string when LLM responds' do
-        response_double = double('response', content: 'Everything seems quiet.')
-        chat_double = double('chat')
-        allow(chat_double).to receive(:with_instructions)
-        allow(chat_double).to receive(:ask).and_return(response_double)
         llm_double = double('Legion::LLM', started?: true)
-        allow(llm_double).to receive(:chat).and_return(chat_double)
+        allow(llm_double).to receive(:chat).and_return(content: 'Everything seems quiet.')
         stub_const('Legion::LLM', llm_double)
 
         result = described_class.narrate(sections_data: {})

data/spec/legion/extensions/agentic/language/narrator/runners/narrator_spec.rb

@@ -33,6 +33,15 @@ RSpec.describe Legion::Extensions::Agentic::Language::Narrator::Runners::Narrato
     end
   end
 
+  describe 'reflection data for LLM narration' do
+    it 'maps reflection unacted_count to pending_adaptations' do
+      data = client.send(:llm_reflection_data, reflection: { health: 0.7, unacted_count: 3 })
+
+      expect(data[:health]).to eq(0.7)
+      expect(data[:pending_adaptations]).to eq(3)
+    end
+  end
+
   describe '#recent_entries' do
     before do
       5.times { |i| client.narrate(tick_results: { emotional_evaluation: { valence: i * 0.2 } }, cognitive_state: {}) }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-language
 version: !ruby/object:Gem::Version
-  version: 0.1.10
+  version: 0.1.12
 platform: ruby
 authors:
 - Esity