x_aeon_agents 2.0.4 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee491e3709d878a677bb2468858a77b652a8abb2252adee3360250fa97cfb124
-  data.tar.gz: f3931b321d6543788ce76f600497e752f68c02e37a5898840bf2cc691a1c091a
+  metadata.gz: 5f92902d46f24df17a53a218985801e0e9bf46a7f68baca87fc0f51bcc941409
+  data.tar.gz: e7f3821af21c86e308b690de3ca85943663a2e5fceed95a20cc361b7de595002
 SHA512:
-  metadata.gz: 30126b405563c4315ecdc3a02161c5194f98dca77198343b9818d99992a44c5b35a0f55526c42e75bd0b8216f46b381876f6f63e40cad44fcae92a76ef6af5f7
-  data.tar.gz: 732494caa45af12147985e009e5ee70553ed5621eaca5ad6dbedc97976d9f0ddd899efb8dc812f0e4b8ceb9e222feed3213146a9b8685bbeb96d63bb0e17b63c
+  metadata.gz: dbbf138ea84abc33f30b04c9bef997eae604ce88dbb572968a9198973e32b0f8be95d276047e0c60ddb53a0773badf70972e3d59faffb533ecb77eed421b6fac
+  data.tar.gz: 79e7d6a39eab32a6813f6f10af4cf09640032ca0f2a061b2727116b196e78574268ea055ab117e6890985b8997b6b2c503c94e6a32881f5004396c622114cc0c

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+# [v2.2.0](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.1.0...v2.2.0) (2026-10-26 12:38:46)
+
+### Features
+
+* [feat: add non-interactive answer fallback for agents](https://github.com/Muriel-Salvan/x_aeon_agents/commit/fc2e01beb4f7b88ae6a5ba97af5ca69422147632)
+
+# [v2.1.0](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.0.4...v2.1.0) (2026-10-22 13:25:41)
+
+## Global changes
+### Patches
+
+* [feat(skill-installer): add global skills installation support](https://github.com/Muriel-Salvan/x_aeon_agents/commit/165088bc2cbd077cb3ccd781c51d9a590cef0b80)
+
+## Changes for skill-installer
+### Features
+
+* [feat(skill-installer): add global skills installation support](https://github.com/Muriel-Salvan/x_aeon_agents/commit/165088bc2cbd077cb3ccd781c51d9a590cef0b80)
+
 # [v2.0.4](https://github.com/Muriel-Salvan/x_aeon_agents/compare/v2.0.3...v2.0.4) (2026-10-22 11:31:50)
 
 ### Patches

data/lib/x_aeon_agents/agent_defaults.rb

@@ -35,10 +35,16 @@ module XAeonAgents
     #
     # @param base [Class] The base class prepending this mixin
     def self.prepended(base)
-      base.prepend ComposableAgents::Mixins::ArtifactContract unless base.ancestors.include?(ComposableAgents::Mixins::ArtifactContract)
-      base.prepend ComposableAgents::Mixins::Resumable unless base.ancestors.include?(ComposableAgents::Mixins::Resumable)
+      mixins_to_prepend = [
+        ComposableAgents::Mixins::ArtifactContract,
+        ComposableAgents::Mixins::Resumable
+      ]
+      mixins_to_prepend << ComposableAgents::Mixins::UserInteraction if base.is_a?(ComposableAgents::Cline::Agent)
+      mixins_to_prepend << ComposableAgents::Mixins::AiAgentUserInteraction if base.is_a?(ComposableAgents::AiAgents::Agent)
+      mixins_to_prepend.each { |mixin| base.prepend mixin unless base.ancestors.include?(mixin) }
       # Make sure we always prepend at the top our initializer that sets all defaults
       base.prepend(
+        # TODO: Move this module into a dedicated mixin class and Ruby file.
         Module.new do
           # Constructor
           #
@@ -126,6 +132,20 @@ module XAeonAgents
               block&.call
             end
           end
+
+          # Answer an agent's question
+          #
+          # @param question [String] The agent's question
+          # @return [String] The answer that should be sent back to the agent
+          def answer_to(question)
+            if Config.interactive
+              super
+            else
+              'You are running in non-interactive mode, so no human user is available to answer this question. ' \
+                'Please continue using your best judgment and your existing knowledge to determine the most ' \
+                'appropriate answer, and proceed with the task without further user input.'
+            end
+          end
         end
       )
     end

data/lib/x_aeon_agents/agents/skill_installer_agent.rb

@@ -10,7 +10,13 @@ module XAeonAgents
       #
       # @return [Hash{Symbol => Object}] Set of input artifacts description, per artifact name
       def input_artifacts_contracts
-        { agent: 'Agent name to be used to install skills' }
+        {
+          agent: 'Agent name to be used to install skills',
+          global: {
+            description: 'Install skills globally instead of in the project',
+            optional: true
+          }
+        }
       end
 
       # Constructor
@@ -22,9 +28,10 @@ module XAeonAgents
 
       # Execute the agent to install skills from the .skills manifest.
       #
-      # @param agent [String] Agent name to be used to install skills
+      # @param agent [String, Symbol] Agent name to be used to install skills
+      # @param global [Boolean] Install skills globally (in the user home directory) instead of in the project
       # @return [Hash{Symbol => Object}] Output artifacts content
-      def run(agent: 'cline')
+      def run(agent: 'cline', global: false)
         super
         agent_name = agent.to_sym
         original_no_color = ENV.fetch('NO_COLOR', nil)
@@ -39,7 +46,8 @@ module XAeonAgents
           install_skills_recursive(
             repo_desc[4..].strip,
             skills_desc[12..].split(',').map(&:strip),
-            agent_name
+            agent_name,
+            global:
           )
         end
 
@@ -49,22 +57,34 @@ module XAeonAgents
 
       private
 
+      # Directory in which skills are installed for the given agent.
+      #
+      # @param _agent [Symbol] Agent to use
+      # @param global [Boolean] Whether skills are installed globally
+      # @return [String] Skills directory path
+      def skills_dir_for(_agent, global)
+        # TODO: Adapt to other kinds of agents, or get the directory from skillkit itself.
+        if global
+          File.join(Dir.home, '.cline', 'skills')
+        else
+          File.join(Dir.pwd, '.cline', 'skills')
+        end
+      end
+
       # Install skills using skillkit, including dependencies recursively.
       #
       # @param repo [String] Repository
       # @param skills [Array<String>] Skills to install
       # @param agent [Symbol] Agent to use
-      def install_skills_recursive(repo, skills, agent)
+      # @param global [Boolean] Whether skills are installed globally
+      def install_skills_recursive(repo, skills, agent, global: false)
         return if skills.empty?
 
-        agents_config = {
-          cline: { skills_dir: '.cline/skills' }
-        }
-        skills_dir = agents_config[agent][:skills_dir]
+        skills_dir = skills_dir_for(agent, global)
 
         task(:install_skills, name: 'Install skills', intent: "Install skills #{repo} / #{skills.join(',')}") do
-          Helpers.run_cmd("skillkit install #{repo} --yes --skills=#{skills.join(',')} --agent=#{agent}")
-          fix_skills_metadata(skills, agent)
+          Helpers.run_cmd("skillkit install #{repo} --yes --skills=#{skills.join(',')} --agent=#{agent}#{' --global' if global}")
+          fix_skills_metadata(skills, skills_dir)
 
           # Resolve dependencies
           deps_per_repo = {}
@@ -82,20 +102,17 @@ module XAeonAgents
             end
           end
 
-          deps_per_repo.each { |dep_repo, dep_skills| install_skills_recursive(dep_repo, dep_skills, agent) }
+          deps_per_repo.each { |dep_repo, dep_skills| install_skills_recursive(dep_repo, dep_skills, agent, global:) }
         end
       end
 
       # Fix the .skillkit.json subpath property after skillkit install.
       #
       # @param skills [Array<String>] Installed skills
-      # @param agent [Symbol] Agent used
-      def fix_skills_metadata(skills, agent)
+      # @param skills_dir [String] Directory in which skills are installed
+      def fix_skills_metadata(skills, skills_dir)
         require 'json'
 
-        agents_config = { cline: { skills_dir: '.cline/skills' } }
-        skills_dir = agents_config[agent][:skills_dir]
-
         skills.each do |skill_name|
           json_file = "#{skills_dir}/#{skill_name}/.skillkit.json"
           json = JSON.parse(File.read(json_file))

data/lib/x_aeon_agents/cli.rb

@@ -333,13 +333,16 @@ module XAeonAgents
         $   xaa install-skills
 
         $   xaa install-skills --agent cline
+
+        $   xaa install-skills --global
     LONGDESC
     option :agent, type: :string, default: 'cline', desc: 'Agent name to be used to install skills'
+    option :global, type: :boolean, default: false, desc: 'Install skills globally instead of in the project'
     # Installs skills and their dependencies from the .skills manifest.
     def install_skills
-      Agents::SkillInstallerAgent.new(session_id: options[:session_id]).run(
-        agent: options[:agent].to_sym
-      )
+      kwargs = { agent: options[:agent].to_sym }
+      kwargs[:global] = true if options[:global]
+      Agents::SkillInstallerAgent.new(session_id: options[:session_id]).run(**kwargs)
     end
 
     # --------------------------------------------------------------------------- #

data/lib/x_aeon_agents/version.rb

@@ -2,5 +2,5 @@ module XAeonAgents
   # @!group Global API
 
   # Gem version
-  VERSION = '2.0.4'
+  VERSION = '2.2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: x_aeon_agents
 version: !ruby/object:Gem::Version
-  version: 2.0.4
+  version: 2.2.0
 platform: ruby
 authors:
 - Muriel Salvan