tungo-sdk 0.2.0

data/lib/tungo/models/chat_history_block.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Блок ответа в истории — те же виды, что клиент собирает из живого потока: text | tool | proposal |
+    # question | error
+    #
+    # The variant is selected by the +kind+ property. An object with a value this SDK version
+    # does not know is returned as a {Tungo::UnknownVariant}.
+    module ChatHistoryBlock
+      extend Tungo::Internal::Union
+
+      discriminated_by(
+        "kind",
+        "text" => :ChatHistoryText,
+        "tool" => :ChatHistoryTool,
+        "proposal" => :ChatHistoryProposal,
+        "question" => :ChatHistoryQuestion,
+        "error" => :ChatHistoryError
+      )
+      variants(
+        :ChatHistoryText,
+        :ChatHistoryTool,
+        :ChatHistoryProposal,
+        :ChatHistoryQuestion,
+        :ChatHistoryError
+      )
+    end
+  end
+end

data/lib/tungo/models/chat_history_error.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Ошибка хода
+    class ChatHistoryError < Tungo::Model
+      # @!attribute [r] code
+      #   Причина: - `budget` — кончился лимит (дня или разговора) - `rate_limited` — сервис модели
+      #   перегружен — повторите - `api` — сбой сервиса модели - `refusal` — модель отказалась отвечать
+      #   - `context_overflow` — разговор слиш…
+      #   @return [String, nil]
+      optional :code, :ChatHistoryErrorCode
+
+      # @!attribute [r] kind
+      #   Ошибка хода
+      #   @return [String]
+      required :kind, :string
+
+      # @!attribute [r] message
+      #   Текст для человека
+      #   @return [String]
+      required :message, :string
+    end
+  end
+end

data/lib/tungo/models/chat_history_error_code.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Причина: - `budget` — кончился лимит (дня или разговора) - `rate_limited` — сервис модели перегружен
+    # — повторите - `api` — сбой сервиса модели - `refusal` — модель отказалась отвечать -
+    # `context_overflow` — разговор слиш…
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ChatHistoryErrorCode
+      extend Tungo::Internal::Enum
+
+      BUDGET = "budget"
+      RATE_LIMITED = "rate_limited"
+      API = "api"
+      REFUSAL = "refusal"
+      CONTEXT_OVERFLOW = "context_overflow"
+      ABORTED = "aborted"
+      MAX_ITERATIONS = "max_iterations"
+      MAX_TOKENS = "max_tokens"
+      EMPTY_ANSWER = "empty_answer"
+      UNEXPECTED = "unexpected"
+      HISTORY = "history"
+      INTERNAL = "internal"
+      STREAM_FAILED = "stream_failed"
+      BATCH_FAILED = "batch_failed"
+      BATCH_ABANDONED = "batch_abandoned"
+    end
+  end
+end

data/lib/tungo/models/chat_history_proposal.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Подготовленный документ: карточку взять свежей — GET …/proposals/{proposal_id}
+    class ChatHistoryProposal < Tungo::Model
+      # @!attribute [r] kind
+      #   Подготовленный документ
+      #   @return [String]
+      required :kind, :string
+
+      # @!attribute [r] proposal_id
+      #   Номер предложения (P-000123): карточка — GET …/proposals/{id}
+      #   @return [String]
+      required :proposal_id, :string
+    end
+  end
+end

data/lib/tungo/models/chat_history_question.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Вопрос ИИ к человеку
+    class ChatHistoryQuestion < Tungo::Model
+      # @!attribute [r] kind
+      #   Вопрос ИИ
+      #   @return [String]
+      required :kind, :string
+
+      # @!attribute [r] proposal_id
+      #   Номер предложения, к которому вопрос
+      #   @return [String, nil]
+      optional :proposal_id, :string
+
+      # @!attribute [r] text
+      #   Вопрос
+      #   @return [String]
+      required :text, :string
+    end
+  end
+end

data/lib/tungo/models/chat_history_text.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Кусок ответа текстом
+    class ChatHistoryText < Tungo::Model
+      # @!attribute [r] kind
+      #   Текст ответа
+      #   @return [String]
+      required :kind, :string
+
+      # @!attribute [r] text
+      #   Текст (Markdown)
+      #   @return [String]
+      required :text, :string
+    end
+  end
+end

data/lib/tungo/models/chat_history_tool.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Шаг ИИ (вызов инструмента)
+    class ChatHistoryTool < Tungo::Model
+      # @!attribute [r] detail
+      #   Подробности или текст ошибки
+      #   @return [String, nil]
+      optional :detail, :string
+
+      # @!attribute [r] kind
+      #   Шаг ИИ
+      #   @return [String]
+      required :kind, :string
+
+      # @!attribute [r] name
+      #   Имя инструмента (машинное)
+      #   @return [String]
+      required :name, :string
+
+      # @!attribute [r] status
+      #   done — шаг выполнен; error — не получился
+      #   @return [String]
+      required :status, :ChatHistoryToolStatus
+
+      # @!attribute [r] title
+      #   Название шага по-русски
+      #   @return [String]
+      required :title, :string
+    end
+  end
+end

data/lib/tungo/models/chat_history_tool_status.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # done — шаг выполнен; error — не получился
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ChatHistoryToolStatus
+      extend Tungo::Internal::Enum
+
+      DONE = "done"
+      ERROR = "error"
+    end
+  end
+end

data/lib/tungo/models/chat_message.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Сообщение разговора: вопрос человека (role = user) или ответ ИИ (role = assistant)
+    #
+    # The variant is selected by the +role+ property. An object with a value this SDK version
+    # does not know is returned as a {Tungo::UnknownVariant}.
+    module ChatMessage
+      extend Tungo::Internal::Union
+
+      discriminated_by(
+        "role",
+        "user" => :ChatUserMessage,
+        "assistant" => :ChatAssistantMessage
+      )
+      variants(
+        :ChatUserMessage,
+        :ChatAssistantMessage
+      )
+    end
+  end
+end

data/lib/tungo/models/chat_message_request.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Вопрос ИИ-бухгалтеру
+    class ChatMessageRequest < Tungo::Model
+      # @!attribute [r] attachments
+      #   Файлы к вопросу. До 5 файлов, каждый до 10 МБ, все вместе до 14 МБ (до кодирования в base64).
+      #   Картинка — до 5 МБ, PDF — до 100 страниц. Форматы (по расширению имени): .pdf, .jpg, .jpeg,
+      #   .png, .webp, .docx, .xlsx, .xls, .…
+      #   @return [Array<Tungo::Models::ChatAttachment>, nil]
+      optional :attachments, array_of(:ChatAttachment)
+
+      # @!attribute [r] capabilities
+      #   Что умеет клиент: ["choice"] — показывать уточняющие вопросы с вариантами (событие choice).
+      #   Без него ИИ спрашивает обычным текстом
+      #   @return [Array<String>, nil]
+      optional :capabilities, array_of(:string)
+
+      # @!attribute [r] dialog_id
+      #   Продолжить разговор с этим id. Без него — новый разговор, его id придёт в заголовке
+      #   X-Dialog-Id
+      #   @return [String, nil]
+      optional :dialog_id, :string, nullable: true
+
+      # @!attribute [r] message
+      #   Вопрос человека, до 4000 знаков; можно не писать, если приложены файлы
+      #   @return [String, nil]
+      optional :message, :string
+
+      # @!attribute [r] mode
+      #   Режим хода: auto (по умолчанию) — ИИ сам решает, ответить или подготовить документ; ask —
+      #   только ответ и разбор, без документов; document — подготовить документ
+      #   @return [String, nil]
+      optional :mode, :ChatMessageRequestMode
+
+      # @!attribute [r] new_dialog
+      #   true — начать новый разговор именно с этим dialog_id (клиент задаёт id сам); id уже занят —
+      #   409
+      #   @return [Boolean, nil]
+      optional :new_dialog, :boolean
+
+      # @!attribute [r] proposal_id
+      #   Вопрос по предложению (кнопка «Ответить в чате» у карточки или в ленте): ход начнётся с этим
+      #   предложением в контексте — ИИ увидит его номер, статус, блокеры и предупреждения. Нет такого
+      #   предложения в компании — 404
+      #   @return [String, nil]
+      optional :proposal_id, :string, nullable: true
+
+      # @!attribute [r] stream
+      #   false — ответ одним JSON (ChatTurnResult), когда ход закончится; по умолчанию — поток SSE
+      #   @return [Boolean, nil]
+      optional :stream, :boolean
+
+      # @!attribute [r] turn
+      #   Номер последнего хода, который видел клиент (заголовок X-Turn-No): если сервер этот ход
+      #   потерял (перезапуск) — 410, начните новый разговор
+      #   @return [Integer, nil]
+      optional :turn, :integer, nullable: true
+    end
+  end
+end

data/lib/tungo/models/chat_message_request_mode.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Режим хода: auto (по умолчанию) — ИИ сам решает, ответить или подготовить документ; ask — только
+    # ответ и разбор, без документов; document — подготовить документ
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ChatMessageRequestMode
+      extend Tungo::Internal::Enum
+
+      AUTO = "auto"
+      ASK = "ask"
+      DOCUMENT = "document"
+    end
+  end
+end

data/lib/tungo/models/chat_pending_question.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Открытый уточняющий вопрос: показать варианты; ответ — POST …/chat/{id}/answer
+    class ChatPendingQuestion < Tungo::Model
+      # @!attribute [r] choice_id
+      #   id вопроса: ответ — POST …/chat/{dialog_id}/answer с этим choice_id
+      #   @return [String]
+      required :choice_id, :string
+
+      # @!attribute [r] questions
+      #   Вопросы — ответить на все сразу
+      #   @return [Array<Tungo::Models::ChatChoiceQuestion>]
+      required :questions, array_of(:ChatChoiceQuestion)
+    end
+  end
+end

data/lib/tungo/models/chat_question.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Вопрос ИИ к человеку без вариантов (ответить обычным сообщением)
+    class ChatQuestion < Tungo::Model
+      # @!attribute [r] proposal_id
+      #   Номер предложения, к которому вопрос; нет — вопрос вообще
+      #   @return [String, nil]
+      optional :proposal_id, :string
+
+      # @!attribute [r] text
+      #   Вопрос ИИ к человеку
+      #   @return [String]
+      required :text, :string
+    end
+  end
+end

data/lib/tungo/models/chat_stop_result.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Итог «Стоп»
+    class ChatStopResult < Tungo::Model
+      # @!attribute [r] dismissed
+      #   Есть — закрыт открытый уточняющий вопрос
+      #   @return [Boolean, nil]
+      optional :dismissed, :boolean
+
+      # @!attribute [r] id
+      #   id разговора (обычно UUID): по нему продолжают разговор (dialog_id), открывают его GET
+      #   …/chat/{id} и стирают
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] stopped
+      #   true — ход шёл и остановлен; false — ход уже не шёл
+      #   @return [Boolean]
+      required :stopped, :boolean
+    end
+  end
+end

data/lib/tungo/models/chat_token_count.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Размер и самая большая цена первого вызова модели
+    class ChatTokenCount < Tungo::Model
+      # @!attribute [r] input_cost_tiyn
+      #   Цена входа без скидки кэша, в тиынах
+      #   @return [Integer]
+      required :input_cost_tiyn, :integer
+
+      # @!attribute [r] input_tokens
+      #   Токены входа — подсчёт провайдера
+      #   @return [Integer]
+      required :input_tokens, :integer
+
+      # @!attribute [r] max_cost_tiyn
+      #   Самая большая цена одного вызова: вход и весь предел выхода, в тиынах
+      #   @return [Integer]
+      required :max_cost_tiyn, :integer
+
+      # @!attribute [r] max_output_tokens
+      #   Предел выхода одного вызова
+      #   @return [Integer]
+      required :max_output_tokens, :integer
+
+      # @!attribute [r] model
+      #   Модель первого вызова
+      #   @return [String]
+      required :model, :string
+    end
+  end
+end

data/lib/tungo/models/chat_token_count_request.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Вопрос, размер которого нужно посчитать
+    class ChatTokenCountRequest < Tungo::Model
+      # @!attribute [r] attachments
+      #   Файлы, как в POST …/chat. До 5 файлов, каждый до 10 МБ, все вместе до 14 МБ (до кодирования в
+      #   base64). Картинка — до 5 МБ, PDF — до 100 страниц. Форматы (по расширению имени): .pdf, .jpg,
+      #   .jpeg, .png, .webp, .docx, .xlsx…
+      #   @return [Array<Tungo::Models::ChatAttachment>, nil]
+      optional :attachments, array_of(:ChatAttachment)
+
+      # @!attribute [r] dialog_id
+      #   Разговор, чья история считается; нет — новый разговор
+      #   @return [String, nil]
+      optional :dialog_id, :string
+
+      # @!attribute [r] message
+      #   Текст вопроса; без него нужны файлы
+      #   @return [String, nil]
+      optional :message, :string
+
+      # @!attribute [r] mode
+      #   Режим хода, как в POST …/chat: от него зависят инструменты
+      #   @return [String, nil]
+      optional :mode, :ChatTokenCountRequestMode
+    end
+  end
+end

data/lib/tungo/models/chat_token_count_request_mode.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Режим хода, как в POST …/chat: от него зависят инструменты
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ChatTokenCountRequestMode
+      extend Tungo::Internal::Enum
+
+      AUTO = "auto"
+      ASK = "ask"
+      DOCUMENT = "document"
+    end
+  end
+end

data/lib/tungo/models/chat_turn_error.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Ошибка хода
+    class ChatTurnError < Tungo::Model
+      # @!attribute [r] can_request_more
+      #   Только у code = budget: лимит можно попросить поднять у админа
+      #   @return [Boolean, nil]
+      optional :can_request_more, :boolean
+
+      # @!attribute [r] code
+      #   Причина: - `budget` — кончился лимит (дня или разговора) - `rate_limited` — сервис модели
+      #   перегружен — повторите - `api` — сбой сервиса модели - `refusal` — модель отказалась отвечать
+      #   - `context_overflow` — разговор слиш…
+      #   @return [String]
+      required :code, :ChatTurnErrorCode
+
+      # @!attribute [r] limit_kind
+      #   Только у code = budget: day — дневной лимит, dialog — лимит разговора
+      #   @return [String, nil]
+      optional :limit_kind, :ChatTurnErrorLimitKind
+
+      # @!attribute [r] message
+      #   Текст для человека — показать в ленте ответа
+      #   @return [String]
+      required :message, :string
+
+      # @!attribute [r] type
+      #   Вид ошибки, как у REST: limit_error, unavailable_error, conflict_error, invalid_request_error,
+      #   api_error
+      #   @return [String]
+      required :type, :string
+
+      # Properties beyond the declared ones are allowed; read them with #[].
+      additional_properties :any
+    end
+  end
+end

data/lib/tungo/models/chat_turn_error_code.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Причина: - `budget` — кончился лимит (дня или разговора) - `rate_limited` — сервис модели перегружен
+    # — повторите - `api` — сбой сервиса модели - `refusal` — модель отказалась отвечать -
+    # `context_overflow` — разговор слиш…
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ChatTurnErrorCode
+      extend Tungo::Internal::Enum
+
+      BUDGET = "budget"
+      RATE_LIMITED = "rate_limited"
+      API = "api"
+      REFUSAL = "refusal"
+      CONTEXT_OVERFLOW = "context_overflow"
+      ABORTED = "aborted"
+      MAX_ITERATIONS = "max_iterations"
+      MAX_TOKENS = "max_tokens"
+      EMPTY_ANSWER = "empty_answer"
+      UNEXPECTED = "unexpected"
+      HISTORY = "history"
+      INTERNAL = "internal"
+      STREAM_FAILED = "stream_failed"
+      BATCH_FAILED = "batch_failed"
+      BATCH_ABANDONED = "batch_abandoned"
+    end
+  end
+end

data/lib/tungo/models/chat_turn_error_limit_kind.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Только у code = budget: day — дневной лимит, dialog — лимит разговора
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module ChatTurnErrorLimitKind
+      extend Tungo::Internal::Enum
+
+      DAY = "day"
+      DIALOG = "dialog"
+    end
+  end
+end

data/lib/tungo/models/chat_turn_proposal.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Предложение, подготовленное в ходе
+    class ChatTurnProposal < Tungo::Model
+      # @!attribute [r] card
+      #   @return [Tungo::Models::ProposalCard]
+      required :card, :ProposalCard
+
+      # @!attribute [r] id
+      #   Номер предложения (P-000123): карточка — GET …/proposals/{id}
+      #   @return [String]
+      required :id, :string
+    end
+  end
+end

data/lib/tungo/models/chat_turn_result.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Ход одним JSON: stream: false (или Accept: application/json), а также повтор хода по Idempotency-Key
+    class ChatTurnResult < Tungo::Model
+      # @!attribute [r] answer
+      #   Итоговый ответ текстом (Markdown), без промежуточных шагов
+      #   @return [String]
+      required :answer, :string
+
+      # @!attribute [r] citations
+      #   Источники ответа
+      #   @return [Array<Tungo::Models::ChatCitation>]
+      required :citations, array_of(:ChatCitation)
+
+      # @!attribute [r] dialog_id
+      #   id разговора (обычно UUID): по нему продолжают разговор (dialog_id), открывают его GET
+      #   …/chat/{id} и стирают
+      #   @return [String]
+      required :dialog_id, :string
+
+      # @!attribute [r] errors
+      #   Ошибки хода (как error в событии error); пусто — без ошибок
+      #   @return [Array<Tungo::Models::ChatTurnError>]
+      required :errors, array_of(:ChatTurnError)
+
+      # @!attribute [r] pending_question
+      #   Открытый уточняющий вопрос: ответ — POST …/chat/{dialog_id}/answer; null — вопроса нет
+      #   @return [Tungo::Models::ChatPendingQuestion, nil]
+      required :pending_question, :ChatPendingQuestion, nullable: true
+
+      # @!attribute [r] proposals
+      #   Документы, которые ИИ подготовил в этом ходе
+      #   @return [Array<Tungo::Models::ChatTurnProposal>]
+      required :proposals, array_of(:ChatTurnProposal)
+
+      # @!attribute [r] questions
+      #   Вопросы ИИ к человеку без вариантов
+      #   @return [Array<Tungo::Models::ChatQuestion>]
+      required :questions, array_of(:ChatQuestion)
+
+      # @!attribute [r] stop_reason
+      #   Чем кончился ход (как stop_reason в событии done); null — ход прервался внутренней ошибкой
+      #   (подробности в errors)
+      #   @return [String, nil]
+      required :stop_reason, :string, nullable: true
+
+      # @!attribute [r] turn_no
+      #   Номер хода в разговоре (как заголовок X-Turn-No)
+      #   @return [Integer, BigDecimal]
+      required :turn_no, :number
+
+      # @!attribute [r] usage
+      #   @return [Tungo::Models::ChatTurnUsage, nil]
+      optional :usage, :ChatTurnUsage
+    end
+  end
+end