ask-agent 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f95edab12d96da68593e426829ac2507682b4b5620b5ec0b09269062bf168bd9
-  data.tar.gz: 7353fff33dba2ebff749df32d4c079759f1f4b2eca9193a5299fe9ec7238966c
+  metadata.gz: 82d7ec2cb06f4ce9cbaa41ece0ac4800772b44dcbe54c33e46f6edefb863f1b2
+  data.tar.gz: b8b5cfec092ae7b0117f0a4ec3b441becc0ea21c806107cb0ae9c51c5b215618
 SHA512:
-  metadata.gz: 3e3dc6f6cae44b0c2f36e12c9253b3f21e97a17634907754cc1d2ea8930bd8bcc54b2f65ef2194dae9e1e60d4a721d8071a677f3f0bbfa0d99d68515c0da82b9
-  data.tar.gz: ab443967abf274b113b9ebd8f2901feffa1cf2d7e1436e6a14df8d1dbb87fa1f204d0cb97d2d567858e89631c0b08ed97bf4183174c6ffce97aee363ffa0f724
+  metadata.gz: d9a3dd55f214105d58858f31122a0064a9a94165f37d5b8fc8d1f202ce87fe19ff8ad4f0c6e52de1d66bf115940e3c48e8673762d16912514668b82cabd8daa3
+  data.tar.gz: ecaecabad77df46494a9ee0f99840cbeeaf59163cecaf1ccb8af8810e98bfa8333455c1ed3b50d1bc66c106c38e74b98329d28fea3d2e4393cacdd9453213c23

data/CHANGELOG.md

@@ -1,3 +1,38 @@
+## [0.9.0] — 2026-07-21
+
+### Added
+
+- **Prompt caching support** — `prompt_caching` option enables provider-native prompt caching for significant cost savings on repeated conversation prefixes. Works with both Anthropic and OpenAI.
+
+  ```ruby
+  # Global config
+  Ask::Agent.configure do |c|
+    c.prompt_caching = true
+  end
+
+  # Or per-session
+  session = Ask::Agent::Session.new(model: "claude-sonnet-4", prompt_caching: true)
+  ```
+
+  **Anthropic**: Caches the system prompt and the last user message content. The provider automatically returns cached reads instead of processing the full context on repeated calls. Response metadata includes `cache_creation_input_tokens` and `cache_read_input_tokens`.
+
+  **OpenAI**: Caching is automatic for prompts exceeding 1024 tokens. Response metadata includes `cached_tokens` from `usage.prompt_tokens_details.cached_tokens`.
+
+- **Prompt caching capability** — Both `Ask::Providers::Anthropic` and `Ask::Providers::OpenAI` now advertise `prompt_caching: true` in their capabilities.
+
+## [0.8.1] — 2026-07-21
+
+### Added
+
+- **Per-agent skills via `agent_dir:`** — `Session` now accepts `agent_dir:` parameter. When set, `Ask::Skills.discover(agent_dir:)` discovers skills scoped to that agent directory, loading them alongside shared skills.
+
+- **Agent definitions pass `agent_dir` automatically** — `Ask::Agent.new("name")` passes the agent's directory path to `Session`, enabling per-agent skill discovery without any configuration.
+
+### Changed
+
+- `Ask::Agent::Session#initialize` now accepts optional `agent_dir:` keyword.
+- Skills discovery in Session uses `Ask::Skills.discover(agent_dir: @agent_dir)` instead of the plain `Ask::Skills.discover`, enabling the new per-agent and shared skills paths from ask-skills 0.3.0.
+
 ## [0.8.0] — 2026-07-21
 
 ### Added

data/lib/ask/agent/chat.rb

@@ -33,7 +33,7 @@ module Ask
 
       attr_writer :test_provider
 
-      def initialize(model:, tools: [], temperature: nil, schema: nil, provider: nil, **)
+      def initialize(model:, tools: [], temperature: nil, schema: nil, provider: nil, prompt_caching: nil, **)
         @model_id = model.respond_to?(:id) ? model.id : model.to_s
         @model_info = Ask::ModelCatalog.find(@model_id)
         @tools = tools
