ask-agent 0.27.1 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1728d64a66438d1ff5ed51490420b7f9f87d806fc8a5bd98317d9c4de44e68e
-  data.tar.gz: 2172947edba0c5a906ebdc01643eaa0adda23d1405d22dcb0dd5a662c71e4944
+  metadata.gz: 36e26d74ffa1c3e3e97b8e172f4fef2ada07c1c194488a8f550e8b77b7473ee1
+  data.tar.gz: 82568a4cc3ed19617293416d10f2f3194c1a18079a1426431a2d878afee75fa0
 SHA512:
-  metadata.gz: cb6be0c48b35c3b7e68ba73edc98fbe9209ffcdc58ee2a7524dd12ea0d3202b0d62397f449579d4b8154b97876cfc57da1031eb004a02fb25c61765b11e764bd
-  data.tar.gz: e2d4f5c8fa6808c0d1e73e9d237c56d8e48fb4bc8630b9bf0feb89309bab872a1bca8a42d603030dafadeeb30d203e35e413a533dded5d3a9086e8b8031ef3fc
+  metadata.gz: cfd202f83bb95e3349282c3771e591f93062976b58c964d65e928e09a6408818ef969200c10b68c4a307e0c0d9fabde112aaf20b9776110a5040590370ecd317
+  data.tar.gz: 7d3ae82b872659e9e27217bc98cf7dfffee28f5209ee5f351dcc944564a63a777888fdad780de218956019d38f223996ebd6372c7be84cf33fdbf9a1eeb4e5a7

data/CHANGELOG.md

@@ -1,3 +1,29 @@
+## [0.28.0] — 2026-08-06
+
+### Changed (breaking)
+
+- **`Ask::Agent::Extensions` is now `Ask::Agent::Policies`.** The
+  tool-lifecycle policy classes — `ApprovalPolicy`, `Permissions`,
+  `RateLimiter`, `AuditLog` — moved from `lib/ask/agent/extensions/` to
+  `lib/ask/agent/policies/` and are namespaced under `Ask::Agent::Policies`.
+  The folder is now named after its seam (like `middleware`,
+  `stream_transforms`, `persistence`) instead of "extra stuff".
+  `Ask::Agent.load_extensions` → `Ask::Agent.load_policies`.
+  Update references: `Ask::Agent::Extensions::X` → `Ask::Agent::Policies::X`.
+
+  **What this means for the taxonomy:** policies are opt-in, replaceable
+  implementations of the tool-lifecycle hook seam — the agent loop runs
+  without them, and users can swap in their own implementations. Core
+  mechanisms are unchanged and stay on `Session`: the approval queue, the
+  `:pending` result status, and the `approval: true` option are core;
+  `Policies::ApprovalPolicy` is the reference classification policy wired on
+  top of them.
+
+### Added
+
+- **`Ask::Agent.load_policies`** — replaces `load_extensions` (same
+  behavior: eagerly requires every policy in the policies directory).
+
 ## [0.27.1] — 2026-08-06
 
 ### Fixed

data/lib/ask/agent/{extensions → policies}/approval_policy.rb

@@ -2,7 +2,7 @@
 
 module Ask
   module Agent
-    module Extensions
+    module Policies
       # Approval policy hook: classifies tool calls as approval-required and
       # routes them into an {Ask::Agent::ApprovalQueue}.
       #
@@ -15,7 +15,7 @@ module Ask
       #
       # @example
       #   queue = Ask::Agent::ApprovalQueue.new
-      #   policy = Ask::Agent::Extensions::ApprovalPolicy.new(queue: queue)
+      #   policy = Ask::Agent::Policies::ApprovalPolicy.new(queue: queue)
       #   session = Ask::Agent::Session.new(
       #     model: "gpt-4o",
       #     tools: [SendEmail],

data/lib/ask/agent/{extensions → policies}/audit_log/active_record_writer.rb

@@ -3,7 +3,7 @@ require "time"
 
 module Ask
   module Agent
-    module Extensions
+    module Policies
       class AuditLog
         # ActiveRecord adapter for the audit log.
         # Auto-creates the +ask_audit_logs+ table on first write using

data/lib/ask/agent/{extensions → policies}/audit_log.rb

@@ -5,7 +5,7 @@ require "time"
 
 module Ask
   module Agent
-    module Extensions
+    module Policies
       # Event-driven audit log for agent sessions.
       #
       # Subscribes to all session events and writes them to a configurable
@@ -93,16 +93,16 @@ module Ask
 
           case adapter
           when :active_record
-            require "ask/agent/extensions/audit_log/active_record_writer"
+            require "ask/agent/policies/audit_log/active_record_writer"
             AuditLog::ActiveRecordWriter.new
           when Hash
             resolve(adapter[:adapter] || adapter[:writer])
           when Symbol, String
             # Try to load adapter by convention:
-            # :active_record → ask/agent/extensions/audit_log/active_record_writer
+            # :active_record → ask/agent/policies/audit_log/active_record_writer
             name = adapter.to_s
             begin
