From ba8ef7a73a62f533a8153334cfdfe94d6ca489d6 Mon Sep 17 00:00:00 2001
From: rodrigo toledo <rodrigo@rtoledo.inf.br>
Date: Wed, 10 Dec 2025 07:29:33 -0300
Subject: [PATCH 1/3] Bump version to 0.1.13

- Add score_threshold parameter to similarity_search, similarity_search_by_vector, and ask methods
- Improve test coverage with comprehensive tests for score_threshold functionality and ask method
---
 .tool-versions                                |  2 +-
 CHANGELOG.md                                  | 17 ++++
 Gemfile.lock                                  |  9 +-
 .../vectorsearch/pgvector.rb                  | 28 ++++--
 lib/langchainrb_rails/active_record/hooks.rb  | 10 ++-
 lib/langchainrb_rails/version.rb              |  2 +-
 .../vectorsearch/pgvector_spec.rb             | 88 ++++++++++++++++---
 7 files changed, 126 insertions(+), 30 deletions(-)

diff --git a/.tool-versions b/.tool-versions
index 0583546..3f03c7a 100644
--- a/.tool-versions
+++ b/.tool-versions
@@ -1 +1 @@
-ruby 3.2.2
\ No newline at end of file
+ruby 3.4.7
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 55ef32a..fdc6519 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,43 +9,60 @@
 - [DOCS]: Documentation changes. No changes to the library's behavior.
 - [SECURITY]: A change which fixes a security vulnerability.
 
+## [0.1.13] - 2025-12-10
+
+- [FEATURE]: Add `score_threshold` parameter to `similarity_search`, `similarity_search_by_vector`, and `ask` methods to filter out irrelevant results based on similarity score
+- [FEATURE]: Improve test coverage with comprehensive tests for the new `score_threshold` functionality and `ask` method
+
 ## [0.1.12] - 2024-09-20
+
 - Adding `rails g langchainrb_rails:assistant --llm=...` generator
 - Adding `rails g langchainrb_rails:prompt` generator
 
 ## [0.1.11] - 2024-06-16
+
 - Add destroy_from_vectorsearch hook
 
 ## [0.1.10] - 2024-05-20
 
 ## [0.1.9] - 2024-04-19
+
 - Bump langchainrb gem to include v0.11.x
 - Remove pg_vector Overriding Operator Constants
 
 ## [0.1.8] - 2024-03-16
+
 - Bump langchainrb gem
 
 ## [0.1.7] - 2024-01-29
+
 - Fix Pgvector#ask method
 
 ## [0.1.6] - 2024-01-25
+
 - Fix bug when multiple ActiveRecord models use vectorsearch
 - Bump langchainrb version
 - Avoid extra query when Pgvector is used
 
 ## [0.1.5] - 2023-11-30
+
 - Qdrant vectorsearch generator
 
 ## [0.1.4] - 2023-11-20
+
 - Bugfix AR integration when using vectorsearch other than Pgvector
 
 ## [0.1.3] - 2023-11-01
+
 - Pgvector vectorsearch generator
 
 ## [0.1.2] - 2023-10-27
+
 - Pinecone vectorsearch generator
 
 ## [0.1.1] - 2023-10-23
 
 ## [0.1.0] - 2023-10-22
+
 - Initial release
+
diff --git a/Gemfile.lock b/Gemfile.lock
index a35c67b..b3ec51b 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -141,7 +141,6 @@ GEM
     matrix (0.4.2)
     method_source (1.0.0)
     mini_mime (1.1.5)
-    mini_portile2 (2.8.8)
     minitest (5.25.4)
     mutex_m (0.3.0)
     net-imap (0.4.18)
@@ -154,12 +153,9 @@ GEM
     net-smtp (0.5.0)
       net-protocol
     nio4r (2.7.4)
-    nokogiri (1.17.2)
-      mini_portile2 (~> 2.8.2)
+    nokogiri (1.18.10-x86_64-darwin)
       racc (~> 1.4)
-    nokogiri (1.17.2-x86_64-darwin)
-      racc (~> 1.4)
-    nokogiri (1.17.2-x86_64-linux)
+    nokogiri (1.18.10-x86_64-linux-gnu)
       racc (~> 1.4)
     parallel (1.26.3)
     parser (3.3.6.0)
@@ -279,7 +275,6 @@ GEM
     zeitwerk (2.6.18)
 
 PLATFORMS
-  ruby
   x86_64-darwin-19
   x86_64-darwin-22
   x86_64-linux
diff --git a/lib/langchainrb_overrides/vectorsearch/pgvector.rb b/lib/langchainrb_overrides/vectorsearch/pgvector.rb
index ed7c9a5..deddd5d 100644
--- a/lib/langchainrb_overrides/vectorsearch/pgvector.rb
+++ b/lib/langchainrb_overrides/vectorsearch/pgvector.rb
@@ -79,14 +79,16 @@ def destroy_default_schema
     # Search for similar texts in the index
     # @param query [String] The text to search for
     # @param k [Integer] The number of top results to return
+    # @param score_threshold [Float] The minimum similarity score (lower distance) to include in results
     # @return [Array<Hash>] The results of the search
     # TODO - drop the named "query:" param so it is the same interface as #ask?
-    def similarity_search(query:, k: 4)
+    def similarity_search(query:, k: 4, score_threshold: nil)
       embedding = llm.embed(text: query).embedding
 
       similarity_search_by_vector(
         embedding: embedding,
-        k: k
+        k: k,
+        score_threshold: score_threshold
       )
     end
 
@@ -94,23 +96,33 @@ def similarity_search(query:, k: 4)
     # You must generate your own vector using the same LLM that generated the embeddings stored in the Vectorsearch DB.
     # @param embedding [Array<Float>] The vector to search for
     # @param k [Integer] The number of top results to return
+    # @param score_threshold [Float] The minimum similarity score (lower distance) to include in results
     # @return [Array<Hash>] The results of the search
     # TODO - drop the named "embedding:" param so it is the same interface as #ask?
-    def similarity_search_by_vector(embedding:, k: 4)
-      model
-        .nearest_neighbors(:embedding, embedding, distance: operator)
-        .limit(k)
+    def similarity_search_by_vector(embedding:, k: 4, score_threshold: nil)
+      query = model.nearest_neighbors(:embedding, embedding, distance: operator)
+
+      if score_threshold
+        # Fetch more results than needed and filter in Ruby to avoid depending on virtual columns
+        candidates = query.limit(k + 5)
+        filtered = candidates.select { |r| r.neighbor_distance <= score_threshold }.first(k)
+        ids = filtered.map(&:id)
+        model.where(id: ids).order(Arel.sql("array_position(ARRAY#{ids.inspect}, id)"))
+      else
+        query.limit(k)
+      end
     end
 
     # Ask a question and return the answer
     # @param question [String] The question to ask
     # @param k [Integer] The number of results to have in context
+    # @param score_threshold [Float] The minimum similarity score to include in results
     # @yield [String] Stream responses back one String at a time
     # @return [String] The answer to the question
-    def ask(question:, k: 4, &block)
+    def ask(question:, k: 4, score_threshold: nil, &block)
       # Noisy as the embedding column has a lot of data
       ActiveRecord::Base.logger.silence do
-        search_results = similarity_search(query: question, k: k)
+        search_results = similarity_search(query: question, k: k, score_threshold: score_threshold)
 
         context = search_results.map do |result|
           result.as_vector
diff --git a/lib/langchainrb_rails/active_record/hooks.rb b/lib/langchainrb_rails/active_record/hooks.rb
index fca1e39..e7af729 100644
--- a/lib/langchainrb_rails/active_record/hooks.rb
+++ b/lib/langchainrb_rails/active_record/hooks.rb
@@ -105,11 +105,13 @@ def embed!
         #
         # @param query [String] The query to search for
         # @param k [Integer] The number of results to return
+        # @param score_threshold [Float] The minimum similarity score to include in results
         # @return [ActiveRecord::Relation] The ActiveRecord relation
-        def similarity_search(query, k: 1)
+        def similarity_search(query, k: 1, score_threshold: nil)
           records = class_variable_get(:@@provider).similarity_search(
             query: query,
-            k: k
+            k: k,
+            score_threshold: score_threshold
           )
 
           return records if LangchainrbRails.config.vectorsearch.is_a?(Langchain::Vectorsearch::Pgvector)
@@ -123,13 +125,15 @@ def similarity_search(query, k: 1)
         #
         # @param question [String] The question to ask
         # @param k [Integer] The number of results to have in context
+        # @param score_threshold [Float] The minimum similarity score to include in results
         # @yield [String] Stream responses back one String at a time
         # @return [String] The answer to the question
         # standard:disable Style/ArgumentsForwarding
-        def ask(question, k: 4, &block)
+        def ask(question, k: 4, score_threshold: nil, &block)
           class_variable_get(:@@provider).ask(
             question: question,
             k: k,
+            score_threshold: score_threshold,
             &block
           ).chat_completion
         end
diff --git a/lib/langchainrb_rails/version.rb b/lib/langchainrb_rails/version.rb
index 786d6a1..c287871 100644
--- a/lib/langchainrb_rails/version.rb
+++ b/lib/langchainrb_rails/version.rb
@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LangchainrbRails
-  VERSION = "0.1.12"
+  VERSION = "0.1.13"
 end
diff --git a/spec/langchainrb_overrides/vectorsearch/pgvector_spec.rb b/spec/langchainrb_overrides/vectorsearch/pgvector_spec.rb
index 65df1d2..5b03f2d 100644
--- a/spec/langchainrb_overrides/vectorsearch/pgvector_spec.rb
+++ b/spec/langchainrb_overrides/vectorsearch/pgvector_spec.rb
@@ -1,27 +1,95 @@
 # frozen_string_literal: true
 
 RSpec.describe Langchain::Vectorsearch::Pgvector do
-  let(:llm) { Langchain::LLM::OpenAI.new(api_key: "123") }
+  let(:llm) { double("LLM") }
+  let(:model) { double("Model") }
   subject { described_class.new(llm: llm) }
 
-  describe "#add_texts" do
+  before do
+    subject.model = model
   end
 
-  describe "#update_text" do
-  end
-
-  describe "#create_default_schema" do
-  end
+  describe "#similarity_search" do
+    it "passes score_threshold to similarity_search_by_vector" do
+      allow(llm).to receive(:embed).and_return(double(embedding: [0.1, 0.2]))
+      allow(model).to receive(:nearest_neighbors).and_return(double(limit: []))
+      allow(model).to receive(:where).and_return([])
 
-  describe "#destroy_default_schema" do
-  end
+      expect(subject).to receive(:similarity_search_by_vector).with(embedding: [0.1, 0.2], k: 4, score_threshold: 0.5)
 
-  describe "#similarity_search" do
+      subject.similarity_search(query: "test", k: 4, score_threshold: 0.5)
+    end
   end
 
   describe "#similarity_search_by_vector" do
+    let(:query) { double("Query") }
+    let(:candidates) { double("Candidates") }
+    let(:filtered) { [double(id: 1, neighbor_distance: 0.3), double(id: 2, neighbor_distance: 0.4)] }
+
+    before do
+      allow(model).to receive(:nearest_neighbors).and_return(query)
+    end
+
+    context "without score_threshold" do
+      it "returns query.limit(k)" do
+        allow(query).to receive(:limit).with(4).and_return(:result)
+
+        result = subject.similarity_search_by_vector(embedding: [0.1, 0.2], k: 4)
+
+        expect(result).to eq(:result)
+      end
+    end
+
+    context "with score_threshold" do
+      it "filters candidates and returns ordered results" do
+        allow(query).to receive(:limit).with(9).and_return(candidates) # k + 5 = 9
+        allow(candidates).to receive(:select).and_return(filtered)
+        allow(filtered).to receive(:first).with(4).and_return(filtered)
+        allow(model).to receive(:where).with(id: [1, 2]).and_return(double(order: :ordered_result))
+
+        result = subject.similarity_search_by_vector(embedding: [0.1, 0.2], k: 4, score_threshold: 0.5)
+
+        expect(result).to eq(:ordered_result)
+      end
+    end
   end
 
   describe "#ask" do
+    it "passes score_threshold to similarity_search and processes results" do
+      # Mock embedding
+      allow(llm).to receive(:embed).and_return(double(embedding: [0.1, 0.2]))
+
+      # Mock nearest_neighbors and query chain
+      query = double("Query")
+      allow(model).to receive(:nearest_neighbors).and_return(query)
+      allow(query).to receive(:limit).and_return([])
+
+      # Mock search results
+      record1 = double("Record1", as_vector: "Vector 1")
+      record2 = double("Record2", as_vector: "Vector 2")
+      search_results = [record1, record2]
+
+      # Mock similarity_search to return the results
+      allow(subject).to receive(:similarity_search).and_return(search_results)
+
+      # Mock logger silence
+      logger = double("Logger")
+      allow(ActiveRecord::Base).to receive(:logger).and_return(logger)
+      allow(logger).to receive(:silence).and_yield
+
+      # Mock generate_rag_prompt
+      allow(subject).to receive(:generate_rag_prompt).and_return("Mocked prompt")
+
+      # Mock llm.chat
+      chat_response = double("ChatResponse", chat_completion: "Mocked answer")
+      allow(llm).to receive(:chat).and_return(chat_response)
+
+      result = subject.ask(question: "question", k: 4, score_threshold: 0.5)
+
+      expect(subject).to have_received(:similarity_search).with(query: "question", k: 4, score_threshold: 0.5)
+      expect(subject).to have_received(:generate_rag_prompt).with(question: "question", context: "Vector 1\n---\nVector 2")
+      expect(llm).to have_received(:chat).with(messages: [{role: "user", content: "Mocked prompt"}])
+      expect(result.chat_completion).to eq("Mocked answer")
+    end
   end
 end

From b1d94ac49bcbed00829881332286b75256e633f9 Mon Sep 17 00:00:00 2001
From: rodrigo toledo <rodrigo@rtoledo.inf.br>
Date: Wed, 10 Dec 2025 07:30:48 -0300
Subject: [PATCH 2/3] Add langchainrb_rails-0.1.13.gem binary file

---
 Gemfile.lock                 |   2 +-
 langchainrb_rails-0.1.13.gem | Bin 0 -> 21504 bytes
 2 files changed, 1 insertion(+), 1 deletion(-)
 create mode 100644 langchainrb_rails-0.1.13.gem

diff --git a/Gemfile.lock b/Gemfile.lock
index b3ec51b..c5273bd 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    langchainrb_rails (0.1.12)
+    langchainrb_rails (0.1.13)
       langchainrb (>= 0.19)
 
 GEM
diff --git a/langchainrb_rails-0.1.13.gem b/langchainrb_rails-0.1.13.gem
new file mode 100644
index 0000000000000000000000000000000000000000..1d86f975764cdd5d815b13ac46cab29f3a7bd4de
GIT binary patch
literal 21504
zcmeFXQ;;r95H_~9ZQHhOp4C~~wr$(CZQJ(lS=%<=e1CG0)PIvos#3{CdM<iqx_YX6
zrmCN=>9#d>F*GrBF=R0J0{VZ7nEoR+Ha4LD!T+QGnX@o){I|!#!okYP$;$CR<jkyW
zY|KDJO#e?A^nX0p)!D_+=|7X)Elf>q{*QwHY5spE|KEK3-<|uP)c?P_B#edv3V54G
z0Rdgrl#So!K<c~FsPNuQrtZc?(*=g_l8><s;0usn6pa=sm}nfSlcFIzY4tw0zf(dK
zG+KA;b&1&uBTgFj^dU2Uw`9W^-OHfRr{DpgX2{+NmtBnGWMn`~<Sx*t{1L&?_=8?k
zB9h6+`sWWvR&XO%-mUVzH7DBWgN%h7g^3gDD!MDHtqIPTG_tKuWvqO$vQK#jFfyP7
zy&U3HnE?%xBGwQX8T6=W%?k(cD>+gr8c)%_7cY4<Y4L5#M^Jtf9}}+ltvyl*F)GXq
zTpOs%sgH;v`|Ls~cg=cVi3~wT)y_B*{=x)fA6YEE$2xSkI!#!&6=qK`RP|MZ)GaY#
zSKqitZ~aWi9_u6m;<f?-_eY4{ZQjDv5Z<NjWVqBv0Ofj%PVxigu?#BgWsgzu@heQu
z;i;zalqp<hy|=YK;O*&K0OgLH{d-9&ev-b^^8p~*_4XxI(hY}A7npPW;C|es{mHFI
z2<;3E1LwMBf+4$hg8KSGeju=8iI9e^+}(CGXutD5xzGiHYFxWp6B*GFBUBVoU(rIp
zNp>gudVD%Qgos?GYyn*3$X4I*{+R_23ptgo!wx?Sw@#NGDO~0)GO9814&Hl7kgdb2
zn_ODcg;4IwehJ#pceOh2es@=HFZd62vN00aTmFht#qu>`w%uM&e$PJ#rQKn}D`U6U
zkMpLCZ$a|>><@_|2O}>IJ$4`x`O05Ie6_g!ll_DOFl$R-eU$8@%l#9`3PV#BOkHO{
z2}eF2mJF4%5kg0L1_vK?s~;cLTuWBuVZz9z#is8X1X)w+#$=Zh9~$sV!;*zGC>0I{
zNeE4$1OK0hd#ji_1mHJHyP=wF&<n<=Umb_MmkefIb`{fMEE>u=er-U*_II1Bga&%v
zk8Azx+75A%mR52R6FvCQjwujibL;Fv;?34&vXqBxmS}74%v_;=E@-e-yImxE5tzg8
zgsNml>p{yrINzp8KwgT1I+%!Er7dWt`H*?@($Eo3^3@E_Kh;M(i2zvlHYhN?Hw^RT
zy8R2AF5Ajs>O0wNr6K6Qk^Nh2nEQWTBFkv$10Uh2{7-PF1}~Q|J4kA*TpZ-o$$5KD
z>w?-Zm}AEJQV8!X&w`X78U23upt;DF_Ii1dX`^~I)NoV(io{wn#LAvoWm80!lTQ%Q
zEtW}r58uvIpuoM!jf3v?evl{aQ<cYgRk2#k;E?`iuW_|?F~i;04G3oIL1}PwQqoIH
zT0jUiYrwau1<urQX-PMUYaC*6D;-VhX#cvC4jYoJ$N{uX=);%jJ+CzX%p*2ubv212
zV>+H6XKG~Pd$@MbatNMfY0EuL^En^!r<%WLE4(}O^^xY?+M(LTZ^ZF3F6>F0aP9@$
z!%4IyCS{#4n_weWZ5MO^fZ`EW6&*4EzZ%8<f4lzg-oXEg{r@50|9kk)#>B?L{y*bC
zD+kB_kN^L7-}L{A-v5sO*S_0M+fq&Yd{4Ah7w3&DqCpzcc5yeBT4}bqiRAHQ?uy|O
z!hvFmBT!&mKvY`BUp_+uHZ~)DHY1)pcUz2H`3;$_j6gjTNvmzy*U?f1G*@YvssD|W
zk;#x(z`d5>i$rhVrX8SgPH?mT-suSO#mu?6wRLrC<Sf>#d*>Up5^z8uuuSG^d_J`r
zv1FjoDSp=+{3Ro>dPx*DZYR@IA&9@s<f<wNBfDxP2vdahJNB%vDp&@#Si)O07&2BW
zSR=4EH6B^sTR|wFbLDuiy$CS#rWFO;n;VM*-X1m)f^sdATx3FWIvx_rB$szz=Ghbi
zU|pn^H-j)CpQBQV*<8GVLn*uOJ_lEdHKP+~JU5<(w-5za{5+@#J$nBx5iT}fjqtzR
zCxz*uZG$J)u0Z^DyWlK~_0aT|Szf;-Z}kx_`QjifBey+o`K}Yky6N`&V~G90>Jn|!
zLf{HFDWt?LUj?k?W&6af8U;V{nCwG9r;h54EcRP^z}<ul`wEse!alK$MXBeq<yFzB
zACy3`#ZcDbD^j9jS&Q(WGv-#<&D?yS6$99!f-cGR?~ggR0JybqKkc~HKL9_0f!})R
zX-m+;dXC|}1M{=h*TLzXpW*bmjjz~Oz?wvN;tn8iw*DL-Ab=P#6rgf32>PhurCXJ>
zY%bZo?Z3n8;kib<U4p6l2GYi{MA&(dz+>VK<c;Sj%90Cbyk3m%gfD+EXd*Ip%MMNb
zGQsuu9k^${Z6mT2p`*k@tf4$ZEbb`xW$AEZV9n^(uDDBZ(=;|jRZ|7=^FS8IKyB9z
zMS`zvGeX=g;1dgNQ|@>y|HT%_Q9ogT^V-PGdB1!G6KSL+NUR*OQ+oGJCf)&hSu`++
z<Nx}465ZP`y3P3QuCzqndy$|c40^wM8H2^Yw#n`DWA+7h86d|LNc`$!vvh3-;>}e*
z03qncNVOTBe?Nn0C>#C(Tw29g1)0(grOHvj9Jf}CnviC((NE#zY(`Jm$Gzzd4^J4h
z&-4nIEyI+AvBFk89uf$(yb#St-CaEk=N(ttMe#P7$8$o;>>c@l|JJ)6TSr7)Dkgnf
ziZ_Bd^>9DCS=^nhw~6&YcVd71B4t5ZPFwh88`J8@fgp|$@=?GGQ!95ZKVbW7&O|-y
z<y^dFp^i&5zA1a>dCUhqQn2F!2C_s2)8owIXzVVByi?$R1|7rg(3ol`veO~RQ;)`X
z{aV+Z9-ylXSHFWa&^0;A4a`(LVGN4@4jdFyM*Z+#QtWjxlp|Wa45VHM>3l{!Wib)r
zI&*tZpl_SBL>8JFV(Jubgzu<p%u{4|7!3j)cw&eelaWPO9@^chfSbI5mb_87=3m3H
zNj5Y??3XuQM@VKO1rllQSU;WT`i~5FW}I2QTA0c2kZX<`TScb~t@WE+Xh3s3d8MZG
zYh}TAtA>L^JRc|=wP6107N{x;`~X%=LfOS|rT*#@*GBGfHvUt*d+Qw;STH+|((J83
z)L2JF$SWm(l6=LQ>#pD!8UN@}F09Db2}&02%cdY4RRD@;KS5ru2-mj+*EVtyjlGK2
z<^m?xD)|M)1KN}I_(mWgbf)&GOwC+$&9DdZJ}d?p^#}Ss)K(~3)=Lc75KFbRL0}nd
z%yPzD84-MaptK{#2hl?xr~6o66-WOG!{jYu9tg*G8_73#k+X_E%*g-AXoSET8J4Ng
zcI|lL!-fY8LAWhGL0ff$0SnZKKZBwJ4Pz$a;RWqI`Z7Okm!)tW7fKi2NO?Z1%dU6p
zpOLF@_q8Oku4cR8s_g})>y<ca;BBbiWjC;J*<sP#Tj(8t@d7J@_(%SxA9vPk?YDc=
zqW-x5D-i%Ov$QCm@lu5A@D$o&Lq@b7D5gwMdO>!vVpYKaawnTZMUWPVH1QDf`ZLIm
z33LEI0Wah7Ak1(-{H=FL1XiJu<o^ImJx)ZLN?Y=suP9x7!Z!WLjDb9_O(ZsP#!rU`
zg4lz?VP$E4P+wk%xzKT`z%Q7qEU_W*WdC9P4~viU^)Syyl{uW@3eDdlrv7`CdNJr1
zzoq1d<9Tl*#J}ltZ%o4ae?(7U_EWV;px^jnw1vIEyNE65cF|L*^cqKEm)zbqn1t4H
zMW~)1$KF3)onKo(e@FPN+(a2r{k|+1$gQ=hg1O)~A^bTVzc5X1ps78eVRl_uA`e^k
zea|ItGHQVDEO=Z$?xS8&2HdmMd$Fv>i>|V}w)!jc^%mbnR{rU5dU1zEo{QfJl;#6s
zyjb@}bw;we#rAnB^#A$5H1ykq$eT}RU}5zNx>1hJOPl=4j9rkiTIEz`Bk;g5`Yw0~
zm`Y&4N7Bzqgf<k~a@}Mj!aJZfc3p}e(O6kh#XB{~JCA<c+X-}VTVU&oi3+}Mb_Glw
z*wj=bynKCLg=%(`5#S5dQm_eM=>4g;9=N7omLgYZUrWcWqGOU77iM=<j{D&}DOqlS
zCIZ(zRBZq>8@@9|colGYTg|+PKiM$s!sA}a{|um_E-%GXJ8<gHs24kqJ2RXgyDcv@
z5wqw%hB4i^($&xm?0Uef`pYd641aB<$z}-0ewlVUzavVG25M4vmp3V3SPNnQvzaC&
z!ixtQ3)R6^n<DfgQjFgb;sg3=5sY0V(KMxGFA^VnO1MQQ5EfoAbL8ksrh-A+R`LNa
z(R`S-=Szw)ZWbXx?ah=NF5G|<PF-&p7a%G#p+2RP3q*ApKg4VX1iIjXw3&~m{%#{e
zCicR2=Y@|K_)Ob_SlUf4C0jDyf9;s?2u%YMLc^hdb(LBfyJvN!^JD&PD@7GJd6#Ro
zl<NsJ_F9|#3kxrF*r>!bu~lZQTw|~hh1?R*LPn)}H6Y=)f<DU2+%K;)IxeQTNEKxp
za;dAz23gCFWAU{=|0$%~2<u_MKfMptlejI8K<_X$0`h9iDc#_r%K|YkPmLgnF6`~X
ze%`ENb-<tUg48}@KlrgQK-+D1C2ga1nMG|*1zrY9bGbf&qPl|5YR|@NeLfalK+PRz
z%;Qo+FUgf$Bo<l$bC(RI+=M_yO?VW6jTH;7w_+aKT3fd~fLM8GSoAE2`mZuO0M_-V
zVCsi-;_o)I8*(%i)*-A(3z%(66MWBM1>%tbh3dzK6_{Qd`xA&7Ah(2lzxp0%G8W+>
zK*&bWHFlZX(nHkU5=IBxYHUEZI+;sGIQLWxEQIC(wT$d$OnJb8@Iieb^}4JuG=(S%
z;x@uCotYX$`9tKw(fsu_tjLK0pG4L&gRX`*j9$WuI-dkewl2QcV!F(Mft&NckeRky
z*O1dN)TG~q$_0=6Nqts_tDq{~7}QQ;(u&kn-qSfoI=U5TGrJq@N`*aqkki;H(4O(P
zziaYtWK4&p95mVnOGO<4Z@o+D0O@Ek8eB9yv{GY_f9u+=tvU}^|D$kHXH<r<3d(}r
zR|7w6dDHdb9%><uUQ3l2n@^r>n?p>zt(fWCPWzC}{58}i$a*=&c68k)Y5O#fE`uEt
z2AyFG%IJ|0NF~*#Ka@{(8u5@i&F);GS)E&=-GMi-AEcII($#;&K?al=DKz`*yW&s7
zft^)o(7dH+GRnGijP8=UWEKZ0=4bTa2>egU1slv%l`VX}9OasVaZpNVhH{Y-9okw5
z_TS2-!?T`o_PhtLy0K~Wl5X|zGugF#`Oc=%v@wZAiQLLR1uty5r+mN$!y~wp$k89)
zWt$S}jzhg83FaSmL+o{0U7Rr%)gpby`kb@%*`HTozguhi+Mm{{{<i1!u9Uagg0Ax)
zEjy)!(;APxWO#)nSktb9?fqesJMfLF7U*N!MyyzHMAzaPIq((alKU3z8j2YqEtRDN
zqscav)McWdc1x)`*rR09|3tEedL^>)<gsI+X@U+$byjS!jVe4eM~B@i>(BH=j);h1
z1yi*`$CLpifVB|4KeDyzhWy=z-F+B6@}`BJ%@AVcf}kcZYhI&@s#wT4ht%nQ*uO1u
z&5n)d6K>ICX@RU(h-cjuA0)^&k<<oh@}WoN3xS!Z8yuxBut%Deg!pa#S+W!1s;;4j
zu(-<<kgF{)y2f|mRIR~83|^IgHZ9MK(Ue}kO;9@4cWC!yC5t9G@;}|oem#O0viPA-
zHE}m-%H9yCc*=y8>R{F{35oru5Qur_ydbC_i`i27wI9q`5<Q6L<~J;2KJt4%@iyCL
zMq64SRn=L-#%4_~J8jyx@`u_u)w4wV0@&?q{!HI?fh@k42-vQ$?z6y}7HAWgxk1Bv
zRb&3mS9|Q^XfmeHR3S9qG2-)qwK#WGE#vybIuarUtDve4i*dfhs?=|KN!$cC!2viP
zTW;G3+xj~`g~qabJnwi};AnFi?<qtes!um&5&Ek!AH+1h((2_li-ZNwO)tFarD}7S
zh&(Y^%K5cT$%qiIM<@y`TQ6K*dR=U$Drh7lSNZJoHhVkxv=f}$s|!X<uUHx*T$$2Z
zlR`HvRJlKJ+nrRa<^Y4*LR4~AZnCVb$N**sZG+TZwE@0?8W&5BdM4wPw-E-X3J&|n
z>-Ba2<M-D2ahibF=orub#PrwH_w~)q4KdC=_gVK-`vbssr9GPicpIAneCY{LlFI1a
z<tF&{BmP6QAoK&exfM&k+8~TGKs~Q##pG<l_hNpTY=*MT(*s#9e%Ltk>d#L=wkT)-
zhg(!k@Iq&apeA1g@(n#At}Tcz!__O!XPF9CW(21Q%_@ZLo;dCTBVR@ikS-GT0>96M
zt;q(mf7J~z4=*nQFkC90D`*Q~uuompAjfwJPa<Yk*ZPd+I5|p2FOsgBTd9kC#267C
zUkwm`6@k~xQ4moBFIa+*4*02e==1)T+Gx(WB*oAWX^@`pvW132H<$1GumFy5uIr)U
zgHVKodgEi&-r~NfL}^iT7XHW~KdJWN1YR4)jws3mTjGf%r>s7ZWU#Cq3JPZ?DEtFW
zAT6T3wICcC3+(<|{%2^^&HEf}TjL5>g4!k39T?M~NJFhhMuI3HnIM&+jlhTcfRsB2
zE8ASJ<@_Te3V2(bb=algN2B}r{eE<kaa*$6<SwI!o9El}j@t(L<i_}2x2~c0@csrm
z5JhqulCnQ(7}MlyU*mDTH~0*_>FbSCvU_~|_`ag$?Q`~bmw|7acVpB4%ja&N+!Nvj
z0RcGm4JaJ=e3Ez&0-S0?3wh&ehZN3(Ytyf-z2E)Oy7bxT?ik2$=vBULGW(`Dxi`1{
zYg_VocDtA}e7t+%+Zo8a!TtUa>hGp+ueZaYQ1yMx^)H;@#6$JXkFQNt%MXT^f5;Ch
zZ@9f5|Caa1Wk?UtKmR^h#QYnP`L_I<yT>vECEl-X?|RzfkJqc4^zNE9Vj*rCL*`xH
z$LVTapO72d;eK99?{G-2nB3vuWYTx7KxKm5imLu={5$oD*Tr3Cg^B3m;q_D$1<DmJ
z6QP3LL5A=kRrwn9K$7>bn}<3Osk}S8J5V~!JW%V8oK=Zmd7n79_Wb_cpO``Y=pVq}
zm)ahHz3&OYn=v2oTMzgU{Qc_xT?e!UCo`#^K&1w&wEi{S9vhI)SpA*q9h0ZX3?T6g
zJb?B-2K?j$q6b;1EqVtYGfA1Mr$t+tkd7ThhHrW=$v|46+v5G@7isW9)izxA`@!;>
z4C;~S`x^o&8q{p`L7>bA#{1-S_J(WWj+`5);KOed#<hGU72G!i_cHQo57OB#JLLX+
zMCLaDrHnijy8?agTtLH)29hh5Pi|(p$l(qB3f^%4Sm+$7d5cU`o;+9La4u1>$C%&_
zP-L%s3Q#Ckyy)0V<sLh|V=C<p{hmX+Q0Oq``ni85#YI9@uG>ByHl*u|o>@6E?x79+
z?Ux2$+jy#Alz?#keprx}5P;{)0YNAV%leCcTv@UOTee~$-eECB3z_<Z^Jz6_As!Lk
z<sM28O<V!<<>(6aXpn)uB!AkADb|alU^%O#rK!)xS3ggAk#yL_8{p6Gez@L|S@}Bs
zbW=RJ=Fc`P>2K)h{__mY(+OZ6JpZ8#9*~c%3*-tvqn>lHSTUac@jWe2O(0dZu)u+2
zR~Hj7B)x`QT*(%b9!d;ppE};&j}Itj^LPxBw%y~r+H1dhKm!UNX2{1ZHl~=6BgV*h
z{CD5SnCeF)$v4pbOZomwA*0fAkSKAaSaT0u%v7+2&(~t4tfc1D6;7-yJOFmk+zQ$E
z;Ecc5pTYqp)B^d9Cy_~xvI~nUR!Qc^?1-d$nrU<ADIsM}L?TW|A?8tndd}f1`K3zs
zu5j`F-E&4!jM5(7u*HoxD6+62gs&CI1<OJgQ8&TLG!_|d6y||sCP7`mVDQ$^;pjsu
zJ7<AEhTzP7AFhgh@rSgWMWzzziSn@Yvq@o1j7!9*7Hh_4IPm3o3fjEUYB$plJlSZJ
zWsr3&?upsNN~#e$3}f_X5~|uNb=BuFEcD-$)DV=};>*W|qLP1r0vSurP_wbHiTeml
zumrlQ1)Jd!_g%AP^#@-7O#Bl}2BM9^*$9;g7ty@DuFG2xyqH)9IeMgNWJK3>vA(>|
ztilQT=?Nvo-aQ-T+Ml7*MVATIKp&tCPO)YW>c*pZf3z|7`gP{0G#UDEyyX;jg<)Bz
zi?QSH`~NWJRnPrvR`0F8yFahm^KhFY@a#B9&sy*kdI23L2w&hM$N%+fkxedfPpyz?
zSi<DAbSF4paoP>`q?t10&1{&M@nmV)F}{gPiJ)rAtH2>N5QX-xA!!fWde<G8a?$DB
zNX~&M61GyIV(9?wa%94CMdbnXDg+X$Up|21VH@<3lNi6jayM;BxDM6MsZkwbHG7`i
zu9HBOJ6U;zX-Xb?IbC$)rubLfGxzN+qO3r`xaX03e%-0gsF#`SAN<M%*g;aHXvW%1
zAE~HgU|>9Rbu^TI%c?C>5>qAu%B5RHIU21D&eI>VdoaU74*9uKDHl5-c?%#cDDc-e
zeclMa{(#+Eh#$*<>64^ozm)xtia3?EZ}7G)TEI}g(!9G?2l#K*O#_Usu3;{u=&)Gy
z>OLxG98(c@L;>Xb`5{<MNMZ0bxq~G;8>F&V_Wiv99wnufv)8X_okf)mQj;{>(Yp`?
z;y<x4+hN|B#NuoIs~M8x!ka;PB_uIK*z%RJQQ_=RD;>E?BKr)k@2ZY$+^Epw47Zx$
z?s!i;TZ~Dk!V~M078q~49J7bXLo#Og67)(34)ST^#f~#|JUZoX2zL~>ce0{y&wO{L
zXFY|Qilj_BA`lHZyUOQloCwGLpnp2d)OcsAq-57_0h+=Dxt-N0D2-;2Ipd+eTguC+
z61sdRy2W&b%Hb}5WR24NV#{Kr#rQz7om5rhU*t1@MR9?}ru#OV?2xLE)jGr`ybE@j
zZyEp^Ot(FRUwq9;AD|p~Shq}3f$3BB2=#|t2p{JWjwu1|ldH7|u<ymwkNOU>MEPu3
z@OR7$zkF`cv=f|m^r8>0{}quK{|j1Y8^v1MEcaTi;#EH7J>D0>9IZO@Vi_N2ckBHg
zqS4-^FAL7Ek2zwfb_(K=;IX?IK}J~O!vSuT3}^xQ#TQ7HExZn2*X&S3#_ikra`%!W
zevS4u_?g8Z6&ccl&pGzo6kp-|QP~EiNZJvph2toSU~DHBA{mE%3}aNh48uR281upI
zo+R-gh7(zDeY^+K{7Pxb_=j@bu?4LlEsrFFmuRvV`)eJ}oKA$dk=qdj?P#|f2w@I$
z<Xw5wH7HP$5!FF%@9N3JN{!&9E-_2k%{|%6u9Ph!Sxh4g^xw418qIcoVkFxqa*#y(
z)WVVxl<MYldl6uSK4k`bJd!_|<~bD)ZI0+0C9ntT(%Tyddv70EkB86^O>~9@hX88D
zFCv*udMhNkzSF;1Kq-k*z?*J+oe>v6a8Vbr!gRx^jS2|i?>kwVm>VQhlx#xA$k&N?
zx`^eVr~9NI<}QQBNtQCZ(Zeb62sV#S`xT=j)>R+_*mA@7T{Urf`_M?&CLx_-1-qb+
z$CaBHw6<+UFubO-fHt+fG`t|{FP-vYS@gpUmOk`iY2*T$WX*sC*rwP&bfqw+jJKsA
zf(xmsPq|oOVo&@I5jvhNO=UiTn{JHS7&frSC4cfph@A@Z<i8)VPS#V5vMNq4$g;1^
zwA>KbB^=ovz9zEGAKe~M-$5HlkAS5(&Ku|7Kfd7&VkkrHh@y6H+!77|$kBs+B|~+E
zXh_HK=qQTA3T}Ghb9tW2Q)W)CPLHuUfPk&vPSgRqDZrAA*^?k!JBP-ZpuWg2X6BD}
znd%^Gpxq?}rnFYSv49b~OK@Ew0Lxn+;sn}x*oBApzGqpOk2mm4L8^X@N7JzP&rpyG
zKX`4TXG^Wrqn==(Jt3JiJbxv%AEL^hc`3jRe=qZSujar1YuI9c0>7mbGjbxk1o-m6
z#HA)NDZv3Id2-c9rW>}{ZaczN)&xP`K8?e8&^`ICp|RyiBf=8$gou_PjliZ$$ogOo
z!XKO2Hy*O*V3?1C@Mv020*b5Sz-Rdz4*|r&lgQ5YBjP7~Sv@gkG;v!k4=BK~cLD8t
z-n-U9Vyhx#ygJ$H(@1Yhp*xW~u8Ldv6P&7RkQf%lw+(iSnKB9mjG1C&^TKlAEuDKW
zA_PLVJ7jG~7oFUE7mXxyX=<Ix#Lq;mEA!@_&G4MdAv66HP>{rc#};N&^GCH&%FyxQ
z&M(#DR{=A&V3R4zFNfpUt;tP1K1Y%311P+U7u{7?wDHOZb2PQ<7pY6g7g3%MQ^7FT
zh-!v_wNe#Nb|)1FM(=jF**kd@*QrSsQ8YzZ00WwmE~dX)&6}^^T2*ueq#Lz>wq1ZT
zDeR>=>y+E9UbbTF;i=Ly(8u-p-l*n7GF?UaBGr^;Se@zW>CC}{aaa=z8uYml!d8|?
z)M!k)L^+ZaQfHnTyC?^EYzp1;G=dB<si&eqgQpnXw-7>RRXl83NdZWi_2mvv63T}K
zQo^EN;?yh{adLsd2@9$<1Iu|;=G(mq2DX|RO4ZH~T$MN_2t{(E=m~Y!Ac-T~$lR8g
zp25XFb*I?@lR0znKbL6E<6+1Rn}S&<<Vj4_h9dviLBdC=ISef|H-5!5`Xaqxj8mir
zWh-KMT+?*YqaqksYHr7Xxuw#J%~`r+>9%jc`<{%<FaHz(2H@RpYh3udw>2>ZsI6W7
z5!4U*?k~w;jOxXZlL~`uN}}4e3QJywRF64>E%kp2k^3m~Md8%k2kh9`n!NzjtNWq=
zpD5>mz)ZG17i9koEa>Bh8DU8C2M_8is!3rX6}gsZ>-M(No<Mj(16Wt{BI~?xS02Ia
z@ctyl$^*VNx+`FSAa4M2UB<ZocDt@?#8oG123s{qmk;bVG%LKzh;tsEt=v>oI7y=`
z{*!Jt(C(wNysqqr2VW+8l7b{c-~~nna}8|976z&+rt_LBi6gK`s7rxCVr^KyLNvkm
z$n62qG8a+#Kl|Gl`Kj$<-%1FqCsN<<>#2f}MRz%^Cc_3w5GY>8G%T{8V@+{fjOWZ8
zC)*g%LDfdT{pe_;vdy-}Sd+t7*sRm|=&a**w16}*W4@dkW_Nnaoym;iXB*>cZ&1f{
znTSgjBwgllt{LM4wV7rv3)_KtnGb8e5jCM#_O)hEwQz44t~6B$UT8M_e-%A{=9B{r
zN|;&_c{3Xh?jtcE55MV@(ogcTr7_Pt@KpS{E`j4@LJue-*#knt?cL(r6cOU%6!Y);
zHvGE%mr@nyOdd>NMmJ~ny=u210wL*GM#yJEQ8n`WWLL@Az-j09^6kbOy?-+54^;ai
zs>%*j^neE5qN>023{RqRDnkm*WBwdb7~K{KL-Uy-1fV<;>^ce?Z?XdG5w+i^4sOK_
z5&sd}EM|WND1cj2{bBj%ofna1kt$@0>2Jx7Ns+;u#mt1S?zW@6`s9Wxq#`DtAGK_F
z5j#0PoC`w8w7$S>lgRgt3R`vg;klUW3gp3w|8XFm&O2_{0{3>9p&-mXDt#fZdibID
z&O|QJL^&eFGYIM*+8aKPD6Mvf^Dk@I<(G^^1C0XIumC=y;Hnibg0N^cD6aVZ?`f)0
zAL&p^N)2mwU@!rsuEH%>bq@z!P~P8Psg2LBAF7PFVfLFti%+$@PxGs0I)jc4kg@BR
zIU`VgXFUi&Iw^_cWb8h4M`nC8SOXt66kqCq%7s9}=!>~Bni419GKL@?9wTj+Jpv5B
zEwg!~1gl9nAC2fcZh>*V1A>6Yvgh1)Ep)!)g){?(RG>Q4fF1r3@}iwb>;$KY@C8cp
zAN|<PZCJ)kNrZXt!8p>)X@;Y!DcngXKJDzghA;+|tAD()oPooSLPp90Y^{V`^J-6H
z+ZR#J3k-^z)I71{Ww{6hIeAuz2Qv>^{msRm3_hG-WJW?mZpW^2q42=D%E$l~`FC6G
z^V8*F6O(tP7r||+w;Zz)`kqp7QH<;60MsYhh?>|8(;3ltG4R<sr$A-tnAWIR?NL;N
zjl!OeXkxme3SDmJO$=^d;2Dt#`14WLyf|kK-^5m+VstG{K_1@vY<IcA1+nDO?g3g(
zZ0M#WUDT3N6NTVrPi8n`^rZ;NDH|^yQxYD;S(bITR?Gu_8D=jG;=R%7(%&M*OsC&V
zJk3xY7pd-~TxhqTv~4Sc^2u8YxTwzD34FiTRqL&)Dl6A#4cqsSINfvoP6RW86uId$
z`9`F6Hr`v2h-nb0&#J~*g-O+!Z2GPw@Y#Jh9cT>wfNzm*_02D$vAmHUY9B+HtK$#W
zaS7F4AdpzBEEql%e9c5CQsh__cToz6EvtoTBzSXE#SjZ*5GI2rU1~1MQ6mv?d984%
z$iMhb@4?ty@yicEhs1E*JSy~5yQyK``5Pjmt6@w4x<^!UZ8tzRdXnqK_{9qR$XZqf
z#wXC=TZa8BssKm$iI`S5kv|FUXHOuf$U};-hGR!G2|?y4Arwua4@Q?$%ke`pUXd@D
zC!In8FgzZ4B4rh{BaBVn?Zaf>&}=ULGK*oHbdmKobC2{ddQGaXSo1BJjOJ@HyBx^l
zRq&gD#AVpIMT(zTrB!cF-Fv>Lj9sj6nN&DJH|9tyXbxCjIgJ%v`^Q7m+HZN@p%*#k
zv`U-sD(PF2axPR{7wBW2?Cd($OU*cte`Pd9ya@;i!YD7Bu)}}>kRHg-q;8rf!!*K-
z7Lu}?2z;`0ky`1ok-R{TY%coaIDwu;DfmM0gkqhuR}>n(B*RpuaLN>rxN`k~VlXAW
zJ4(VnQZc*+{Gjx45?^K~c6FfI`)RwwGAn}6=p~6uHFqic<KF25rT<~ZfeHuDwu7m|
zjv%R^4lRJRM!gyUH7$Xe65adnxvP=)`mx;0Ge#ID0{^3QAQZG9x9^Oy-V{x68r^qd
zirAm8`H!v(mVR<;>a=K*?)z%vko*mRW$TpS$3I(p^QnJ~qAWyf6VOit=m&nY6@98X
z_^4(Ye}<5Nqe+K>snj9R31*n59jYYoVrx&4D&=pF>44IBtC${kW@IhJ%<)N0udB<U
zNvkJ$*9g=vZTP8DjoRTdlSCUQd87FHF{e(7*gEYSmH%31GlFQEtETD#;?QDHuqo!_
zv-S{mR$)klGa<EE4U5h$_R@mVFNdO@x&>M7t`g%0)xqc3D*|t&Y0lon243oHw<w+m
znz0kgoBvk?9U0e*d%)b%ZV@y-Hir#PI=dYc2;6{+WRd2My7KWyNN!&PXiye|ehhvJ
zyo6+a#w@1*h>C*tL7y-NMh<Bzw~=q~-k~@pg(l-cK?Ds2GC6wveK{vp1iIHpO6MHi
z_)=TTn8d9m)lxif$mK)v@n9I0nR_b!Z7fLP;8%YH){YpJjt5}R#_}LIYlcry`wC#3
z2S_e&)YP5=D^3#YVS-aAik>=MLR47IA;hSgp9&^8C*#e7CnGI_&XA;KT`+;If~0qb
z%(Aa3Il*WlR~YdYL9pcRJ34U2cDa?CsKbF`F<KFLL(RG=OO}=rC^}<s8i#m9nXOPS
z^n{sl<J?mRrruMcfyMS9*gQ<jZl{V2qn~MIP!~rJB9^G~IfIXy!daQ0@}aei@T=7s
zxNZ(Ax{SutdyFN4l@XnWvlCn_0%vi4KN}9+46QU1nI=b{bB5%Y`Jt)^JgBZ{6ZR-R
zOpiN}>mPS!CL9lXlafm-J9;+{&TE~vlRmDS63XWG_Sp3%ex>$$PhM;<I(~seO7<X(
zLl9Ul^@5>@@CR@Yxchxd7p-=&evw6&x<=Jw8uu^$6@JX^!wvr>ugg25BxRpDV=D+1
zH6WWMnO9!x`v^G2%j9RmC(Qg~3r5z^ftShP2_LF$+dHC<&}}n7%DeGvEioy5fXvU^
zCKU_X1dd7-$4mfX+>!Twt}>+hl|gN_kacF(Bxr!mwkb^nvysE9|GV{qDx;8z<23d)
z9Vb;J$Cxi@oX4=jYG#Qbij;OQEyws{kp;G{o8S<__n3YNR3UC%8NX&*?(H|{S4H(Z
z<2GeZc~{=&u72*34_(_O>`tc<(0#3Zj&8WLNNJ1W#e0^K98+W&fcJ-s6}@n&b97|>
z4yJVjDC0ZeM=wU_=`9YIA?;*KDXSgrN<0~$e!88Qjg;+v-iiU6kq(R$pO_Oy#oO1}
zy+}umo7u?}8YP7-VXoNT(m~snG*4L8Hn&tmugs)(>N!X_ZD@JLL$QjoD;UAP1Z*2X
z>1r2{7m;C#+VVI86j_umr$08QT36wa?HH3$yZJHZw9KgK0$hCpIeuY8vaoECQ#rxX
zMtJxkcQ!-Va$gp3(1USUhBVA3L%|`Vp7w~~(sMD=&}MvA3SBhiEcoH8{lMnv-JpZ(
zx8w?FYFnUm-8nQQ9VjbORq0+KX*$*fjKomS5ZGuQC^Qt7T~Cl0J_b0Ui?Y#9RGeU;
z`#)q_XDUF3dqjBx)G$P6*uE5>2@(`F8F1lkcN)`lO+uG@*X(S!5O0F<vncQvPwldu
z$Nl*f`!fU2!EbrKm3OfZPRG;2SclH|8fQL<G-YNJrPe13G0mJ>((J|t33%tMXWlRu
zrX$StqVIY45<(F_xsY+%cQ+K+IUQ;yN3>Bqvubl_?y{&gXD%>LeI%xK>h4lI-(DD3
zdPmTdmRd>2GfVpe<S1!_+`xaNvZRl$T3LW}$KO>RW}d>Wdn#QY7X!?BF=mQNN)><2
zRacYzfZUH@9S~PsdGiAlpJ0*tCJxz5E=CYN!-KNlQR$jFiLdEe&Em)GrJLO>cg2(A
zHmN-|%E4&)J~$~9OC)sI+^a=j?0>%X@fLPdaR-Xt_iAfrXFmSR`FnW)fTkP3Ke?V_
z#Ilgm071^AnM+nq&(0vOJ`h_dRpDxr#7LOVPGJR2mr{2+@3KqU=+2~AT0$LPB*zmy
z_uIP$CRAPX$Xjq=Q*u&tNQp%3HhI5m?u@bx_OA^ja!gN|jEmK;_)xj-j9+`NB!PTY
zIxawUyVIG!w)Rae`j5Z#ub@^B)x4jYb_y+>dql<qO{OQ?OJ$`#`-0pfNUrG{^O<OF
z+-<bumUzl>w*0OshJUS*NzHyMg6C|#4xHzDhBVxXcaIh__cED7s=S3i;DuSGI%$52
zhTb-_6ph1$h6;8^xxST4^K{cXn)dqMUBZ%d*w!&My=DN{C%=A-^<b|0Jt=)cLyg<{
zZ1p!2eQTHXD*MAV`l|1cT+aZwxJYJ1TgRGE|879LI7(q%Tjz}3-`+jJ{Dr>GVPY?{
z6gz8<YL+38S+;s+U=%%W#aj8KIM}^$ip@*K8F_P`R~@JF*-L~Oneqr6ofITV|7^HZ
zWOSv_<5Gbe<VkHQ{0xh@7_OA3<<>0o8omMTc?W?MC49$8b*VPdNx98BmliiL3XFVc
zFd!VSXihbOPkWA_U#t#SQdvf?pkWX}t6O(IzIz9TdRpjG>`TfyK6lb}9U;qj%;KY@
z8l+)5$}&?p=#Wb7Y%+`<!x_9nNrb05!cN3P!0j<!pi_`$cBN)_1Ke&QT~3A*8UeGa
zdWibtK~q@LGtG<Dl-g}x%D}$&FGQMxe@dW957q7G^(I5UfJgq0kl!vp&n_<?kU-N9
zVYnn=t|$2`LcxfZ=WWad*iCf#tkh{8B^9#}R<VB7^}jsBw)Z*&-`rK|v_E}iD(SIH
zj{8bGh`)c|3JQ+l2i!OL|H`%}Qum38S_C-?soaTE87jN;wdWo#$+C&^3+nR0b+4cp
zY$hHXbz~aJ0wG+i8a1dFk_S)}TR>O1RT{;J>jS%$21=;;4G$iT13JAuY$Vqk;7N$_
zj}$;j=_0~AnMiF<sfkg0urG-jK1Hu$E%TfGFUD#?%^1uMOK(DUXfp$vk{;opu2E*l
z3b~wKqI9=>!Ecsir%>}^8fcX;-cHE6<FV1t7=o4Kik$?dk9m&23ZiESmY%M~oyvri
z2b&KXy=z4P%;AvVXU=aTE$n2O;_{>^8uVik*t1$NS(FW#q!((YV8M<kQK9e3FZydH
z;LA8U9bB>=)pSydn7<}Lk$O{zyVFgCtdP4Fu}E)IDdybC8L!CUlZ4n{QRRhlGjm~f
zY#Mpac$yIp5mCC1-i60*<i;)~|ModCjiNH|m*R^P$d3{r9D?591bprZf}6{d1*jAV
zPh5i$=bvBbYlPCJ3kY+Yc7&4k?L6~(xe|3FBHTlq-Wr3t30T+XO&Bnhh0SzUra7WH
zSy(WcMSqVt$C|bZy)O`T{W>Q*2PNlXCA8!*#;dk}>wu~$8~r0Wg>jw)2pcm7B0ZYR
z8ihPQq_4H~)8ouMfiQ$m6x3}tbtvUgxLw87snRgB_Y$38E|)ueI50ibaX${^O3Z>H
z8w=fM%|kZOW6`>)uJc7cn$?u{dN%>~NY%|F#DgGT{?@eK0B>jK|5|FB06%&+{yg^Q
z=I!$rUj=e@6C5ddnN%b49pcIjL#d5+rZr#mF|IRU50j@nZdVXt)9KYmJ(Y8h-d^-S
z(y+H^jQ+!6Bam`nvpT1<_1@r?yeXUhXw9svu&1wd-pVv6OW*^K<x%_gAW=c}n5GIW
zYAM5eza6tX2%!zLv*tR$$OtO<N)tSy1C30SyQ~-6x0l>+p9fC^cgp=nUTT5&zn-nZ
zYqc$)2U|r+6;a&>u*-oa+IGAqjA&87QKcS)K-z20)<L8E{by!ke@_)$N%;-i65%PY
zlqu$_S#Lgt)HB@{m(LF_>cj2hC-!!43G%P;33B*#1Q{908T^C3(_@|VsDK%g0GGI%
z-*?)xW2Z8|UpR+?=6E}1A{VfXAgAQb>%fejFO2m*8kj)N7MC~%aR+Mk8Xk!EH*po%
z*Who4=JVCf%^zItM4p}RrgqU;u3}?_+ueK=imbP<xyVJ{(X367`8}6wnL)}%YmVUt
z8WPfuRgE>t%7vauq*LD=CinqUb}p-p4Lnp)(JXu~PcaLJtuIeK$jfkZ!Y7cRN?jIr
zC*9?)2Bx<dahSTHHUM-;m&;gN9lGtrUH}vTnE`bs`eZ6vWHGI@QCwZSvjxbwv9@;L
z*VW({e;$JO!gCULkn1wP*2boK{%+|vT~WAM2t<brU~6M?2iVxE;naBC)1U+F=rE{M
zZN`!n>qwOHrp2z561~yl?<@pIM7J1G-ZuRMiPR#wt7R=7)Ad9e%%c}_PW4hygqf1q
zfxO$)%2jf>8%wo-R#tXw<3-2t7tJr&mWf_Qsy)DRea@bYb~YJ+9O4fM`?2Ol$6C0V
zcdOw^#(W8-SUd9A>aK$sK1!#N%3~^J&sk0?!{SwD(U*QzA4m7;R<Z6gL}&c?N9fF9
zuJ1yO;Jpy1GZl6MnvCI!!U~|fD<oYWI)?G(KYS{m@b`n#p(=5w0IWK{_1oIEXuJvf
z%|7no29oMmgDV}rn==8)EO4T^IHP)v2i0A#wp&5`(Xlp#`fh>?gq5~!#8(Q^%mmgj
z8(2MSp7zgto^9s`*tWE{Ii2-u-=u!Ob;kluc!N7E#B2^`1c!4w_zAntagn_}J&)T!
zaI85Q12-+_1>+?T%eP?CBhpY!rWqBd#9JTQosBxu+9jgq93q-Y!E4|0?RL5qr?)se
z(EUIF^Sg)+-hlks9)O~CD!{N50C4*h9Dkts8zvYG9U$7D2~6Z%JC0us!29H^{)SC!
zRr%?sTlL4L(XRQyRZ@otNCh@{`IvdkKRj;jJo{G2VxR=9ZqLen>sPmSwmt&-(&IZE
zuD&S4NJfvmHp1?Imj9tM$(Xm&Lf^nzrHtJ2fy^A}AUufav~CUl{j9)=(unYsZjy?j
z1a;kj@5w#n?HiG&8k^O;?`9%zGiKR1RNdaAwa!kRI$_w>ECI0porU|cw`=Qr{mySU
zt`Vp9@`L?hOlD-<RNfKpV>%d&783d7UO?$LsJwdhG%yfR%`K@CDProlO;|=aH5A@@
z^YPd?(BK=ul!H-G))351m0@8mliXv*`JI%yyBBkx1^&?5BaKiy&h_XDQp@Y-m~wVC
z5>92${Yffa!hjz72~-{ze&`@0B@hM{8N>_e%a755Dqb1?+MDJP-b~F-FqvWrK`6UE
zBv>O>42i<t6gG14ijt=EzskpgnY%$rW_K>|z#POO+_M~i3*mZCcGPWV{`;{)11c`o
z)cP%Ul(en*eu+6l=Fe=rWY5`+_nfndzC)MsUn{<1e&69HYPxytY!|q;5bEf>0`K8!
zrcyaN??sj`3z_c@f6tin?0L}L0|L&pHc+f?0ojv5Aj@`a`GLE&tg8~4jFII&a0d<x
zQ+mqVFXhq8;p8IcH4ZBoG1p;a2IenTt7O_3CaOp0rJu|1^i+ph&tVY0DaH;nVRnbb
zbrmWnK7DusLHB43X^F*_lHNzF5d>u~H3&}eWD+XqXg|-Prn!81^IvxgHV9^$+F%si
zd$SnGxbm28%6rz>qJnKgai)Qn)TH-R->4)htJxd9<9@I1-po`04sLAfw|V*gchrku
zpo!eg^zkGqAsQ=0XXG9%$-5ksPNOJ9-EO8UbTasf9uAyz@9@{qJFbBi&CbY0CQZOw
zf>8Zf^0B+={ZzSaul1$A8~}GV24HV(Z0sx!*rWNOWo8xqVa8WV=)KX&LQh$&5QOW-
zeC{&dMXJ2uH_K#>+5qp~Re~u3?<ts8(2c?lnw4jwjK1^r{&!fnz?N_N0r9#gvHQEN
zvjcb}&jFZU3y!`89+}1&bM~y2#G;LoHs8A`RFVTn>U0I(HInK#PCjKzDzhKLU#`>(
zMi-6zo0EMF#BL&T?E$X|*S4S#FvrMnsi2FBXc1MCpdg^huWd=~F7waD-AN(ASoCk+
zomld3Ue#O#V2T1Bw?afNCB5yDLWjZN3B8Wylz8`wSy%d4P<?2h^;6cor9bW2u5SMQ
zBKm7Q`xEBt9qVd9l?|I)%8lFcJr5&P0<df28F*9B`z5gW;J3NyPT$_WfmB>w_v3u|
z<|>UK1pdm`p$^2scw)RCj9Rz*&-nF6D8>1E$b}=5+rJSEy%kqrmLmJ{`nbbygzfFV
zmKpMl+Vcje*vSP0`S;u#r{i@S1_|bkC*D=+*IPJ9tM=a|f%25zlLca`^_cqJpDm56
zMCt};i3_%2CC4`*d-;KE!0Hl!J?on3q?78wKh?ec%Si2i>~&coo}K*+L6?lLHN=w_
zt>20dqPk6h45oiSL+(pa%z7~^-u!e{c7AW4q92`^&CHKxofuHH)QJ^$r?`_s0S1sE
zo<sZ^yVmj)F%YQqaHdx_5_e4i55ko%dT2=%OAr8Wpiuty2kLW<-ZztqNo^IV!tYEM
z381IouxkkyM@l4f2Fhr&#~M;E^6e2XPlk+9_55hPD8}0k->y;Yl*C_lLV&&xWeqc`
zjn!1~iCbcYvc+GG(P<`BHSos8daC?P#5YBeDaAN?$aV;J)KwKnn}BR+-7G#wsf58a
z*dvIpX@X#hAP3eeaG2GEW$+=snWrD6;}wiBtUr}Uo-?71TfTZu(wQZ9Ez3ZeqUIC+
zH6N){^4FI`X;J(NmRP*z=Hm%LoBe}K1Zo^e{Ek{NGKEpgMf%2k>hHlw4L_he=(Cf8
z1{;y%8{>AWvVZ+Kom9RVR)8MO@g!@Xv{W`CDL}q-sKQ3y5fe<*RW&rzvCP(lB%k!N
z<Q#50<*cxK=B_p<(*E9;Scta?LIhk(qjznCcIb_af=kciVKtR?0+zC1Fwm_7uIxNE
z#D*)_rq9P(?lPw0I9G#Hzb$_i+%fd3<+rQ2A$Uyy=8|v)q<tWaR@yE+#+EfRE@m=1
z`mZKI13UZ9Bn#tkCuWrXdW`Os-QD7ex@49(KxD|znZwe(n>FH7Re^1hO&n~tahVRK
zF&5pSb}M@*C=|Oct+vkpt=usvfFd#9_|>Q;$PNkoIHz*$yU#*ahSo@iod3k_?(h~S
zFE5aqcJ(U04Z@dMnkjj}9DE8}3}MM<=bEwLg03#e!OPOZIF*n^V&Il#-Y^np9Deeh
z)h>!D;Dfi2*}9c*f}o2TxhFa5Td7$L&6u~7H?S~aeJ&|B?EqElGdiF-RtGV%YYwU%
z956bZ*R5WU^iaR7nNKZ2-;TM3&U?<GaufeOKpRv@?U_fX9$<jWnNn#-gDTBozivEE
zCxg<50=69uVvjL++4Wynf0B<-8%4Ys%DkKat*5hs+&o>hBc65CxQ%uuaS>*Nu>vWi
z5FQp?^VJ76X==zK%&pLBrjNNZ$987)x>e9$XR(-U5}qro%W`1)CG^uul^O~+H<s=)
z8q5xUoEf1jlAjVy3$ua^KaE6wNFT_T?bLqZ7+~i4fBGfx`wXx5By>zXqnrme>(}Ky
z!TBA!+74Q_)TsNhlzw~g8$LrOIB6i&`E`Ns?xWr4_a<AoU#!^AMhC4zqpj^rL*mp4
zl6FnBIQ;rv?r31QVZMPYo?*=4$hfJo7|!ULBBEmOlQwQgSY7pKWF~BAgqu97#IS|@
zGUof=1`BUJWu0`rwG#b{`hP1kML#od(KnPiV2Rnxgfk$@c8S2`Hg~5)`kDZYhJbuW
z%e$mA|5^35-~QFVn}EBMr;R7Z$UA;&!QbC6%8}?XUHzR5=|2Czr;8<uQ;*2BWpSRx
z0q7#>gb))9bZ>mGc^hh@w6_e;9T2JcX(RdQ%6>P`_WH@aApm=h-|F7h#wb7!;iqKL
z$jRkluc7r!e6gs)tN{*b+*yrC8FP;$uGV@CNkCQCl$SV}(0Kxao|XE6Phl{o8<eV%
zr>?lM4-%h{TL|}!E2IGUi(c2QDG}3Xfevv%m@f~A8un=Y<K&B&&M0kW%u!17Kq%MG
zeMZ>sFr4OZoLV5vIZlYa#&bX052l`ee+XbteGO3FyZLtq;N|~pPoK#vJkKwTq9QG1
z<ZL{XXcVST9nR>1FIGSeO5K~jvc3pxPY5pU+n4s|eIusq9!KFBhzb-nx%&^cR)QHK
z$#s2!d|R$>vCV<P1tBQ~YZCzF(cihbFEtf_Tm7YftNe>;)Xh?N3g)%_N^|m|JnS_O
zmv>S=V^hr+Mz}5!TTV_7I1__cT{1|azYSB<Zf;}2ghc>xp>W99<U$#TuLl%GZw5Eb
z5}lMwTo#WPpQ^6yNHfK1=~cAyUHh?(DmZg3)ZgVBMdc^%J*oC2Vl>-ah#m;z#Y)E;
zi2+N5d*f$hl&v1KG5J3-pWu!vDdX3Q?)*l~hI>2?;#C8ozAMVl!piW~4L0j&2i0RE
zTAQVZIHl3*Pbt=L7~v*Yi8I-?Vf^knrM3!p+tg|l{?SxQjShj3xWDyty1T|&&wfe5
zPC64#SUcstu0J62559$&?$gyaDHzhNpN6f;%@g>S=j6}Nr{)ReHE=N;OeL1z9c~eF
zqS!WUtq%5^GYAUmJ&Sb!;|W0iP44xv$haqb{PC`&Mpl0tl15hX`=F10SpQd%lZh*O
z*dDNNNYKSvOlg!~gnP(mIu0^vyYP`Zo0w_({Lb;}pH@Q32=re=%D<VD|BAPq>Tmu&
z!e9P#io(%Aimpyree0M=$glw8v#u(p1hl9_4lPTS%TmKllH^T%5dgTYAscJn`HeC^
zt7#aC!!=eNUoftThY&Js!w+yvm@=9Fh5(RhpR9En^&w-euR8~nNdq?$#JVm)Ql~w1
z#69n|wx=eZw>zu_7uwm-)km7s(rEfDipJ}n;t4=#5&Uvb<j1}`Zx*od&#L~qU%&EK
zW8_BT@4gIdk03phH&a721Kk)+1KGr-&HmLQM)bJp$L;}r#{bgJnFTeOW??w!u*n)g
z(SRMa5w%4?J7G~IvKUrb21h_5ix4(h1f-#X5J15;q5>j<ENL2tFrWlM1QOs!B8hAP
zngAUH)6E{XKtM2L`J0}bshW$a>Wl80sqyOEoT^jx)?4S|eBb*NFgyc#OCGHE44vk=
z7iko~uq$Hm!*ccsvao^&S>}WabYX8Ej%Rt9G9-o%DSsH3ybnXfu5s?qI)GGA%pv4Y
zTczIfPp?arJCG*?+=i9)E?v64UFKjp|Mr}<HDUlplUh$aXpa0D5pm8v;%Tivb5uU+
zxh7$`&J#I(Tb#|PJ!cb2vuh8oFvyEMHL{XOs(O}Q=zgF+BloV>SJAd_2ObkUn5#{h
z<b1VVPF`i_iH}b2;1%?>f?X72n<kl7d?#I+tOH>>O=Wgbd!M}75^2}6=MTG*0~$V&
zwbRFfvwEkxQUc|W3;H+SSO&t?KM+2dlxTfSQg|bXhn8YDGf;I!Vl|P`tUac2lU|u^
zO6jOg$9S7V{!v7sA-^c_-uK#Tq5xX?mKsqW5@V*zqg%?Un>!5IlP*&!l$e?;&KfG$
zFZy*MkGTa&N%#K{@6sLj*Q0&LB5!)qg<YQcp^A&8E8jC}_(|?%u3lmEX1&x4WN+uB
zMQG@m<?YPH@Q8K*(&R%vgEBTLfxnk(2}O40uLt0!{#HIykO7O!x|uxuO-eFLxe9Hm
zo}FrKyvRgP*$QMih%d~RH_;!VmpF*8Sk+1-cEYPZhe+s}ENA~!aeN^we9s+rq3z`6
zEe7%dP|V6H_6REC5XB_aF5E~TrutDoylDU=?KoyMJp2W7XDQd~fG(Sp($Sm_L`68~
zXTYM?R8|yp74RbwCG3PD?vhcjKbMlQx!^b69ARvj68x9<nqKS@58FHBMrzc<&7NS<
z!L!6`ca{9lzCrXX0zwU&#&U4!;)Bj+Yt3yi3cC#4AE7TuMw0|Lu1w`CrO-lSwho}A
z(*xC0_)EoVB}<B>z*b9(ue5mmp2o~x*V?Bdi;|_2t_oZrrvVH{z^X;~Ejy5C29n#=
zGjyKyx>d9so*_S#9JRLGUPq>0*x-cCGVvytB`D4-5s3C<PJ}^D+?AAaeaHF9j@wa<
zCNUcvi~yfJv|(s87wZWLN#HWvOoQ0Q-B`(h3_pnH7eBY^=P@d7g~>(Qf==WqO}GAL
zvp}fW#JElZ+)oVH$t?Op#IaV>nNmW!ZH;nXcF=FBZt2m%^)N_W!%=+EMt_tK&??4%
zSp-tq;m;@Wz>FA-QjE1A@09+BuT`9#gn*J`3y8Z1>D)l&6bqdr(|v3}@4hS%=Qiww
z5PWhT)ET?D`^rs_l2E>tpqE&l(XTE;o8ktlb%v7a)iZFgJ4Y;ioiMAZcsVT~+VMLJ
zg?Ai<+wfN>VmQSOjwYLfRo^uZw}DMH=9+oS-xfF}U2nj*_zD@r#1U}qCH>r0dgK@!
zXQU0+)rJglwFeL3O#HWg{Kl)RflhgZo|sO=xE_g?(dc={+1s%&-?mEIBk0?IYbnqp
zt$Pc_rIrojgCYI?DJ7xvV0B>QY8T^h=f*?O1(#^M)ow@tuQ#0D1nDE_fXCosPX)fs
z9v*EYHGKY^XfjPF?uce?omJh=f5Lk%rfxrBP2A&~;;|+{FgnG+In`=iQ`M|~uPSwQ
z=e^i&&wM6sP>mevg2_-kDAhqbtI!=gb8Yz!iSQVul)GBpd~!dwl#0{|odZtllo^dv
zP~$7vQuSwGZC?vqv}Y$&K!(=$F(P2+a+%B)fpZh(Q?0b!szu%ZOij=1W#cl4Z{f3C
z_`Jk`tmR_|78Q!f_xolSB#lCWzV52BSx|A>L~o+gaRtK`0*)nkcY`o!2|b2weP%td
zY_XH2wMHGhnB<ItjZTL0C^Cld+T1R}h36L4{R{Qm$;XMH3IqazyCDiW*K#0PQoo0v
z@W0+05P}W39vc@CYw)dqMED;=0r?G$^&j|OMhN7;^S=<rr;I-HKmH7F{fqyB%{iN^
zVWcR%Zq|wMJ0^~ZK%<%Rx{ikrm+4Jz6eyKxALp)kq_p}x<Z;?^#~4!r5t~<;z<2@&
zP^JEL2s>Ewk<M0+%$dS2|LiKe!b3S}BT$1t4c1KrreTh6;l=y(vCErEuODH5y@#aP
zzB1<ecZh~7ga3h&7bLBQSXUL=>(wp*C4>#%;K2`e28n?i`qk=HCz&s0hhDIv^x6Ag
za)&DoYg>PmlIg=ts47I?!b0;3(ehDzVfUx}nptxw%L;kibhuy+Qpdx`JBJ;8eN2;d
zs*?C6@-^?KZ-sP&H}loUt24p0@N#)fH1JDeh*Q6r4V6zwKjl%9Qyts+)01CJt+JHL
mwTueXb)+i~t*y!04~0lr|5qE~&v4!68J`vStiXSR0>1+3*8#Br

literal 0
HcmV?d00001


From 44f0a213eaf38d6928a29698aabcacc9c51dfe48 Mon Sep 17 00:00:00 2001
From: rodrigo toledo <rodrigo@rtoledo.inf.br>
Date: Wed, 10 Dec 2025 07:44:59 -0300
Subject: [PATCH 3/3] Fix gemspec to exclude .gem files from file list

- Added exclusion for .gem files to prevent circular reference error
- Fixes 'contains itself' validation error when building/installing gem
---
 langchainrb_rails.gemspec | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/langchainrb_rails.gemspec b/langchainrb_rails.gemspec
index 3c20f8d..37d4af9 100644
--- a/langchainrb_rails.gemspec
+++ b/langchainrb_rails.gemspec
@@ -23,7 +23,7 @@ Gem::Specification.new do |spec|
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
   spec.files = Dir.chdir(__dir__) do
     `git ls-files -z`.split("\x0").reject do |f|
-      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|circleci)|appveyor)})
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|circleci)|appveyor)}) || f.match?(/\.gem$/)
     end
   end
   spec.bindir = "exe"