swarm_memory 2.0.0 → 2.1.1

data/lib/swarm_memory/tools/memory_grep.rb

@@ -19,6 +19,7 @@ module SwarmMemory
         - pattern (REQUIRED): Regular expression pattern to search for (e.g., 'status: pending', 'TODO.*urgent', '\\btask_\\d+\\b')
 
         **Optional Parameters:**
+        - path: Limit search to specific path (e.g., 'concept/', 'fact/api-design/', 'skill/ruby')
         - case_insensitive: Set to true for case-insensitive search (default: false)
         - output_mode: Choose output format - 'files_with_matches' (default), 'content', or 'count'
 
@@ -44,22 +45,38 @@ module SwarmMemory
         - Quantifiers: '*' (0+), '+' (1+), '?' (0 or 1), '{3}' (exactly 3)
         - Alternation: 'pending|in-progress|blocked'
 
+        **Path Parameter - Directory-Style Filtering:**
+        The path parameter works just like searching in directories:
+        - 'concept/' - Search only concept entries
+        - 'fact/api-design' - Search only in fact/api-design (treats as directory)
+        - 'fact/api-design/' - Same as above
+        - 'skill/ruby/blocks.md' - Search only that specific file
+
         **Examples:**
         ```
         # Find entries containing "TODO" (case-sensitive)
         MemoryGrep(pattern: "TODO")
 
+        # Search only in concepts
+        MemoryGrep(pattern: "TODO", path: "concept/")
+
+        # Search in a specific subdirectory
+        MemoryGrep(pattern: "endpoint", path: "fact/api-design")
+
+        # Search a specific file
+        MemoryGrep(pattern: "lambda", path: "skill/ruby/blocks.md")
+
         # Find entries with any status (case-insensitive)
         MemoryGrep(pattern: "status:", case_insensitive: true)
 
-        # Show actual content of matches
-        MemoryGrep(pattern: "error|warning|failed", output_mode: "content")
+        # Show actual content of matches in skills only
+        MemoryGrep(pattern: "error|warning|failed", path: "skill/", output_mode: "content")
 
-        # Count how many times "completed" appears in each entry
-        MemoryGrep(pattern: "completed", output_mode: "count")
+        # Count how many times "completed" appears in experiences
+        MemoryGrep(pattern: "completed", path: "experience/", output_mode: "count")
 
-        # Find task numbers
-        MemoryGrep(pattern: "task_\\d+")
+        # Find task numbers in facts
+        MemoryGrep(pattern: "task_\\d+", path: "fact/")
 
         # Find incomplete tasks
         MemoryGrep(pattern: "^- \\[ \\]", output_mode: "content")
@@ -84,6 +101,7 @@ module SwarmMemory
         **Tips:**
         - Start with simple literal patterns before using complex regex
         - Use case_insensitive=true for broader matches
+        - Use path parameter to limit search scope (faster and more precise)
         - Use output_mode="content" to see context around matches
         - Escape special regex characters with backslash: \\. \\* \\? \\[ \\]
         - Test patterns on a small set before broad searches
@@ -94,6 +112,10 @@ module SwarmMemory
         desc: "Regular expression pattern to search for",
         required: true
 
+      param :path,
+        desc: "Limit search to specific path (e.g., 'concept/', 'fact/api-design/', 'skill/ruby/blocks.md')",
+        required: false
+
       param :case_insensitive,
         type: "boolean",
         desc: "Set to true for case-insensitive search (default: false)",
@@ -119,17 +141,19 @@ module SwarmMemory
       # Execute the tool
       #
       # @param pattern [String] Regex pattern to search for
+      # @param path [String, nil] Optional path filter
       # @param case_insensitive [Boolean] Whether to perform case-insensitive search
       # @param output_mode [String] Output mode
       # @return [String] Formatted search results
-      def execute(pattern:, case_insensitive: false, output_mode: "files_with_matches")
+      def execute(pattern:, path: nil, case_insensitive: false, output_mode: "files_with_matches")
         results = @storage.grep(
           pattern: pattern,
+          path: path,
           case_insensitive: case_insensitive,
           output_mode: output_mode,
         )
 
-        format_results(results, pattern, output_mode)
+        format_results(results, pattern, output_mode, path)
       rescue ArgumentError => e
         validation_error(e.message)
       rescue RegexpError => e
@@ -142,40 +166,52 @@ module SwarmMemory
         "<tool_use_error>InputValidationError: #{message}</tool_use_error>"
       end
 
-      def format_results(results, pattern, output_mode)
+      def format_results(results, pattern, output_mode, path_filter)
         case output_mode
         when "files_with_matches"
-          format_files_with_matches(results, pattern)
+          format_files_with_matches(results, pattern, path_filter)
         when "content"
-          format_content(results, pattern)
+          format_content(results, pattern, path_filter)
         when "count"
-          format_count(results, pattern)
+          format_count(results, pattern, path_filter)
         else
           validation_error("Invalid output_mode: #{output_mode}")
         end
       end
 
-      def format_files_with_matches(paths, pattern)
+      def format_search_header(pattern, path_filter)
+        if path_filter && !path_filter.empty?
+          "'#{pattern}' in #{path_filter}"
+        else
+          "'#{pattern}'"
+        end
+      end
+
+      def format_files_with_matches(paths, pattern, path_filter)
+        search_desc = format_search_header(pattern, path_filter)
+
         if paths.empty?
-          return "No matches found for pattern '#{pattern}'"
+          return "No matches found for pattern #{search_desc}"
         end
 
         result = []
-        result << "Memory entries matching '#{pattern}' (#{paths.size} #{paths.size == 1 ? "entry" : "entries"}):"
+        result << "Memory entries matching #{search_desc} (#{paths.size} #{paths.size == 1 ? "entry" : "entries"}):"
         paths.each do |path|
           result << "  memory://#{path}"
         end
         result.join("\n")
       end
 
-      def format_content(results, pattern)
+      def format_content(results, pattern, path_filter)
+        search_desc = format_search_header(pattern, path_filter)
+
         if results.empty?
-          return "No matches found for pattern '#{pattern}'"
+          return "No matches found for pattern #{search_desc}"
         end
 
         total_matches = results.sum { |r| r[:matches].size }
         output = []
-        output << "Memory entries matching '#{pattern}' (#{results.size} #{results.size == 1 ? "entry" : "entries"}, #{total_matches} #{total_matches == 1 ? "match" : "matches"}):"
+        output << "Memory entries matching #{search_desc} (#{results.size} #{results.size == 1 ? "entry" : "entries"}, #{total_matches} #{total_matches == 1 ? "match" : "matches"}):"
         output << ""
 
         results.each do |result|
@@ -189,14 +225,16 @@ module SwarmMemory
         output.join("\n").rstrip
       end
 
-      def format_count(results, pattern)
+      def format_count(results, pattern, path_filter)
+        search_desc = format_search_header(pattern, path_filter)
+
         if results.empty?
-          return "No matches found for pattern '#{pattern}'"
+          return "No matches found for pattern #{search_desc}"
         end
 
         total_matches = results.sum { |r| r[:count] }
         output = []
-        output << "Memory entries matching '#{pattern}' (#{results.size} #{results.size == 1 ? "entry" : "entries"}, #{total_matches} total #{total_matches == 1 ? "match" : "matches"}):"
+        output << "Memory entries matching #{search_desc} (#{results.size} #{results.size == 1 ? "entry" : "entries"}, #{total_matches} total #{total_matches == 1 ? "match" : "matches"}):"
 
         results.each do |result|
           output << "  memory://#{result[:path]}: #{result[:count]} #{result[:count] == 1 ? "match" : "matches"}"

data/lib/swarm_memory/tools/memory_write.rb

@@ -10,6 +10,10 @@ module SwarmMemory
       description <<~DESC
         Store content in persistent memory with structured metadata for semantic search and retrieval.
 
+        IMPORTANT: Content must be 250 words or less. If content exceeds this limit, extract key entities: concepts, experiences, facts, skills,
+        then split into multiple focused memories (each under 250 words) that capture ALL important details.
+        Link related memories using the 'related' metadata field with memory:// URIs.
+
         CRITICAL: ALL 8 required parameters MUST be provided. Do NOT skip any. If you're missing information, ask the user or infer reasonable defaults.
 
         REQUIRED PARAMETERS (provide ALL 8):
@@ -136,6 +140,18 @@ module SwarmMemory
         tools: nil,
         permissions: nil
       )
+        # Validate content length (250 word limit)
+        word_count = content.split(/\s+/).size
+        if word_count > 250
+          return validation_error(
+            "Content exceeds 250-word limit (#{word_count} words). " \
+              "Please extract the key entities and concepts from this content, then split it into multiple smaller, " \
+              "focused memories (each under 250 words) that still capture ALL the important details. " \
+              "Link related memories together using the 'related' metadata field with memory:// URIs. " \
+              "Each memory should cover one specific aspect or concept while preserving completeness.",
+          )
+        end
+
         # Build metadata hash from params
         # Handle both JSON strings (from LLMs) and Ruby arrays (from tests/code)
         metadata = {}

data/lib/swarm_memory/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SwarmMemory
-  VERSION = "2.0.0"
+  VERSION = "2.1.1"
 end

data/lib/swarm_sdk/agent/chat.rb

@@ -413,6 +413,18 @@ module SwarmSDK
           )
         end
 
+        # Handle nil response from provider (malformed API response)
+        if response.nil?
+          raise RubyLLM::Error, "Provider returned nil response. This usually indicates a malformed API response " \
+            "that couldn't be parsed.\n\n" \
+            "Provider: #{@provider.class.name}\n" \
+            "API Base: #{@provider.api_base}\n" \
+            "Model: #{@model.id}\n" \
+            "Response: #{response.inspect}\n\n" \
+            "The API endpoint returned a response that couldn't be parsed into a valid Message object. " \
+            "Enable RubyLLM debug logging (RubyLLM.logger.level = Logger::DEBUG) to see the raw API response."
+        end
+
         @on[:new_message]&.call unless block
 
         # Handle schema parsing if needed
@@ -834,6 +846,9 @@ module SwarmSDK
           when "openai", "deepseek", "perplexity", "mistral", "openrouter"
             config.openai_api_base = base_url
             config.openai_api_key = ENV["OPENAI_API_KEY"] || "dummy-key-for-local"
+            # Use standard 'system' role instead of 'developer' for OpenAI-compatible proxies
+            # Most proxies don't support OpenAI's newer 'developer' role convention
+            config.openai_use_system_role = true
           when "ollama"
             config.ollama_api_base = base_url
           when "gpustack"

data/lib/swarm_sdk/swarm/tool_configurator.rb

@@ -298,7 +298,7 @@ module SwarmSDK
       # Check if a tool should be disabled based on disable_default_tools config
       #
       # @param tool_name [Symbol] Tool name to check
-      # @param disable_config [nil, Boolean, Array<Symbol>] Disable configuration
+      # @param disable_config [nil, Boolean, Symbol, Array<Symbol>] Disable configuration
       # @return [Boolean] True if tool should be disabled
       def tool_disabled?(tool_name, disable_config)
         return false if disable_config.nil?
@@ -306,6 +306,9 @@ module SwarmSDK
         if disable_config == true
           # Disable all default tools
           true
+        elsif disable_config.is_a?(Symbol)
+          # Single tool name
+          disable_config == tool_name
         elsif disable_config.is_a?(Array)
           # Disable only tools in the array
           disable_config.include?(tool_name)

data/lib/swarm_sdk/tools/think.rb

@@ -72,6 +72,8 @@ module SwarmSDK
         back to earlier thinking. Use clear formatting and organization to make it easy to reference
         later. Don't hesitate to think out loud - this tool is designed to augment your cognitive capabilities and help
         you deliver better solutions.
+
+        **CRITICAL:** The Think tool takes only one parameter: thoughts. Do not include any other parameters.
       DESC
 
       param :thoughts,
@@ -79,9 +81,7 @@ module SwarmSDK
         desc: "Your thoughts, plans, calculations, or any notes you want to record",
         required: true
 
-      def execute(thoughts:)
-        return validation_error("thoughts are required") if thoughts.nil? || thoughts.empty?
-
+      def execute(**kwargs)
         "Thought noted."
       end
 

data/lib/swarm_sdk/version.rb

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

data/lib/swarm_sdk.rb

@@ -17,8 +17,7 @@ require "async/semaphore"
 require "ruby_llm"
 require "ruby_llm/mcp"
 
-module SwarmSDK
-end
+require_relative "swarm_sdk/version"
 
 require "zeitwerk"
 loader = Zeitwerk::Loader.new
@@ -147,15 +146,6 @@ require "ruby_llm/mcp/parameter"
 
 module RubyLLM
   module MCP
-    class Parameter < RubyLLM::Parameter
-      def initialize(name, type: "string", desc: nil, required: true, default: nil, union_type: nil)
-        super(name, type: type, desc: desc, required: required)
-        @properties = {}
-        @union_type = union_type
-        @default = default
-      end
-    end
-
     module Notifications
       class Initialize
         def call

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: swarm_memory
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.1
 platform: ruby
 authors:
 - Paulo Arruda
 bindir: bin
 cert_chain: []
-date: 2025-10-26 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -71,14 +71,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -307,7 +307,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Persistent memory system for SwarmSDK agents
 test_files: []