lex-agentic-language 0.1.8 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b04c9da9a6fcda5c086ee1e27fd8c2a2007faa556737be3d88219a2e505663ba
-  data.tar.gz: fa94cc1d6fda5c3b9fe38a2e6aa9254ee238a9af4f2f3802aeeb94813e98f352
+  metadata.gz: 2388849ad378d8489580d4638dc181111798e6ce0a153e99fe40f2c441152b96
+  data.tar.gz: 05c2295ad8bf6a17e2592cce376b6c15408c4bf5f0a35786cdfe650ecd50ffa1
 SHA512:
-  metadata.gz: 0b08cdd7dc45ec57422597aa41d7a75a6c375b4f5f70cacc8a6abfcb14e6326528dda67ec4c6392596cfcd19b05fdd0bf244cb8a48b3be3d7d84921e5e38b453
-  data.tar.gz: 59f6320175d8e48918b8d45ff9e3b8ea25796205f5d23703d12a978bd722441f48d1f91253178f237b9cde97aad458478eb06de288f1913489775a9934ea7089
+  metadata.gz: 4b68a01ec6173f4ad3bcb486ed33c9ffe87c269da569c6615e49d96366f79a6f997a1265827f511343a735f15cfdc3464f032a0a9db825556b6b38d2519af96d
+  data.tar.gz: 9baccb232491d12120647c84aa5aaae42a2936f2aec7f83b681fab2226af871f13433277c964fc612afbef07c17275e4c2a5231168f2f158545658d07469e5b1

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.1.9] - 2026-04-22
+### Added
+- InnerSpeech::Actor::DecayInnerSpeech (60s) — first actor in the extension, enables autonomous salience decay
+### Fixed
+- LlmEnhancer `available?` now logs errors at debug level instead of swallowing silently
+- Documented PragmaticInference::Utterance vs InnerSpeech::Utterance schema distinctions
+
 ## [0.1.8] - 2026-04-15
 ### Changed
 - Set `mcp_tools?`, `mcp_tools_deferred?`, and `transport_required?` to `false` — internal cognitive pipeline extension

data/README.md

@@ -1,26 +1,50 @@
 # lex-agentic-language
 
-Domain consolidation gem for language processing and communication. Bundles 9 source extensions into one loadable unit under `Legion::Extensions::Agentic::Language`.
+Domain consolidation gem for language processing and communication. Bundles 9 sub-modules into one loadable unit under `Legion::Extensions::Agentic::Language`.
 
 ## Overview
 
 **Gem**: `lex-agentic-language`
-**Version**: 0.1.8
+**Version**: 0.1.9
 **Namespace**: `Legion::Extensions::Agentic::Language`
 
 ## Sub-Modules
 
-| Sub-Module | Source Gem | Purpose |
-|---|---|---|
-| `Language::Language` | `lex-language` | Core language processing — token parsing, semantic framing, pragmatic intent |
-| `Language::Grammar` | `lex-cognitive-grammar` | Grammatical structure processing |
-| `Language::InnerSpeech` | `lex-inner-speech` | Vygotsky inner speech — private verbal thought for problem solving |
-| `Language::Narrator` | `lex-narrator` | Real-time narrative stream of internal state (optional LLM enhancement) |
-| `Language::NarrativeReasoning` | `lex-narrative-reasoning` | Narrative as a reasoning mode — story-schema activation |
-| `Language::FrameSemantics` | `lex-frame-semantics` | Fillmore frame semantics — conceptual frames, slots, fillers |
-| `Language::PragmaticInference` | `lex-pragmatic-inference` | Gricean maxims and conversational implicature |
-| `Language::ConceptualBlending` | `lex-conceptual-blending` | Fauconnier & Turner — emergent blended structure from two input spaces |
-| `Language::ConceptualMetaphor` | `lex-conceptual-metaphor` | Lakoff & Johnson — structural mappings between conceptual domains |
+| Sub-Module | Purpose |
+|---|---|
+| `Language::Language` | Core language processing — token parsing, semantic framing, pragmatic intent |
+| `Language::Grammar` | Grammatical construction processing (construal, construction, grammar engine) |
+| `Language::InnerSpeech` | Vygotsky inner speech — private verbal thought for problem solving |
+| `Language::Narrator` | Real-time narrative stream of internal state (optional LLM enhancement) |
+| `Language::NarrativeReasoning` | Narrative as a reasoning mode — story-schema activation |
+| `Language::FrameSemantics` | Fillmore frame semantics — conceptual frames, slots, fillers |
+| `Language::PragmaticInference` | Gricean maxims and conversational implicature |
+| `Language::ConceptualBlending` | Fauconnier & Turner — emergent blended structure from two input spaces |
+| `Language::ConceptualMetaphor` | Lakoff & Johnson — structural mappings between conceptual domains |
+
+## Actors
+
+- `Language::InnerSpeech::Actor::DecayInnerSpeech` — every 60s, decays utterance salience in the inner voice stream via `update_inner_speech`
+
+This is the first actor added to this gem. Without it the inner speech stream grows indefinitely.
+
+## Quick Usage
+
+```ruby
+require 'legion/extensions/agentic/language'
+
+# Use the InnerSpeech runner
+include Legion::Extensions::Agentic::Language::InnerSpeech::Runners::InnerSpeech
+
+inner_speak(content: "Should I accept this task?", mode: :questioning, topic: :task_eval)
+# => { success: true, utterance_id: "...", mode: :questioning }
+
+inner_plan(content: "First verify the input, then transform")
+# => { success: true, utterance_id: "..." }
+
+recent_inner_speech(count: 3)
+# => { success: true, utterances: [...], count: 3 }
+```
 
 ## Installation
 
