tungo-sdk 0.2.0

data/lib/tungo/models/automation_manual_run.rb

@@ -0,0 +1,189 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Ручной запуск; с event_id — пробный прогон на прошлом событии.
+    class AutomationManualRun < Tungo::Model
+      # @!attribute [r] answer
+      #   Итоговый ответ ИИ — что сделано, текстом как в чате. null — ответа нет (ещё идёт, не удался
+      #   или action: checks)
+      #   @return [String, nil]
+      required :answer, :string, nullable: true
+
+      # @!attribute [r] attempt
+      #   Номер попытки: 1, каждый повтор (retry) прибавляет 1
+      #   @return [Integer]
+      required :attempt, :integer
+
+      # @!attribute [r] auto_retries
+      #   Сколько раз запуск уже повторялся сам после «1С не на связи»
+      #   @return [Integer]
+      required :auto_retries, :integer
+
+      # @!attribute [r] cancel_requested
+      #   true — отмена запрошена, идущий запуск остановится на ближайшем шаге (state станет cancelled)
+      #   @return [Boolean]
+      required :cancel_requested, :boolean
+
+      # @!attribute [r] cost_tiyn
+      #   Стоимость запуска — расход ИИ с баланса платформы, в тиынах (1 ₸ = 100 тиын). 0 — ИИ не
+      #   вызывался. Поле есть только у ключа API и у владельца и админа организации по сессии;
+      #   остальным участникам его нет
+      #   @return [Integer, nil]
+      optional :cost_tiyn, :integer
+
+      # @!attribute [r] created_at
+      #   Когда запуск поставлен в очередь, ISO 8601 UTC
+      #   @return [String]
+      required :created_at, :string
+
+      # @!attribute [r] current_step
+      #   Номер шага (с 1), на котором запуск идёт, упал или отменён — с него продолжит повтор; null —
+      #   запуск закончен успешно или шаги ещё не начинались
+      #   @return [Integer, nil]
+      required :current_step, :integer, nullable: true
+
+      # @!attribute [r] error
+      #   Почему запуск не удался или пропущен — текст для человека; null — ошибки нет
+      #   @return [String, nil]
+      required :error, :string, nullable: true
+
+      # @!attribute [r] error_code
+      #   Машинная причина ошибки: `onec_offline` — 1С не была на связи (программа в офисе или сервер
+      #   1С); null — другая причина или ошибки нет
+      #   @return [String, nil]
+      required :error_code, :string, nullable: true
+
+      # @!attribute [r] event_id
+      #   Событие (hev_…), которое запустило: у хука — тот же event_id, что вернул приём POST
+      #   /hooks/{token}; подробности — event у GET …/runs/{id}. null — запуск не по событию
+      #   @return [String, nil]
+      required :event_id, :string, nullable: true
+
+      # @!attribute [r] event_type
+      #   Вид события Tungo, запустившего сценарий (trigger = event); null — запуск не по нему
+      #   @return [String, nil]
+      required :event_type, :string, nullable: true
+
+      # @!attribute [r] external_id
+      #   id этого события у отправителя (по id_path хука, Idempotency-Key, X-Event-Id или sha256 тела)
+      #   — для сопоставления со своим заказом или платежом; у события Tungo — его id evt_… (тот же, что
+      #   в вебхуке); у пробного события …
+      #   @return [String, nil]
+      required :external_id, :string, nullable: true
+
+      # @!attribute [r] filter_matched
+      #   Только при event_id. Подходит ли выбранное событие фильтру сценария. false — настоящая
+      #   доставка такого события сценарий не запустила бы; прогон всё равно идёт: событие выбрали вы
+      #   @return [Boolean, nil]
+      optional :filter_matched, :boolean
+
+      # @!attribute [r] finished_at
+      #   Когда закончился, ISO 8601 UTC; null — ещё не закончился
+      #   @return [String, nil]
+      required :finished_at, :string, nullable: true
+
+      # @!attribute [r] id
+      #   id запуска: подробности — GET …/automations/runs/{id}; повторить упавший — POST
+      #   …/runs/{id}/retry (run_…)
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] output
+      #   Итог в форме сценария (output): поля — числа, да/нет, значения из списка и номера. Тот же итог
+      #   — в вебхуке automation.run.completed. null — у сценария нет формы итога, ИИ итог не вернул или
+      #   он не прошёл проверку (output_…
+      #   @return [Hash{String=>Object}, nil]
+      required :output, map_of(:AutomationManualRunOutputValue), nullable: true
+
+      # @!attribute [r] output_error
+      #   Почему итога нет: `not_returned` — ИИ его не отдал; `rejected` — отдал не в заданной форме
+      #   (например, имя в поле номера). Запуск при этом не падает. null — итог есть или формы нет
+      #   @return [String, nil]
+      required :output_error, :AutomationManualRunOutputError, nullable: true
+
+      # @!attribute [r] output_note
+      #   То же словами для человека; null — итог есть или формы нет
+      #   @return [String, nil]
+      required :output_note, :string, nullable: true
+
+      # @!attribute [r] proposals
+      #   Предложения, подготовленные запуском (по всем попыткам)
+      #   @return [Array<Tungo::Models::AutomationRunProposal>]
+      required :proposals, array_of(:AutomationRunProposal)
+
+      # @!attribute [r] requested_by
+      #   Кто запросил запуск (usr_…) — при ручном запуске и повторе. null — запуск по хуку или
+      #   расписанию: человека нет, смотрите trigger и run_as сценария
+      #   @return [String, nil]
+      required :requested_by, :string, nullable: true
+
+      # @!attribute [r] retry_at
+      #   Когда запуск повторится сам (ISO 8601 UTC) — только при error_code = onec_offline, пока не
+      #   кончились попытки настройки automations.retry; null — сам не повторится
+      #   @return [String, nil]
+      required :retry_at, :string, nullable: true
+
+      # @!attribute [r] retryable
+      #   true — запуск можно повторить (state = error): показать кнопку «Повторить» → POST
+      #   …/runs/{id}/retry
+      #   @return [Boolean]
+      required :retryable, :boolean
+
+      # @!attribute [r] scenario_id
+      #   Какой сценарий запущен (его могли удалить после запуска) (scn_…)
+      #   @return [String]
+      required :scenario_id, :string
+
+      # @!attribute [r] slot_at
+      #   Плановое время запуска по расписанию, ISO 8601 UTC; null — запуск не по расписанию
+      #   @return [String, nil]
+      required :slot_at, :string, nullable: true
+
+      # @!attribute [r] started_at
+      #   Когда начался, ISO 8601 UTC; null — ещё не начался
+      #   @return [String, nil]
+      required :started_at, :string, nullable: true
+
+      # @!attribute [r] state
+      #   Состояние: `queued` — ждёт очереди (у компании на паузе — до её снятия); `running` — идёт;
+      #   `done` — завершён (итог — answer и proposals); `error` — не удался (почему — error; можно
+      #   повторить, а при error_code = onec_offl…
+      #   @return [String]
+      required :state, :AutomationManualRunState
+
+      # @!attribute [r] steps
+      #   Итоги шагов запуска по порядку (у запусков до цепочек — пусто). Повтор упавшего запуска
+      #   продолжает с упавшего шага, прошлые не повторяются
+      #   @return [Array<Tungo::Models::AutomationRunStep>]
+      required :steps, array_of(:AutomationRunStep)
+
+      # @!attribute [r] stop_reason
+      #   Техническая причина остановки хода ИИ (например, end_turn — штатно). Для людей — answer и
+      #   error. null — хода ИИ не было или он не закончился
+      #   @return [String, nil]
+      required :stop_reason, :string, nullable: true
+
+      # @!attribute [r] tools
+      #   Какие инструменты ИИ вызывал (технические имена) — для разбора запуска
+      #   @return [Array<String>]
+      required :tools, array_of(:string)
+
+      # @!attribute [r] trial
+      #   true — пробный прогон: на прошлом событии (POST …/scenarios/{id}/run с event_id) или на
+      #   пробном событии хука (POST …/hooks/{id}/test с run: true). В 1С само ничего не пишется даже
+      #   при правиле автоодобрения — все предложе…
+      #   @return [Boolean]
+      required :trial, :boolean
+
+      # @!attribute [r] trigger
+      #   Что запустило: `hook` — событие хука (event_id); `event` — событие внутри Tungo (event_type,
+      #   event_id; external_id — id события evt_…, тот же, что у вебхука); `schedule` — расписание
+      #   (slot_at); `manual` — ручной запуск (…
+      #   @return [String]
+      required :trigger, :AutomationManualRunTrigger
+    end
+  end
+end

data/lib/tungo/models/automation_manual_run_output_error.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
+    # Почему итога нет: `not_returned` — ИИ его не отдал; `rejected` — отдал не в заданной форме
+    # (например, имя в поле номера). Запуск при этом не падает. null — итог есть или формы нет
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module AutomationManualRunOutputError
+      extend Tungo::Internal::Enum
+
+      NOT_RETURNED = "not_returned"
+      REJECTED = "rejected"
+    end
+  end
+end

data/lib/tungo/models/automation_manual_run_output_value.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
+    # The +AutomationManualRunOutputValue+ union of the API contract.
+    #
+    # The value is returned as it is.
+    module AutomationManualRunOutputValue
+      extend Tungo::Internal::Union
+
+      variants(
+        :number,
+        :boolean,
+        :string
+      )
+    end
+  end
+end

data/lib/tungo/models/automation_manual_run_state.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Состояние: `queued` — ждёт очереди (у компании на паузе — до её снятия); `running` — идёт; `done` —
+    # завершён (итог — answer и proposals); `error` — не удался (почему — error; можно повторить, а при
+    # error_code = onec_offl…
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module AutomationManualRunState
+      extend Tungo::Internal::Enum
+
+      QUEUED = "queued"
+      RUNNING = "running"
+      DONE = "done"
+      ERROR = "error"
+      SKIPPED = "skipped"
+      CANCELLED = "cancelled"
+    end
+  end
+end

data/lib/tungo/models/automation_manual_run_trigger.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Что запустило: `hook` — событие хука (event_id); `event` — событие внутри Tungo (event_type,
+    # event_id; external_id — id события evt_…, тот же, что у вебхука); `schedule` — расписание (slot_at);
+    # `manual` — ручной запуск (…
+    #
+    # A value this SDK version does not know is passed through unchanged.
+    module AutomationManualRunTrigger
+      extend Tungo::Internal::Enum
+
+      HOOK = "hook"
+      SCHEDULE = "schedule"
+      MANUAL = "manual"
+      EVENT = "event"
+      DIRECTBANK = "directbank"
+    end
+  end
+end

data/lib/tungo/models/automation_output_field.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Поле итога: вид значения и описание для ИИ.
+    #
+    # The variant is selected by the +type+ property. An object with a value this SDK version
+    # does not know is returned as a {Tungo::UnknownVariant}.
+    module AutomationOutputField
+      extend Tungo::Internal::Union
+
+      discriminated_by(
+        "type",
+        "number" => :AutomationOutputFieldOption1,
+        "integer" => :AutomationOutputFieldOption2,
+        "boolean" => :AutomationOutputFieldOption3,
+        "id" => :AutomationOutputFieldOption4,
+        "enum" => :AutomationOutputFieldOption5
+      )
+      variants(
+        :AutomationOutputFieldOption1,
+        :AutomationOutputFieldOption2,
+        :AutomationOutputFieldOption3,
+        :AutomationOutputFieldOption4,
+        :AutomationOutputFieldOption5
+      )
+    end
+  end
+end

data/lib/tungo/models/automation_output_field_option1.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
+    # The +AutomationOutputFieldOption1+ object of the API contract.
+    class AutomationOutputFieldOption1 < Tungo::Model
+      # @!attribute [r] description
+      #   Что положить в поле — для ИИ, обычными словами (до 500 знаков). Пишет разработчик.
+      #   @return [String]
+      required :description, :string
+
+      # @!attribute [r] type
+      #   `number` — число
+      #   @return [String]
+      required :type, :string
+    end
+  end
+end

data/lib/tungo/models/automation_output_field_option2.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
+    # The +AutomationOutputFieldOption2+ object of the API contract.
+    class AutomationOutputFieldOption2 < Tungo::Model
+      # @!attribute [r] description
+      #   Что положить в поле — для ИИ, обычными словами (до 500 знаков). Пишет разработчик.
+      #   @return [String]
+      required :description, :string
+
+      # @!attribute [r] type
+      #   `integer` — целое число (суммы — в тиынах)
+      #   @return [String]
+      required :type, :string
+    end
+  end
+end

data/lib/tungo/models/automation_output_field_option3.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
+    # The +AutomationOutputFieldOption3+ object of the API contract.
+    class AutomationOutputFieldOption3 < Tungo::Model
+      # @!attribute [r] description
+      #   Что положить в поле — для ИИ, обычными словами (до 500 знаков). Пишет разработчик.
+      #   @return [String]
+      required :description, :string
+
+      # @!attribute [r] type
+      #   `boolean` — да/нет
+      #   @return [String]
+      required :type, :string
+    end
+  end
+end

data/lib/tungo/models/automation_output_field_option4.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
+    # The +AutomationOutputFieldOption4+ object of the API contract.
+    class AutomationOutputFieldOption4 < Tungo::Model
+      # @!attribute [r] description
+      #   Что положить в поле — для ИИ, обычными словами (до 500 знаков). Пишет разработчик.
+      #   @return [String]
+      required :description, :string
+
+      # @!attribute [r] type
+      #   `id` — номер (заказа, документа, платежа) по шаблону ^[A-Za-z0-9_.\-/#]{1,64}$
+      #   @return [String]
+      required :type, :string
+    end
+  end
+end

data/lib/tungo/models/automation_output_field_option5.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
+    # The +AutomationOutputFieldOption5+ object of the API contract.
+    class AutomationOutputFieldOption5 < Tungo::Model
+      # @!attribute [r] description
+      #   Что положить в поле — для ИИ, обычными словами (до 500 знаков). Пишет разработчик.
+      #   @return [String]
+      required :description, :string
+
+      # @!attribute [r] type
+      #   `enum` — одно значение из списка values
+      #   @return [String]
+      required :type, :string
+
+      # @!attribute [r] values
+      #   Допустимые значения (1–50, без повторов): латиница, цифры и `_ . - / #`, до 64 знаков
+      #   @return [Array<String>]
+      required :values, array_of(:string)
+    end
+  end
+end

data/lib/tungo/models/automation_output_spec.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Форма итога шага ИИ (только action: agent): имя поля → вид и описание, от 1 до 20 полей. ИИ в конце
+    # хода обязан отдать итог в этой форме; он проверяется по ней и приходит в запуске (output) и в
+    # вебхуке automation.run.com…
+    module AutomationOutputSpec
+      extend Tungo::Internal::Alias
+
+      target map_of(:AutomationOutputField)
+    end
+  end
+end

data/lib/tungo/models/automation_run.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Models
+    # Запуск сценария — запись журнала автоматизаций.
+    class AutomationRun < Tungo::Model
+      # @!attribute [r] answer
+      #   Итоговый ответ ИИ — что сделано, текстом как в чате. null — ответа нет (ещё идёт, не удался
+      #   или action: checks)
+      #   @return [String, nil]
+      required :answer, :string, nullable: true
+
+      # @!attribute [r] attempt
+      #   Номер попытки: 1, каждый повтор (retry) прибавляет 1
+      #   @return [Integer]
+      required :attempt, :integer
+
+      # @!attribute [r] auto_retries
+      #   Сколько раз запуск уже повторялся сам после «1С не на связи»
+      #   @return [Integer]
+      required :auto_retries, :integer
+
+      # @!attribute [r] cancel_requested
+      #   true — отмена запрошена, идущий запуск остановится на ближайшем шаге (state станет cancelled)
+      #   @return [Boolean]
+      required :cancel_requested, :boolean
+
+      # @!attribute [r] cost_tiyn
+      #   Стоимость запуска — расход ИИ с баланса платформы, в тиынах (1 ₸ = 100 тиын). 0 — ИИ не
+      #   вызывался. Поле есть только у ключа API и у владельца и админа организации по сессии;
+      #   остальным участникам его нет
+      #   @return [Integer, nil]
+      optional :cost_tiyn, :integer
+
+      # @!attribute [r] created_at
+      #   Когда запуск поставлен в очередь, ISO 8601 UTC
+      #   @return [String]
+      required :created_at, :string
+
+      # @!attribute [r] current_step
+      #   Номер шага (с 1), на котором запуск идёт, упал или отменён — с него продолжит повтор; null —
+      #   запуск закончен успешно или шаги ещё не начинались
+      #   @return [Integer, nil]
+      required :current_step, :integer, nullable: true
+
+      # @!attribute [r] error
+      #   Почему запуск не удался или пропущен — текст для человека; null — ошибки нет
+      #   @return [String, nil]
+      required :error, :string, nullable: true
+
+      # @!attribute [r] error_code
+      #   Машинная причина ошибки: `onec_offline` — 1С не была на связи (программа в офисе или сервер
+      #   1С); null — другая причина или ошибки нет
+      #   @return [String, nil]
+      required :error_code, :string, nullable: true
+
+      # @!attribute [r] event_id
+      #   Событие (hev_…), которое запустило: у хука — тот же event_id, что вернул приём POST
+      #   /hooks/{token}; подробности — event у GET …/runs/{id}. null — запуск не по событию
+      #   @return [String, nil]
+      required :event_id, :string, nullable: true
+
+      # @!attribute [r] event_type
+      #   Вид события Tungo, запустившего сценарий (trigger = event); null — запуск не по нему
+      #   @return [String, nil]
+      required :event_type, :string, nullable: true
+
+      # @!attribute [r] external_id
+      #   id этого события у отправителя (по id_path хука, Idempotency-Key, X-Event-Id или sha256 тела)
+      #   — для сопоставления со своим заказом или платежом; у события Tungo — его id evt_… (тот же, что
+      #   в вебхуке); у пробного события …
+      #   @return [String, nil]
+      required :external_id, :string, nullable: true
+
+      # @!attribute [r] finished_at
+      #   Когда закончился, ISO 8601 UTC; null — ещё не закончился
+      #   @return [String, nil]
+      required :finished_at, :string, nullable: true
+
+      # @!attribute [r] id
+      #   id запуска: подробности — GET …/automations/runs/{id}; повторить упавший — POST
+      #   …/runs/{id}/retry (run_…)
+      #   @return [String]
+      required :id, :string
+
+      # @!attribute [r] output
+      #   Итог в форме сценария (output): поля — числа, да/нет, значения из списка и номера. Тот же итог
+      #   — в вебхуке automation.run.completed. null — у сценария нет формы итога, ИИ итог не вернул или
+      #   он не прошёл проверку (output_…
+      #   @return [Hash{String=>Object}, nil]
+      required :output, map_of(:AutomationRunOutputValue), nullable: true
+
+      # @!attribute [r] output_error
+      #   Почему итога нет: `not_returned` — ИИ его не отдал; `rejected` — отдал не в заданной форме
+      #   (например, имя в поле номера). Запуск при этом не падает. null — итог есть или формы нет
+      #   @return [String, nil]
+      required :output_error, :AutomationRunOutputError, nullable: true
+
+      # @!attribute [r] output_note
+      #   То же словами для человека; null — итог есть или формы нет
+      #   @return [String, nil]
+      required :output_note, :string, nullable: true
+
+      # @!attribute [r] proposals
+      #   Предложения, подготовленные запуском (по всем попыткам)
+      #   @return [Array<Tungo::Models::AutomationRunProposal>]
+      required :proposals, array_of(:AutomationRunProposal)
+
+      # @!attribute [r] requested_by
+      #   Кто запросил запуск (usr_…) — при ручном запуске и повторе. null — запуск по хуку или
+      #   расписанию: человека нет, смотрите trigger и run_as сценария
+      #   @return [String, nil]
+      required :requested_by, :string, nullable: true
+
+      # @!attribute [r] retry_at
+      #   Когда запуск повторится сам (ISO 8601 UTC) — только при error_code = onec_offline, пока не
+      #   кончились попытки настройки automations.retry; null — сам не повторится
+      #   @return [String, nil]
+      required :retry_at, :string, nullable: true
+
+      # @!attribute [r] retryable
+      #   true — запуск можно повторить (state = error): показать кнопку «Повторить» → POST
+      #   …/runs/{id}/retry
+      #   @return [Boolean]
+      required :retryable, :boolean
+
+      # @!attribute [r] scenario_id
+      #   Какой сценарий запущен (его могли удалить после запуска) (scn_…)
+      #   @return [String]
+      required :scenario_id, :string
+
+      # @!attribute [r] slot_at
+      #   Плановое время запуска по расписанию, ISO 8601 UTC; null — запуск не по расписанию
+      #   @return [String, nil]
+      required :slot_at, :string, nullable: true
+
+      # @!attribute [r] started_at
+      #   Когда начался, ISO 8601 UTC; null — ещё не начался
+      #   @return [String, nil]
+      required :started_at, :string, nullable: true
+
+      # @!attribute [r] state
+      #   Состояние: `queued` — ждёт очереди (у компании на паузе — до её снятия); `running` — идёт;
+      #   `done` — завершён (итог — answer и proposals); `error` — не удался (почему — error; можно
+      #   повторить, а при error_code = onec_offl…
+      #   @return [String]
+      required :state, :AutomationRunState
+
+      # @!attribute [r] steps
+      #   Итоги шагов запуска по порядку (у запусков до цепочек — пусто). Повтор упавшего запуска
+      #   продолжает с упавшего шага, прошлые не повторяются
+      #   @return [Array<Tungo::Models::AutomationRunStep>]
+      required :steps, array_of(:AutomationRunStep)
+
+      # @!attribute [r] stop_reason
+      #   Техническая причина остановки хода ИИ (например, end_turn — штатно). Для людей — answer и
+      #   error. null — хода ИИ не было или он не закончился
+      #   @return [String, nil]
+      required :stop_reason, :string, nullable: true
+
+      # @!attribute [r] tools
+      #   Какие инструменты ИИ вызывал (технические имена) — для разбора запуска
+      #   @return [Array<String>]
+      required :tools, array_of(:string)
+
+      # @!attribute [r] trial
+      #   true — пробный прогон: на прошлом событии (POST …/scenarios/{id}/run с event_id) или на
+      #   пробном событии хука (POST …/hooks/{id}/test с run: true). В 1С само ничего не пишется даже
+      #   при правиле автоодобрения — все предложе…
+      #   @return [Boolean]
+      required :trial, :boolean
+
+      # @!attribute [r] trigger
+      #   Что запустило: `hook` — событие хука (event_id); `event` — событие внутри Tungo (event_type,
+      #   event_id; external_id — id события evt_…, тот же, что у вебхука); `schedule` — расписание
+      #   (slot_at); `manual` — ручной запуск (…
+      #   @return [String]
+      required :trigger, :AutomationRunTrigger
+    end
+  end
+end