minds_sdk 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c87aafd23aa3c79beffb7e71f2e8c5559cdeacd4d9ea313a918959d3c467f7c6
-  data.tar.gz: 50968756d64771da955cbbcdfe0a4f56222c01b6a1a5d4228b0916d0e2e34cf3
+  metadata.gz: ac43c5b8357b515c69241475ef036f61883fd8fc4a4e693dacf60f4fb046b284
+  data.tar.gz: bb9b63eaf02ab0dfb1333588771ae3f893191efe46c41f9956cf74575ba439b8
 SHA512:
-  metadata.gz: 0cb27972f74e235847215349ae2ff1d43c3dd157918954d7987e3ee1d1327d4239e13180213fd7c8fcf95abedb47b3c1a059dde0e22c614b24dabd86868e8385
-  data.tar.gz: 5a9e256939116119fe9b2e5252dadcdc15cc5fc8083f9434bd296005e47ccff265ade9922db54a6c9554dcf895501acd15b173a9fafb84419fb41e2cd5e8d6e6
+  metadata.gz: 783c67217b99f88df67dadfa58eaccabaadfcce50460cdb2085701e51866a73580aae5d28a850a48fe3b2e65b1c5758a92bcd66aa655a3c8dafb3b1381586eef
+  data.tar.gz: 7ccb9a82511e2e57082d4c043796919c4755caedc23fa6b729d681f73b9a6027abd45a36e8c1160924387f066a84807a3a3a8663329814d01a123f6ff6cc1de7

data/CHANGELOG.md

@@ -5,22 +5,22 @@
 ### Added
 - Initial release of the Minds Ruby SDK
 - Implemented `Minds::Client` for configuring and initializing the SDK
-- Added `Minds::Resources::Datasources` for managing data sources:
+- Added `Minds::Datasources` for managing data sources:
   - `create`: Create a new datasource
   - `all`: List all datasources
   - `find`: Get a datasource by name
   - `destroy`: Delete a datasource
-- Added `Minds::Resources::Minds` for managing minds:
+- Added `Minds::Minds` for managing minds:
   - `all`: List all minds
   - `find`: Get a mind by name
   - `create`: Create a new mind
   - `destroy`: Delete a mind
-- Implemented `Minds::Resources::Mind` class with methods:
+- Implemented `Minds::Mind` class with methods:
   - `update`: Update mind properties
   - `add_datasources`: Add a datasource to a mind
   - `destroy_datasources`: Remove a datasource from a mind
   - `completion`: Call mind completion (with streaming support)
-- Added support for various datasource types through `DatabaseConfig` class
+- Added support for various datasource types through `Minds::DatabaseConfig` class
 - Implemented error handling with custom error classes
 - Added YARD-style documentation for all public methods
 

data/lib/minds/client.rb

@@ -6,13 +6,15 @@ module Minds
 
     SENSITIVE_ATTRIBUTES = %i[@base_url @api_key].freeze
     CONFIG_KEYS = %i[base_url api_key log_errors api_version].freeze
-    attr_reader(*CONFIG_KEYS)
+    attr_reader(*CONFIG_KEYS, :faraday_middleware)
 
-    def initialize(options = {})
+    def initialize(options = {}, &faraday_middleware)
       # if key not present. Fall back to global config
       CONFIG_KEYS.each do |key|
         instance_variable_set "@#{key}", options[key] || Client.config.send(key)
       end
+
+      @faraday_middleware = faraday_middleware
     end
 
     class << self

data/lib/minds/datasources.rb

@@ -37,7 +37,7 @@ module Minds
     # @option ds_config [String] :description Description of the database. Used by mind to understand what data can be retrieved from it.
     # @option ds_config [Hash] :connection_data (optional) Credentials to connect to the database
     # @option ds_config [Array<String>] :tables (optional) List of allowed tables
-    # @param update [Boolean] If true, to update datasourse if exists, default is false
+    # @param update [Boolean] If true, to update datasource if exists, default is false
     # @return [Datasource] The created datasource object
     # @raise [ObjectNotSupported] If datasource type is not supported
     #
@@ -57,6 +57,8 @@ module Minds
     def create(ds_config, update = false)
       name = ds_config.name
 
+      Validators.validate_datasource_name!(name)
+
       path = "datasources"
       path += "/#{name}" if update
 

data/lib/minds/errors.rb

@@ -1,6 +1,9 @@
+# frozen_string_literal: true
+
 module Minds
   class Error < StandardError; end
-  class ValidationError < Error; end
   class ObjectNotFound < Error; end
   class ObjectNotSupported < Error; end
+  class MindNameInvalid < Error; end
+  class DatasourceNameInvalid < Error; end
 end

data/lib/minds/minds.rb

@@ -5,7 +5,7 @@ require "uri"
 
 module Minds
   DEFAULT_PROMPT_TEMPLATE = "Use your database tools to answer the user's question: {{question}}"
-
+  DEFAULT_MODEL = "gpt-4o"
   class Mind
     attr_reader :name, :model_name, :provider, :parameters, :created_at, :updated_at, :datasources, :prompt_template
 
@@ -36,6 +36,7 @@ module Minds
     # @param parameters [Hash, nil] Alter other parameters of the mind (optional)
     # @return [void]
     def update(name: nil, model_name: nil, provider: nil, prompt_template: nil, datasources: nil, parameters: nil)
+      Validators.validate_mind_name!(name) if !name.nil?
       data = {}
       ds_names = []
       datasources.each do |ds|
@@ -210,6 +211,8 @@ module Minds
     #   )
     #
     def create(name:, model_name: nil, provider: nil, prompt_template: nil, datasources: nil, parameters: nil, replace: false, update: false)