@@ -32,8 +56,8 @@ gem 'lex-agentic-language'
 
 ```bash
 bundle install
-bundle exec rspec        # 735 examples, 0 failures
-bundle exec rubocop      # 0 offenses
+bundle exec rspec
+bundle exec rubocop
 ```
 
 ## License

data/lib/legion/extensions/agentic/language/inner_speech/actors/decay_inner_speech.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/actors/every'
+
+module Legion
+  module Extensions
+    module Agentic
+      module Language
+        module InnerSpeech
+          module Actor
+            # DecayInnerSpeech runs every 60 seconds and ticks the inner voice stream,
+            # decaying the salience of all queued utterances.  Without this actor the
+            # stream would grow indefinitely and old utterances would remain at full
+            # salience, distorting urgency calculations.
+            #
+            # Delegates to Runners::InnerSpeech#update_inner_speech, which calls
+            # InnerVoice#tick → SpeechStream#decay_all.
+            class DecayInnerSpeech < Legion::Extensions::Actors::Every
+              time 60
+
+              def runner_class
+                Legion::Extensions::Agentic::Language::InnerSpeech::Runners::InnerSpeech
+              end
+
+              def runner_function
+                'update_inner_speech'
+              end
+
+              def run_now?
+                false
+              end
+
+              def use_runner?
+                false
+              end
+
+              def check_subtask?
+                false
+              end
+
+              def generate_task?
+                false
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,5 +1,16 @@
 # frozen_string_literal: true
 
+# InnerSpeech::Helpers::Utterance — represents a single token of inner-voice activity.
+#
+# Key fields: mode (narrating/planning/questioning/…), voice (rational/bold/cautious/…),
+# urgency (0–1), salience (0–1, subject to temporal decay via #decay_salience!).
+# Salience decays over time via the InnerSpeech decay actor (every 60 s), which calls
+# Runners::InnerSpeech#update_inner_speech → InnerVoice#tick → SpeechStream#decay_all.
+#
+# Compare with PragmaticInference::Helpers::Utterance, which models an external
+# communicative act scored against Gricean maxims with implicature accumulation.
+# That class carries NO urgency, salience, or decay logic.
+
 module Legion
   module Extensions
     module Agentic

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

@@ -16,9 +16,15 @@ module Legion
 
               module_function
 
+              def log
+                Legion::Logging
+              end
+              private_class_method :log
+
               def available?
                 !!(defined?(Legion::LLM) && Legion::LLM.respond_to?(:started?) && Legion::LLM.started?)
-              rescue StandardError => _e
+              rescue StandardError => e
+                log.debug("[narrator:llm] available? check failed: #{e.class}: #{e.message}")
                 false
               end
 
@@ -27,8 +33,8 @@ module Legion
                 response = llm_ask(prompt)
                 parse_narrate_response(response)
               rescue StandardError => e
-                Legion::Logging.warn("[narrator:llm] narrate failed: #{e.message}") # rubocop:disable Legion/HelperMigration/DirectLogging
-                Legion::Logging.warn(e.backtrace) # rubocop:disable Legion/HelperMigration/DirectLogging
+                log.warn("[narrator:llm] narrate failed: #{e.message}")
+                log.warn(e.backtrace)
                 nil
               end
 
