lara-sdk 1.9.1 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 370e00f8aea75a62aaa75afe314ccdac0917176902accfdeed31742b83cb1fdd
-  data.tar.gz: 251d5fb842d8aae2a055fd3705ac1af73def99396b342610accc07224e3f0569
+  metadata.gz: 33000e4a2972ae2f98c8e9b2e307122e4d729d1e50e5d78325fde5d5b7d470b4
+  data.tar.gz: 11a9586abaf2b895fe0d7f50f04470c462b80f83c44ffb33a9a4c869c30bb4bb
 SHA512:
-  metadata.gz: 006a24cc826bd26ddef6f73ff54f1721d8fa45f21358b51bab6a502c824ac2313f4c2ee38cc2ca8dd83952df8f961d8b9ce082aa6b0fb5e8c93867c9b5e978ce
-  data.tar.gz: e48c25fc3d1207010b55051516e1c50b83532127fdc57cbd11752680a973348557e78b5345a70fa856e43913bfca0cd87d437004361611f8b4212a3e8857321d
+  metadata.gz: bab5b019aaab9736023be72456df455558afcc17dce5060792c6b4d8fe73a34c81065a86320614437a234792b6ca204ddddd3884049e0927e51d16d894eb3441
+  data.tar.gz: 0a5bd84f86a55cce9ab60930178411857cc84df2534d6b91deb5300ab0e9ff12bdc126a7e374458d83a64c7cd105dda4ba6852b4eac313b40852e528941d7158

data/lib/lara/models/glossaries.rb

@@ -5,10 +5,10 @@ require_relative "base"
 module Lara
   module Models
     class Glossary < Base
-      attr_reader :id, :name, :owner_id, :created_at, :updated_at, :shared_at, :is_personal, :permission_mask
+      attr_reader :id, :name, :owner_id, :created_at, :updated_at, :shared_at, :permission_mask
 
       def initialize(id:, name:, owner_id:, created_at: nil, updated_at: nil, shared_at: nil,
-                     is_personal: nil, permission_mask: nil, **_kwargs)
+                     permission_mask: nil, **_kwargs)
         super()
         @id = id
         @name = name
@@ -16,8 +16,6 @@ module Lara
         @created_at = Base.parse_time(created_at)
         @updated_at = Base.parse_time(updated_at)
         @shared_at = Base.parse_time(shared_at)
-        # The API sends is_personal: true and omits the key otherwise; it never sends false or null.
-        @is_personal = is_personal || false
         # Effective combined mask in GET list/detail; selected share's stored mask in GET /shares.
         # Nil when omitted, including non-GET responses.
         @permission_mask = permission_mask

data/lib/lara/models/memories.rb

@@ -6,11 +6,11 @@ module Lara
   module Models
     class Memory < Base
       attr_reader :id, :created_at, :updated_at, :name, :external_id, :secret,
-                  :owner_id, :collaborators_count, :shared_at, :is_personal, :permission_mask
+                  :owner_id, :collaborators_count, :shared_at, :permission_mask
 
       def initialize(id:, name:, owner_id:, created_at: nil, updated_at: nil,
                      external_id: nil, secret: nil, collaborators_count: nil, shared_at: nil,
-                     is_personal: nil, permission_mask: nil, **_kwargs)
+                     permission_mask: nil, **_kwargs)
         super()
         @id = id
         @name = name
@@ -21,8 +21,6 @@ module Lara
         @secret = secret
         @collaborators_count = collaborators_count
         @shared_at = Base.parse_time(shared_at)
-        # The API sends is_personal: true and omits the key otherwise; it never sends false or null.
-        @is_personal = is_personal || false
         # Effective combined mask in GET list/detail; selected share's stored mask in GET /shares.
         # Nil when omitted, including non-GET responses.
         @permission_mask = permission_mask

data/lib/lara/models/text.rb

@@ -115,10 +115,10 @@ module Lara
     end
 
     class Styleguide < Base
-      attr_reader :id, :name, :content, :owner_id, :created_at, :updated_at, :shared_at, :is_personal, :permission_mask
+      attr_reader :id, :name, :content, :owner_id, :created_at, :updated_at, :shared_at, :permission_mask
 
       def initialize(id:, name:, content: nil, owner_id: nil, created_at: nil, updated_at: nil,
-                     shared_at: nil, is_personal: nil, permission_mask: nil, **_kwargs)
+                     shared_at: nil, permission_mask: nil, **_kwargs)
         super()
         @id = id
         @name = name
@@ -127,8 +127,6 @@ module Lara
         @created_at = Base.parse_time(created_at)
         @updated_at = Base.parse_time(updated_at)
         @shared_at = Base.parse_time(shared_at)
-        # The API sends is_personal: true and omits the key otherwise; it never sends false or null.
-        @is_personal = is_personal || false
         # Effective combined mask in GET list/detail; selected share's stored mask in GET /shares.
         # Nil when omitted, including non-GET responses.
         @permission_mask = permission_mask
@@ -169,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)
@@ -200,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
@@ -217,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.1"
+  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.1
+  version: 1.10.0
 platform: ruby
 authors:
 - Translated
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-06 00:00:00.000000000 Z
+date: 2026-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday