liter_llm 1.4.0.pre.rc.27-x86_64-linux → 1.4.0.pre.rc.29-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 883494e4d2cd69849909a810b0bfe2aea1c8707055b3614b09d68920623aff75
-  data.tar.gz: 504ec8ce7d395e2556e12e6e96b27410f69a4a82170269b612531c6aba61063e
+  metadata.gz: f1fbe232a406fd0fdee9c5616c4800a0e6a7baa4caac9a3b0a215285cecf72f1
+  data.tar.gz: 7f3cc7ddb324164d38ef8f7d6152d53254ef560b5e812f1a139953c17fb30183
 SHA512:
-  metadata.gz: 8ca27aee5fe47a5af419cf1e01d43a8fac41c2e80893471fe24f7809cdd62effcb928b59be7c0e2fb064474ea45e7c441d736628d6c6cca9b50317cc22b14502
-  data.tar.gz: 5c25a760b4f9673fcb33d94045b38e6319ad8b83264b23cbb3f9b60e02e343b13c0b355afa14aa34acd0697d63fe18e8321f35c717da3c079047044a835bc5d6
+  metadata.gz: 651e9e2f47a8b7c74224f4b69cf48d3a7d8c4529d8ba68f30c27c396430c25bdac4ba8650255395bfb8bd8f0d59ce7769cc05b266122d693f1d35b03211eaaa6
+  data.tar.gz: 5728b31387997e1994d10940cbbc4640f97d6ce1e1fccb7ce89cc5a4bc6e57335c8e7f7d4929860cb754a8d976bbf8fd05e20bf58593352f73f421523f9cc1b1

data/Steepfile

@@ -1,18 +1,6 @@
 # frozen_string_literal: true
 
-# Steep configuration for the LiterLlm Ruby package.
-
 target :lib do
   signature 'sig'
-
   check 'lib'
-
-  # Standard library used by the wrapper layer.
-  library 'json'
-
-  # Strategic ignores:
-
-  # 1. Native extension entry point — methods are defined in Rust via Magnus
-  #    and cannot be resolved by Steep's static analysis.
-  ignore 'lib/liter_llm_rb.rb' if File.exist?('lib/liter_llm_rb.rb')
 end

data/lib/liter_llm/native.rb

@@ -0,0 +1,628 @@
+# This file is auto-generated by alef — DO NOT EDIT.
+# alef:hash:5eaeda34a14cac3162d7a94cbbc45e5fe3cea5acf5327a1a76bbf2a3f99f4b8f
+# To regenerate: alef generate
+# To verify freshness: alef verify --exit-code
+# Issues & docs: https://github.com/kreuzberg-dev/alef
+# frozen_string_literal: true
+
+require 'json'
+require 'sorbet-runtime'
+require 'liter_llm_rb'
+module LiterLlm
+  # A chat message in a conversation.
+  module Message
+    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[:role] || hash["role"]
+      case discriminator
+      when "system" then MessageSystem.from_hash(hash)
+      when "user" then MessageUser.from_hash(hash)
+      when "assistant" then MessageAssistant.from_hash(hash)
+      when "tool" then MessageTool.from_hash(hash)
+      when "developer" then MessageDeveloper.from_hash(hash)
+      when "function" then MessageFunction.from_hash(hash)
+      else raise "Unknown discriminator: #{discriminator}"
+      end
+    end
+
+  end
+
+  # Variant MessageSystem of the Message sum type.
+  MessageSystem = Data.define(:value) do
+    include Message
+    extend T::Sig
+
+    # @return [SystemMessage]
+    sig { returns(SystemMessage) }
+    def value = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def system? = true
+
+    sig { returns(T::Boolean) }
+    def user? = false
+
+    sig { returns(T::Boolean) }
+    def assistant? = false
+
+    sig { returns(T::Boolean) }
+    def tool? = false
+
+    sig { returns(T::Boolean) }
+    def developer? = false
+
+    sig { returns(T::Boolean) }
+    def function? = 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(value: hash[:_0] || hash["_0"])
+    end
+  end
+
+  # Variant MessageUser of the Message sum type.
+  MessageUser = Data.define(:value) do
+    include Message
+    extend T::Sig
+
+    # @return [UserMessage]
+    sig { returns(UserMessage) }
+    def value = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def system? = false
+
+    sig { returns(T::Boolean) }
+    def user? = true
+
+    sig { returns(T::Boolean) }
+    def assistant? = false
+
+    sig { returns(T::Boolean) }
+    def tool? = false
+
+    sig { returns(T::Boolean) }
+    def developer? = false
+
+    sig { returns(T::Boolean) }
+    def function? = 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(value: hash[:_0] || hash["_0"])
+    end
+  end
+
+  # Variant MessageAssistant of the Message sum type.
+  MessageAssistant = Data.define(:value) do
+    include Message
+    extend T::Sig
+
+    # @return [AssistantMessage]
+    sig { returns(AssistantMessage) }
+    def value = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def system? = false
+
+    sig { returns(T::Boolean) }
+    def user? = false
+
+    sig { returns(T::Boolean) }
+    def assistant? = true
+
+    sig { returns(T::Boolean) }
+    def tool? = false
+
+    sig { returns(T::Boolean) }
+    def developer? = false
+
+    sig { returns(T::Boolean) }
+    def function? = 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(value: hash[:_0] || hash["_0"])
+    end
+  end
+
+  # Variant MessageTool of the Message sum type.
+  MessageTool = Data.define(:value) do
+    include Message
+    extend T::Sig
+
+    # @return [ToolMessage]
+    sig { returns(ToolMessage) }
+    def value = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def system? = false
+
+    sig { returns(T::Boolean) }
+    def user? = false
+
+    sig { returns(T::Boolean) }
+    def assistant? = false
+
+    sig { returns(T::Boolean) }
+    def tool? = true
+
+    sig { returns(T::Boolean) }
+    def developer? = false
+
+    sig { returns(T::Boolean) }
+    def function? = 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(value: hash[:_0] || hash["_0"])
+    end
+  end
+
+  # Variant MessageDeveloper of the Message sum type.
+  MessageDeveloper = Data.define(:value) do
+    include Message
+    extend T::Sig
+
+    # @return [DeveloperMessage]
+    sig { returns(DeveloperMessage) }
+    def value = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def system? = false
+
+    sig { returns(T::Boolean) }
+    def user? = false
+
+    sig { returns(T::Boolean) }
+    def assistant? = false
+
+    sig { returns(T::Boolean) }
+    def tool? = false
+
+    sig { returns(T::Boolean) }
+    def developer? = true
+
+    sig { returns(T::Boolean) }
+    def function? = 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(value: hash[:_0] || hash["_0"])
+    end
+  end
+
+  # Deprecated legacy function-role message; retained for API compatibility.
+  MessageFunction = Data.define(:value) do
+    include Message
+    extend T::Sig
+
+    # @return [FunctionMessage]
+    sig { returns(FunctionMessage) }
+    def value = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def system? = false
+
+    sig { returns(T::Boolean) }
+    def user? = false
+
+    sig { returns(T::Boolean) }
+    def assistant? = false
+
+    sig { returns(T::Boolean) }
+    def tool? = false
+
+    sig { returns(T::Boolean) }
+    def developer? = false
+
+    sig { returns(T::Boolean) }
+    def function? = 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(value: hash[:_0] || hash["_0"])
+    end
+  end
+
+end
+
+module LiterLlm
+  # A single content part in a user message — text, image, document, or audio.
+  module ContentPart
+    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 ContentPartText.from_hash(hash)
+      when "image_url" then ContentPartImageUrl.from_hash(hash)
+      when "document" then ContentPartDocument.from_hash(hash)
+      when "input_audio" then ContentPartInputAudio.from_hash(hash)
+      else raise "Unknown discriminator: #{discriminator}"
+      end
+    end
+
+  end
+
+  # Plain text.
+  ContentPartText = Data.define(:text) do
+    include ContentPart
+    extend T::Sig
+
+    # @return [String]
+    sig { returns(String) }
+    def text = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def text? = true
+
+    sig { returns(T::Boolean) }
+    def image_url? = false
+
+    sig { returns(T::Boolean) }
+    def document? = false
+
+    sig { returns(T::Boolean) }
+    def input_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
+
+  # Image identified by URL (with optional detail level).
+  ContentPartImageUrl = Data.define(:image_url) do
+    include ContentPart
+    extend T::Sig
+
+    # @return [ImageUrl]
+    sig { returns(ImageUrl) }
+    def image_url = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def text? = false
+
+    sig { returns(T::Boolean) }
+    def image_url? = true
+
+    sig { returns(T::Boolean) }
+    def document? = false
+
+    sig { returns(T::Boolean) }
+    def input_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
+
+  # Document file (PDF, CSV, etc.) as base64 or URL.
+  ContentPartDocument = Data.define(:document) do
+    include ContentPart
+    extend T::Sig
+
+    # @return [DocumentContent]
+    sig { returns(DocumentContent) }
+    def document = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def text? = false
+
+    sig { returns(T::Boolean) }
+    def image_url? = false
+
+    sig { returns(T::Boolean) }
+    def document? = true
+
+    sig { returns(T::Boolean) }
+    def input_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(document: hash[:document] || hash["document"])
+    end
+  end
+
+  # Audio input as base64.
+  ContentPartInputAudio = Data.define(:input_audio) do
+    include ContentPart
+    extend T::Sig
+
+    # @return [AudioContent]
+    sig { returns(AudioContent) }
+    def input_audio = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def text? = false
+
+    sig { returns(T::Boolean) }
+    def image_url? = false
+
+    sig { returns(T::Boolean) }
+    def document? = false
+
+    sig { returns(T::Boolean) }
+    def input_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(input_audio: hash[:input_audio] || hash["input_audio"])
+    end
+  end
+
+end
+
+module LiterLlm
+  # Response format constraint.
+  module ResponseFormat
+    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 ResponseFormatText.from_hash(hash)
+      when "json_object" then ResponseFormatJsonObject.from_hash(hash)
+      when "json_schema" then ResponseFormatJsonSchema.from_hash(hash)
+      else raise "Unknown discriminator: #{discriminator}"
+      end
+    end
+
+  end
+
+  # Plain text output (default).
+  ResponseFormatText = Data.define do
+    include ResponseFormat
+    extend T::Sig
+
+    sig { returns(T::Boolean) }
+    def text? = true
+
+    sig { returns(T::Boolean) }
+    def json_object? = false
+
+    sig { returns(T::Boolean) }
+    def json_schema? = 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
+    end
+  end
+
+  # Output must be valid JSON object (no schema validation).
+  ResponseFormatJsonObject = Data.define do
+    include ResponseFormat
+    extend T::Sig
+
+    sig { returns(T::Boolean) }
+    def text? = false
+
+    sig { returns(T::Boolean) }
+    def json_object? = true
+
+    sig { returns(T::Boolean) }
+    def json_schema? = 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
+    end
+  end
+
+  # Output must conform to the specified JSON schema.
+  ResponseFormatJsonSchema = Data.define(:json_schema) do
+    include ResponseFormat
+    extend T::Sig
+
+    # @return [JsonSchemaFormat]
+    sig { returns(JsonSchemaFormat) }
+    def json_schema = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def text? = false
+
+    sig { returns(T::Boolean) }
+    def json_object? = false
+
+    sig { returns(T::Boolean) }
+    def json_schema? = 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(json_schema: hash[:json_schema] || hash["json_schema"])
+    end
+  end
+
+end
+
+module LiterLlm
+  # Document input for OCR — either a URL or inline base64 data.
+  module OcrDocument
+    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 "document_url" then OcrDocumentUrl.from_hash(hash)
+      when "base64" then OcrDocumentBase64.from_hash(hash)
+      else raise "Unknown discriminator: #{discriminator}"
+      end
+    end
+
+  end
+
+  # A publicly accessible document URL.
+  OcrDocumentUrl = Data.define(:url) do
+    include OcrDocument
+    extend T::Sig
+
+    # The document URL (HTTP/HTTPS).
+    sig { returns(String) }
+    def url = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def url? = true
+
+    sig { returns(T::Boolean) }
+    def base64? = 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(url: hash[:url] || hash["url"])
+    end
+  end
+
+  # Inline base64-encoded document data.
+  OcrDocumentBase64 = Data.define(:data, :media_type) do
+    include OcrDocument
+    extend T::Sig
+
+    # Base64-encoded document content.
+    sig { returns(String) }
+    def data = super # rubocop:disable Lint/UselessMethodDefinition
+
+    # MIME type (e.g. `"application/pdf"`, `"image/png"`, `"image/jpeg"`).
+    sig { returns(String) }
+    def media_type = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def url? = false
+
+    sig { returns(T::Boolean) }
+    def base64? = 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(data: hash[:data] || hash["data"], media_type: hash[:media_type] || hash["media_type"])
+    end
+  end
+
+end
+
+module LiterLlm
+  # Storage backend for the response cache.
+  module CacheBackend
+    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 "memory" then CacheBackendMemory.from_hash(hash)
+      when "open_dal" then CacheBackendOpenDal.from_hash(hash)
+      else raise "Unknown discriminator: #{discriminator}"
+      end
+    end
+
+  end
+
+  # In-memory LRU cache (default). No external dependencies.
+  CacheBackendMemory = Data.define do
+    include CacheBackend
+    extend T::Sig
+
+    sig { returns(T::Boolean) }
+    def memory? = true
+
+    sig { returns(T::Boolean) }
+    def open_dal? = 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
+    end
+  end
+
+  # OpenDAL-backed storage. Supports 40+ backends (S3, Redis, GCS, local FS, etc.).
+  CacheBackendOpenDal = Data.define(:scheme, :config) do
+    include CacheBackend
+    extend T::Sig
+
+    # OpenDAL scheme name (e.g. "s3", "redis", "fs", "gcs", "azblob").
+    sig { returns(String) }
+    def scheme = super # rubocop:disable Lint/UselessMethodDefinition
+
+    # Backend-specific configuration as key-value pairs passed to OpenDAL.
+    sig { returns(T::Hash[String, String]) }
+    def config = super # rubocop:disable Lint/UselessMethodDefinition
+
+    sig { returns(T::Boolean) }
+    def memory? = false
+
+    sig { returns(T::Boolean) }
+    def open_dal? = 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(scheme: hash[:scheme] || hash["scheme"], config: hash[:config] || hash["config"])
+    end
+  end
+
+end

data/lib/liter_llm/version.rb

@@ -0,0 +1,10 @@
+# This file is auto-generated by alef — DO NOT EDIT.
+# alef:hash:bb4ea25903074aa895a421146740df576392e90d6785c18ec57ce6b8d9347fda
+# To regenerate: alef generate
+# To verify freshness: alef verify --exit-code
+# Issues & docs: https://github.com/kreuzberg-dev/alef
+# frozen_string_literal: true
+
+module LiterLlm
+  VERSION = '1.4.0.pre.rc.29'
+end

data/lib/liter_llm.rb

@@ -1,3 +1,13 @@
+# This file is auto-generated by alef — DO NOT EDIT.
+# alef:hash:012bd4e1dc47a9ae9de57cc0db4d8edc929648b7f8b829b96afe0410c1979847
+# To regenerate: alef generate
+# To verify freshness: alef verify --exit-code
+# Issues & docs: https://github.com/kreuzberg-dev/alef
 # frozen_string_literal: true
 
-require 'liter_llm_rb'
+require_relative 'liter_llm/version'
+require_relative 'liter_llm/native'
+
+module LiterLlm
+  # Re-export all types and functions from native extension
+end