gigachat-ruby 0.1.0

data/lib/gigachat/types/chat_completion.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    # Response of POST /v2/chat/completions.
+    class ChatCompletion < Base
+      attribute :model
+      attribute :thread_id
+      attribute :message_id
+      attribute :messages, Message, array: true
+      attribute :finish_reason
+      attribute :usage, Usage
+      attribute :additional_data
+
+      # The spec documents `created_at`; the Python SDK also accepts `created`.
+      def created_at = self[:created_at] || self[:created]
+
+      def text = assistant_messages.map(&:text).join
+
+      def message = assistant_messages.first
+
+      def function_call = parts.find(&:function_call)&.function_call
+
+      def files = parts.flat_map { it.files || [] }
+
+      private
+
+      def assistant_messages = (messages || []).select { [nil, "assistant"].include?(it.role) }
+
+      def parts = (messages || []).flat_map { it.content || [] }
+    end
+  end
+end

data/lib/gigachat/types/chat_event.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    # One named SSE event of a v2 stream (`response.message.delta`, `response.message.done`, ...).
+    class ChatEvent < ChatCompletion
+      DELTA = "response.message.delta"
+      DONE = "response.message.done"
+      TOOL_IN_PROGRESS = "response.tool.in_progress"
+      TOOL_COMPLETED = "response.tool.completed"
+
+      attr_reader :type
+
+      def initialize(data = {}, type: nil, x_headers: nil)
+        super(data, x_headers:)
+        @type = type
+      end
+
+      def delta? = type == DELTA
+
+      def done? = type == DONE
+
+      def tool_in_progress? = type == TOOL_IN_PROGRESS
+
+      def tool_completed? = type == TOOL_COMPLETED
+    end
+  end
+end

data/lib/gigachat/types/content_part.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class ContentPart < Base
+      attribute :text
+      attribute :files, FileRef, array: true
+      attribute :function_call, FunctionCall
+      attribute :function_result
+      attribute :tool_execution, ToolExecution
+      attribute :logprobs
+      attribute :inline_data
+    end
+  end
+end

data/lib/gigachat/types/embedding.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class Embedding < Base
+      attribute :object
+      attribute :embedding
+      attribute :index
+      attribute :usage
+    end
+  end
+end

data/lib/gigachat/types/embeddings.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class Embeddings < Base
+      enumerable :data, Embedding
+      attribute :model
+      attribute :object
+
+      def vectors = map(&:embedding)
+    end
+  end
+end

data/lib/gigachat/types/file_deleted.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class FileDeleted < Base
+      attribute :id
+      attribute :deleted
+      attribute :access_policy
+
+      def deleted? = deleted == true
+    end
+  end
+end

data/lib/gigachat/types/file_list.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class FileList < Base
+      enumerable :data, FileObject
+    end
+  end
+end

data/lib/gigachat/types/file_object.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class FileObject < Base
+      attribute :id
+      attribute :bytes
+      attribute :created_at
+      attribute :filename
+      attribute :object
+      attribute :purpose
+      attribute :access_policy
+      attribute :modalities
+    end
+  end
+end

data/lib/gigachat/types/file_ref.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class FileRef < Base
+      attribute :id
+      attribute :target
+      attribute :mime
+    end
+  end
+end

data/lib/gigachat/types/function_call.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class FunctionCall < Base
+      attribute :name
+
+      # The spec types arguments as a JSON string, but the API (and both official SDKs) send an object.
+      # Accept both and always hand back a Hash; the raw value stays available via `[:arguments]`.
+      def arguments
+        raw = self[:arguments]
+        return raw if raw.is_a?(Hash)
+        return {} unless raw.is_a?(String)
+
+        parsed = JSON.parse(raw, symbolize_names: true)
+        parsed.is_a?(Hash) ? parsed : {}
+      rescue JSON::ParserError
+        {}
+      end
+    end
+  end
+end

data/lib/gigachat/types/function_validation.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class FunctionValidation < Base
+      class Issue < Base
+        attribute :description
+        attribute :schema_location
+      end
+
+      attribute :status
+      attribute :message
+      attribute :json_ai_rules_version
+      attribute :errors, Issue, array: true
+      attribute :warnings, Issue, array: true
+
+      def valid? = (errors || []).empty?
+    end
+  end
+end

data/lib/gigachat/types/message.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class Message < Base
+      attribute :role
+      attribute :message_id
+      attribute :content, ContentPart, array: true
+
+      # The live API returns `tool_state_id` (checked 2026-10-02, and the request schema agrees), while the
+      # spec's response schema and the Python SDK say `tools_state_id`. Read either; the raw key is kept as
+      # is, so passing the message back sends exactly what the API returned.
+      def tools_state_id = self[:tools_state_id] || self[:tool_state_id]
+
+      alias tool_state_id tools_state_id
+
+      def text = (content || []).filter_map(&:text).join
+    end
+  end
+end

data/lib/gigachat/types/model.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class Model < Base
+      attribute :id
+      attribute :object
+      attribute :owned_by
+      attribute :type
+    end
+  end
+end

data/lib/gigachat/types/model_list.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class ModelList < Base
+      enumerable :data, Model
+      attribute :object
+    end
+  end
+end

data/lib/gigachat/types/tokens_count.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class TokensCount < Base
+      attribute :object
+      attribute :tokens
+      attribute :characters
+    end
+  end
+end

data/lib/gigachat/types/tokens_count_list.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    # POST /tokens/count returns a bare JSON array; the client wraps it as `{ data: [...] }`.
+    class TokensCountList < Base
+      enumerable :data, TokensCount
+    end
+  end
+end

data/lib/gigachat/types/tool_execution.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class ToolExecution < Base
+      attribute :name
+      attribute :status
+      attribute :seconds_left
+      attribute :censored
+    end
+  end
+end

data/lib/gigachat/types/usage.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    class Usage < Base
+      attribute :input_tokens
+      attribute :input_tokens_details
+      attribute :output_tokens
+      attribute :total_tokens
+    end
+  end
+end

data/lib/gigachat/types/v1/chat_completion.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    module V1
+      # Response of POST /chat/completions (v1).
+      class ChatCompletion < Base
+        attribute :choices, Choice, array: true
+        attribute :created
+        attribute :model
+        attribute :object
+        attribute :usage, Usage
+
+        def text = choices.to_a.first&.message&.content || ""
+      end
+    end
+  end
+end

data/lib/gigachat/types/v1/chat_completion_chunk.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    module V1
+      # One `data:` frame of a v1 stream.
+      class ChatCompletionChunk < Base
+        attribute :choices, Choice, array: true
+        attribute :created
+        attribute :model
+        attribute :object
+        attribute :usage, Usage
+
+        def text = (choices || []).filter_map { it.delta&.content }.join
+      end
+    end
+  end
+end

data/lib/gigachat/types/v1/choice.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    module V1
+      class Choice < Base
+        attribute :message, Message
+        attribute :delta, Message
+        attribute :index
+        attribute :finish_reason
+      end
+    end
+  end
+end

data/lib/gigachat/types/v1/message.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    module V1
+      class Message < Base
+        attribute :role
+        attribute :content
+        attribute :name
+        attribute :created
+        attribute :functions_state_id
+        attribute :function_call, FunctionCall
+      end
+    end
+  end
+end

data/lib/gigachat/types/v1/usage.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module GigaChat
+  module Types
+    module V1
+      class Usage < Base
+        attribute :prompt_tokens
+        attribute :completion_tokens
+        attribute :precached_prompt_tokens
+        attribute :total_tokens
+      end
+    end
+  end
+end

data/lib/gigachat/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module GigaChat
+  VERSION = "0.1.0"
+end

data/lib/gigachat-ruby.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+# Bundler auto-requires a gem by its name; the library's entry point is `require "gigachat"`.
+require_relative "gigachat"

data/lib/gigachat.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday/multipart"
+require "json"
+require "openssl"
+require "securerandom"
+require "stringio"
+require "time"
+require "uri"
+require "zeitwerk"
+
+# Ruby client for the GigaChat REST API.
+module GigaChat
+  LOADER = Zeitwerk::Loader.for_gem(warn_on_extra_files: false)
+  LOADER.inflector.inflect("gigachat" => "GigaChat", "sse_decoder" => "SSEDecoder")
+  # The shim's name is not a valid constant; errors.rb defines many constants and is required explicitly.
+  LOADER.ignore("#{__dir__}/gigachat-ruby.rb", "#{__dir__}/gigachat/errors.rb")
+  LOADER.setup
+
+  class << self
+    # Global defaults shared by every client built afterwards.
+    def config = @config ||= Configuration.new
+
+    def configure = yield(config)
+
+    def reset_config! = (@config = Configuration.new)
+  end
+end
+
+require_relative "gigachat/errors"

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification
+name: gigachat-ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Aleksandr Dryzhuk
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+description: 'Plain-Ruby client for Sber''s GigaChat API: chat (v2 and v1) with SSE
+  streaming, embeddings, files, batches, token counting and AI-text detection.'
+email:
+- dev@ad-it.pro
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/gigachat-ruby.rb
+- lib/gigachat.rb
+- lib/gigachat/auth/access_token.rb
+- lib/gigachat/auth/token_manager.rb
+- lib/gigachat/certs/russian_trusted_root_ca.pem
+- lib/gigachat/client.rb
+- lib/gigachat/configuration.rb
+- lib/gigachat/errors.rb
+- lib/gigachat/internal/chat_accumulator.rb
+- lib/gigachat/internal/mime_types.rb
+- lib/gigachat/internal/retry_policy.rb
+- lib/gigachat/internal/sse_decoder.rb
+- lib/gigachat/internal/transport.rb
+- lib/gigachat/internal/util.rb
+- lib/gigachat/internal/v1_chat_accumulator.rb
+- lib/gigachat/resources/base.rb
+- lib/gigachat/resources/batches.rb
+- lib/gigachat/resources/chat.rb
+- lib/gigachat/resources/chat_v1.rb
+- lib/gigachat/resources/embeddings.rb
+- lib/gigachat/resources/files.rb
+- lib/gigachat/resources/functions.rb
+- lib/gigachat/resources/models.rb
+- lib/gigachat/stream.rb
+- lib/gigachat/types/ai_check_result.rb
+- lib/gigachat/types/balance.rb
+- lib/gigachat/types/balance_entry.rb
+- lib/gigachat/types/base.rb
+- lib/gigachat/types/batch.rb
+- lib/gigachat/types/batch_list.rb
+- lib/gigachat/types/chat_completion.rb
+- lib/gigachat/types/chat_event.rb
+- lib/gigachat/types/content_part.rb
+- lib/gigachat/types/embedding.rb
+- lib/gigachat/types/embeddings.rb
+- lib/gigachat/types/file_deleted.rb
+- lib/gigachat/types/file_list.rb
+- lib/gigachat/types/file_object.rb
+- lib/gigachat/types/file_ref.rb
+- lib/gigachat/types/function_call.rb
+- lib/gigachat/types/function_validation.rb
+- lib/gigachat/types/message.rb
+- lib/gigachat/types/model.rb
+- lib/gigachat/types/model_list.rb
+- lib/gigachat/types/tokens_count.rb
+- lib/gigachat/types/tokens_count_list.rb
+- lib/gigachat/types/tool_execution.rb
+- lib/gigachat/types/usage.rb
+- lib/gigachat/types/v1/chat_completion.rb
+- lib/gigachat/types/v1/chat_completion_chunk.rb
+- lib/gigachat/types/v1/choice.rb
+- lib/gigachat/types/v1/message.rb
+- lib/gigachat/types/v1/usage.rb
+- lib/gigachat/version.rb
+homepage: https://github.com/amdest/gigachat-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/amdest/gigachat-ruby
+  source_code_uri: https://github.com/amdest/gigachat-ruby
+  changelog_uri: https://github.com/amdest/gigachat-ruby/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: Ruby client for the GigaChat REST API
+test_files: []