apologist 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 76803053a1ad437bb60fa57feb7a40ae4b94f951f8045ff06af98f95f36bc783
-  data.tar.gz: '09b14123c5775032a9d6ad4aa93cef811bf9e713c5abbddf773a23e60ce189eb'
+  metadata.gz: e27c5f8d43b4ee1b57eb564bd1726321cac37d5c84b811b393d9ce4201286559
+  data.tar.gz: 3ae4204096640bfa470269728328f80375ff7ca0c08ffb03915fc6cc2d33bf26
 SHA512:
-  metadata.gz: 022d955a4414294dae0aacafd2e9a6f1f123c2b998c6fd584e6e100e7aa19aff871e5a799448d521aa510c35d4493bf6eb3f8356592e0b091fa0b652c0114f92
-  data.tar.gz: 293d9d182ba7c19f626a07c7416a926e86524886313ce74f75d7f779eeaac85ec3c702cdbe359c92832825bc920601ea97d0dad542405485da0c2916d2eb682a
+  metadata.gz: 33c6b125c14788c2ce7c25d4b365328a3f83aa1026cb99147356a6ea667baaa698ce57fd9e1452a0a7d89dbf6fc83188b62b69ee83a73b3b269f6da5f559e4b0
+  data.tar.gz: fbd9b0198961d5962b6829a9928ffd512cdb6d1cd43242551f2fb96903b51b9ed3c73b8635276e3c62c5ade138f9f30bddb7c7decba0785a09d1ea672e124a01

data/.fern/metadata.json

@@ -6,9 +6,9 @@
     "moduleName": "Apologist",
     "clientModuleName": "AgentClient"
   },
-  "originGitCommit": "b34e9073b4d563508b6a9eab41f15e10ab60fb15",
+  "originGitCommit": "b939d4f55706b529800e2b0a7cb51582fd764206",
   "originGitCommitIsDirty": false,
   "invokedBy": "ci",
   "ciProvider": "github",
-  "sdkVersion": "1.0.5"
+  "sdkVersion": "1.1.1"
 }

data/.fern/replay.lock

@@ -18,7 +18,13 @@ generations:
     cli_version: unknown
     generator_versions:
       fernapi/fern-ruby-sdk: 1.20.2
-current_generation: cd8e3844e905789fae21b4e0fc0ab42555405e60
+  - commit_sha: 9f892528827622170ef9dbf8ae8bd2af9b36ab49
+    tree_hash: a3c01408729d88d2074ea3c27446779728e93dea
+    timestamp: 2026-08-16T19:24:40.075Z
+    cli_version: unknown
+    generator_versions:
+      fernapi/fern-ruby-sdk: 1.20.2
+current_generation: 9f892528827622170ef9dbf8ae8bd2af9b36ab49
 patches:
   - id: patch-b2534827
     content_hash: sha256:c0e690c52123f547bfb10b269e15cdf8fc30efc06f659245a89b685ad5f01e00
@@ -61,3 +67,43 @@ patches:
           VERSION = "1.0.4"
         end
     status: unresolved
+  - id: patch-a022d6a4
+    content_hash: sha256:a326550ec15fed946c79d51281694d85ee01e110945a2c29f06281fbb966d20b
+    original_commit: a022d6a443853a5d9891f1d647086085833e4326
+    original_message: Release 1.1.0.
+    original_author: Jake Carlson <jake@carlsonville.com>
+    base_generation: d717b15ab3ca1c43aea27a140756d6525bbae651
+    files:
+      - lib/Apologist/version.rb
+    patch_content: |+
+      From a022d6a443853a5d9891f1d647086085833e4326 Mon Sep 17 00:00:00 2001
+      From: Jake Carlson <jake@carlsonville.com>
+      Date: Sun, 16 Aug 2026 13:28:38 -0500
+      Subject: [PATCH] Release 1.1.0.
+
+      ---
+       lib/Apologist/version.rb | 2 +-
+       1 file changed, 1 insertion(+), 1 deletion(-)
+
+      diff --git a/lib/Apologist/version.rb b/lib/Apologist/version.rb
+      index df5e61e..32e15e1 100644
+      --- a/lib/Apologist/version.rb
+      +++ b/lib/Apologist/version.rb
+      @@ -1,5 +1,5 @@
+       # frozen_string_literal: true
+       
+       module Apologist
+      -  VERSION = "1.0.5"
+      +  VERSION = "1.1.0"
+       end
+      -- 
+      2.52.0
+
+    theirs_snapshot:
+      lib/Apologist/version.rb: |
+        # frozen_string_literal: true
+
+        module Apologist
+          VERSION = "1.1.0"
+        end
+    status: unresolved

data/lib/Apologist/agent/client.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Agent
+    class Client
+      # @param client [Apologist::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Pauses the agent globally and fans out pause transition messages to open conversations. Requires an API key.
+      #
+      # @param request_options [Hash]
+      # @param _params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      #
+      # @example
+      #   client.agent.pause_agent
+      #
+      # @return [Apologist::Agent::Types::PauseAgentResponse]
+      def pause_agent(request_options: {}, **_params)
+        request = Apologist::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "pause",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Apologist::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Apologist::Agent::Types::PauseAgentResponse.load(response.body)
+        else
+          error_class = Apologist::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Resumes the agent globally and fans out resume transition messages to open conversations. Requires an API key.
+      #
+      # @param request_options [Hash]
+      # @param _params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      #
+      # @example
+      #   client.agent.resume_agent
+      #
+      # @return [Apologist::Agent::Types::ResumeAgentResponse]
+      def resume_agent(request_options: {}, **_params)
+        request = Apologist::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "resume",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Apologist::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Apologist::Agent::Types::ResumeAgentResponse.load(response.body)
+        else
+          error_class = Apologist::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/lib/Apologist/agent/types/pause_agent_response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Agent
+    module Types
+      class PauseAgentResponse < Internal::Types::Model
+        field :data, -> { Apologist::Types::AgentPauseState }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/agent/types/resume_agent_response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Agent
+    module Types
+      class ResumeAgentResponse < Internal::Types::Model
+        field :data, -> { Apologist::Types::AgentPauseState }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/channels/client.rb

@@ -402,6 +402,106 @@ module Apologist
         error_class = Apologist::Errors::ResponseError.subclass_for_code(code)
         raise error_class.new(response.body, code: code)
       end
+
+      # Handles the Meta WhatsApp Cloud API webhook verification handshake, echoing `hub.challenge` when
+      # `hub.verify_token` matches the channel's configured token.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :id
+      # @option params [Apologist::Channels::Types::VerifyWhatsAppWebhookRequestHubMode] :hub_mode
+      # @option params [String] :hub_verify_token
+      # @option params [String, nil] :hub_challenge
+      #
+      # @example
+      #   client.channels.verify_whats_app_webhook(
+      #     id: "id",
+      #     hub_mode: "subscribe",
+      #     hub_verify_token: "hub.verify_token"
+      #   )
+      #
+      # @return [String]
+      def verify_whats_app_webhook(request_options: {}, **params)
+        params = Apologist::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["hub.mode"] = params[:hub_mode] if params.key?(:hub_mode)
+        query_params["hub.verify_token"] = params[:hub_verify_token] if params.key?(:hub_verify_token)
+        query_params["hub.challenge"] = params[:hub_challenge] if params.key?(:hub_challenge)
+
+        request = Apologist::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "channels/#{URI.encode_uri_component(params[:id].to_s)}/whatsapp",
+          query: query_params,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Apologist::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Apologist::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # Receives WhatsApp Cloud API message events for the channel. Payload shape is defined by Meta. Signature
+      # verification via `x-hub-signature-256` is used when the channel has an App Secret configured; otherwise the
+      # webhook relies on URL secrecy and/or an `api_key` query parameter.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :id
+      # @option params [String, nil] :hub_signature256
+      #
+      # @example
+      #   client.channels.receive_whats_app_message(
+      #     id: "id",
+      #     body: {
+      #       key: "value"
+      #     }
+      #   )
+      #
+      # @return [untyped]
+      def receive_whats_app_message(request_options: {}, **params)
+        params = Apologist::Internal::Types::Utils.normalize_keys(params)
+        path_param_names = %i[id]
+        body_params = params.except(*path_param_names)
+
+        headers = {}
+        headers["x-hub-signature-256"] = params[:hub_signature256] if params[:hub_signature256]
+
+        request = Apologist::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "channels/#{URI.encode_uri_component(params[:id].to_s)}/whatsapp",
+          headers: headers,
+          body: body_params,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Apologist::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Apologist::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
     end
   end
 end

data/lib/Apologist/channels/types/receive_whats_app_message_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Channels
+    module Types
+      class ReceiveWhatsAppMessageRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+
+        field :hub_signature256, -> { String }, optional: true, nullable: false, api_name: "x-hub-signature-256"
+
+        field :body, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/channels/types/verify_whats_app_webhook_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Channels
+    module Types
+      class VerifyWhatsAppWebhookRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+
+        field :hub_mode, -> { Apologist::Channels::Types::VerifyWhatsAppWebhookRequestHubMode }, optional: false, nullable: false, api_name: "hub.mode"
+
+        field :hub_verify_token, -> { String }, optional: false, nullable: false, api_name: "hub.verify_token"
+
+        field :hub_challenge, -> { String }, optional: true, nullable: false, api_name: "hub.challenge"
+      end
+    end
+  end
+end

data/lib/Apologist/channels/types/verify_whats_app_webhook_request_hub_mode.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Channels
+    module Types
+      module VerifyWhatsAppWebhookRequestHubMode
+        extend Apologist::Internal::Types::Enum
+
+        SUBSCRIBE = "subscribe"
+      end
+    end
+  end
+end

data/lib/Apologist/client.rb

@@ -20,7 +20,7 @@ module Apologist
       @raw_client = Apologist::Internal::Http::RawClient.new(
         base_url: base_url || Apologist::Environment::DEFAULT,
         headers: {
-          "User-Agent" => "apologist/1.0.5",
+          "User-Agent" => "apologist/1.1.1",
           "X-Fern-Language" => "Ruby",
           "x-api-key" => api_key.to_s
         },
@@ -58,6 +58,16 @@ module Apologist
       @benchmarks ||= Apologist::Benchmarks::Client.new(client: @raw_client)
     end
 
+    # @return [Apologist::Agent::Client]
+    def agent
+      @agent ||= Apologist::Agent::Client.new(client: @raw_client)
+    end
+
+    # @return [Apologist::Conversations::Client]
+    def conversations
+      @conversations ||= Apologist::Conversations::Client.new(client: @raw_client)
+    end
+
     # @return [Apologist::Channels::Client]
     def channels
       @channels ||= Apologist::Channels::Client.new(client: @raw_client)

data/lib/Apologist/conversations/client.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Conversations
+    class Client
+      # @param client [Apologist::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Returns a paginated list of conversations for the requesting agent, newest first.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [Integer, nil] :page
+      # @option params [Integer, nil] :per_page
+      #
+      # @example
+      #   client.conversations.list_conversations
+      #
+      # @return [Apologist::Conversations::Types::ListConversationsResponse]
+      def list_conversations(request_options: {}, **params)
+        params = Apologist::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["page"] = params[:page] if params.key?(:page)
+        query_params["per_page"] = params[:per_page] if params.key?(:per_page)
+
+        request = Apologist::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "conversations",
+          query: query_params,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Apologist::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Apologist::Conversations::Types::ListConversationsResponse.load(response.body)
+        else
+          error_class = Apologist::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Returns a single conversation by internal UUID or team-scoped external id.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :id
+      #
+      # @example
+      #   client.conversations.get_conversation(id: "id")
+      #
+      # @return [Apologist::Conversations::Types::GetConversationResponse]
+      def get_conversation(request_options: {}, **params)
+        params = Apologist::Internal::Types::Utils.normalize_keys(params)
+        request = Apologist::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "conversations/#{URI.encode_uri_component(params[:id].to_s)}",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Apologist::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Apologist::Conversations::Types::GetConversationResponse.load(response.body)
+        else
+          error_class = Apologist::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Pauses the agent on a conversation identified by internal UUID or team-scoped external id. Requires an API key.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :id
+      #
+      # @example
+      #   client.conversations.pause_conversation(id: "id")
+      #
+      # @return [Apologist::Conversations::Types::PauseConversationResponse]
+      def pause_conversation(request_options: {}, **params)
+        params = Apologist::Internal::Types::Utils.normalize_keys(params)
+        request = Apologist::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "conversations/#{URI.encode_uri_component(params[:id].to_s)}/pause",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Apologist::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Apologist::Conversations::Types::PauseConversationResponse.load(response.body)
+        else
+          error_class = Apologist::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # Resumes the agent on a conversation identified by internal UUID or team-scoped external id. Requires an API key.
+      #
+      # @param request_options [Hash]
+      # @param params [Hash]
+      # @option request_options [String] :base_url
+      # @option request_options [Hash{String => Object}] :additional_headers
+      # @option request_options [Hash{String => Object}] :additional_query_parameters
+      # @option request_options [Hash{String => Object}] :additional_body_parameters
+      # @option request_options [Integer] :timeout_in_seconds
+      # @option params [String] :id
+      #
+      # @example
+      #   client.conversations.resume_conversation(id: "id")
+      #
+      # @return [Apologist::Conversations::Types::ResumeConversationResponse]
+      def resume_conversation(request_options: {}, **params)
+        params = Apologist::Internal::Types::Utils.normalize_keys(params)
+        request = Apologist::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "conversations/#{URI.encode_uri_component(params[:id].to_s)}/resume",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Apologist::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Apologist::Conversations::Types::ResumeConversationResponse.load(response.body)
+        else
+          error_class = Apologist::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/lib/Apologist/conversations/types/get_conversation_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Conversations
+    module Types
+      class GetConversationRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/conversations/types/get_conversation_response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Conversations
+    module Types
+      class GetConversationResponse < Internal::Types::Model
+        field :data, -> { Apologist::Types::Conversation }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/conversations/types/list_conversations_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Conversations
+    module Types
+      class ListConversationsRequest < Internal::Types::Model
+        field :page, -> { Integer }, optional: true, nullable: false
+
+        field :per_page, -> { Integer }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/conversations/types/list_conversations_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Conversations
+    module Types
+      class ListConversationsResponse < Internal::Types::Model
+        field :data, -> { Internal::Types::Array[Apologist::Types::Conversation] }, optional: true, nullable: false
+
+        field :total, -> { Integer }, optional: true, nullable: false
+
+        field :page, -> { Integer }, optional: true, nullable: false
+
+        field :per_page, -> { Integer }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/conversations/types/pause_conversation_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Conversations
+    module Types
+      class PauseConversationRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/conversations/types/pause_conversation_response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Conversations
+    module Types
+      class PauseConversationResponse < Internal::Types::Model
+        field :data, -> { Apologist::Types::Conversation }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/conversations/types/resume_conversation_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Conversations
+    module Types
+      class ResumeConversationRequest < Internal::Types::Model
+        field :id, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/conversations/types/resume_conversation_response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Conversations
+    module Types
+      class ResumeConversationResponse < Internal::Types::Model
+        field :data, -> { Apologist::Types::Conversation }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/types/agent_pause_state.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    # Agent-wide pause or resume result, including fan-out counts.
+    class AgentPauseState < Internal::Types::Model
+      field :is_paused, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+      field :paused_at, -> { String }, optional: true, nullable: false
+
+      field :resumed_at, -> { String }, optional: true, nullable: false
+
+      field :emitted, -> { Integer }, optional: true, nullable: false
+
+      field :skipped, -> { Integer }, optional: true, nullable: false
+    end
+  end
+end