lara-sdk 1.9.2 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51ee605bbd73a183adcb0692120063624117745a88d47f04c60c8f937dfdeafd
-  data.tar.gz: 8b9bb03c7cf3316a0fa7bb92f95a56630a404aa22956fb5c1dbb10e923a16bc4
+  metadata.gz: 33000e4a2972ae2f98c8e9b2e307122e4d729d1e50e5d78325fde5d5b7d470b4
+  data.tar.gz: 11a9586abaf2b895fe0d7f50f04470c462b80f83c44ffb33a9a4c869c30bb4bb
 SHA512:
-  metadata.gz: 5ead2e652fdf3c398a87062a229c125eeef41e51f1f222db805d97af36bf7b66723931f9f28a1e4b032fdc0750fdde0314d6e0f84e40b3a351543e7c266c8964
-  data.tar.gz: 3deda3e7fd1175f5d9c3c9afa3e8211b34a530be5c7e73f65bf13c63380b43e7e62abdc410755fdd263d2f74f2655602e3a0f513ab552cdffb62412650cfe025
+  metadata.gz: bab5b019aaab9736023be72456df455558afcc17dce5060792c6b4d8fe73a34c81065a86320614437a234792b6ca204ddddd3884049e0927e51d16d894eb3441
+  data.tar.gz: 0a5bd84f86a55cce9ab60930178411857cc84df2534d6b91deb5300ab0e9ff12bdc126a7e374458d83a64c7cd105dda4ba6852b4eac313b40852e528941d7158

data/lib/lara/models/text.rb

@@ -167,11 +167,73 @@ module Lara
       end
     end
 
+    class IntelligenceError < Base
+      attr_reader :status_code, :message
+
+      def initialize(status_code:, message:)
+        super()
+        @status_code = status_code
+        @message = message
+      end
+
+      def self.from_hash(hash)
+        return nil if hash.nil?
+
+        new(status_code: hash["statusCode"] || hash["status_code"], message: hash["message"])
+      end
+    end
+
+    class IntelligenceFailure < Base
+      attr_reader :applied, :error
+
+      def initialize(applied:, error:)
+        super()
+        @applied = applied
+        @error = IntelligenceError.from_hash(error)
+      end
+    end
+
+    # Applied is false or "partial" for reference retrieval failures.
+    class ReferenceRetrievalFailure < IntelligenceFailure
+    end
+
+    class ReasoningWarning < Base
+      attr_reader :code, :message
+
+      def initialize(code:, message:)
+        super()
+        @code = code
+        @message = message
+      end
+    end
+
+    class ReasoningFeedback < Base
+      attr_reader :applied, :error, :warnings
+
+      def initialize(applied:, error: nil, warnings: [])
+        super()
+        @applied = applied
+        @error = IntelligenceError.from_hash(error)
+        @warnings = warnings.map { |warning| ReasoningWarning.new(**warning.transform_keys(&:to_sym)) }
+      end
+    end
+
+    class TextWarnings < Base
+      attr_reader :reasoning, :references, :prosa
+
+      def initialize(reasoning: nil, references: nil, prosa: nil)
+        super()
+        @reasoning = ReasoningFeedback.new(**reasoning.transform_keys(&:to_sym)) if reasoning
+        @references = ReferenceRetrievalFailure.new(**references.transform_keys(&:to_sym)) if references
+        @prosa = IntelligenceFailure.new(**prosa.transform_keys(&:to_sym)) if prosa
+      end
+    end
+
     class TextResult < Base
       attr_reader :content_type, :source_language, :translation,
                   :adapted_to, :glossaries,
                   :adapted_to_matches, :glossaries_matches,
-                  :profanities, :styleguide_results
+                  :profanities, :styleguide_results, :warnings
 
       def self.from_hash(hash)
         return nil unless hash.is_a?(Hash)
@@ -198,13 +260,14 @@ module Lara
           adapted_to_matches: adapted_to_matches,
           glossaries_matches: glossaries_matches,
           profanities: profanities,
-          styleguide_results: styleguide_results
+          styleguide_results: styleguide_results,
+          warnings: hash["warnings"] && TextWarnings.new(**hash["warnings"].transform_keys(&:to_sym))
         )
       end
 
       def initialize(content_type:, source_language:, translation:, adapted_to: nil, glossaries: nil,
                      adapted_to_matches: nil, glossaries_matches: nil, profanities: nil,
-                     styleguide_results: nil)
+                     styleguide_results: nil, warnings: nil)
         super()
         @content_type = content_type
         @source_language = source_language
@@ -215,6 +278,7 @@ module Lara
         @glossaries_matches = glossaries_matches
         @profanities = profanities
         @styleguide_results = styleguide_results
+        @warnings = warnings
       end
 
       class << self

data/lib/lara/translator.rb

@@ -56,6 +56,8 @@ module Lara
     # @param verbose [Boolean]
     # @param style [String,nil]
     # @param reasoning [Boolean] When true with a block, yields partial results during reasoning
+    # @param image_context [Hash,Array<Hash>,nil] One HTTPS or base64 PNG/JPEG/WebP image; requires reasoning when non-empty.
+    #   Image validation is performed by the API. An empty array preserves text-only translation.
     # @param headers [Hash,nil]
     # @param metadata [String, Hash, nil]
     # @param profanities_detect [String,nil] One of "target", "source_target"
@@ -65,7 +67,7 @@ module Lara
     def translate(text, target:, source: nil, source_hint: nil, adapt_to: nil, glossaries: nil,
                   instructions: nil, content_type: nil, multiline: true, timeout_ms: nil,
                   priority: nil, use_cache: nil, cache_ttl_s: nil, no_trace: false, verbose: false,
-                  style: nil, reasoning: false, headers: nil, metadata: nil,
+                  style: nil, reasoning: false, image_context: nil, headers: nil, metadata: nil,
                   profanities_detect: nil, profanities_handling: nil,
                   styleguide_id: nil, styleguide_reasoning: nil,
                   styleguide_explanation_language: nil, &callback)
@@ -94,6 +96,7 @@ module Lara
         verbose: verbose,
         style: style,
         reasoning: reasoning,
+        image_context: image_context,
         metadata: metadata,
         profanities_detect: profanities_detect,
         profanities_handling: profanities_handling,

data/lib/lara/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lara
-  VERSION = "1.9.2"
+  VERSION = "1.10.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lara-sdk
 version: !ruby/object:Gem::Version
-  version: 1.9.2
+  version: 1.10.0
 platform: ruby
 authors:
 - Translated
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-15 00:00:00.000000000 Z
+date: 2026-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday