ask-agent 0.25.3 → 0.25.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec5991dad0128d2383500176d9872d4fda5ac504f81826eeac343a1b8435616b
-  data.tar.gz: f62dd7104119cd637c2ca590bc8c3e7c7c6c32e8f85d2d0e7e2cc2cbd2e8b019
+  metadata.gz: d6b698047e4a92d613f1d6f21b7c82ab46a02ee12886f9625913feb701b67b1a
+  data.tar.gz: 6f2bd64156cafdeea1b8bdbcaca0b5eca9470250e1f3e65ead20ea2f1098a451
 SHA512:
-  metadata.gz: 0ea8e0cf1e8750265f971b7379db7fddbc8c425d7f765835bc1d2b23e0fdf79001b2ceb93cc70e5647999e4327f6aa0ae3e56ed6708cdd8c66ea8e0006ddb039
-  data.tar.gz: bd758b33c296cd20fd90429d269fb079b5a1501b074c854d1dcfe27c007c2234b509693e7a136abf801738c775ed7c64894e2e2bc7c7414499f14ec2bbd6b416
+  metadata.gz: 76e12be0f0ab184371e8253f4abfa0f1f8c80106ea905050afc3a6d7d7a07df4a71230d4ed42a2309359327956022b6728edc4f0c50a8f2fdbfe9b2d39237abc
+  data.tar.gz: 99b18d89c18690ebb314a2e7871fc05bb4c0d79ced8e87c630de1fe6b558eb18954f253eafac80dfdda45bcc38e44efbd461cab0089c7813df37ca7da1899e5c

data/CHANGELOG.md

@@ -1,3 +1,22 @@
+## [0.25.5] - 2026-08-05
+
+### Changed
+
+- **`load_skill` tool moved to ask-skills.** Sessions now inject
+  `Ask::Skills::LoadSkillTool` (ask-skills owns discovery, listing, and
+  loading). No API change for session users — `skills_disclosure false`
+  still opts out of the auto-injected tool.
+
+## [0.25.4] - 2026-08-05
+
+### Added
+
+- **`skills_disclosure` opt-out for progressive skill disclosure.** Sessions
+  auto-inject the `load_skill` tool by default; agents with a fixed tool
+  surface (e.g. voice receptionists) can declare `skills_disclosure false`
+  in their definition (or pass `skills_disclosure: false` to
+  `Session.new`) to keep the tool payload minimal and deterministic.
+
 ## [0.25.3] - 2026-08-04
 
 ### Fixed

data/lib/ask/agent/definition.rb

@@ -92,6 +92,18 @@ module Ask
           end
         end
 
+        # Set or get the progressive skill disclosure flag. When enabled
+        # (default), sessions include the load_skill tool so the model can
+        # pull in skills on demand. Voice/UI agents with a fixed tool
+        # surface can disable it to keep the payload minimal.
+        def skills_disclosure(value = :__no_value__)
+          if value == :__no_value__
+            _config.key?(:skills_disclosure) ? _config[:skills_disclosure] : true
+          else
+            _config[:skills_disclosure] = value
+          end
+        end
+
         # Set an arbitrary Session option. Accepts any key that
         # Ask::Agent::Session.new understands.
         #

data/lib/ask/agent/session.rb

@@ -21,12 +21,14 @@ module Ask
                      compactor: nil, hooks: {}, state: nil, persistence: nil,
                      id: nil, system_prompt: nil, parallel_tools: true,
                      reflector: nil, telemetry: true, meta_agent: nil,
-                     agent_dir: nil, evaluator: nil, audit_log: nil, **chat_options)
+                     agent_dir: nil, evaluator: nil, audit_log: nil,
+                     skills_disclosure: true, **chat_options)
         @id = id || SecureRandom.uuid
         @agent_dir = agent_dir
         @max_turns = max_turns
         @max_tool_retries = max_tool_retries
         @parallel_tools = parallel_tools
+        @skills_disclosure = skills_disclosure
         @event_handlers = { all: [] }
         @running = false
         @deleted = false
