ask-tools 0.2.6 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10504b125a562dba192ed5c432608b54e3140ea5f38822e5e045a1f8546f7609
-  data.tar.gz: afd13e8a2a242e095ac71bc7c9f02cac14931e3966664dd6e3a88995869f6840
+  metadata.gz: 0e0b16a246eee9282788e5ec82210cacc6a507d83591645aca2ce87d17e0e129
+  data.tar.gz: 546cf192269daacbbf48e7e1fe4a188ad42d3e5f8e9e50ccaeb3d96ca24803be
 SHA512:
-  metadata.gz: 1bdeed01d810365cb450ec8548ee6815718e51df479de5f8ef9ea6105cfd97ce31e872eaec98b93e4be36ac67368dcaf726b96b343fa7d393d42dcb73cb5c9cd
-  data.tar.gz: b9ed6b94f72cd3ec96a18faac67ae85e9f4593859069f216632d8a8f78111b432680ca8bbc19f736f4ed5c0976b913d9b2afdeb6ec2ed46e88516e859db9b57e
+  metadata.gz: 9b6cab4332f8f76e36ccfe1024976578d739258125cdad49567cc9eb0ab21334bff1b28a5c61aee3bdaf21d375e9ac5d78ae2f248f717b1d6c942a0d75b8a51c
+  data.tar.gz: 9a08ac4432817ceb9917f1490a2e1b5c0905609feac8181b9de4404097c1b366b185cd653315e116cf658a655ee48089dec662ce1e5b611024feb0fcde4f2660

data/CHANGELOG.md

@@ -1,3 +1,61 @@
+## [0.4.0] — 2026-07-26
+
+### Added
+
+- **`name` class DSL for custom tool names** — tools can now declare a
+  custom name with `name "my_tool"` at the class level instead of
+  overriding `def name`. The class method safely shadows `Module#name`
+  by detecting arguments: `ClassName.name` returns the Ruby class path,
+  `name "foo"` sets the tool name. Instance `#name` returns the custom
+  name if set, otherwise auto-derives from the class name.
+
+### Removed
+
+- **`Ask::Tools::SubAgent`** — removed in favor of `Ask::Agent::SubAgent`
+  in ask-agent v0.18.0. Sub-agent delegation now lives in the agent
+  runtime where it can automatically build sessions.
+
+## [0.3.0] — 2026-07-26
+
+### Added
+
+- **`Ask::Tools::SubAgent` — delegate tasks to a specialized sub-agent tool**.
+  An `Ask::Tool` subclass that wraps a runner callable. When the LLM calls it,
+  the sub-agent runs independently with its own model, tools, and instructions.
+
+  The tool supports per-instance `name:` and `description:` overrides so that
+  multiple sub-agents can coexist in the same tool list with distinct identities.
+
+  ```ruby
+  search = Ask::Tools::SubAgent.new(
+    name: "web_search",
+    description: "Search the web for current information",
+    runner: ->(task) {
+      Ask::Agent::Session.new(model: "gpt-4o-mini", tools: [Search])
+        .run(task).to_s
+    }
+  )
+  ```
+
+### Fixed
+
+- **Tool discovery no longer breaks on tools with required constructor args**.
+  `Ask::Tools::SubAgent` makes its `runner:` parameter optional so that tool
+  discovery (which instantiates via `klass.new`) works without error. An
+  unconfigured SubAgent returns a clear error message at call time.
+
+## [0.2.6] — 2026-07-18
+
+### Fixed
+
+- **`Tool#call` filters `_abort_controller` before passing to `execute`** — The internal `_abort_controller` key was being passed as a keyword argument to tool `execute` methods. Tools with explicit keyword arguments (e.g., `def execute(title:, extraction_scope:)`) crashed with `ArgumentError: unknown keyword` because they didn't accept `_abort_controller`. Now filtered before the `execute(**kwargs)` call.
+
+## [0.2.5] — 2026-07-18
+
+### Fixed
+
+- **`Tool#normalize_args` parses JSON string arguments from LLMs** — Tool call arguments arrive as JSON strings from the LLM, but `normalize_args` only handled Hash arguments. JSON strings were silently ignored, returning an empty args hash and causing "missing required parameters" errors. Now parses JSON strings before normalizing keys to symbols.
+
 ## [0.2.4] - 2026-06-25
 
 ### Changed

data/lib/ask/tools/tool.rb

@@ -20,6 +20,7 @@ module Ask
         subclass.instance_variable_set(:@description, nil)
         subclass.instance_variable_set(:@parameters, {})
         subclass.instance_variable_set(:@params_schema_definition, nil)
+        subclass.instance_variable_set(:@tool_name, nil)
       end
 
       def description(text = nil)
@@ -28,6 +29,18 @@ module Ask
       end
       alias desc description
 
+      # Declare a custom tool name.
+      # Called with no argument returns the class name (via Module#name).
+      # Called with a string stores a custom name for the instance.
+      # Example: name "my_custom_tool"
+      def name(custom = :_no_arg_given)
+        if custom == :_no_arg_given
+          super()  # Module#name, returns the Ruby class path
+        else
+          @tool_name = custom
+        end
+      end
+
       def param(name, type:, desc: nil, description: nil, required: true)
         type = type.to_s.downcase.to_sym
         validate_param_type!(type, name)
@@ -115,6 +128,9 @@ module Ask
     end
 
     def name
+      custom = self.class.instance_variable_get(:@tool_name)
+      return custom if custom
+
       klass_name = self.class.name.to_s.split("::").last || ""
       normalized = klass_name.dup.force_encoding("UTF-8").unicode_normalize(:nfkd)
       normalized.encode("ASCII", replace: "")

data/lib/ask/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Tools
-    VERSION = "0.2.6"
+    VERSION = "0.4.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-tools
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.4.0
 platform: ruby
 authors:
 - Kaka Ruto