-              require "ask/agent/extensions/audit_log/#{name}_writer"
+              require "ask/agent/policies/audit_log/#{name}_writer"
               klass_name = name.split("_").map(&:capitalize).join
               klass = AuditLog.const_get(klass_name)
               klass.new

data/lib/ask/agent/{extensions → policies}/permissions.rb

@@ -2,7 +2,7 @@
 
 module Ask
   module Agent
-    module Extensions
+    module Policies
       class Permissions
         DEFAULT_TOOLS = %i[write edit bash destroy].freeze
 

data/lib/ask/agent/{extensions → policies}/rate_limiter.rb

@@ -2,7 +2,7 @@
 
 module Ask
   module Agent
-    module Extensions
+    module Policies
       class RateLimiter
         def initialize(max_calls_per_minute: 20, max_tool_calls_per_turn: 5)
           @max_calls_per_minute = max_calls_per_minute

data/lib/ask/agent/session.rb

@@ -421,7 +421,7 @@ module Ask
       def build_audit_log(config)
           config ||= Ask::Agent.configuration.audit_log
           return nil unless config
-          Ask::Agent::Extensions::AuditLog.new(self, adapter: config)
+          Ask::Agent::Policies::AuditLog.new(self, adapter: config)
         end
 
       # Build the approval queue + policy when approval is enabled.
@@ -451,7 +451,7 @@ module Ask
           )
         end
 
-        policy = Ask::Agent::Extensions::ApprovalPolicy.new(
+        policy = Ask::Agent::Policies::ApprovalPolicy.new(
           queue: queue,
           require_approval: policy_opts[:require_approval],
           tools: @tools

data/lib/ask/agent/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Agent
-    VERSION = "0.27.1"
+    VERSION = "0.28.0"
   end
 end

data/lib/ask/agent.rb

@@ -21,11 +21,20 @@ module Ask
 
     class UnknownAgent < Error; end
 
-    module Extensions
-      autoload :Permissions, "ask/agent/extensions/permissions"
-      autoload :RateLimiter, "ask/agent/extensions/rate_limiter"
-      autoload :AuditLog, "ask/agent/extensions/audit_log"
-      autoload :ApprovalPolicy, "ask/agent/extensions/approval_policy"
+    # Policies are opt-in, replaceable implementations of the tool-lifecycle
+    # hook seam (before_tool / after_tool). The agent loop runs without them
+    # and their semantics are unchanged by their absence; users compose and
+    # swap them freely (see Ask::Agent::Hooks for the seam).
+    #
+    # A policy is NOT core machinery. Core mechanisms live on Session — the
+    # approval queue, the :pending result status, and the `approval: true`
+    # option are core; Policies::ApprovalPolicy is the reference
+    # classification policy wired on top of them.
+    module Policies
+      autoload :Permissions, "ask/agent/policies/permissions"
+      autoload :RateLimiter, "ask/agent/policies/rate_limiter"
+      autoload :AuditLog, "ask/agent/policies/audit_log"
+      autoload :ApprovalPolicy, "ask/agent/policies/approval_policy"
     end
 
     module Middleware
@@ -236,8 +245,8 @@ module Ask
       yield configuration
     end
 
-    def self.load_extensions
-      Dir[File.expand_path("agent/extensions/*.rb", __dir__)].each { |f| require f }
+    def self.load_policies
+      Dir[File.expand_path("agent/policies/*.rb", __dir__)].each { |f| require f }
     rescue Errno::ENOENT
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-agent
 version: !ruby/object:Gem::Version
-  version: 0.27.1
+  version: 0.28.0
 platform: ruby
 authors:
 - Kaka Ruto
@@ -174,11 +174,6 @@ files:
 - lib/ask/agent/definition.rb
 - lib/ask/agent/evaluator.rb
 - lib/ask/agent/events.rb
-- lib/ask/agent/extensions/approval_policy.rb
-- lib/ask/agent/extensions/audit_log.rb
-- lib/ask/agent/extensions/audit_log/active_record_writer.rb
-- lib/ask/agent/extensions/permissions.rb
-- lib/ask/agent/extensions/rate_limiter.rb
 - lib/ask/agent/hooks.rb
 - lib/ask/agent/loop.rb
 - lib/ask/agent/meta_agent.rb
@@ -190,6 +185,11 @@ files:
 - lib/ask/agent/middleware/retry_on_failure.rb
 - lib/ask/agent/persistence/base.rb
 - lib/ask/agent/persistence/in_memory.rb
+- lib/ask/agent/policies/approval_policy.rb
+- lib/ask/agent/policies/audit_log.rb
+- lib/ask/agent/policies/audit_log/active_record_writer.rb
+- lib/ask/agent/policies/permissions.rb
+- lib/ask/agent/policies/rate_limiter.rb
 - lib/ask/agent/reflector.rb
 - lib/ask/agent/scheduler.rb
 - lib/ask/agent/session.rb