boxcars 0.8.0 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 27e2420c9339daf37e4eb0c63f86fede297cf48931398a33b2a73054900b5288
-  data.tar.gz: f6fd74d8381fa7905715706d51fafdd179f47c4b021cb57caeacbadb9fdb40a1
+  metadata.gz: 842e02d2d8d43ea2a989c5a0b5708022443cf532d7616ab4319a063705f808fa
+  data.tar.gz: 0c3349ae1dc50be9984bd440c520a74f2f972151338f1ff23aca5bc47d56837c
 SHA512:
-  metadata.gz: 3844edd3c676e68aead5f2a461b401a11a7094d944b66f5b560d03f55a5ca49c936d0ddd8e4f58ac44a32300895c2d34fd5c52adc45fdfc489653b3cf5de2c78
-  data.tar.gz: f8844a5a5977a7769a495bc16b3bc1d6204501a42106fe2528ec6d60be559c08419eae242a1d3ed8b73c1dc9ff44e94c7f2e4e7dd06413483f4db3a66e299711
+  metadata.gz: 68c3560e8e67c59f711c6433ba5950b48e5ecc0d955b039280399c81baf26361bb659eae89660f2180064b8a2ec7cf799bf0950b42cb5bc8c28b224fa6eb6c53
+  data.tar.gz: 9f2538a7659b6ab4f236f23fbecb0a594f0ad0778e82b4fc634a2179e355fb40fb5f9ec54f6b9df6cda558a93ca5d2522c950ed8fe454d800cea1db16f5b72ba

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [v0.8.0](https://github.com/BoxcarsAI/boxcars/tree/v0.8.0) (2025-06-03)
+
+[Full Changelog](https://github.com/BoxcarsAI/boxcars/compare/v0.7.7...v0.8.0)
+
+**Closed issues:**
+
+- ActiveRecord translations [\#249](https://github.com/BoxcarsAI/boxcars/issues/249)
+- Any chance of getting AWS Bedrock as a provider? [\#239](https://github.com/BoxcarsAI/boxcars/issues/239)
+
+**Merged pull requests:**
+
+- Add observability hooks [\#251](https://github.com/BoxcarsAI/boxcars/pull/251) ([francis](https://github.com/francis))
+
+## [v0.7.7](https://github.com/BoxcarsAI/boxcars/tree/v0.7.7) (2025-04-23)
+
+[Full Changelog](https://github.com/BoxcarsAI/boxcars/compare/v0.7.6...v0.7.7)
+
 ## [v0.7.6](https://github.com/BoxcarsAI/boxcars/tree/v0.7.6) (2025-04-22)
 
 [Full Changelog](https://github.com/BoxcarsAI/boxcars/compare/v0.7.5...v0.7.6)

data/Gemfile.lock

@@ -1,7 +1,8 @@
 PATH
   remote: .
   specs:
-    boxcars (0.8.0)
+    boxcars (0.8.2)
+      faraday-retry (~> 2.0)
       google_search_results (~> 2.2)
       gpt4all (~> 0.0.5)
       hnswlib (~> 0.9)

data/README.md

@@ -351,17 +351,30 @@ Set up observability by configuring a backend:
 ```ruby
 # Using PostHog backend
 require 'boxcars/observability_backends/posthog_backend'
+require 'posthog'
+
+# Create a PostHog client with your desired configuration
+posthog_client = PostHog::Client.new(
+  api_key: ENV['POSTHOG_API_KEY'] || 'your_posthog_api_key',
+  host: 'https://app.posthog.com', # or your self-hosted instance
+  on_error: proc { |status, body| 
+    Rails.logger.warn "PostHog error: #{status} - #{body}" 
+  }
+)
 
 Boxcars.configure do |config|
-  config.observability_backend = Boxcars::PosthogBackend.new(
-    api_key: ENV['POSTHOG_API_KEY'] || 'your_posthog_api_key',
-    host: 'https://app.posthog.com' # or your self-hosted instance
-  )
+  config.observability_backend = Boxcars::PosthogBackend.new(client: posthog_client)
 end
 
 # Using multiple backends
 require 'boxcars/observability_backends/multi_backend'
-backend1 = Boxcars::PosthogBackend.new(api_key: ENV['POSTHOG_API_KEY'])
+
+# Create PostHog client
+posthog_client = PostHog::Client.new(
+  api_key: ENV['POSTHOG_API_KEY'],
+  host: 'https://app.posthog.com'
+)
+backend1 = Boxcars::PosthogBackend.new(client: posthog_client)
 backend2 = YourCustomBackend.new
 
 Boxcars.configure do |config|
@@ -440,14 +453,18 @@ The PostHog backend requires the `posthog-ruby` gem:
 gem 'posthog-ruby'
 
 # Configure the backend
+require 'posthog'
+
+posthog_client = PostHog::Client.new(
+  api_key: ENV['POSTHOG_API_KEY'],
+  host: 'https://app.posthog.com',
+  on_error: proc { |status, body| 
+    Rails.logger.warn "PostHog error: #{status} - #{body}" 
+  }
+)
+
 Boxcars.configure do |config|
-  config.observability_backend = Boxcars::PosthogBackend.new(
-    api_key: ENV['POSTHOG_API_KEY'],
-    host: 'https://app.posthog.com',
-    on_error: proc { |status, body| 
-      Rails.logger.warn "PostHog error: #{status} - #{body}" 
-    }
-  )
+  config.observability_backend = Boxcars::PosthogBackend.new(client: posthog_client)
 end
 ```
 

data/boxcars.gemspec

@@ -31,6 +31,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   # runtime dependencies
+  spec.add_dependency "faraday-retry", "~> 2.0"
   spec.add_dependency "google_search_results", "~> 2.2"
   spec.add_dependency "gpt4all", "~> 0.0.5"
   spec.add_dependency "hnswlib", "~> 0.9"

data/lib/boxcars/observability_backends/posthog_backend.rb

@@ -9,10 +9,13 @@ module Boxcars
   #
   # Example Usage:
   #   require 'boxcars/observability_backends/posthog_backend'
-  #   Boxcars::Observability.backend = Boxcars::PosthogBackend.new(
+  #   require 'posthog'
+  #
+  #   client = PostHog::Client.new(
   #     api_key: 'YOUR_POSTHOG_API_KEY',
   #     host: 'https://app.posthog.com' # or your self-hosted instance
   #   )
+  #   Boxcars::Observability.backend = Boxcars::PosthogBackend.new(client: client)
   #
   #   # To track user-specific events, ensure :user_id is present in properties
   #   Boxcars::Observability.track(
@@ -23,32 +26,18 @@ module Boxcars
     include Boxcars::ObservabilityBackend
 
     # Initializes the PosthogBackend.
-    # Configures the PostHog client with the provided API key and host.
+    # Accepts a pre-configured PostHog client instance.
     #
-    # @param api_key [String] Your PostHog project API key.
-    # @param host [String] The PostHog API host. Defaults to 'https://app.posthog.com'.
-    # @param _personal_api_key [String, nil] Optional: A personal API key for server-side operations if needed.
-    # @param on_error [Proc, nil] Optional: A lambda/proc to call when an error occurs during event capture.
-    #   It receives the error code and error body as arguments.
-    #   Defaults to a proc that logs the error to stderr.
+    # @param client [PostHog::Client] A configured PostHog client instance.
     # @raise [LoadError] if the 'posthog-ruby' gem is not available.
-    def initialize(api_key:, host: 'https://app.posthog.com', _personal_api_key: nil, on_error: nil)
+    def initialize(client:)
       begin
         require 'posthog'
       rescue LoadError
         raise LoadError, "The 'posthog-ruby' gem is required to use PosthogBackend. Please add it to your Gemfile."
       end
 
-      @on_error_proc = on_error || proc do |status, body|
-        Boxcars.error("PostHog error: Status #{status}, Body: #{body}", :red)
-      end
-
-      # The posthog-ruby gem uses a simpler API
-      @posthog_client = PostHog::Client.new(
-        api_key:,
-        host:,
-        on_error: @on_error_proc
-      )
+      @posthog_client = client
     end
 
     # Tracks an event with PostHog.

data/lib/boxcars/vector_store/pgvector/build_from_array.rb

@@ -115,8 +115,7 @@ else
     module VectorStore
       module Pgvector
         class PgvectorNotAvailableError < StandardError
-          DEFAULT_MESSAGE = "The 'pgvector' and 'pg' gems are required. Please add them to your Gemfile."
-          def initialize(message = DEFAULT_MESSAGE)
+          def initialize(message = "The 'pgvector' and 'pg' gems are required. Please add them to your Gemfile.")
             super
           end
         end

data/lib/boxcars/vector_store/pgvector/build_from_files.rb

@@ -103,8 +103,7 @@ else
     module VectorStore
       module Pgvector
         class PgvectorNotAvailableError < StandardError
-          DEFAULT_MESSAGE = "The 'pgvector' and 'pg' gems are required. Please add them to your Gemfile."
-          def initialize(message = DEFAULT_MESSAGE)
+          def initialize(message = "The 'pgvector' and 'pg' gems are required. Please add them to your Gemfile.")
             super
           end
         end

data/lib/boxcars/vector_store/pgvector/save_to_database.rb

@@ -155,8 +155,7 @@ else
     module VectorStore
       module Pgvector
         class PgvectorNotAvailableError < StandardError
-          DEFAULT_MESSAGE = "The 'pgvector' and 'pg' gems are required. Please add them to your Gemfile."
-          def initialize(message = DEFAULT_MESSAGE)
+          def initialize(message = "The 'pgvector' and 'pg' gems are required. Please add them to your Gemfile.")
             super
           end
         end

data/lib/boxcars/vector_store/pgvector/search.rb

@@ -167,8 +167,7 @@ else
     module VectorStore
       module Pgvector
         class PgvectorNotAvailableError < StandardError
-          DEFAULT_MESSAGE = "The 'pgvector' and 'pg' gems are required. Please add them to your Gemfile."
-          def initialize(message = DEFAULT_MESSAGE)
+          def initialize(message = "The 'pgvector' and 'pg' gems are required. Please add them to your Gemfile.")
             super
           end
         end

data/lib/boxcars/version.rb

@@ -2,5 +2,5 @@
 
 module Boxcars
   # The current version of the gem.
-  VERSION = "0.8.0"
+  VERSION = "0.8.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: boxcars
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.2
 platform: ruby
 authors:
 - Francis Sullivan
@@ -10,6 +10,20 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: google_search_results
   requirement: !ruby/object:Gem::Requirement