+      Validators.validate_mind_name!(name) if !name.nil?
+
       if replace
         find(name)
         destroy(name)
@@ -227,7 +230,7 @@ module Minds
       parameters["prompt_template"] ||= DEFAULT_PROMPT_TEMPLATE
       data = {
         name: name,
-        model_name: model_name,
+        model_name: model_name || DEFAULT_MODEL,
         provider: provider,
         parameters: parameters,
         datasources: ds_names

data/lib/minds/rest_client.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "uri"
+
 module Minds
   module RestClient
     def get(path:)
@@ -26,20 +28,21 @@ module Minds
 
     def delete(path:, parameters: nil)
       conn.delete(uri(path: path)) do |req|
-        req.body = parameters.to_json
+        req.body = parameters.to_json unless parameters.nil?
       end&.body
     end
 
     private
 
     def uri(path:)
-      return path if @base_url.include?(@api_version)
+      base_path = URI(@base_url).path
+      return path if base_path.split("/").include?(@api_version)
 
       "/#{@api_version}/#{path}"
     end
 
     def conn
-      Faraday.new(url: @base_url) do |builder|
+      connection = Faraday.new(url: @base_url) do |builder|
         builder.use MiddlewareErrors if @log_errors
         builder.headers["Authorization"] = "Bearer #{@api_key}"
         builder.headers["Content-Type"] = "application/json"
@@ -47,6 +50,9 @@ module Minds
         builder.response :json
         builder.response :raise_error
       end
+
+      @faraday_middleware&.call(connection)
+      connection
     end
   end
 end

data/lib/minds/validators.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Minds
+  module Validators
+    class << self
+      # Validates a mind name according to naming rules
+      #
+      # @param name [String] The mind name to validate
+      # @return [Boolean] Returns true if valid
+      # @raise [MindNameInvalid] If the mind name is invalid
+      #
+      # @example Valid mind names
+      #   validate_mind_name!("my_mind_1") # => true
+      #
+      # @example Invalid mind names
+      #   validate_mind_name!("123_mind") # raises MindNameInvalid
+      #   validate_mind_name!("my mind") # raises MindNameInvalid
+      #   validate_mind_name!("very_very_long_mind_name_over_32_chars") # raises MindNameInvalid
+      #
+      # @note Mind name rules:
+      #   - Must start with a letter
+      #   - Can contain only letters, numbers, or underscores
+      #   - Maximum length of 32 characters
+      #   - Cannot contain spaces
+      def validate_mind_name!(name)
+        unless name.match?(/\A[a-zA-Z][a-zA-Z0-9_]{0,31}\z/)
+          raise MindNameInvalid, "Mind name '#{name}' is invalid. It must start with a letter, contain only letters, numbers, or underscores, and be 32 characters or less."
+        end
+      end
+
+      # Validates a datasource name according to naming rules
+      #
+      # @param name [String] The datasource name to validate
+      # @return [Boolean] Returns true if valid
+      # @raise [DatasourceNameInvalid] If the datasource name is invalid
+      #
+      # @example Valid datasource names
+      #   validate_datasource_name!("my_database") # => true
+      #
+      # @example Invalid datasource names
+      #   validate_datasource_name!("123_db") # raises DatasourceNameInvalid
+      #   validate_datasource_name!("my database") # raises DatasourceNameInvalid
+      #   validate_datasource_name!("very_very_long_database_name_over_62_characters_not_allowed") # raises DatasourceNameInvalid
+      #
+      # @note Datasource name rules:
+      #   - Must start with a letter
+      #   - Can contain only letters, numbers, or underscores
+      #   - Maximum length of 62 characters
+      #   - Cannot contain spaces
+      def validate_datasource_name!(name)
+        unless name.match?(/\A[a-zA-Z][a-zA-Z0-9_]{0,61}\z/)
+          raise DatasourceNameInvalid, "Datasource name '#{name}' is invalid. It must start with a letter, contain only letters, numbers, or underscores, and be 62 characters or less."
+        end
+      end
+    end
+  end
+end

data/lib/minds/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Minds
-  VERSION = "1.0.1"
+  VERSION = "1.1.0"
 end

data/lib/minds.rb

@@ -9,6 +9,7 @@ require_relative "minds/errors"
 require_relative "minds/config/base"
 require_relative "minds/datasources"
 require_relative "minds/minds"
+require_relative "minds/validators"
 
 module Minds
   class MiddlewareErrors < Faraday::Middleware
@@ -30,10 +31,10 @@ module Minds
         error_suffix = "\033[0m"
 
         formatted_message = msg.split("\n").map do |line|
-          "#{' ' * 15}#{line}"
+          "#{' ' * 14}#{line}"
         end.join("\n")
 
-        "#{error_prefix} Rest Client Error\n#{formatted_message}#{error_suffix}\n"
+        "#{error_prefix} Minds Client Error\n#{formatted_message}#{error_suffix}\n"
       end
 
       logger.error(e.response[:body])

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: minds_sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - tungnt
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-10 00:00:00.000000000 Z
+date: 2025-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -65,6 +65,7 @@ files:
 - lib/minds/errors.rb
 - lib/minds/minds.rb
 - lib/minds/rest_client.rb
+- lib/minds/validators.rb
 - lib/minds/version.rb
 - sig/minds.rbs
 homepage: https://github.com/tungnt1203/minds_ruby_sdk
@@ -90,7 +91,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.4.1
 signing_key:
 specification_version: 4
 summary: Minds Ruby SDK provides an interface to interact with the Minds AI system