ask-agent 0.40.28 → 0.40.29

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af8d2bd0d675ffdced29db02c1a37c4fc9c3ca96e8b051b5ebed5f55fd07433f
-  data.tar.gz: c84dc5c902cf4cef1c301c556123b7f435b16b257b68cd7ed1595708dfe836c9
+  metadata.gz: b55a3e7db1b87fa2e915014f6e8a787b24fe60df99602b14b95da3bb06fdf3a5
+  data.tar.gz: 57017799b4dfb6ab2f842212ba9eed1321bcd61c3872b92a5347a85e98f5ace7
 SHA512:
-  metadata.gz: f4fca625ea3ab60981b20319e7451a3b18222cdf5d7c40f3b68bde5e7642091f1e645404430f6c96d52655707363bf86f385642e1c37b602b4c0b6934040067f
-  data.tar.gz: 3be6afd9ec87a5550bc3a276be875e61e7cb1aa4998ab0d88c1081fe970538e16a668a3625fe1b5ee1aff451fa07d9e60f79951fd3114f0ab80ec0b2e2382792
+  metadata.gz: ef7705c41d359caed21b9424f09ec1aaf6164b3f0d773b78fdbfe0173a7f56dc1bff0af819d6aedb237fb45bdf990246282c2bfa4e1a64864df2d639f6c6d8e3
+  data.tar.gz: '08aed23b7e951f35182a683d52ae2c67d534fb2ccf97d2c1a6fc99ec505e49ce88be55225b9250eae6a1fb8d18e6aaaeb17994cb0ddf11b207a9a34fa14231c9'

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+### Added
+
+- **`Session#run(runtime_event_sink:)` forwards ask-runtime tool lifecycle events** through the agent loop and recursive turns to `ToolExecutor#execute_batch`.
+
 ### Fixed
 
 - **`SessionAdapter.resume` surfaces every ask-session miss as

data/README.md

@@ -34,6 +34,24 @@ session.on_event do |event|
 end
 ```
 
+To also record provider-neutral ask-runtime tool lifecycle events, pass an
+event sink to `Session#run`. For example, when using ask-session:
+
+```ruby
+require "ask-session"
+
+host = Ask::Session::Host.new
+host.create(id: session.id)
+runtime_sink = host.sink(session.id)
+session.run("What files are here?", runtime_event_sink: runtime_sink)
+```
+
+The sink receives tool start and terminal events, including failures,
+cancellations, and timeouts. Leave `runtime_event_sink` unset if you do not
+need this additional lifecycle stream. Integrations that already persist
+protocol-facing tool events should avoid attaching a second sink to the same
+host for those executions.
+
 ## Declarative Agents
 
 Agents follow a file convention. Each agent lives in a directory under
@@ -75,7 +93,7 @@ in `agents/<name>/skills/`, shared skills in `agents/shared/skills/`.
 | Entry point | Purpose |
 |---|---|
 | `Ask::Agent::Session.new(model:, tools: [], max_turns: 25, ...)` | Full agent loop: message, tool calls, results, follow-up |
-| `session.run(message)` | Run the loop for one message |
+| `session.run(message, runtime_event_sink: nil)` | Run the loop for one message; optionally emit ask-runtime tool lifecycle events to a sink |
 | `session.on_event { \|e\| }` | Stream `Ask::Agent::Events` (text deltas, tool execution, evaluation) |
 | `Ask::Agent.new("name")` | Build a session from a declarative agent definition |
 | `Ask.chat(message)` | One-shot chat without instantiating a Session |

data/lib/ask/agent/loop.rb

@@ -17,7 +17,7 @@ module Ask
       @max_consecutive_tool_turns = max_consecutive_tool_turns
       end
 
-      def run_turn(chat:, message:, tools:, tool_executor:, compactor:, hooks:, event_emitter:, session_id: nil, persist: nil, tool_call_repair: nil, steer_source: nil, attachments: nil)
+      def run_turn(chat:, message:, tools:, tool_executor:, compactor:, hooks:, event_emitter:, session_id: nil, persist: nil, tool_call_repair: nil, steer_source: nil, attachments: nil, runtime_event_sink: nil)
         raise MaxTurnsExceeded if @turn_count >= @max_turns
 
         event_emitter.emit(Events::TurnStart.new)
@@ -104,6 +104,7 @@ module Ask
           user_results = tool_executor.execute(
             user_tool_calls, tools, hooks: hooks, event_emitter: event_emitter,
             session_id: session_id, turn: @turn_count,
+            runtime_event_sink: runtime_event_sink,
             result_callback: lambda do |tool_call_id, result|
               tc = user_tool_calls[tool_call_id]
               next unless tc
@@ -175,7 +176,8 @@ module Ask
           session_id: session_id,
           persist: persist,
           tool_call_repair: tool_call_repair,
-          steer_source: steer_source
+          steer_source: steer_source,
+          runtime_event_sink: runtime_event_sink
         )
       end
 

data/lib/ask/agent/session.rb

@@ -288,7 +288,7 @@ module Ask
       #   (only when the +artifacts:+ option is enabled)
       attr_reader :artifact_store
 
-      def run(message, tools: nil, reset: true, attachments: nil)
+      def run(message, tools: nil, reset: true, attachments: nil, runtime_event_sink: nil)
         raise "Session deleted" if @deleted
         raise "Session already running" if @running
 
@@ -331,7 +331,8 @@ module Ask
 	            session_id: @id,
             tool_call_repair: @tool_call_repair,
             steer_source: method(:drain_one_steer),
-	            persist: @state ? method(:persist!) : nil
+	            persist: @state ? method(:persist!) : nil,
+	            runtime_event_sink: runtime_event_sink
 	          )
 
           @total_input_tokens += @loop.last_input_tokens.to_i
@@ -409,7 +410,8 @@ module Ask
               hooks: @hooks,
               event_emitter: self,
               session_id: @id,
-              tool_call_repair: @tool_call_repair
+              tool_call_repair: @tool_call_repair,
+              runtime_event_sink: runtime_event_sink
             )
 
             @total_input_tokens += @loop.last_input_tokens.to_i
@@ -449,7 +451,8 @@ module Ask
               hooks: @hooks,
               event_emitter: self,
               session_id: @id,
-              tool_call_repair: @tool_call_repair
+              tool_call_repair: @tool_call_repair,
+              runtime_event_sink: runtime_event_sink
             )
 
             @total_input_tokens += @loop.last_input_tokens.to_i

data/lib/ask/agent/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Agent
-    VERSION = "0.40.28"
+    VERSION = "0.40.29"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-agent
 version: !ruby/object:Gem::Version
-  version: 0.40.28
+  version: 0.40.29
 platform: ruby
 authors:
 - Kaka Ruto
@@ -127,14 +127,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.1.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.1
+        version: 0.1.2
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement