chat_sdk 0.2.1 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8db1850adc2b313ad351d222eed5ed588f6c46b122bcf9f6f8f3eba445c19d5
-  data.tar.gz: 5fd507fa0cb224b1e204f5eeaedee74379769f4f9c5a8055af4549ecb1bbc97f
+  metadata.gz: 112741546df05e559d84fed5aa333fb613c8654b1cb2833ef301c045b60bece8
+  data.tar.gz: 53fbc7f474321ecc3fd546dae9625f450496b482248aee1cac2ca411dc91f5dc
 SHA512:
-  metadata.gz: 8af8ee31c13cbc5acccef41282ad5717ad2b2ff149fed4bcec95bfdb9fc6c422560d4d55c965e992cc1df1194232813b64f62653cc4c158ff51b4226768f871c
-  data.tar.gz: 0d1132b3d7f19f466aeb29c0d5827af6abc7702a917c90b1d679675239d24fda092b7d273830f881dd0b2e9693a1a975b6f3e6f1ff22f4c4652dbb876489915e
+  metadata.gz: 75fbe5c2fb02cd9647bb7220eac4deb2f772a52e39df489483c9d939dc52ed18a4bd90fedac2d3afeabedf37f6b5de745b66f4c08e925477c213bfe05bea3df6
+  data.tar.gz: 4bb1c49244d388e7f5d6bd3ab3b3e647c7a6fa04d3db66c80f2397c954ed1ad74edd15a6c79bc087d0a4f5104e0baa1c2232b3cc16191884e6ad73d4d18d488c

data/lib/chat_sdk/adapter/base.rb

@@ -89,6 +89,14 @@ module ChatSDK
         Cards::Renderer.new.render(postable_message.card)
       end
 
+      protected
+
+      def read_json_body(rack_request)
+        body = rack_request.body.read
+        rack_request.body.rewind
+        JSON.parse(body)
+      end
+
       private
 
       def require_capability!(cap)

data/lib/chat_sdk/adapter/meta_verification.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "openssl"
+require "rack/utils"
+
+module ChatSDK
+  module Adapter
+    module MetaVerification
+      def verify_meta_signature!(rack_request, secret:, platform_name:)
+        signature = rack_request.get_header("HTTP_X_HUB_SIGNATURE_256")
+
+        unless signature
+          raise ChatSDK::SignatureVerificationError, "Missing #{platform_name} signature header"
+        end
+
+        body = rack_request.body.read
+        rack_request.body.rewind
+
+        expected = "sha256=#{OpenSSL::HMAC.hexdigest("SHA256", secret, body)}"
+
+        unless Rack::Utils.secure_compare(signature, expected)
+          raise ChatSDK::SignatureVerificationError, "Invalid #{platform_name} signature"
+        end
+
+        true
+      end
+
+      def meta_ack_response(rack_request, verify_token:)
+        return nil unless rack_request.get?
+
+        params = rack_request.params
+        mode = params["hub.mode"]
+        token = params["hub.verify_token"]
+        challenge = params["hub.challenge"]
+
+        if mode == "subscribe" && token == verify_token
+          [200, {}, [challenge.to_s]]
+        end
+      end
+    end
+  end
+end

data/lib/chat_sdk/ai.rb

@@ -7,8 +7,12 @@ module ChatSDK
         Converter.to_ai_messages(messages, include_names: include_names, &transform)
       end
 
-      def create_tools(chat:, preset: :messenger, require_approval: true)
-        ToolBuilder.new(chat: chat, preset: preset, require_approval: require_approval).build
+      def create_tools(preset: :messenger, require_approval: true)
+        ToolBuilder.new(preset: preset, require_approval: require_approval).build
+      end
+
+      def create_executor(chat:)
+        ToolExecutor.new(chat: chat)
       end
     end
   end

data/lib/chat_sdk/api_client/base.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+module ChatSDK
+  module ApiClient
+    class Base
+      MAX_RETRIES = 2
+
+      private
+
+      def connection
+        @connection ||= build_connection { |f| f.request :json }
+      end
+
+      def upload_connection
+        @upload_connection ||= build_connection { |f| f.request :multipart }
+      end
+
+      def build_connection
+        Faraday.new(url: base_url) do |f|
+          yield f
+          configure_auth(f)
+          f.response :json
+          f.adapter :net_http
+        end
+      end
+
+      def base_url
+        raise NotImplementedError
+      end
+
+      def adapter_name
+        raise NotImplementedError
+      end
+
+      def configure_auth(faraday)
+        raise NotImplementedError
+      end
+
+      def resolve_path(path)
+        path
+      end
+
+      def request(method, path, body = nil)
+        retries = 0
+        resolved = resolve_path(path)
+        begin
+          ChatSDK::Instrumentation.instrument("api_request.chat_sdk", adapter: adapter_name, method: method, path: resolved) do
+            response = connection.public_send(method, resolved) do |req|
+              req.body = body if body && method != :get
+            end
+            handle_response(response)
+          end
+        rescue ChatSDK::RateLimitedError => e
+          ChatSDK::Instrumentation.instrument("rate_limited.chat_sdk", adapter: adapter_name, retry_after: e.retry_after, attempt: retries + 1)
+          retries += 1
+          raise if retries > MAX_RETRIES
+          sleep(e.retry_after || (2**retries * 0.5))
+          retry
+        end
+      end
+
+      def handle_response(response)
+        return extract_success_body(response) if response.success?
+
+        body = response.body
+
+        if response.status == 429
+          raise ChatSDK::RateLimitedError.new(
+            "#{adapter_name} API rate limited",
+            retry_after: extract_retry_after(response),
+            status: response.status,
+            body: body,
+            adapter_name: adapter_name
+          )
+        end
+
+        raise ChatSDK::PlatformError.new(
+          "#{adapter_name} API error: #{extract_error_message(response)}",
+          status: response.status,
+          body: body,
+          adapter_name: adapter_name
+        )
+      end
+
+      def extract_success_body(response)
+        body = response.body
+        body.is_a?(Hash) ? body : {}
+      end
+
+      def extract_retry_after(_response)
+        nil
+      end
+
+      def extract_error_message(response)
+        response.status.to_s
+      end
+    end
+  end
+end

data/lib/chat_sdk/author.rb

@@ -2,13 +2,14 @@
 
 module ChatSDK
   class Author
-    attr_reader :id, :name, :platform, :raw
+    attr_reader :id, :name, :platform, :locale, :raw
 
-    def initialize(id:, name:, platform:, bot: false, raw: nil)
+    def initialize(id:, name:, platform:, bot: false, locale: nil, raw: nil)
       @id = id
       @name = name
       @platform = platform
       @bot = bot
+      @locale = locale
       @raw = raw
     end
 

data/lib/chat_sdk/cards/text_helpers.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module ChatSDK
+  module Cards
+    module TextHelpers
+      private
+
+      def collect_text_parts(node)
+        parts = []
+        node.children.each do |child|
+          case child.type
+          when :text
+            parts << child.attributes[:content]
+          when :divider
+            parts << "---"
+          when :fields
+            child.children.each do |field|
+              parts << "#{field.attributes[:label]}: #{field.attributes[:value]}"
+            end
+          when :section
+            parts << child.attributes[:title] if child.attributes[:title]
+            parts.concat(collect_text_parts(child))
+          end
+        end
+        parts
+      end
+
+      def truncate(text, max)
+        return "" unless text
+        (text.length > max) ? "#{text[0..max - 4]}..." : text
+      end
+    end
+  end
+end

data/lib/chat_sdk/dispatcher.rb

@@ -10,18 +10,20 @@ module ChatSDK
     end
 
     def dispatch(event, adapter:, adapter_name:)
-      return unless dedupe(event, adapter_name)
+      ChatSDK::Instrumentation.instrument("dispatch.chat_sdk", adapter: adapter_name, event_type: event.type) do
+        return unless dedupe(event, adapter_name)
 
-      thread = build_thread(event, adapter)
-      thread_key = thread_key_for(event, adapter_name)
+        thread = build_thread(event, adapter)
+        thread_key = thread_key_for(event, adapter_name)
 
-      return unless acquire_lock(thread_key, event)
+        return unless acquire_lock(thread_key, event)
 
-      begin
-        handlers = @registry.handlers_for(event)
-        handlers.each { |handler| execute_handler(handler, event, thread) }
-      ensure
-        release_lock(thread_key)
+        begin
+          handlers = @registry.handlers_for(event)
+          handlers.each { |handler| execute_handler(handler, event, thread) }
+        ensure
+          release_lock(thread_key)
+        end
       end
     end
 
@@ -31,11 +33,13 @@ module ChatSDK
       event_id = extract_event_id(event)
       return true unless event_id
 
-      @state.set_if_absent(
+      is_new = @state.set_if_absent(
         "chat_sdk:dedupe:#{adapter_name}:#{event_id}",
         true,
         ttl: @config.dedupe_ttl
       )
+      ChatSDK::Instrumentation.instrument("dedupe.chat_sdk", adapter: adapter_name, event_id: event_id, duplicate: !is_new)
+      is_new
     end
 
     def extract_event_id(event)
@@ -58,15 +62,20 @@ module ChatSDK
 
     def acquire_lock(thread_key, event)
       lock_key = "chat_sdk:lock:#{thread_key}"
-      return true if @state.acquire_lock(lock_key, owner: lock_owner, ttl: 30)
+      acquired = @state.acquire_lock(lock_key, owner: lock_owner, ttl: 30)
 
-      policy = @config.on_lock_conflict
-      policy = policy.call(thread_key, event) if policy.respond_to?(:call)
+      unless acquired
+        policy = @config.on_lock_conflict
+        policy = policy.call(thread_key, event) if policy.respond_to?(:call)
 
-      return false unless policy == :force
+        if policy == :force
+          @state.force_lock(lock_key, owner: lock_owner, ttl: 30)
+          acquired = true
+        end
+      end
 
-      @state.force_lock(lock_key, owner: lock_owner, ttl: 30)
-      true
+      ChatSDK::Instrumentation.instrument("lock.chat_sdk", key: thread_key, acquired: acquired, policy: acquired ? nil : policy)
+      acquired
     end
 
     def release_lock(thread_key)
@@ -82,12 +91,14 @@ module ChatSDK
     end
 
     def execute_handler(handler, event, thread)
-      case event.type
-      when :mention, :subscribed_message, :direct_message
-        handler.block.call(thread, event.message)
-      when :reaction, :action, :slash_command
-        add_thread_to_event(event, thread)
-        handler.block.call(event)
+      ChatSDK::Instrumentation.instrument("handler.chat_sdk", handler_type: event.type) do
+        case event.type
+        when :mention, :subscribed_message, :direct_message
+          handler.block.call(thread, event.message)
+        when :reaction, :action, :slash_command
+          add_thread_to_event(event, thread)
+          handler.block.call(event)
+        end
       end
     rescue => e
       ChatSDK::Log.error("Handler error (#{event.type}): #{e.message}")

data/lib/chat_sdk/instrumentation.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module ChatSDK
+  module Instrumentation
+    @subscribers = Hash.new { |h, k| h[k] = [] }
+    @mutex = Mutex.new
+
+    class << self
+      def subscribe(event_name, &block)
+        @mutex.synchronize { @subscribers[event_name] << block }
+        block
+      end
+
+      def unsubscribe(event_name, block)
+        @mutex.synchronize { @subscribers[event_name].delete(block) }
+      end
+
+      def instrument(event_name, payload = {})
+        listeners = @mutex.synchronize { @subscribers[event_name]&.dup }
+        unless listeners&.any?
+          return yield if block_given?
+
+          return
+        end
+
+        start = monotonic_now
+        result = yield if block_given?
+        payload[:duration] = monotonic_now - start
+        fire(listeners, event_name, payload)
+        result
+      rescue => e
+        payload[:duration] = monotonic_now - start if start
+        payload[:error] = e
+        fire(listeners, event_name, payload) if listeners&.any?
+        raise
+      end
+
+      def reset!
+        @mutex.synchronize { @subscribers.clear }
+      end
+
+      private
+
+      def fire(listeners, event_name, payload)
+        listeners.each { |block| block.call(event_name, payload) }
+      rescue => e
+        ChatSDK::Log.debug("Instrumentation subscriber error: #{e.message}")
+      end
+
+      def monotonic_now
+        Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      end
+    end
+  end
+end

data/lib/chat_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ChatSDK
-  VERSION = "0.2.1"
+  VERSION = "0.3.1"
 end

metadata

@@ -1,10 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: chat_sdk
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.1
 platform: ruby
 authors:
-- Rootly
+- Quentin Rousseau
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
@@ -26,7 +26,7 @@ dependencies:
 description: Platform-agnostic chat bot framework with normalized events, cards DSL,
   streaming, and pluggable adapters
 email:
-- eng@rootly.com
+- quentin@rootly.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -34,11 +34,13 @@ files:
 - lib/chat_sdk.rb
 - lib/chat_sdk/adapter/base.rb
 - lib/chat_sdk/adapter/capabilities.rb
+- lib/chat_sdk/adapter/meta_verification.rb
 - lib/chat_sdk/ai.rb
 - lib/chat_sdk/ai/converter.rb
 - lib/chat_sdk/ai/stream_handler.rb
 - lib/chat_sdk/ai/tool_builder.rb
 - lib/chat_sdk/ai/tool_executor.rb
+- lib/chat_sdk/api_client/base.rb
 - lib/chat_sdk/author.rb
 - lib/chat_sdk/cards/actions_context.rb
 - lib/chat_sdk/cards/builder.rb
@@ -46,6 +48,7 @@ files:
 - lib/chat_sdk/cards/node.rb
 - lib/chat_sdk/cards/renderer.rb
 - lib/chat_sdk/cards/select_context.rb
+- lib/chat_sdk/cards/text_helpers.rb
 - lib/chat_sdk/channel.rb
 - lib/chat_sdk/chat.rb
 - lib/chat_sdk/config.rb
@@ -59,6 +62,7 @@ files:
 - lib/chat_sdk/events/reaction.rb
 - lib/chat_sdk/events/slash_command.rb
 - lib/chat_sdk/events/subscribed_message.rb
+- lib/chat_sdk/instrumentation.rb
 - lib/chat_sdk/log.rb
 - lib/chat_sdk/message.rb
 - lib/chat_sdk/modals/builder.rb
@@ -76,7 +80,7 @@ files:
 - lib/chat_sdk/version.rb
 - lib/chat_sdk/webhook/endpoint.rb
 - lib/chat_sdk/webhook/router.rb
-homepage: https://github.com/rootlyhq/rootly-chat-sdk
+homepage: https://github.com/rootlyhq/chat-sdk
 licenses:
 - MIT
 metadata: