ask-core 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8cf33a5ee5e4a2e658e9e9b7244f0b368a188cb1a9a81d580003d7ed7f5bcb32
-  data.tar.gz: 4f0b398650815bde265b4becd15da23ae13f868ff06791b6a410e4c561775826
+  metadata.gz: b2d67418e2412efacf4d0b5c35d1897826f0da1c0a52c159f7503e8b794d66f1
+  data.tar.gz: 2b39ea638d11e5147058a1f35e3aa3c130650972082330e2dd30a752eeb68a36
 SHA512:
-  metadata.gz: 807a0ccb0851c2d1d51f4351072188f681c3356afbc74a477e4f795fc4c3456cf523b5d623f5d827bc5a76ab36d62e13348d13cba3298ddd6cd7822aa757814d
-  data.tar.gz: c9e02adf485410de34cbfbc8154a893aaffb2c5c72d618aeaeb6551d9a8c6482680683a5e5528a9f4e5398cef462bfd6018582e1021a1e70915b59277a8bc42d
+  metadata.gz: 8910e469a984ca9f2758dc816b6b13714b5985fad2dbb0910b2d2d0b5313ff04abfcffad06e3fcf2de4a53eb2d3e34fda1292150867bae39d476b5ad4a3551e4
+  data.tar.gz: 6ed636a7ed4b15f423b5914708064e44ac286e6488b87857d271646e83fad113b8dec97a1a7082e95bbd598d1ee2c631a77bffa0d03595ebd7d10db9a965b2ab

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [0.10.0] - 2026-08-05
+
+### Added
+
+- **`Ask::Result.pending`** — a new `:pending` status for async tool
+  execution. A tool returns pending to hand the turn back to the agent
+  (the interim message gets voiced) while the real work continues in the
+  background; the session completes it later. `Result#pending?` predicates
+  it; `to_h` keeps the tool shape.
+
 ## [0.9.0] — 2026-08-03
 
 ### Changed

data/lib/ask/result.rb

@@ -18,7 +18,7 @@ module Ask
   # Feature gems extend this class or build on it — they never redefine it.
   # See ask-docs "Architecture & ownership" for the rule.
   class Result
-    STATUSES = %i[success error aborted blocked short_circuited].freeze
+    STATUSES = %i[success error aborted blocked short_circuited pending].freeze
 
     class << self
       # @!group Factory Methods
@@ -55,6 +55,17 @@ module Ask
         new(content: reason, status: :blocked)
       end
 
+      # Create a pending result (async tool): the work continues in the
+      # background and the session completes it later via
+      # +Ask::Agent::Session#complete_pending_tool+. The agent voices the
+      # tool's interim message immediately and keeps talking.
+      # @param message [String] interim status the model can voice
+      # @param metadata [Hash] additional metadata
+      # @return [Ask::Result]
+      def pending(message, metadata: {})
+        new(content: message, status: :pending, metadata: metadata)
+      end
+
       # Create a successful result (tool API — alias for +success+).
       # @param data [Object] the tool's output
       # @param metadata [Hash] optional metadata
@@ -117,6 +128,9 @@ module Ask
     # @return [Boolean] true if the result is a success (tool API)
     def ok? = @status == :success
 
+    # @return [Boolean] true if the result is pending (async tool running)
+    def pending? = @status == :pending
+
     # @return [Boolean] true if the result is a success (tool API)
     def ok = @status == :success
 

data/lib/ask/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ask
-  VERSION = "0.9.0"
+  VERSION = "0.10.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-core
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Kaka Ruto