@@ -57,7 +63,7 @@ module Legion
                   Legion::LLM.respond_to?(:pipeline_enabled?) &&
                   Legion::LLM.pipeline_enabled?)
               rescue StandardError => e
-                Legion::Logging.warn("pipeline_available? #{e.class}: #{e.message}") # rubocop:disable Legion/HelperMigration/DirectLogging
+                log.warn("[narrator:llm] pipeline_available? #{e.class}: #{e.message}")
                 false
               end
 

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

@@ -1,5 +1,15 @@
 # frozen_string_literal: true
 
+# PragmaticInference::Helpers::Utterance — represents a single communicative act
+# evaluated through Gricean maxims (quantity, quality, relation, manner).
+#
+# Key fields: speaker, speech_act, literal_meaning, maxim_scores, implicatures, confidence.
+# Maxim compliance is scored per-maxim and aggregated via #overall_compliance.
+# Violations and implicatures are accumulated after construction via mutation methods.
+#
+# Compare with InnerSpeech::Helpers::Utterance, which models inner-voice tokens
+# (mode, urgency, salience, decay) and carries NO maxim or implicature logic.
+
 require 'securerandom'
 
 module Legion

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Language
-        VERSION = '0.1.8'
+        VERSION = '0.1.9'
       end
     end
   end

data/spec/legion/extensions/agentic/language/inner_speech/actors/decay_inner_speech_spec.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# Stub the base class before loading the actor so the spec can run in isolation
+# without requiring the full Legion framework.
+#
+# The stub must support the `time` DSL accessor used by Every actors: a class-level
+# setter (time 60) and an instance-level reader that delegates to the class method.
+module Legion
+  module Extensions
+    module Actors
+      class Every
+        def self.time(val = :_unset)
+          if val == :_unset
+            @time || 1
+          else
+            @time = val
+          end
+        end
+
+        def time
+          self.class.time
+        end
+      end
+    end
+  end
+end
+
+$LOADED_FEATURES << 'legion/extensions/actors/every'
+
+require_relative '../../../../../../../lib/legion/extensions/agentic/language/inner_speech/actors/decay_inner_speech'
+
+RSpec.describe Legion::Extensions::Agentic::Language::InnerSpeech::Actor::DecayInnerSpeech do
+  subject(:actor) { described_class.new }
+
+  describe '#runner_class' do
+    it do
+      expect(actor.runner_class).to eq(
+        Legion::Extensions::Agentic::Language::InnerSpeech::Runners::InnerSpeech
+      )
+    end
+  end
+
+  describe '#runner_function' do
+    it { expect(actor.runner_function).to eq 'update_inner_speech' }
+  end
+
+  describe '#time' do
+    it { expect(actor.time).to eq 60 }
+  end
+
+  describe '#run_now?' do
+    it { expect(actor.run_now?).to be false }
+  end
+
+  describe '#use_runner?' do
+    it { expect(actor.use_runner?).to be false }
+  end
+
+  describe '#check_subtask?' do
+    it { expect(actor.check_subtask?).to be false }
+  end
+
+  describe '#generate_task?' do
+    it { expect(actor.generate_task?).to be false }
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-language
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.9
 platform: ruby
 authors:
 - Esity
@@ -208,6 +208,7 @@ files:
 - lib/legion/extensions/agentic/language/grammar/runners/cognitive_grammar.rb
 - lib/legion/extensions/agentic/language/grammar/version.rb
 - lib/legion/extensions/agentic/language/inner_speech.rb
+- lib/legion/extensions/agentic/language/inner_speech/actors/decay_inner_speech.rb
 - lib/legion/extensions/agentic/language/inner_speech/client.rb
 - lib/legion/extensions/agentic/language/inner_speech/helpers/constants.rb
 - lib/legion/extensions/agentic/language/inner_speech/helpers/inner_voice.rb
@@ -266,6 +267,7 @@ files:
 - spec/legion/extensions/agentic/language/grammar/helpers/construction_spec.rb
 - spec/legion/extensions/agentic/language/grammar/helpers/grammar_engine_spec.rb
 - spec/legion/extensions/agentic/language/grammar/runners/cognitive_grammar_spec.rb
+- spec/legion/extensions/agentic/language/inner_speech/actors/decay_inner_speech_spec.rb
 - spec/legion/extensions/agentic/language/inner_speech/client_spec.rb
 - spec/legion/extensions/agentic/language/inner_speech/helpers/inner_voice_spec.rb
 - spec/legion/extensions/agentic/language/inner_speech/helpers/speech_stream_spec.rb