apologist 1.0.2

data/lib/Apologist/internal/types/utils.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Internal
+    module Types
+      # Utilities for dealing with and checking types
+      module Utils
+        # Wraps a type into a type function
+        #
+        # @param type [Proc, Object]
+        # @return [Proc]
+        def self.wrap_type(type)
+          case type
+          when Proc
+            type
+          else
+            -> { type }
+          end
+        end
+
+        # Resolves a type or type function into a type
+        #
+        # @param type [Proc, Object]
+        # @return [Object]
+        def self.unwrap_type(type)
+          type.is_a?(Proc) ? type.call : type
+        end
+
+        def self.coerce(target, value, strict: false)
+          type = unwrap_type(target)
+
+          case type
+          in Array
+            case value
+            when ::Array
+              return type.coerce(value, strict: strict)
+            when Set, ::Hash
+              return coerce(type, value.to_a)
+            end
+          in Hash
+            case value
+            when ::Hash
+              return type.coerce(value, strict: strict)
+            when ::Array
+              return coerce(type, value.to_h)
+            end
+          in ->(t) { t <= NilClass }
+            return nil
+          in ->(t) { t <= String }
+            case value
+            when String, Symbol, Numeric, TrueClass, FalseClass
+              return value.to_s
+            end
+          in ->(t) { t <= Symbol }
+            case value
+            when Symbol, String
+              return value.to_sym
+            end
+          in ->(t) { t <= Integer }
+            case value
+            when Numeric, String, Time
+              return value.to_i
+            end
+          in ->(t) { t <= Float }
+            case value
+            when Numeric, Time, String
+              return value.to_f
+            end
+          in ->(t) { t <= Model }
+            case value
+            when type
+              return value
+            when ::Hash
+              return type.coerce(value, strict: strict)
+            end
+          in Module
+            case type
+            in ->(t) {
+                 t.singleton_class.included_modules.include?(Enum) ||
+                   t.singleton_class.included_modules.include?(Union)
+               }
+              return type.coerce(value, strict: strict)
+            else
+              value # rubocop:disable Lint/Void
+            end
+          else
+            value # rubocop:disable Lint/Void
+          end
+
+          raise Errors::TypeError, "cannot coerce value of type `#{value.class}` to `#{target}`" if strict
+
+          value
+        end
+
+        def self.symbolize_keys(hash)
+          hash.transform_keys(&:to_sym)
+        end
+
+        # Converts camelCase keys to snake_case symbols
+        # This allows SDK methods to accept both snake_case and camelCase keys
+        # e.g., { refundMethod: ... } becomes { refund_method: ... }
+        #
+        # @param hash [Hash]
+        # @return [Hash]
+        def self.normalize_keys(hash)
+          hash.transform_keys do |key|
+            key_str = key.to_s
+            # Convert camelCase to snake_case
+            snake_case = key_str.gsub(/([a-z\d])([A-Z])/, '\1_\2').downcase
+            snake_case.to_sym
+          end
+        end
+      end
+    end
+  end
+end

data/lib/Apologist/internal/url_encoded/request.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Internal
+    module UrlEncoded
+      # @api private
+      class Request < Apologist::Internal::Http::BaseRequest
+        attr_reader :body
+
+        # @param base_url [String] The base URL for the request
+        # @param path [String] The path for the request
+        # @param method [Symbol] The HTTP method for the request (:get, :post, etc.)
+        # @param headers [Hash] Additional headers for the request (optional)
+        # @param query [Hash] Query parameters for the request (optional)
+        # @param body [Object, nil] The form-urlencoded request body (optional)
+        # @param request_options [Apologist::RequestOptions, Hash{Symbol=>Object}, nil]
+        def initialize(base_url:, path:, method:, headers: {}, query: {}, body: nil, request_options: {})
+          super(base_url:, path:, method:, headers:, query:, request_options:)
+
+          @body = body
+        end
+
+        # @return [Hash] The encoded HTTP request headers.
+        # @param protected_keys [Array<String>] Header keys set by the SDK client (e.g. auth, metadata)
+        #   that must not be overridden by additional_headers from request_options.
+        def encode_headers(protected_keys: [])
+          sdk_headers = {
+            "Content-Type" => "application/x-www-form-urlencoded",
+            "Accept" => "application/json"
+          }.merge(@headers)
+          merge_additional_headers(sdk_headers, protected_keys:)
+        end
+
+        # @return [String, nil] The encoded HTTP request body.
+        def encode_body
+          @body.nil? ? nil : URI.encode_www_form(@body.to_h.compact)
+        end
+      end
+    end
+  end
+end

data/lib/Apologist/shares/client.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Shares
+    class Client
+      # @param client [Apologist::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # Public, unauthenticated read of the messages behind a share token. The token is the bearer capability and
+      # enforces tenant isolation against the host agent. An empty or invalid token yields an empty messages array.
+      #
+      # @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] :token
+      #
+      # @example
+      #   client.shares.get_shared_messages(token: "token")
+      #
+      # @return [Apologist::Shares::Types::GetSharedMessagesResponse]
+      def get_shared_messages(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: "shares/#{URI.encode_uri_component(params[:token].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::Shares::Types::GetSharedMessagesResponse.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/shares/types/get_shared_messages_request.rb

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

data/lib/Apologist/shares/types/get_shared_messages_response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Shares
+    module Types
+      class GetSharedMessagesResponse < Internal::Types::Model
+        field :messages, -> { Internal::Types::Array[Internal::Types::Hash[String, Object]] }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class ChatCompletionRequest < Internal::Types::Model
+      extend Apologist::Internal::Types::Union
+
+      member -> { Object }
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_request_logprobs.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class ChatCompletionRequestLogprobs < Internal::Types::Model
+      extend Apologist::Internal::Types::Union
+
+      member -> { Internal::Types::Boolean }
+
+      member -> { Integer }
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_request_metadata.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class ChatCompletionRequestMetadata < Internal::Types::Model
+      field :anonymous, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+      field :conversation, -> { String }, optional: true, nullable: false
+
+      field :language, -> { String }, optional: true, nullable: false
+
+      field :max_memories, -> { Integer }, optional: true, nullable: false
+
+      field :parent_url, -> { String }, optional: true, nullable: false
+
+      field :parent_host, -> { String }, optional: true, nullable: false
+
+      field :session, -> { String }, optional: true, nullable: false
+
+      field :device, -> { String }, optional: true, nullable: false
+
+      field :shared_prompt, -> { Integer }, optional: true, nullable: false
+
+      field :translation, -> { String }, optional: true, nullable: false
+
+      field :variables, -> { Internal::Types::Hash[String, String] }, optional: true, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_request_reasoning_effort.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    module ChatCompletionRequestReasoningEffort
+      extend Apologist::Internal::Types::Enum
+
+      LOW = "low"
+      MEDIUM = "medium"
+      HIGH = "high"
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_request_response_format.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class ChatCompletionRequestResponseFormat < Internal::Types::Model
+      field :type, -> { Apologist::Types::ChatCompletionRequestResponseFormatType }, optional: true, nullable: false
+
+      field :json_schema, -> { Apologist::Types::ChatCompletionRequestResponseFormatJSONSchema }, optional: true, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_request_response_format_json_schema.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    # Required when type is json_schema. Supplies the JSON Schema the structured output must conform to. Structured
+    # outputs are non-streaming.
+    class ChatCompletionRequestResponseFormatJSONSchema < Internal::Types::Model
+      field :name, -> { String }, optional: true, nullable: false
+
+      field :description, -> { String }, optional: true, nullable: false
+
+      field :schema, -> { Internal::Types::Hash[String, Object] }, optional: true, nullable: false
+
+      field :strict, -> { Internal::Types::Boolean }, optional: true, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_request_response_format_type.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    module ChatCompletionRequestResponseFormatType
+      extend Apologist::Internal::Types::Enum
+
+      TEXT = "text"
+      HTML = "html"
+      JSON_ = "json"
+      RAW = "raw"
+      JSON_SCHEMA = "json_schema"
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_request_tool_choice.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class ChatCompletionRequestToolChoice < Internal::Types::Model
+      extend Apologist::Internal::Types::Union
+
+      member -> { Apologist::Types::ChatCompletionRequestToolChoiceZero }
+
+      member -> { Internal::Types::Hash[String, Object] }
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_request_tool_choice_zero.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    module ChatCompletionRequestToolChoiceZero
+      extend Apologist::Internal::Types::Enum
+
+      NONE = "none"
+      AUTO = "auto"
+      REQUIRED = "required"
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_request_verbosity.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    module ChatCompletionRequestVerbosity
+      extend Apologist::Internal::Types::Enum
+
+      MINIMAL = "minimal"
+      LOW = "low"
+      MEDIUM = "medium"
+      HIGH = "high"
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_response.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class ChatCompletionResponse < Internal::Types::Model
+      field :id, -> { String }, optional: true, nullable: false
+
+      field :object, -> { String }, optional: true, nullable: false
+
+      field :created, -> { Integer }, optional: true, nullable: false
+
+      field :model, -> { String }, optional: true, nullable: false
+
+      field :choices, -> { Internal::Types::Array[Apologist::Types::ChatCompletionResponseChoicesItem] }, optional: true, nullable: false
+
+      field :usage, -> { Apologist::Types::ChatCompletionResponseUsage }, optional: true, nullable: false
+
+      field :cached, -> { Internal::Types::Boolean }, optional: true, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_response_choices_item.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class ChatCompletionResponseChoicesItem < Internal::Types::Model
+      field :index, -> { Integer }, optional: true, nullable: false
+
+      field :message, -> { Apologist::Types::ChatMessage }, optional: true, nullable: false
+
+      field :logprobs, -> { Internal::Types::Hash[String, Object] }, optional: true, nullable: false
+
+      field :finish_reason, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/chat_completion_response_usage.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class ChatCompletionResponseUsage < Internal::Types::Model
+      field :prompt_tokens, -> { Integer }, optional: true, nullable: false
+
+      field :completion_tokens, -> { Integer }, optional: true, nullable: false
+
+      field :total_tokens, -> { Integer }, optional: true, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/chat_message.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class ChatMessage < Internal::Types::Model
+      field :role, -> { Apologist::Types::ChatMessageRole }, optional: true, nullable: false
+
+      field :content, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/chat_message_role.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    module ChatMessageRole
+      extend Apologist::Internal::Types::Enum
+
+      SYSTEM = "system"
+      USER = "user"
+      ASSISTANT = "assistant"
+    end
+  end
+end

data/lib/Apologist/types/cta_match_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class CtaMatchRequest < Internal::Types::Model
+      extend Apologist::Internal::Types::Union
+
+      member -> { Object }
+    end
+  end
+end

data/lib/Apologist/types/error.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class Error < Internal::Types::Model
+      field :success, -> { Internal::Types::Boolean }, optional: false, nullable: false
+
+      field :errors, -> { Internal::Types::Array[String] }, optional: false, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/success_response.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class SuccessResponse < Internal::Types::Model
+      field :success, -> { Internal::Types::Boolean }, optional: false, nullable: false
+
+      field :message, -> { String }, optional: false, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/tag_ref.rb

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

data/lib/Apologist/types/user.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class User < Internal::Types::Model
+      field :id, -> { String }, optional: true, nullable: false
+
+      field :external_id, -> { String }, optional: true, nullable: false
+
+      field :team_id, -> { Integer }, optional: true, nullable: false
+
+      field :created_at, -> { String }, optional: true, nullable: false
+
+      field :migrated_at, -> { String }, optional: true, nullable: false
+
+      field :migrated_to_user_id, -> { String }, optional: true, nullable: false
+
+      field :tags, -> { Internal::Types::Array[Apologist::Types::TagRef] }, optional: true, nullable: false
+
+      field :responder_id, -> { Integer }, optional: true, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/user_flag.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    # A team-level user flag definition from the user_flags table.
+    class UserFlag < Internal::Types::Model
+      field :id, -> { Integer }, optional: true, nullable: false
+
+      field :name, -> { String }, optional: true, nullable: false
+
+      field :user_id, -> { Integer }, optional: true, nullable: false
+
+      field :team_id, -> { Integer }, optional: true, nullable: false
+
+      field :synced_at, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/webhook_agent_ref.rb

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

data/lib/Apologist/types/webhook_cta.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class WebhookCta < Internal::Types::Model
+      field :id, -> { Integer }, optional: false, nullable: false
+
+      field :name, -> { String }, optional: true, nullable: false
+
+      field :content, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/webhook_evaluation.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    # Result of an evaluation run for CTA/guardrail events.
+    class WebhookEvaluation < Internal::Types::Model
+      field :score, -> { Integer }, optional: true, nullable: false
+
+      field :passed, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+      field :content, -> { String }, optional: true, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/webhook_event_info.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    class WebhookEventInfo < Internal::Types::Model
+      field :key, -> { Apologist::Types::WebhookEventInfoKey }, optional: false, nullable: false
+
+      field :label, -> { String }, optional: false, nullable: false
+
+      field :occurred_at, -> { String }, optional: false, nullable: false
+    end
+  end
+end

data/lib/Apologist/types/webhook_event_info_key.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Apologist
+  module Types
+    module WebhookEventInfoKey
+      extend Apologist::Internal::Types::Enum
+
+      PROMPT_SUBMIT = "prompt_submit"
+      RESPONSE_START = "response_start"
+      RESPONSE_END = "response_end"
+      AUTOMATIONS_END = "automations_end"
+      RESPONSE_LIKE = "response_like"
+      RESPONSE_FLAG = "response_flag"
+      RESPONSE_FEEDBACK = "response_feedback"
+      REFERRAL_CLICK = "referral_click"
+      CTA_TRIGGER = "cta_trigger"
+      CTA_CLICK = "cta_click"
+      GUARDRAIL_TRIGGER = "guardrail_trigger"
+      ATTRIBUTION_CLICK = "attribution_click"
+      FOOTER_CLICK = "footer_click"
+      NEW_USER = "new_user"
+      NEW_DEVICE = "new_device"
+      NEW_SESSION = "new_session"
+      NEW_CONVERSATION = "new_conversation"
+      ERROR = "error"
+    end
+  end
+end

data/lib/Apologist/types/webhook_named_ref.rb

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