ask-tools 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7672f4d067288ae4d37530eb3884b818355d6a3aeaaefc14594224e7c4794b9d
-  data.tar.gz: fe3d5ba56939e98775c4e80edec495d40d14fb8bd6d71b2d594d9a3484fc0d13
+  metadata.gz: fddd3e7a3998f538e21fddf3f9323ec7b969a897db7ecee939f5e5c19fef7531
+  data.tar.gz: 4646d45de5d280fc9679d2d0602e5d0ba1af40e5b130e65746c9cf119ab12010
 SHA512:
-  metadata.gz: '08a09910d9ace8bbdb32640e3049e30bbefb8fd6a18ea4594f000441b71029815ad0bf9ef22e2ef0c9da727de29f2f1ee3d3aa99f6ac1162a6a7987270384b2e'
-  data.tar.gz: dc70926d230847a1a6d114986c8042cc8a91fc7f9ce448b0354d19f6d613906287ff0fd777d0dd737ade6e5fcf693376a8ab4125e6b7102c703bc681a24ede35
+  metadata.gz: a6193699fc8993e5c3d9ba529af162744237b16234ea5ffb8aa3e35563b3b8ad605b01ba1b223c4ceb8ffb4a7ba500addad2efc6a817e787506c54dd4b7ebf75
+  data.tar.gz: 8352c90b852053fd97e5470d9e1d207c1ddbdc2d3f7b4b1db42ac399ec530aed51a5baedc35503dabcf0a7452ee27a6267900c4d34f251e25f2f481f803c5b87

data/CHANGELOG.md

@@ -0,0 +1,47 @@
+## [0.2.2] - 2026-06-23
+
+### Fixed
+
+- Added `ask-schema` as a runtime dependency in gemspec. The `tool.rb` already
+  required `ask-schema` but it wasn't declared, causing `LoadError` for consumers
+  installing from Rubygems without local path resolution.
+
+## [0.2.0] - 2026-06-21
+
+### Added
+
+- Gemspec metadata for Rubygems discovery
+- CHANGELOG.md included in gem files list
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2026-06-09
+
+### Added
+
+- `Ask::Tool` base class with DSL for declaring `description` and `param`
+- Auto-derived tool names from class names (CamelCase → snake_case, strips `_tool`)
+- `Ask::Result` value object with `ok?`, `output`, `error`, `metadata` and factory methods `ok(data:)`, `error(message:)`
+- JSON Schema generation via `params_schema` and `tool_definition` for LLM function-calling APIs
+- `Ask::Tools` module for tool registration, auto-discovery via `ObjectSpace`, and name-based lookup
+- `Ask::Tool::Halt` for stopping conversation loops
+- `Ask::Tool::Parameter` value object for parameter metadata
+- Comprehensive test suite with 54+ tests using Minitest and Mocha
+
+## [0.1.3] - 2026-06-18
+
+### Added
+
+- Class-level `params_schema` method mirroring the instance method. `ToolDef.from_tool`
+  calls `tool.params_schema` on the object it receives, which may be a Class (not an
+  instance). The instance method existed but there was no class-level equivalent,
+  causing `NoMethodError: undefined method 'params_schema' for class` when dynamic
+  tool classes were passed directly to `ToolDef.from_tool`.
+
+### Tests
+
+- Added `tool_schema_test.rb` (8 tests, 27 assertions) covering class-level
+  `params_schema` for the params DSL, hash schema, empty schema, instance/class
+  equivalence, dynamic tool classes, and parameter metadata.

data/README.md

@@ -1,6 +1,6 @@
 # ask-tools
 
-The foundational gem for the ask-rb ecosystem. Defines `Ask::Tool` — the base class every tool inherits from — along with `Ask::Result` (standardized return value), tool discovery/registration, and a scaffold generator. **Zero external dependencies.**
+The foundational gem for the ask-rb ecosystem. Defines `Ask::Tool` — the base class every tool inherits from — along with `Ask::Result` (standardized return value), tool discovery/registration, and a scaffold generator.
 
 This gem does **not** ship any executable tools. It only provides the contract that tool gems (e.g., `ask-tools-shell`, `ask-tools-filesystem`) implement.
 

data/lib/ask/tools/result.rb

@@ -40,6 +40,15 @@ module Ask
       new(ok: true, output: data, error: nil, metadata: metadata)
     end
 
+    # Create a failed result (positional message form, used by Tool#call).
+    #
+    # @param message [String] description of the failure
+    # @param metadata [Hash] optional metadata
+    # @return [Ask::Result]
+    def self.failure(message, metadata: {})
+      new(ok: false, output: nil, error: message, metadata: metadata)
+    end
+
     # Create a failed result.
     #
     # @param message [String] description of the failure

data/lib/ask/tools/tool.rb

@@ -114,7 +114,7 @@ module Ask
     end
 
     def name
-      klass_name = self.class.name.to_s || ""
+      klass_name = self.class.name.to_s.split("::").last || ""
       normalized = klass_name.dup.force_encoding("UTF-8").unicode_normalize(:nfkd)
       normalized.encode("ASCII", replace: "")
                 .gsub(/[^a-zA-Z0-9_-]/, "-")
@@ -138,15 +138,15 @@ module Ask
       return Ask::Result.failure(validation) if validation
       normalized[:_abort_controller] = abort_controller if abort_controller
       execute(**normalized)
-    rescue Halt => e
-      Ask::Result.ok(data: e.content, metadata: { halted: true })
-    rescue StandardError => e
-      Ask::Result.failure("#{self.class.name.split('::').last} raised #{e.class}: #{e.message}")
-    end
+      rescue Halt => e
+        Ask::Result.ok(data: e.content, metadata: { halted: true })
+      rescue StandardError => e
+        Ask::Result.failure("#{self.class.name.split('::').last} raised #{e.class}: #{e.message}")
+      end
 
       def execute(**args)
-      raise NotImplementedError, "#{self.class} must implement #execute(**args)"
-    end
+        raise NotImplementedError, "#{self.class} must implement #execute(**args)"
+      end
 
     def params_schema
       return @params_schema if defined?(@params_schema)

data/lib/ask/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Tools
-    VERSION = "0.2.0"
+    VERSION = "0.2.2"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-tools
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Kaka Ruto
@@ -9,6 +9,20 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: ask-schema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -51,14 +65,14 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
-description: Defines Ask::Tool (base class), Ask::Result, and tool discovery. Zero
-  dependencies.
+description: Defines Ask::Tool (base class), Ask::Result, and tool discovery.
 email:
 - kaka@myrrlabs.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
 - lib/ask-tools.rb
@@ -69,7 +83,10 @@ files:
 homepage: https://github.com/ask-rb/ask-tools
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/ask-rb/ask-tools
+  source_code_uri: https://github.com/ask-rb/ask-tools
+  changelog_uri: https://github.com/ask-rb/ask-tools/blob/master/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib