liter_llm 1.6.4-x86_64-linux → 1.7.1-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f64a7d556ea441560cb7c11e6c07a5215e9c92e99f05eee02b420a37708f4f4
-  data.tar.gz: 92588b69aa8c122e09ab8f019ca855856ff52ea26646853a44b5d5e2804b3ab2
+  metadata.gz: 0f71313b1bd53ae7bb282e25265f8e3dbcdad617c2802e917489b290b94b55bb
+  data.tar.gz: 5666fa2823976a798088bfd0a715b78672ebd96fbceae5aed06729609d3970ee
 SHA512:
-  metadata.gz: 2192226a898aa995815ec44ba461c85a911da2f782c83649682ea2262b91348cef659e4aa537d7b47954401cc1e2607b37b473f077b4b92631527bcc489191fe
-  data.tar.gz: 80478f44ce80349ddc4e9c2704f97829e3b9a483e1467fcca2c3f45abbd7aa27068dfbbf22303400f20b75709155ae68b8faaee56c266ce261dc654239d1a939
+  metadata.gz: da9f6025473b768d5a8460bc0815057f77891a4f9f13093ee7dcbda845e1a066c925aa74234c7911e15fe010bc89b60344f6cf2b6d8b7a41d02764371479c786
+  data.tar.gz: 8119e62a3827e2a684d71f12e00c6c12f0cea7cfa203d8946a4db33a7e765ad604dffbc856d06d755072f5ecbee7e8ac6487537d93339380fc252ab1e03bfd34

data/lib/liter_llm/native.rb

@@ -1,5 +1,5 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:52effca2513e1c5f8a9a5b90a372d645388de4b92e4f822acc38d97502c322b6
+# alef:hash:fec9b44a56d9714b7b12931bb48e1e8f6d57ef2d0ccaad1f9ac6046ce01a89af
 # To regenerate: alef generate
 # To verify freshness: alef verify --exit-code
 # frozen_string_literal: true
@@ -314,7 +314,142 @@ module LiterLlm
 end
 
 module LiterLlm
-  # Response format constraint.
+  # One part of a structured assistant response.
+  #
+  # `#[serde(tag = "type", rename_all = "snake_case")]` matches OpenAI's
+  # parts-spec discriminator (`"type": "text"`, `"type": "output_image"`, …).
+  module AssistantPart
+    extend T::Helpers
+    extend T::Sig
+
+    interface!
+
+    # Dispatch from a Hash to the appropriate variant constructor.
+    # @param hash [Hash] with discriminator field and variant-specific fields
+    # @return [variant_class] an instance of the appropriate variant
+    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.untyped) }
+    def self.from_hash(hash)
+      discriminator = hash[:type] || hash["type"]
+      case discriminator
+      when "text" then AssistantPartText.from_hash(hash)
+      when "refusal" then AssistantPartRefusal.from_hash(hash)
+      when "output_image" then AssistantPartOutputImage.from_hash(hash)
+      when "output_audio" then AssistantPartOutputAudio.from_hash(hash)
+      else raise "Unknown discriminator: #{discriminator}"
+      end
+    end
+  end
+  ## A text segment of the response.
+  AssistantPartText = Data.define(:text) do
+    include AssistantPart
+    extend T::Sig
+
+    # The text content of this part.
+    sig { returns(String) }
+    def text = super # rubocop:disable Lint/UselessMethodDefinition
+    sig { returns(T::Boolean) }
+    def text? = true
+    sig { returns(T::Boolean) }
+    def refusal? = false
+    sig { returns(T::Boolean) }
+    def output_image? = false
+    sig { returns(T::Boolean) }
+    def output_audio? = false
+    # @param hash [Hash] deserialized from the native extension
+    # @return [self]
+    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
+    def self.from_hash(hash)
+      new(text: hash[:text] || hash["text"])
+    end
+  end
+  ## A refusal — the model declined to respond.
+  AssistantPartRefusal = Data.define(:refusal) do
+    include AssistantPart
+    extend T::Sig
+
+    # The refusal reason.
+    sig { returns(String) }
+    def refusal = super # rubocop:disable Lint/UselessMethodDefinition
+    sig { returns(T::Boolean) }
+    def text? = false
+    sig { returns(T::Boolean) }
+    def refusal? = true
+    sig { returns(T::Boolean) }
+    def output_image? = false
+    sig { returns(T::Boolean) }
+    def output_audio? = false
+    # @param hash [Hash] deserialized from the native extension
+    # @return [self]
+    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
+    def self.from_hash(hash)
+      new(refusal: hash[:refusal] || hash["refusal"])
+    end
+  end
+  ## An image produced by the model (e.g. `gpt-image-1`, Gemini Imagen).
+  AssistantPartOutputImage = Data.define(:image_url) do
+    include AssistantPart
+    extend T::Sig
+
+    # Image URL or data URI referencing the generated image.
+    sig { returns(ImageUrl) }
+    def image_url = super # rubocop:disable Lint/UselessMethodDefinition
+    sig { returns(T::Boolean) }
+    def text? = false
+    sig { returns(T::Boolean) }
+    def refusal? = false
+    sig { returns(T::Boolean) }
+    def output_image? = true
+    sig { returns(T::Boolean) }
+    def output_audio? = false
+    # @param hash [Hash] deserialized from the native extension
+    # @return [self]
+    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
+    def self.from_hash(hash)
+      new(image_url: hash[:image_url] || hash["image_url"])
+    end
+  end
+  ## Audio produced by the model (e.g. `gpt-4o-audio-preview`).
+  AssistantPartOutputAudio = Data.define(:audio) do
+    include AssistantPart
+    extend T::Sig
+
+    # Base64-encoded audio data and its format.
+    sig { returns(AudioContent) }
+    def audio = super # rubocop:disable Lint/UselessMethodDefinition
+    sig { returns(T::Boolean) }
+    def text? = false
+    sig { returns(T::Boolean) }
+    def refusal? = false
+    sig { returns(T::Boolean) }
+    def output_image? = false
+    sig { returns(T::Boolean) }
+    def output_audio? = true
+    # @param hash [Hash] deserialized from the native extension
+    # @return [self]
+    sig { params(hash: T::Hash[T.untyped, T.untyped]).returns(T.attached_class) }
+    def self.from_hash(hash)
+      new(audio: hash[:audio] || hash["audio"])
+    end
+  end
+end
+
+module LiterLlm
+  # Wire format for the chat completions `response_format` field.
+  #
+  # # Provider mapping
+  #
+  # - **OpenAI** (and OpenAI-compatible providers): emitted verbatim as
+  #   `{"type": "json_schema", "json_schema": {...}}` per the
+  #   chat-completions spec.
+  # - **Gemini / Vertex AI**: translated to
+  #   `generationConfig.responseMimeType = "application/json"` and
+  #   `generationConfig.responseSchema = <schema>`. The `name`,
+  #   `description`, and `strict` fields are dropped — Gemini's
+  #   structured-output API does not consume them.
+  # - **Anthropic**: no native JSON mode. A system instruction is
+  #   prepended asking the model to respond with valid JSON.
+  #   `strict` is advisory only; callers should still validate the
+  #   returned JSON if the schema is load-bearing.
   module ResponseFormat
     extend T::Helpers
     extend T::Sig

data/lib/liter_llm/version.rb

@@ -1,10 +1,10 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:52effca2513e1c5f8a9a5b90a372d645388de4b92e4f822acc38d97502c322b6
+# alef:hash:fec9b44a56d9714b7b12931bb48e1e8f6d57ef2d0ccaad1f9ac6046ce01a89af
 # To regenerate: alef generate
 # To verify freshness: alef verify --exit-code
 # frozen_string_literal: true
 
 module LiterLlm
   ## The version string for this package.
-  VERSION = "1.6.4"
+  VERSION = "1.7.1"
 end

data/lib/liter_llm.rb

@@ -1,5 +1,5 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:52effca2513e1c5f8a9a5b90a372d645388de4b92e4f822acc38d97502c322b6
+# alef:hash:fec9b44a56d9714b7b12931bb48e1e8f6d57ef2d0ccaad1f9ac6046ce01a89af
 # To regenerate: alef generate
 # To verify freshness: alef verify --exit-code
 # frozen_string_literal: true

data/sig/types.rbs

@@ -1,5 +1,5 @@
 # This file is auto-generated by alef — DO NOT EDIT.
-# alef:hash:52effca2513e1c5f8a9a5b90a372d645388de4b92e4f822acc38d97502c322b6
+# alef:hash:fec9b44a56d9714b7b12931bb48e1e8f6d57ef2d0ccaad1f9ac6046ce01a89af
 # To regenerate: alef generate
 # To verify freshness: alef verify --exit-code
 
@@ -10,10 +10,10 @@ module LiterLlm
   type json_value = Hash[String, untyped] | Array[untyped] | String | Integer | Float | bool | nil
 
   class SystemMessage
