ask-agent 0.25.3 → 0.25.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec5991dad0128d2383500176d9872d4fda5ac504f81826eeac343a1b8435616b
-  data.tar.gz: f62dd7104119cd637c2ca590bc8c3e7c7c6c32e8f85d2d0e7e2cc2cbd2e8b019
+  metadata.gz: 3703e22ceaf07962231c1cc08751e635d202a3dcb2bf7a0134ee3c1acbeeb975
+  data.tar.gz: d013b9b6a4d188dc71dd6c267388c1b36d83be5b43c0967d73b8cb10843d2123
 SHA512:
-  metadata.gz: 0ea8e0cf1e8750265f971b7379db7fddbc8c425d7f765835bc1d2b23e0fdf79001b2ceb93cc70e5647999e4327f6aa0ae3e56ed6708cdd8c66ea8e0006ddb039
-  data.tar.gz: bd758b33c296cd20fd90429d269fb079b5a1501b074c854d1dcfe27c007c2234b509693e7a136abf801738c775ed7c64894e2e2bc7c7414499f14ec2bbd6b416
+  metadata.gz: 7bf19be96f3344b84b0c8ee7c2079e3eb1ad0a2655c26e5075652a863f66c1c47816d6b4418ba3f29b79b3722e8cf924bedac9aa9965da4099009b4993877b7b
+  data.tar.gz: f214e8356c0e55be0aba092d81c0a0ac79d57b79abf41ce1f2e59db45a73a8ac51fcd0566d6335931a4d68292cba894b3240d4dbda4175c9238ba6f7fc7d4639

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [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
+        # 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 << 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.4"
   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]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-agent
 version: !ruby/object:Gem::Version
-  version: 0.25.3
+  version: 0.25.4
 platform: ruby
 authors:
 - Kaka Ruto