ask-tools 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7672f4d067288ae4d37530eb3884b818355d6a3aeaaefc14594224e7c4794b9d
-  data.tar.gz: fe3d5ba56939e98775c4e80edec495d40d14fb8bd6d71b2d594d9a3484fc0d13
+  metadata.gz: 11f1c3c00fd6ac3f248ef34d23c4073110d6918669103a90bc2aeaacc1d2a622
+  data.tar.gz: d2e1d7153711d7415482956b428542b00514120a066754aa4c9570a77e065f3b
 SHA512:
-  metadata.gz: '08a09910d9ace8bbdb32640e3049e30bbefb8fd6a18ea4594f000441b71029815ad0bf9ef22e2ef0c9da727de29f2f1ee3d3aa99f6ac1162a6a7987270384b2e'
-  data.tar.gz: dc70926d230847a1a6d114986c8042cc8a91fc7f9ce448b0354d19f6d613906287ff0fd777d0dd737ade6e5fcf693376a8ab4125e6b7102c703bc681a24ede35
+  metadata.gz: af1f45a7d1ef8aa089304a43a0196243441b31344fdcf47f45ff05c2265e506b1aa8072e82c7c8d8891f4dae17012fd2259a60e801b0b0371f178fb5151b92b8
+  data.tar.gz: 38df1b93e7a8be8f9b9ffac741db0e5a08f68529a450fd832d1f8b100b7713753c8816f51e36ee2d2fe4b0798bd2a0276de8a5b0efdc36827143b97a44432a39

data/CHANGELOG.md

@@ -0,0 +1,40 @@
+## [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
+- Zero runtime dependencies — stdlib only
+
+## [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/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.1"
   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.1
 platform: ruby
 authors:
 - Kaka Ruto
@@ -59,6 +59,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - LICENSE
 - README.md
 - lib/ask-tools.rb
@@ -69,7 +70,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