swarm_sdk 2.7.5 → 2.7.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6aaba8cabb5957715e88ee02e40e9492fe3546791c806d1ddaff95e967f77aba
-  data.tar.gz: 752d15e6e69bb1a9941212d1c33622d678dcc0dc734b88b77a845c7fca4e982b
+  metadata.gz: 5806264bb99cea0a71727c89c5839ff3027c17cd725e4261244e14ae9079f513
+  data.tar.gz: f3d489dd1d6045dec6b97b499b2d6e27d78440d1b2289a19c2f3bedb27440c8d
 SHA512:
-  metadata.gz: 36532a008bbb328cddf60bca55d7d8e210b2c0701ca546190164a16067d3878e26c6c4a6d347e9f262669c34289bad7ac0ddd714062a6d4ab9807e0ef5fd9dc5
-  data.tar.gz: e7e512794d27d5bd378ea1c96e66f18683cbab8c95e3820672bd74174e0fd5963894958a61aa2e7cf40485c908a7a7adf6a7cbda9d7bfdd480ccd0c3156e4d15
+  metadata.gz: a37edf046435540ba32aa47b5552ef48e1c599c69a0bf0540ccfa2199a01947006ffe98eb8df1848175e11b673bebbf787156815dc4e5ea9403ab0db984997bd
+  data.tar.gz: 2ca616d67f41b19fe596d86fdd36aa6255cb314480c34253aacb7d8276196fd2e2bbd4fb3057b42faec5b000474754df7cce56cddbeb26fcc3301e6fa2a89fcb

data/lib/swarm_sdk/swarm/mcp_configurator.rb

@@ -45,17 +45,23 @@ module SwarmSDK
         Swarm.apply_mcp_logging_configuration
 
         mcp_server_configs.each do |server_config|
+          tools_config = server_config[:tools]
+          mode = tools_config.nil? ? :discovery : :optimized
+
+          # Emit event before initialization
+          emit_mcp_init_start(agent_name, server_config, mode)
+
           client = initialize_mcp_client(server_config)
 
           # Store client for cleanup
           @mcp_clients[agent_name] << client
 
-          tools_config = server_config[:tools]
-
           if tools_config.nil?
             # Discovery mode: Fetch all tools from server (calls tools/list)
             # client.tools returns RubyLLM::Tool instances (already wrapped by internal Coordinator)
             all_tools = client.tools
+            tool_names = all_tools.map { |t| t.respond_to?(:name) ? t.name : t.to_s }
+
             all_tools.each do |tool|
               chat.tool_registry.register(
                 tool,
@@ -63,10 +69,15 @@ module SwarmSDK
                 metadata: { server_name: server_config[:name] },
               )
             end
+
+            # Emit completion event for discovery mode
+            emit_mcp_init_complete(agent_name, server_config, mode, all_tools.size, tool_names)
             RubyLLM.logger.debug("SwarmSDK: Discovered and registered #{all_tools.size} tools from MCP server '#{server_config[:name]}'")
           else
             # Optimized mode: Create tool stubs without tools/list RPC (Plan 025)
             # Use client directly (it has internal coordinator)
+            tool_names = tools_config.map(&:to_s)
+
             tools_config.each do |tool_name|
               stub = Tools::McpToolStub.new(
                 client: client,
@@ -78,6 +89,9 @@ module SwarmSDK
                 metadata: { server_name: server_config[:name] },
               )
             end
+
+            # Emit completion event for optimized mode
+            emit_mcp_init_complete(agent_name, server_config, mode, tools_config.size, tool_names)
             RubyLLM.logger.debug("SwarmSDK: Registered #{tools_config.size} tool stubs from MCP server '#{server_config[:name]}' (lazy schema)")
           end
         rescue StandardError => e
@@ -187,6 +201,42 @@ module SwarmSDK
 
         streamable_config
       end
+
+      # Emit MCP server initialization start event
+      #
+      # @param agent_name [Symbol] Agent name
+      # @param server_config [Hash] MCP server configuration
+      # @param mode [Symbol] Initialization mode (:discovery or :optimized)
+      # @return [void]
+      def emit_mcp_init_start(agent_name, server_config, mode)
+        LogStream.emit(
+          type: "mcp_server_init_start",
+          agent: agent_name,
+          server_name: server_config[:name],
+          transport_type: server_config[:type],
+          mode: mode,
+        )
+      end
+
+      # Emit MCP server initialization complete event
+      #
+      # @param agent_name [Symbol] Agent name
+      # @param server_config [Hash] MCP server configuration
+      # @param mode [Symbol] Initialization mode (:discovery or :optimized)
+      # @param tool_count [Integer] Number of tools registered
+      # @param tool_names [Array<String>] Names of registered tools
+      # @return [void]
+      def emit_mcp_init_complete(agent_name, server_config, mode, tool_count, tool_names)
+        LogStream.emit(
+          type: "mcp_server_init_complete",
+          agent: agent_name,
+          server_name: server_config[:name],
+          transport_type: server_config[:type],
+          mode: mode,
+          tool_count: tool_count,
+          tools: tool_names,
+        )
+      end
     end
   end
 end

data/lib/swarm_sdk/tools/image_extractors/pdf_image_extractor.rb

@@ -4,8 +4,10 @@ module SwarmSDK
   module Tools
     module ImageExtractors
       # Extracts images from PDF documents
-      # Supports JPEG (DCTDecode), FlateDecode, and LZWDecode formats
-      # Converts non-JPEG images to TIFF format
+      # Only extracts JPEG images (DCTDecode format) which are LLM API compatible
+      # Non-JPEG images (FlateDecode, LZWDecode) are skipped because they would
+      # require TIFF format which is not supported by LLM APIs
+      # Supported LLM image formats: ['png', 'jpeg', 'gif', 'webp']
       class PdfImageExtractor
         class << self
           # Extract all images from a PDF document
@@ -65,11 +67,13 @@ module SwarmSDK
 
             case filter
             when :DCTDecode
-              # JPEG images can be saved directly
+              # JPEG images can be saved directly - LLM API compatible
               save_jpeg(stream, page_number, name, temp_dir)
             when :FlateDecode, :LZWDecode, nil
-              # Raw or compressed formats - save as TIFF
-              save_as_tiff(stream, page_number, name, temp_dir)
+              # Skip non-JPEG images to avoid TIFF format (not supported by LLM APIs)
+              # LLM APIs only support: ['png', 'jpeg', 'gif', 'webp']
+              # These images would require TIFF conversion which causes API errors
+              nil
             end
             # Unsupported formats return nil
           rescue StandardError

data/lib/swarm_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SwarmSDK
-  VERSION = "2.7.5"
+  VERSION = "2.7.6"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: swarm_sdk
 version: !ruby/object:Gem::Version
-  version: 2.7.5
+  version: 2.7.6
 platform: ruby
 authors:
 - Paulo Arruda