-    attr_accessor content: String?
+    attr_accessor content: UserContent?
     attr_accessor name: String?
 
-    def initialize: (?content: String, ?name: String) -> void
+    def initialize: (?content: UserContent, ?name: String) -> void
   end
 
   class UserMessage
@@ -45,13 +45,17 @@ module LiterLlm
   end
 
   class AssistantMessage
-    attr_accessor content: String?
+    attr_accessor content: AssistantContent?
     attr_accessor name: String?
     attr_accessor tool_calls: Array[ToolCall]?
     attr_accessor refusal: String?
     attr_accessor function_call: FunctionCall?
 
-    def initialize: (?content: String, ?name: String, ?tool_calls: Array[ToolCall], ?refusal: String, ?function_call: FunctionCall) -> void
+    def initialize: (?content: AssistantContent, ?name: String, ?tool_calls: Array[ToolCall], ?refusal: String, ?function_call: FunctionCall) -> void
+    def text: () -> String?
+    def refusal_text: () -> String?
+    def output_images: () -> Array[ImageUrl]
+    def output_audio: () -> Array[AudioContent]
   end
 
   class ToolMessage
@@ -165,9 +169,10 @@ module LiterLlm
     attr_accessor stream_options: StreamOptions?
     attr_accessor seed: Integer?
     attr_accessor reasoning_effort: ReasoningEffort?
+    attr_accessor modalities: Array[Modality]?
     attr_accessor extra_body: json_value?
 
-    def initialize: (?model: String, ?messages: Array[Message], ?temperature: Float, ?top_p: Float, ?n: Integer, ?stream: bool, ?stop: StopSequence, ?max_tokens: Integer, ?presence_penalty: Float, ?frequency_penalty: Float, ?logit_bias: Hash[String, Float], ?user: String, ?tools: Array[ChatCompletionTool], ?tool_choice: ToolChoice, ?parallel_tool_calls: bool, ?response_format: ResponseFormat, ?stream_options: StreamOptions, ?seed: Integer, ?reasoning_effort: ReasoningEffort, ?extra_body: json_value) -> void
+    def initialize: (?model: String, ?messages: Array[Message], ?temperature: Float, ?top_p: Float, ?n: Integer, ?stream: bool, ?stop: StopSequence, ?max_tokens: Integer, ?presence_penalty: Float, ?frequency_penalty: Float, ?logit_bias: Hash[String, Float], ?user: String, ?tools: Array[ChatCompletionTool], ?tool_choice: ToolChoice, ?parallel_tool_calls: bool, ?response_format: ResponseFormat, ?stream_options: StreamOptions, ?seed: Integer, ?reasoning_effort: ReasoningEffort, ?modalities: Array[Modality], ?extra_body: json_value) -> void
   end
 
   class StreamOptions
@@ -299,6 +304,13 @@ module LiterLlm
     def initialize: (?url: String, ?b64_json: String, ?revised_prompt: String) -> void
   end
 
+  class DecodedDataUrl
+    attr_accessor mime: String?
+    attr_accessor data: String?
+
+    def initialize: (?mime: String, ?data: String) -> void
+  end
+
   class CreateSpeechRequest
     attr_accessor model: String?
     attr_accessor input: String?
@@ -780,6 +792,12 @@ module LiterLlm
     type value = :low | :high | :auto
   end
 
+  class AssistantContent
+  end
+
+  class AssistantPart
+  end
+
   class ToolType
     type value = :function
   end
@@ -797,6 +815,10 @@ module LiterLlm
   class StopSequence
   end
 
+  class Modality
+    type value = :text | :audio | :image
+  end
+
   class FinishReason
     type value = :stop | :length | :tool_calls | :content_filter | :function_call | :other
   end
@@ -859,6 +881,10 @@ module LiterLlm
 
   def self.create_client_from_json: (String json) -> DefaultClient
 
+  def self.encode_data_url: (String bytes, ?String mime) -> String
+
+  def self.decode_data_url: (String url) -> DecodedDataUrl?
+
   def self.register_custom_provider: (CustomProviderConfig config) -> void
 
   def self.unregister_custom_provider: (String name) -> bool

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: liter_llm
 version: !ruby/object:Gem::Version
-  version: 1.6.4
+  version: 1.7.1
 platform: x86_64-linux
 authors:
 - Na'aman Hirschfeld
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-17 00:00:00.000000000 Z
+date: 2026-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sorbet-runtime