@@ -43,10 +43,11 @@ module Ask
         @provider_override = provider
         @provider = nil
 
-        # Read configured middleware and stream transforms from global config
+        # Read configured middleware, transforms, and caching from global config
         config = Ask::Agent.configuration
         @middleware_pipeline = config.middleware.configured? ? config.middleware : nil
         @transform_pipeline = config.stream_transforms.configured? ? config.stream_transforms : nil
+        @prompt_caching = prompt_caching.nil? ? config.prompt_caching : prompt_caching
       end
 
       def ask(message = nil, &block)
@@ -142,6 +143,9 @@ module Ask
       # Build the request hash for the provider call.
       # Middleware can mutate this hash to inject defaults, modify params, etc.
       def build_request(stream)
+        extra = (@extra_params || {}).dup
+        extra[:prompt_caching] = true if @prompt_caching
+
         {
           messages: @messages.map(&:to_h),
           model: @model_id,
@@ -149,7 +153,7 @@ module Ask
           temperature: @temperature,
           stream: stream,
           schema: @schema&.respond_to?(:to_json_schema) ? @schema.to_json_schema : @schema,
-          extra_params: (@extra_params || {}).dup
+          extra_params: extra
         }
       end
 

data/lib/ask/agent/configuration.rb

@@ -4,7 +4,8 @@ module Ask
   module Agent
     class Configuration
       attr_accessor :default_model, :default_max_turns, :compactor_enabled,
-                    :compactor_threshold, :parallel_tool_execution, :max_tool_retries
+                    :compactor_threshold, :parallel_tool_execution, :max_tool_retries,
+                    :prompt_caching
 
       # @return [Middleware::Pipeline] the middleware pipeline for provider calls
       attr_reader :middleware
@@ -19,6 +20,7 @@ module Ask
         @compactor_threshold = 0.8
         @parallel_tool_execution = true
         @max_tool_retries = 3
+        @prompt_caching = false
 
         @middleware = Middleware::Pipeline.new
         @stream_transforms = StreamTransforms::Pipeline.new

data/lib/ask/agent/session.rb

@@ -20,8 +20,10 @@ module Ask
       def initialize(model:, tools: [], max_turns: 25, max_tool_retries: 3,
                      compactor: nil, hooks: {}, persistence: nil,
                      id: nil, system_prompt: nil, parallel_tools: true,
-                     reflector: nil, telemetry: true, meta_agent: nil, **chat_options)
+                     reflector: nil, telemetry: true, meta_agent: nil,
+                     agent_dir: nil, **chat_options)
         @id = id || SecureRandom.uuid
+        @agent_dir = agent_dir
         @max_turns = max_turns
         @max_tool_retries = max_tool_retries
         @parallel_tools = parallel_tools
@@ -46,8 +48,8 @@ module Ask
         @compactor = compactor ? build_compactor(compactor) : nil
         @hooks = Hooks.new(hooks)
 
-        # Auto-discover skills and inject into system prompt
-        @skills_registry = Ask::Skills.discover rescue nil
+        # Auto-discover skills (shared + per-agent if agent_dir is given)
+        @skills_registry = Ask::Skills.discover(agent_dir: @agent_dir) rescue nil
         if @skills_registry && !@skills_registry.names.empty?
           skill_text = @skills_registry.format_for_prompt
           if !skill_text.empty? && @chat.messages.any? { |m| m.role == :system }

data/lib/ask/agent/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module Agent
-    VERSION = "0.8.0"
+    VERSION = "0.9.0"
   end
 end

data/lib/ask/agent.rb

@@ -145,6 +145,9 @@ module Ask
         config = klass._config
         session_opts = { model: config[:model] || Ask::Agent.configuration.default_model }
 
+        # Pass agent directory for per-agent skills discovery
+        session_opts[:agent_dir] = dir
+
         # Resolve tools
         tools = resolve_definition_tools(config[:tools], dir)
         session_opts[:tools] = tools if tools.any?

metadata

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