@@ -356,13 +358,20 @@ module Ask
           tool.is_a?(Class) ? tool.new : tool
         end
         # Always include the load_skill tool for progressive skill disclosure,
-        # unless the test framework is loaded (test mode keeps tools deterministic)
-        unless defined?(Ask::Agent::Test) && Ask::Agent::Test
-          resolved << Skills::LoadSkillTool.new(registry: @skills_registry) unless resolved.any? { |t| t.name == "load_skill" }
+        # unless disabled by the agent (voice agents keep a minimal tool
+        # surface) or the test framework is loaded (test mode keeps tools
+        # deterministic)
+        if skills_disclosure_enabled?
+          resolved << Ask::Skills::LoadSkillTool.new(registry: @skills_registry) unless resolved.any? { |t| t.name == "load_skill" }
         end
         resolved
       end
 
+      # Whether progressive skill disclosure is active for this session.
+      def skills_disclosure_enabled?
+        @skills_disclosure && !(defined?(Ask::Agent::Test) && Ask::Agent::Test)
+      end
+
       def build_compactor(config)
         global = Ask::Agent.configuration
         compactor = Compactor.new(

data/lib/ask/agent/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Agent
-    VERSION = "0.25.3"
+    VERSION = "0.25.5"
   end
 end

data/lib/ask/agent.rb

@@ -170,6 +170,7 @@ module Ask
         session_opts[:provider] = config[:provider] if config[:provider]
         session_opts[:max_turns] = config[:max_turns] if config[:max_turns]
         session_opts[:parallel_tools] = config[:parallel_tools] if config.key?(:parallel_tools)
+        session_opts[:skills_disclosure] = config[:skills_disclosure] if config.key?(:skills_disclosure)
 
         # Pass arbitrary session options
         if config[:options]
@@ -260,7 +261,6 @@ require_relative "agent/configuration"
 require_relative "agent/meta_agent"
 require_relative "agent/persistence/base"
 require_relative "agent/persistence/in_memory"
-require_relative "agent/skills/load_skill_tool"
 require_relative "agent/scheduler"
 require_relative "agent/definition"
 require_relative "agent/cli"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-agent
 version: !ruby/object:Gem::Version
-  version: 0.25.3
+  version: 0.25.5
 platform: ruby
 authors:
 - Kaka Ruto
@@ -191,7 +191,6 @@ files:
 - lib/ask/agent/reflector.rb
 - lib/ask/agent/scheduler.rb
 - lib/ask/agent/session.rb
-- lib/ask/agent/skills/load_skill_tool.rb
 - lib/ask/agent/stream_transforms/base.rb
 - lib/ask/agent/stream_transforms/extract_json.rb
 - lib/ask/agent/stream_transforms/pipeline.rb

data/lib/ask/agent/skills/load_skill_tool.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-module Ask
-  module Agent
-    module Skills
-      # Built-in tool that lets the LLM load a discovered skill's full
-      # instructions on demand. Skills are listed by name and description
-      # via progressive disclosure — the LLM decides which to load.
-      #
-      # Usage by the LLM: call load_skill with the skill name.
-      class LoadSkillTool < Ask::Tool
-        description "Load the full instructions for a skill by name. Use this when a listed skill seems relevant to the current task."
-
-        param :name, type: :string, desc: "Name of the skill to load (e.g., writing-guide)", required: true
-
-        def initialize(registry:)
-          @registry = registry
-          super()
-        end
-
-        def execute(name:)
-          skill = @registry&.[](name)
-          unless skill
-            available = @registry&.names&.join(", ") || "none"
-            return Ask::Result.failure("Skill '#{name}' not found. Available skills: #{available}")
-          end
-
-          # Return the full skill content so it can be injected into conversation
-          content = "## Skill: #{skill.name}\n#{skill.description}\n\n#{skill.instructions}"
-          Ask::Result.ok(data: { name: skill.name, content: content })
-        end
-
-        def name
-          "load_skill"
-        end
-      end
-    end
-  end
-end