swarm_memory 2.0.0

data/lib/swarm_sdk/tools/write.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module SwarmSDK
+  module Tools
+    # Write tool for writing content to files
+    #
+    # Creates new files or overwrites existing files.
+    # Enforces read-before-write rule for existing files.
+    # Includes validation and usage guidelines via system reminders.
+    class Write < RubyLLM::Tool
+      include PathResolver
+
+      description <<~DESC
+        Writes a file to the local filesystem.
+        This tool will overwrite the existing file if there is one at the provided path.
+        If this is an existing file, you MUST use the Read tool first to read the file's contents.
+        This tool will fail if you did not read the file first.
+        ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.
+        NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.
+        Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.
+
+        IMPORTANT - Path Handling:
+        - Relative paths (e.g., "tmp/file.txt", "src/main.rb") are resolved relative to your agent's working directory
+        - Absolute paths (e.g., "/tmp/file.txt", "/etc/passwd") are treated as system absolute paths
+        - When the user says "tmp/file.txt" they mean the tmp directory in your working directory, NOT /tmp
+        - Only use absolute paths (starting with /) when explicitly referring to system-level paths
+      DESC
+
+      param :file_path,
+        type: "string",
+        desc: "Path to the file. Use relative paths (e.g., 'tmp/file.txt') for files in your working directory, or absolute paths (e.g., '/etc/passwd') for system files.",
+        required: true
+
+      param :content,
+        type: "string",
+        desc: "The content to write to the file",
+        required: true
+
+      # Initialize the Write tool for a specific agent
+      #
+      # @param agent_name [Symbol, String] The agent identifier
+      # @param directory [String] Agent's working directory
+      def initialize(agent_name:, directory:)
+        super()
+        @agent_name = agent_name.to_sym
+        @directory = File.expand_path(directory)
+      end
+
+      # Override name to return simple "Write" instead of full class path
+      def name
+        "Write"
+      end
+
+      def execute(file_path:, content:)
+        # Validate inputs
+        return validation_error("file_path is required") if file_path.nil? || file_path.to_s.strip.empty?
+        return validation_error("content is required") if content.nil?
+
+        # CRITICAL: Resolve path against agent directory
+        resolved_path = resolve_path(file_path)
+
+        # Check if file already exists (use resolved path)
+        file_exists = File.exist?(resolved_path)
+
+        # Enforce read-before-write for existing files (use resolved path)
+        if file_exists && !Stores::ReadTracker.file_read?(@agent_name, resolved_path)
+          return validation_error(
+            "Cannot write to existing file without reading it first. " \
+              "You must use the Read tool on '#{file_path}' before overwriting it. " \
+              "This ensures you have context about the file's current contents.",
+          )
+        end
+
+        # Create parent directory if it doesn't exist (use resolved path)
+        parent_dir = File.dirname(resolved_path)
+        FileUtils.mkdir_p(parent_dir) unless File.directory?(parent_dir)
+
+        # Write the file (use resolved path)
+        File.write(resolved_path, content, encoding: "UTF-8")
+
+        # Build success message
+        byte_size = content.bytesize
+        line_count = content.lines.count
+        action = file_exists ? "overwrote" : "created"
+
+        message = "Successfully #{action} file: #{file_path} (#{line_count} lines, #{byte_size} bytes)"
+
+        # Add system reminder for overwritten files
+        if file_exists
+          reminder = "<system-reminder>You overwrote an existing file. Make sure this was intentional and that you read the file first if you needed to preserve any content.</system-reminder>"
+          "#{message}\n\n#{reminder}"
+        else
+          message
+        end
+      rescue Errno::EACCES
+        error("Permission denied: Cannot write to file '#{file_path}'")
+      rescue Errno::EISDIR
+        error("Path is a directory, not a file.")
+      rescue Errno::ENOENT => e
+        error("Failed to create parent directory: #{e.message}")
+      rescue StandardError => e
+        error("Unexpected error writing file: #{e.class.name} - #{e.message}")
+      end
+
+      private
+
+      # Helper methods
+      def validation_error(message)
+        "<tool_use_error>InputValidationError: #{message}</tool_use_error>"
+      end
+
+      def error(message)
+        "Error: #{message}"
+      end
+    end
+  end
+end

data/lib/swarm_sdk/utils.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module SwarmSDK
+  # Shared utility methods for SwarmSDK
+  module Utils
+    class << self
+      # Recursively convert all hash keys to symbols
+      #
+      # Handles nested hashes and arrays containing hashes.
+      #
+      # @param obj [Object] Object to symbolize (Hash, Array, or other)
+      # @return [Object] Object with symbolized keys (if applicable)
+      #
+      # @example
+      #   Utils.symbolize_keys({ "name" => "test", "config" => { "key" => "value" } })
+      #   # => { name: "test", config: { key: "value" } }
+      def symbolize_keys(obj)
+        case obj
+        when Hash
+          obj.transform_keys(&:to_sym).transform_values { |v| symbolize_keys(v) }
+        when Array
+          obj.map { |item| symbolize_keys(item) }
+        else
+          obj
+        end
+      end
+
+      # Recursively convert all hash keys to strings
+      #
+      # Handles nested hashes and arrays containing hashes.
+      #
+      # @param obj [Object] Object to stringify (Hash, Array, or other)
+      # @return [Object] Object with stringified keys (if applicable)
+      #
+      # @example
+      #   Utils.stringify_keys({ name: "test", config: { key: "value" } })
+      #   # => { "name" => "test", "config" => { "key" => "value" } }
+      def stringify_keys(obj)
+        case obj
+        when Hash
+          obj.transform_keys(&:to_s).transform_values { |v| stringify_keys(v) }
+        when Array
+          obj.map { |item| stringify_keys(item) }
+        else
+          obj
+        end
+      end
+    end
+  end
+end

data/lib/swarm_sdk/version.rb

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

data/lib/swarm_sdk.rb

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+require "bundler"
+require "digest"
+require "English"
+require "erb"
+require "fileutils"
+require "json"
+require "logger"
+require "pathname"
+require "securerandom"
+require "set"
+require "yaml"
+
+require "async"
+require "async/semaphore"
+require "ruby_llm"
+require "ruby_llm/mcp"
+
+module SwarmSDK
+end
+
+require "zeitwerk"
+loader = Zeitwerk::Loader.new
+loader.push_dir("#{__dir__}/swarm_sdk", namespace: SwarmSDK)
+loader.inflector.inflect(
+  "cli" => "CLI",
+)
+loader.setup
+
+# Load plugin system explicitly (core infrastructure)
+require_relative "swarm_sdk/plugin"
+require_relative "swarm_sdk/plugin_registry"
+
+# Load custom providers explicitly (Zeitwerk doesn't eager load by default)
+require_relative "swarm_sdk/providers/openai_with_responses"
+
+module SwarmSDK
+  class Error < StandardError; end
+  class ConfigurationError < Error; end
+  class AgentNotFoundError < Error; end
+  class CircularDependencyError < Error; end
+  class ToolExecutionError < Error; end
+  class LLMError < Error; end
+  class StateError < Error; end
+
+  class << self
+    # Settings for SwarmSDK (global configuration)
+    attr_accessor :settings
+
+    # Main entry point for DSL
+    def build(&block)
+      Swarm::Builder.build(&block)
+    end
+
+    # Configure SwarmSDK global settings
+    def configure
+      self.settings ||= Settings.new
+      yield(settings)
+    end
+
+    # Reset settings to defaults
+    def reset_settings!
+      self.settings = Settings.new
+    end
+
+    # Alias for backward compatibility
+    alias_method :configuration, :settings
+    alias_method :reset_configuration!, :reset_settings!
+  end
+
+  # Settings class for SwarmSDK global settings (not to be confused with Configuration for YAML loading)
+  class Settings
+    # WebFetch tool LLM processing configuration
+    attr_accessor :webfetch_provider, :webfetch_model, :webfetch_base_url, :webfetch_max_tokens
+
+    def initialize
+      @webfetch_provider = nil
+      @webfetch_model = nil
+      @webfetch_base_url = nil
+      @webfetch_max_tokens = 4096
+    end
+
+    # Check if WebFetch LLM processing is enabled
+    def webfetch_llm_enabled?
+      !@webfetch_provider.nil? && !@webfetch_model.nil?
+    end
+  end
+
+  # Initialize default settings
+  self.settings = Settings.new
+end
+
+# Automatically configure RubyLLM from environment variables
+# This makes SwarmSDK "just work" when users set standard ENV variables
+RubyLLM.configure do |config|
+  # Only set if config not already set (||= handles nil ENV values gracefully)
+
+  # OpenAI
+  config.openai_api_key ||= ENV["OPENAI_API_KEY"]
+  config.openai_api_base ||= ENV["OPENAI_API_BASE"]
+  config.openai_organization_id ||= ENV["OPENAI_ORG_ID"]
+  config.openai_project_id ||= ENV["OPENAI_PROJECT_ID"]
+
+  # Anthropic
+  config.anthropic_api_key ||= ENV["ANTHROPIC_API_KEY"]
+
+  # Google Gemini
+  config.gemini_api_key ||= ENV["GEMINI_API_KEY"]
+
+  # Google Vertex AI (note: vertexai, not vertex_ai)
+  config.vertexai_project_id ||= ENV["GOOGLE_CLOUD_PROJECT"] || ENV["VERTEXAI_PROJECT_ID"]
+  config.vertexai_location ||= ENV["GOOGLE_CLOUD_LOCATION"] || ENV["VERTEXAI_LOCATION"]
+
+  # DeepSeek
+  config.deepseek_api_key ||= ENV["DEEPSEEK_API_KEY"]
+
+  # Mistral
+  config.mistral_api_key ||= ENV["MISTRAL_API_KEY"]
+
+  # Perplexity
+  config.perplexity_api_key ||= ENV["PERPLEXITY_API_KEY"]
+
+  # OpenRouter
+  config.openrouter_api_key ||= ENV["OPENROUTER_API_KEY"]
+
+  # AWS Bedrock
+  config.bedrock_api_key ||= ENV["AWS_ACCESS_KEY_ID"]
+  config.bedrock_secret_key ||= ENV["AWS_SECRET_ACCESS_KEY"]
+  config.bedrock_region ||= ENV["AWS_REGION"]
+  config.bedrock_session_token ||= ENV["AWS_SESSION_TOKEN"]
+
+  # Ollama (local)
+  config.ollama_api_base ||= ENV["OLLAMA_API_BASE"]
+
+  # GPUStack (local)
+  config.gpustack_api_base ||= ENV["GPUSTACK_API_BASE"]
+  config.gpustack_api_key ||= ENV["GPUSTACK_API_KEY"]
+end
+
+# monkey patches
+# ruby_llm/mcp
+# - add `id` when sending "notifications/initialized" message: https://github.com/patvice/ruby_llm-mcp/issues/65
+# - remove `to_sym` on MCP parameter type: https://github.com/patvice/ruby_llm-mcp/issues/62#issuecomment-3421488406
+require "ruby_llm/mcp/notifications/initialize"
+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
+          @coordinator.request(notification_body, add_id: true, wait_for_response: false)
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,313 @@
+--- !ruby/object:Gem::Specification
+name: swarm_memory
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Paulo Arruda
+bindir: bin
+cert_chain: []
+date: 2025-10-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: informers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: rice
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.6.0
+- !ruby/object:Gem::Dependency
+  name: ruby_llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: swarm_sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+description: Hierarchical persistent memory with semantic search for SwarmSDK AI agents
+email:
+- parrudaj@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- lib/claude_swarm.rb
+- lib/claude_swarm/base_executor.rb
+- lib/claude_swarm/claude_code_executor.rb
+- lib/claude_swarm/claude_mcp_server.rb
+- lib/claude_swarm/cli.rb
+- lib/claude_swarm/commands/ps.rb
+- lib/claude_swarm/commands/show.rb
+- lib/claude_swarm/configuration.rb
+- lib/claude_swarm/hooks/session_start_hook.rb
+- lib/claude_swarm/json_handler.rb
+- lib/claude_swarm/mcp_generator.rb
+- lib/claude_swarm/openai/chat_completion.rb
+- lib/claude_swarm/openai/executor.rb
+- lib/claude_swarm/openai/responses.rb
+- lib/claude_swarm/orchestrator.rb
+- lib/claude_swarm/process_tracker.rb
+- lib/claude_swarm/session_cost_calculator.rb
+- lib/claude_swarm/session_path.rb
+- lib/claude_swarm/settings_generator.rb
+- lib/claude_swarm/system_utils.rb
+- lib/claude_swarm/templates/generation_prompt.md.erb
+- lib/claude_swarm/tools/reset_session_tool.rb
+- lib/claude_swarm/tools/session_info_tool.rb
+- lib/claude_swarm/tools/task_tool.rb
+- lib/claude_swarm/version.rb
+- lib/claude_swarm/worktree_manager.rb
+- lib/claude_swarm/yaml_loader.rb
+- lib/swarm_cli.rb
+- lib/swarm_cli/cli.rb
+- lib/swarm_cli/command_registry.rb
+- lib/swarm_cli/commands/mcp_serve.rb
+- lib/swarm_cli/commands/mcp_tools.rb
+- lib/swarm_cli/commands/migrate.rb
+- lib/swarm_cli/commands/run.rb
+- lib/swarm_cli/config_loader.rb
+- lib/swarm_cli/formatters/human_formatter.rb
+- lib/swarm_cli/formatters/json_formatter.rb
+- lib/swarm_cli/interactive_repl.rb
+- lib/swarm_cli/mcp_serve_options.rb
+- lib/swarm_cli/mcp_tools_options.rb
+- lib/swarm_cli/migrate_options.rb
+- lib/swarm_cli/migrator.rb
+- lib/swarm_cli/options.rb
+- lib/swarm_cli/ui/components/agent_badge.rb
+- lib/swarm_cli/ui/components/content_block.rb
+- lib/swarm_cli/ui/components/divider.rb
+- lib/swarm_cli/ui/components/panel.rb
+- lib/swarm_cli/ui/components/usage_stats.rb
+- lib/swarm_cli/ui/formatters/cost.rb
+- lib/swarm_cli/ui/formatters/number.rb
+- lib/swarm_cli/ui/formatters/text.rb
+- lib/swarm_cli/ui/formatters/time.rb
+- lib/swarm_cli/ui/icons.rb
+- lib/swarm_cli/ui/renderers/event_renderer.rb
+- lib/swarm_cli/ui/state/agent_color_cache.rb
+- lib/swarm_cli/ui/state/depth_tracker.rb
+- lib/swarm_cli/ui/state/spinner_manager.rb
+- lib/swarm_cli/ui/state/usage_tracker.rb
+- lib/swarm_cli/version.rb
+- lib/swarm_memory.rb
+- lib/swarm_memory/adapters/base.rb
+- lib/swarm_memory/adapters/filesystem_adapter.rb
+- lib/swarm_memory/chat_extension.rb
+- lib/swarm_memory/cli/commands.rb
+- lib/swarm_memory/core/entry.rb
+- lib/swarm_memory/core/frontmatter_parser.rb
+- lib/swarm_memory/core/metadata_extractor.rb
+- lib/swarm_memory/core/path_normalizer.rb
+- lib/swarm_memory/core/semantic_index.rb
+- lib/swarm_memory/core/storage.rb
+- lib/swarm_memory/core/storage_read_tracker.rb
+- lib/swarm_memory/dsl/builder_extension.rb
+- lib/swarm_memory/dsl/memory_config.rb
+- lib/swarm_memory/embeddings/embedder.rb
+- lib/swarm_memory/embeddings/informers_embedder.rb
+- lib/swarm_memory/errors.rb
+- lib/swarm_memory/integration/cli_registration.rb
+- lib/swarm_memory/integration/configuration.rb
+- lib/swarm_memory/integration/registration.rb
+- lib/swarm_memory/integration/sdk_plugin.rb
+- lib/swarm_memory/optimization/analyzer.rb
+- lib/swarm_memory/optimization/defragmenter.rb
+- lib/swarm_memory/prompts/memory.md.erb
+- lib/swarm_memory/prompts/memory_assistant.md.erb
+- lib/swarm_memory/prompts/memory_researcher.md.erb
+- lib/swarm_memory/prompts/memory_retrieval.md.erb
+- lib/swarm_memory/search/semantic_search.rb
+- lib/swarm_memory/search/text_search.rb
+- lib/swarm_memory/search/text_similarity.rb
+- lib/swarm_memory/skills/meta/deep-learning.md
+- lib/swarm_memory/skills/meta/deep-learning.yml
+- lib/swarm_memory/tools/load_skill.rb
+- lib/swarm_memory/tools/memory_defrag.rb
+- lib/swarm_memory/tools/memory_delete.rb
+- lib/swarm_memory/tools/memory_edit.rb
+- lib/swarm_memory/tools/memory_glob.rb
+- lib/swarm_memory/tools/memory_grep.rb
+- lib/swarm_memory/tools/memory_multi_edit.rb
+- lib/swarm_memory/tools/memory_read.rb
+- lib/swarm_memory/tools/memory_write.rb
+- lib/swarm_memory/utils.rb
+- lib/swarm_memory/version.rb
+- lib/swarm_sdk.rb
+- lib/swarm_sdk/agent/RETRY_LOGIC.md
+- lib/swarm_sdk/agent/builder.rb
+- lib/swarm_sdk/agent/chat.rb
+- lib/swarm_sdk/agent/chat/context_tracker.rb
+- lib/swarm_sdk/agent/chat/hook_integration.rb
+- lib/swarm_sdk/agent/chat/logging_helpers.rb
+- lib/swarm_sdk/agent/chat/system_reminder_injector.rb
+- lib/swarm_sdk/agent/context.rb
+- lib/swarm_sdk/agent/context_manager.rb
+- lib/swarm_sdk/agent/definition.rb
+- lib/swarm_sdk/claude_code_agent_adapter.rb
+- lib/swarm_sdk/configuration.rb
+- lib/swarm_sdk/context_compactor.rb
+- lib/swarm_sdk/context_compactor/metrics.rb
+- lib/swarm_sdk/context_compactor/token_counter.rb
+- lib/swarm_sdk/hooks/adapter.rb
+- lib/swarm_sdk/hooks/context.rb
+- lib/swarm_sdk/hooks/definition.rb
+- lib/swarm_sdk/hooks/error.rb
+- lib/swarm_sdk/hooks/executor.rb
+- lib/swarm_sdk/hooks/registry.rb
+- lib/swarm_sdk/hooks/result.rb
+- lib/swarm_sdk/hooks/shell_executor.rb
+- lib/swarm_sdk/hooks/tool_call.rb
+- lib/swarm_sdk/hooks/tool_result.rb
+- lib/swarm_sdk/log_collector.rb
+- lib/swarm_sdk/log_stream.rb
+- lib/swarm_sdk/markdown_parser.rb
+- lib/swarm_sdk/model_aliases.json
+- lib/swarm_sdk/models.json
+- lib/swarm_sdk/models.rb
+- lib/swarm_sdk/node/agent_config.rb
+- lib/swarm_sdk/node/builder.rb
+- lib/swarm_sdk/node/transformer_executor.rb
+- lib/swarm_sdk/node_context.rb
+- lib/swarm_sdk/node_orchestrator.rb
+- lib/swarm_sdk/permissions/config.rb
+- lib/swarm_sdk/permissions/error_formatter.rb
+- lib/swarm_sdk/permissions/path_matcher.rb
+- lib/swarm_sdk/permissions/validator.rb
+- lib/swarm_sdk/permissions_builder.rb
+- lib/swarm_sdk/plugin.rb
+- lib/swarm_sdk/plugin_registry.rb
+- lib/swarm_sdk/prompts/base_system_prompt.md.erb
+- lib/swarm_sdk/providers/openai_with_responses.rb
+- lib/swarm_sdk/result.rb
+- lib/swarm_sdk/swarm.rb
+- lib/swarm_sdk/swarm/agent_initializer.rb
+- lib/swarm_sdk/swarm/all_agents_builder.rb
+- lib/swarm_sdk/swarm/builder.rb
+- lib/swarm_sdk/swarm/mcp_configurator.rb
+- lib/swarm_sdk/swarm/tool_configurator.rb
+- lib/swarm_sdk/tools/bash.rb
+- lib/swarm_sdk/tools/clock.rb
+- lib/swarm_sdk/tools/delegate.rb
+- lib/swarm_sdk/tools/document_converters/base_converter.rb
+- lib/swarm_sdk/tools/document_converters/docx_converter.rb
+- lib/swarm_sdk/tools/document_converters/html_converter.rb
+- lib/swarm_sdk/tools/document_converters/pdf_converter.rb
+- lib/swarm_sdk/tools/document_converters/xlsx_converter.rb
+- lib/swarm_sdk/tools/edit.rb
+- lib/swarm_sdk/tools/glob.rb
+- lib/swarm_sdk/tools/grep.rb
+- lib/swarm_sdk/tools/image_extractors/docx_image_extractor.rb
+- lib/swarm_sdk/tools/image_extractors/pdf_image_extractor.rb
+- lib/swarm_sdk/tools/image_formats/tiff_builder.rb
+- lib/swarm_sdk/tools/multi_edit.rb
+- lib/swarm_sdk/tools/path_resolver.rb
+- lib/swarm_sdk/tools/read.rb
+- lib/swarm_sdk/tools/registry.rb
+- lib/swarm_sdk/tools/scratchpad/scratchpad_list.rb
+- lib/swarm_sdk/tools/scratchpad/scratchpad_read.rb
+- lib/swarm_sdk/tools/scratchpad/scratchpad_write.rb
+- lib/swarm_sdk/tools/stores/read_tracker.rb
+- lib/swarm_sdk/tools/stores/scratchpad_storage.rb
+- lib/swarm_sdk/tools/stores/storage.rb
+- lib/swarm_sdk/tools/stores/todo_manager.rb
+- lib/swarm_sdk/tools/think.rb
+- lib/swarm_sdk/tools/todo_write.rb
+- lib/swarm_sdk/tools/web_fetch.rb
+- lib/swarm_sdk/tools/write.rb
+- lib/swarm_sdk/utils.rb
+- lib/swarm_sdk/version.rb
+homepage: https://github.com/parruda/claude-swarm
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/parruda/claude-swarm
+  changelog_uri: https://github.com/parruda/claude-swarm/blob/main/docs/v2/CHANGELOG.swarm_memory.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Persistent memory system for SwarmSDK agents
+test_files: []