ask-ruby-harness 0.3.14 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56ac490231ae158243f39f33cb6344c4422829f93baa63738ef26a2f7e1b1ada
-  data.tar.gz: 5dcdc9117b825cf4c6c8e7b1c7873b35c4a90bbbfc08d34cb89e982e52d0ca0d
+  metadata.gz: 988efe437821b4b14ef9df279c5fc9427890d44f5822e2bfe062aa133fa1d1d1
+  data.tar.gz: 8b4280e25274606e53c105852bb01faf483c1a64624048980d469d2f1c99826b
 SHA512:
-  metadata.gz: e02775a7c2b6d39f1ee6d6961bdd103bbd33af2a085fca8427b7cea4ea47da47e286aa3e5726ee131ff6b50363ecddb8890dd90b388995d536baeca59b59de9a
-  data.tar.gz: eb2f9d5aee1f97ccfb13ea4c8c66dedf8c58309a182476fc56b57720fc840bf8b4a1ed146dc3ce8124fe9254d7404561032fc9fe1e2626b3738d30b58454a1f8
+  metadata.gz: c456006a02bc6b0bb8b052c31c3a0e60411544a7ac87339327bd87083606e174f027d425ab1f0718088361282fbd1231b7ed9b5ef7960f99c5d51a031c6dbb04
+  data.tar.gz: 3c81deb034aee13707429204ead2dbbc200875953f7aff37b953689c17328e678602820232950f8249f5e060a3751b9cb1bccc3666ffcca0165376da752b4f8b

data/CHANGELOG.md

@@ -1,3 +1,26 @@
+## [Unreleased]
+
+## [0.4.0] - 2026-09-23
+
+### Changed
+
+- **Environment mode flows through Ask Agent approvals** — `agent_session`
+  now passes `configuration.effective_mode` as `approval: {mode: ...}` to
+  `Ask::Agent::Session` (merging and preserving caller `approval:` options)
+  instead of building `Ask::Permissions` `before_tool` hooks. The session
+  owns the shared policy, approval queue, and approvals
+  (`session.approval_queue` for `:ask_before_changes`). A caller-supplied
+  `approval[:mode]` that conflicts with the environment mode raises
+  `ArgumentError`; with no environment mode the caller's approval passes
+  through unchanged.
+## [0.3.14] — 2026-09-23
+
+### Changed
+
+- **Permissions now come from `ask-permissions`** — the harness reads its
+  environment permission modes and command allow/deny lists from the
+  `ask-permissions` gem instead of maintaining them locally.
+
 ## [0.3.2] — 2026-08-12
 
 ### Fixed

data/README.md

@@ -53,6 +53,29 @@ Ask::Ruby::Harness.discover_tools!
 session = Ask::Ruby::Harness.agent_session(model: "gpt-4o")
 ```
 
+The configured `env.mode` is passed to the Ask Agent session as its
+approval mode (`approval: {mode: ...}`); the session owns the shared
+policy, approval queue, and approvals. With `env.mode = :ask_before_changes`,
+state-changing tool calls wait on `session.approval_queue` — the host
+drains it and answers each request to let the agent continue:
+
+```ruby
+session = Ask::Ruby::Harness.agent_session
+# while the agent runs:
+queue = session.approval_queue
+queue.pending_actions.each do |action|
+  if permitted?(action)
+    queue.approve(action.id)
+  else
+    queue.reject(action.id, feedback: "not permitted in this environment")
+  end
+end
+```
+
+Callers may pass their own `approval:` options through `agent_session`;
+extra options are preserved, and a caller-supplied `approval[:mode]` that
+conflicts with the environment mode raises `ArgumentError`.
+
 The Rails edition (`ask-rails-harness`) mounts an agent at `/ask` and adds
 framework-native tools (routes, engine) on top of this gem.
 

data/lib/ask/ruby/harness/version.rb

@@ -3,7 +3,7 @@
 module Ask
   module Ruby
     module Harness
-      VERSION = "0.3.14"
+      VERSION = "0.4.0"
     end
   end
 end

data/lib/ask/ruby/harness.rb

@@ -41,8 +41,7 @@ module Ask
           tools = configuration.tools.map { |t| t.is_a?(Class) ? t.new : t }
           prompt = extra.delete(:system_prompt) || configuration.system_prompt || default_system_prompt
 
-          # Resolve environment-specific permissions and wire into agent hooks
-          hooks = build_environment_hooks
+          apply_environment_approval!(extra)
 
           Ask::Agent::Session.new(
             model: configuration.default_model,
@@ -50,7 +49,6 @@ module Ask
             system_prompt: prompt,
             tools: tools,
             state: configuration.persistence_adapter,
-            hooks: hooks,
             **extra
           )
         end
@@ -126,15 +124,34 @@ module Ask
 
         private
 
-        def build_environment_hooks
+        # Normalize the caller's approval against the resolved environment
+        # mode: nil/true becomes {mode: env_mode}; a Hash merges, preserving
+        # all entries and rejecting only a different supplied :mode; an
+        # Ask::Permissions::ApprovalQueue becomes {queue:, mode:}; false or
+        # unsupported types raise ArgumentError. With no environment mode the
+        # caller's approval passes through unchanged.
+        def apply_environment_approval!(extra)
           env_mode = configuration.effective_mode
-          return {} unless env_mode
-
-          perms = Ask::Permissions::Permissions.new(mode: env_mode)
-          { before_tool: [perms.method(:before_tool_call)] }
-        rescue ArgumentError => e
-          warn "[ask-ruby-harness] Invalid environment mode: #{e.message}"
-          {}
+          return unless env_mode
+
+          approval = extra[:approval]
+          extra[:approval] =
+            case approval
+            when nil, true
+              {mode: env_mode}
+            when Hash
+              caller_mode = approval[:mode]
+              if caller_mode && caller_mode != env_mode
+                raise ArgumentError,
+                      "conflicting approval mode: caller specified #{caller_mode.inspect}, " \
+                      "environment config specifies #{env_mode.inspect}"
+              end
+              approval.merge(mode: env_mode)
+            when Ask::Permissions::ApprovalQueue
+              {queue: approval, mode: env_mode}
+            else
+              raise ArgumentError, "unsupported approval: #{approval.inspect}"
+            end
         end
 
         def prune_old_sessions

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-ruby-harness
 version: !ruby/object:Gem::Version
-  version: 0.3.14
+  version: 0.4.0
 platform: ruby
 authors:
 - Kaka Ruto
@@ -71,14 +71,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement