patient_llm 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5a3fc235def2976b4a57107239ab72e51a50a2b3abdfed579c0c0d4ea6f681d
-  data.tar.gz: 77b63683fc706598ab29e2fa710d9d6650c568712301e1ff4d87bd8a50668228
+  metadata.gz: 87bcd18afe8c5a4c46e191946f51201e077b355d223ac9d1817bd4041041143f
+  data.tar.gz: 51a67045f05fc5f55ec1aee9391006eecf60170c3d3e47f3248d2169046ffa0e
 SHA512:
-  metadata.gz: e43ffc0679e0ab348e8462884042ba538d734101acfb5b7ecb5e4058167dc3fdd7aa50ad953a091695faae5ad1ce4c25ff1b13614c2ac553587b3568115e8f9a
-  data.tar.gz: 034554bf031c5696ddb2bf877463f9cbcf5e57e32cdc39563975de22f0ea6cde189be72cfe053ea1338144b320254196ed51589ded11ba753161e4af544de3e4
+  metadata.gz: 594c2deb985655a5396c587e6bce19f603f2f2ae9af3c6df1d8f268f5ac81d9a2542bedeed966f84700ed6f971cc1e1916bf0be3f217397fd07840a794a1f005
+  data.tar.gz: 2e4d20a58e2ce23bb882c1035a98aca401644b85171661b039aa1bc0b7ac5a55a207095ca5facf54723e6ff6baa06e39e752948411dbf3100183bcb041c082f5

data/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.4.0
+
+### Added
+
+- Added `preprocessors:` option to provider configuration and `PatientLLM.ask` for applying named PatientHttp request preprocessors (e.g., AWS SigV4 request signing) at dispatch time. A per-request value replaces the provider default; pass an empty array to clear it for a single request.
+
+### Changed
+
+- Requires patient_http version 1.2 or higher.
+
 ## 0.3.0
 
 ### Changed

data/README.md

@@ -52,6 +52,38 @@ end
 > [!NOTE]
 > You can also set up encryption for your job payloads to ensure the entire serialized payload is always encrypted in the job queue. See the documentation for [patient_http-sidekiq](https://github.com/bdurand/patient_http-sidekiq#sensitive-data-handling) or [patient_http-solid_queue](https://github.com/bdurand/patient_http-solid_queue#sensitive-data-handling) for details.
 
+### Request signing (preprocessors)
+
+Some providers require request signing rather than a static authentication header — for example, AWS Bedrock with SigV4, where a signature is computed over the final outgoing request. For these, register a [request preprocessor](https://github.com/bdurand/patient_http#request-preprocessors) on the PatientHttp configuration and reference it by name from the provider. Like secrets, only the preprocessor name is serialized into the job queue; the signing logic and credentials stay on the processor side.
+
+```ruby
+PatientLLM.configure do |config|
+  config.provider :bedrock,
+    url: "https://bedrock-runtime.us-east-1.amazonaws.com",
+    serializer: :converse,
+    preprocessors: :aws_sigv4
+end
+
+PatientHttp::Sidekiq.configure do |config|
+  config.register_preprocessor(:aws_sigv4) do |request|
+    signer = Aws::Sigv4::Signer.new(
+      service: "bedrock",
+      region: "us-east-1",
+      credentials_provider: Aws::CredentialProviderChain.new.resolve
+    )
+    signature = signer.sign_request(
+      http_method: request.http_method.to_s.upcase,
+      url: request.url,
+      headers: request.headers.to_h,
+      body: request.body.to_s
+    )
+    signature.headers.each { |name, value| request.headers[name] = value }
+  end
+end
+```
+
+Multiple preprocessors can be given as an array; they run in order at dispatch time.
+
 ### Creating a Callback Class
 
 Create a callback class with `on_complete` and `on_error` methods. Callbacks receive
@@ -189,10 +221,13 @@ PatientLLM.ask(session,
   serializer: :messages,                   # Override the API format
   path: "/chat/completions",               # Override the endpoint path
   headers: {"X-Custom" => "value"},        # Additional HTTP headers
-  params: {max_completion_tokens: 1000}    # Additional request parameters
+  params: {max_completion_tokens: 1000},   # Additional request parameters
+  preprocessors: :aws_sigv4                # Replace the provider's request preprocessors
 )
 ```
 
+Note that `headers` and `params` are merged on top of the provider's configured values, while `preprocessors` (like `url`, `serializer`, and `path`) replaces the provider default. Pass `preprocessors: []` to clear a provider-level preprocessor for a single request.
+
 ### URL composition
 
 The full request URL is built by concatenating the base URL (from the provider registry or the `url:` option) with the `path`. When you don't set `path`, it defaults to the path for the active serializer (`/v1/chat/completions` for `:chat_completion`, `/v1/responses` for `:open_responses`, `/v1/messages` for `:messages`, `/converse` for `:converse`, `/v1beta/models/{model}:generateContent` for `:gemini`). A `{model}` placeholder in the path is replaced with the session's model at dispatch time, which is how the Gemini default targets Google's `/v1beta/models/{model}:generateContent` endpoint. Trailing slashes on the base and leading slashes on the path are normalized, so:

data/VERSION

@@ -1 +1 @@
-0.3.0
+0.4.0

data/lib/patient_llm/callback.rb

@@ -216,6 +216,7 @@ module PatientLLM
       ask_kwargs[:path] = request_options["path"] if request_options["path"]
       ask_kwargs[:headers] = request_options["headers"] if request_options["headers"]
       ask_kwargs[:params] = request_options["params"] if request_options["params"]
+      ask_kwargs[:preprocessors] = request_options["preprocessors"] if request_options["preprocessors"]
 
       PatientLLM.ask(session, **ask_kwargs)
     end

data/lib/patient_llm/configuration.rb

@@ -29,8 +29,11 @@ module PatientLLM
     # @param path [String, nil] Override the default endpoint path
     # @param completion_path [String, nil] Deprecated alias for +path+
     # @param params [Hash] Additional parameters to merge into every request payload
+    # @param preprocessors [String, Symbol, Array<String, Symbol>, nil] Names of request
+    #   preprocessors to apply to every request (e.g. for request signing). Names must be
+    #   registered on the PatientHttp configuration with `register_preprocessor`.
     # @return [void]
-    def provider(name, url:, headers: {}, serializer: :chat_completion, path: nil, completion_path: nil, params: {})
+    def provider(name, url:, headers: {}, serializer: :chat_completion, path: nil, completion_path: nil, params: {}, preprocessors: nil)
       if completion_path
         warn "PatientLLM::Configuration#provider: the `completion_path:` argument is deprecated; use `path:` instead", uplevel: 1
         path ||= completion_path
@@ -48,7 +51,8 @@ module PatientLLM
         headers: headers,
         serializer: sym,
         path: path,
-        params: params
+        params: params,
+        preprocessors: preprocessors
       }
     end
 

data/lib/patient_llm.rb

@@ -67,8 +67,11 @@ module PatientLLM
     # @param completion_path [String, nil] Deprecated alias for +path+
     # @param headers [Hash, nil] Additional headers merged on top of provider headers
     # @param params [Hash, nil] Additional params merged into the request payload
+    # @param preprocessors [String, Symbol, Array<String, Symbol>, nil] Names of request
+    #   preprocessors to apply to this request. Replaces the provider's configured
+    #   preprocessors; pass an empty array to clear them for this request.
     # @return [Object] Handler-specific identifier for the enqueued request
-    def ask(session, provider:, callback:, callback_args: {}, url: nil, serializer: nil, path: nil, completion_path: nil, headers: nil, params: nil, tool_iteration: 0, original_request_id: nil) # :nodoc: tool_iteration and original_request_id are internal
+    def ask(session, provider:, callback:, callback_args: {}, url: nil, serializer: nil, path: nil, completion_path: nil, headers: nil, params: nil, preprocessors: nil, tool_iteration: 0, original_request_id: nil) # :nodoc: tool_iteration and original_request_id are internal
       if completion_path
         warn "PatientLLM.ask: the `completion_path:` argument is deprecated; use `path:` instead", uplevel: 1
         path ||= completion_path
@@ -95,6 +98,7 @@ module PatientLLM
         resolved_headers = {"anthropic-version" => ANTHROPIC_VERSION}.merge(resolved_headers)
       end
       resolved_params = (provider_config[:params] || {}).merge(params || {})
+      resolved_preprocessors = preprocessors || provider_config[:preprocessors]
 
       payload = session.request_payload(resolved_serializer)
       payload = deep_merge(payload, deep_stringify_keys(resolved_params)) unless resolved_params.empty?
@@ -107,11 +111,13 @@ module PatientLLM
       request_options["path"] = path if path
       request_options["headers"] = headers if headers && !headers.empty?
       request_options["params"] = params if params && !params.empty?
+      request_options["preprocessors"] = preprocessors if preprocessors
 
       PatientHttp.post(
         request_url,
         json: payload,
         headers: resolved_headers,
+        preprocessors: resolved_preprocessors,
         raise_error_responses: true,
         callback: PatientLLM::Callback,
         callback_args: {

data/patient_llm.gemspec

@@ -37,7 +37,7 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = ">= 3.0"
 
-  spec.add_dependency "patient_http", "~> 1.1"
+  spec.add_dependency "patient_http", "~> 1.2"
   spec.add_dependency "prompt_builder"
 
   spec.add_development_dependency "bundler"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: patient_llm
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Brian Durand
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: prompt_builder
   requirement: !ruby/object:Gem::Requirement