liter_llm 1.6.4-arm64-darwin → 1.7.1-arm64-darwin

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a564ff4eba0c64383ec49751c50dfa57750281b862918ae785120dcb32e4633
-  data.tar.gz: eefd78d853975605fcf9a5c152f48045f0170a6b4ca753b1bc6b436dffb1fb26
+  metadata.gz: 8a2b9ed8fc19c69fe2aacde9b8cab8432a3258a82e272da0ddc417074e837467
+  data.tar.gz: f2ec079bfcb60156446d84e8690b6a734526ada7702b15a8ad0c28f88749265c
 SHA512:
-  metadata.gz: f5cd698365b795f31cf992bcde2c9a2d784cc65f26eb616b9d8e1f34d0e1bf99ed71d0b551d11b4ed399360d565ab5c03325678884d486ce972a3a556d4d9470
-  data.tar.gz: 305f733ae0fd572b65cf43cf2ad260795f02f5d816780313bbd4ef539a8a63b6cc7c3b7c639883eae454d719e443909cb396953169cf12b3d2efdca1d10e8715
+  metadata.gz: 18bbc36d9f3e402a036331375a7c4d7a6164c1abc4321eb07a3e23fb7acc745883d181052b00b8acad60778d751aef68ee354c352fc166b8724b0421e961be66
+  data.tar.gz: 1decbb6f551484411487a3786eef9404a7817d581215d4be58f5faf5c7cfe8b1c662cab2033cb11531c032e642f9dd51637b6929308b9bcd4190e2deb68935ca

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: arm64-darwin
 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