launchdarkly-server-sdk-ai 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4828d6db587bacb6185c5cd2d02840d6cd0529cc00ffc959f42cba096ea8a672
-  data.tar.gz: d88837be2fdc48085ab604d4e13d5f146b46a05d5ae3de7c8cd73435c7ab9f3a
+  metadata.gz: 841cd2b74f8a6e89125e283d2c75442ccb58d64373f04439f882b9d968803818
+  data.tar.gz: 85a82738b8c931e8a9dc466a9cc66ec077e20a2e58fb112e01cd286b1bf551df
 SHA512:
-  metadata.gz: d0dc49a04fb2cd56e039fb9d091ce4d61c4438dbdcc307e176d997740b15e5fe4a14699b04dd3e68399b89b09aa07a30c413ecde749432cb27a45157cf3bc663
-  data.tar.gz: a97a9126fa820435e661c421959560d4dc8107b9f164d42014f4ee4862460295aad5178e9782bf900787374e1c9d9ffb0e26efc3523e2c38969c0a004eda13a4
+  metadata.gz: 1fb7745e91ce1fb85b965c72f033d3c6ea8978f47d30aa691502251bba83238fbe279d5b67cc3a4e00b8669f3509bf61591bba7fa865f3147db2afc9cb5d3361
+  data.tar.gz: dde93cdaac0a5cf24e6c684d9b1769f9c5e6092e1140bf6f8125e6bc8a2eb0c485cc67f460b195366473f8ca2cda6ba41618d57e2c8e08e73798613c590901fa

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [0.3.0](https://github.com/launchdarkly/ruby-server-sdk-ai/compare/0.2.2...0.3.0) (2026-03-05)
+
+
+### ⚠ BREAKING CHANGES
+
+* Use kwargs for completion_config and config methods
+* Return disabled config if no defaultValue is provided ([#23](https://github.com/launchdarkly/ruby-server-sdk-ai/issues/23))
+
+### Features
+
+* Drop support for Ruby 3.0 which is EOL. ([fe3fdf8](https://github.com/launchdarkly/ruby-server-sdk-ai/commit/fe3fdf8c022dd4e53e43e9311d76e3b5a098af75))
+* Use kwargs for completion_config and config methods ([fe3fdf8](https://github.com/launchdarkly/ruby-server-sdk-ai/commit/fe3fdf8c022dd4e53e43e9311d76e3b5a098af75))
+
+
+### Bug Fixes
+
+* Return disabled config if no defaultValue is provided ([#23](https://github.com/launchdarkly/ruby-server-sdk-ai/issues/23)) ([fe3fdf8](https://github.com/launchdarkly/ruby-server-sdk-ai/commit/fe3fdf8c022dd4e53e43e9311d76e3b5a098af75))
+
+## [0.2.2](https://github.com/launchdarkly/ruby-server-sdk-ai/compare/0.2.1...0.2.2) (2026-02-25)
+
+
+### Bug Fixes
+
+* Deprecated config method, use completion_config ([#18](https://github.com/launchdarkly/ruby-server-sdk-ai/issues/18)) ([9f7ec17](https://github.com/launchdarkly/ruby-server-sdk-ai/commit/9f7ec178a87e0f1139c4445d4236cb5db296b0fa))
+* Improve usage reporting ([#18](https://github.com/launchdarkly/ruby-server-sdk-ai/issues/18)) ([9f7ec17](https://github.com/launchdarkly/ruby-server-sdk-ai/commit/9f7ec178a87e0f1139c4445d4236cb5db296b0fa))
+* Remove bundler version constraint from gemspec ([#20](https://github.com/launchdarkly/ruby-server-sdk-ai/issues/20)) ([ef18f32](https://github.com/launchdarkly/ruby-server-sdk-ai/commit/ef18f323d604b3b4d3ca8f913b66316def34042b))
+
 ## [0.2.1](https://github.com/launchdarkly/ruby-server-sdk-ai/compare/0.2.0...0.2.1) (2025-08-28)
 
 

data/PROVENANCE.md

@@ -9,7 +9,7 @@ To verify SLSA provenance attestations, we recommend using [slsa-verifier](https
 <!-- x-release-please-start-version -->
 ```
 # Set the version of the SDK to verify
-VERSION=0.2.1
+VERSION=0.3.0
 ```
 <!-- x-release-please-end -->
 

data/README.md

@@ -7,6 +7,17 @@ LaunchDarkly Server SDK AI library for Ruby
 [![RubyDoc](https://img.shields.io/static/v1?label=docs+-+all+versions&message=reference&color=00add8)](https://www.rubydoc.info/gems/launchdarkly-server-sdk-ai)
 [![GitHub Pages](https://img.shields.io/static/v1?label=docs+-+latest&message=reference&color=00add8)](https://launchdarkly.github.io/ruby-server-sdk-ai)
 
+> [!CAUTION]
+> This AI SDK is in pre-release and not subject to backwards compatibility guarantees. The API may change based on feedback.
+>
+> Pin to a specific minor version and review the [changelog] before upgrading.
+>
+> Active feature development is ongoing in the [Python][python-ai-sdk] and [Node.js][node-ai-sdk] AI SDKs, so this SDK will receive new features at a slower pace. Refer to those for the latest capabilities.
+
+[changelog]: https://github.com/launchdarkly/ruby-server-sdk-ai/blob/main/CHANGELOG.md
+[python-ai-sdk]: https://github.com/launchdarkly/python-server-sdk-ai/tree/main/packages/sdk/server-ai
+[node-ai-sdk]: https://github.com/launchdarkly/js-core/tree/main/packages/sdk/server-ai
+
 LaunchDarkly overview
 -------------------------
 [LaunchDarkly](https://www.launchdarkly.com) is a feature management platform that serves trillions of feature flags daily to help teams build better software, faster. [Get started](https://docs.launchdarkly.com/home/getting-started) using LaunchDarkly today!
@@ -16,7 +27,7 @@ LaunchDarkly overview
 Supported Ruby versions
 -----------------------
 
-This version of the library has a minimum Ruby version of 3.0.0, or 9.4.0 for JRuby.
+This version of the library has a minimum Ruby version of 3.1.0, or 9.4.0 for JRuby.
 
 Getting started
 -----------

data/lib/launchdarkly-server-sdk-ai.rb

@@ -4,6 +4,7 @@ require 'logger'
 require 'mustache'
 
 require 'server/ai/version'
+require 'server/ai/sdk_info'
 require 'server/ai/client'
 require 'server/ai/ai_config_tracker'
 

data/lib/server/ai/client.rb

@@ -3,6 +3,7 @@
 require 'ldclient-rb'
 require 'mustache'
 require_relative 'ai_config_tracker'
+require_relative 'sdk_info'
 
 module LaunchDarkly
   #
@@ -112,6 +113,15 @@ module LaunchDarkly
           @provider = provider
         end
 
+        #
+        # Returns a new disabled AIConfig instance.
+        #
+        # @return [AIConfig] a new disabled config
+        #
+        def self.disabled
+          new(enabled: false)
+        end
+
         def to_h
           {
             _ldMeta: {
@@ -127,6 +137,15 @@ module LaunchDarkly
       #
       # The Client class is the main entry point for the LaunchDarkly AI SDK.
       #
+      TRACK_SDK_INFO = '$ld:ai:sdk:info'
+      TRACK_USAGE_COMPLETION_CONFIG = '$ld:ai:usage:completion-config'
+
+      INIT_TRACK_CONTEXT = LaunchDarkly::LDContext.create({
+        kind: 'ld_ai',
+        key: 'ld-internal-tracking',
+        anonymous: true,
+      })
+
       class Client
         attr_reader :logger, :ld_client
 
@@ -135,30 +154,52 @@ module LaunchDarkly
 
           @ld_client = ld_client
           @logger = LaunchDarkly::Server::AI.default_logger
+
+          @ld_client.track(
+            TRACK_SDK_INFO,
+            INIT_TRACK_CONTEXT,
+            {
+              aiSdkName: LaunchDarkly::Server::AI::SDK_NAME,
+              aiSdkVersion: LaunchDarkly::Server::AI::VERSION,
+              aiSdkLanguage: LaunchDarkly::Server::AI::SDK_LANGUAGE,
+            },
+            1
+          )
         end
 
         #
         # Retrieves the AIConfig
         #
-        # @param config_key [String] The key of the configuration flag
+        # @param key [String] The key of the configuration flag
         # @param context [LDContext] The context used when evaluating the flag
-        # @param default_value [AIConfig] The default value to use if the flag is not found
+        # @param default [AIConfig] The default value to use if the flag is not found
         # @param variables [Hash] Optional variables for rendering messages
         # @return [AIConfig] An AIConfig instance containing the configuration data
         #
-        def config(config_key, context, default_value = nil, variables = nil)
-          @ld_client.track('$ld:ai:config:function:single', context, config_key, 1)
+        def completion_config(key:, context:, default: nil, variables: nil)
+          @ld_client.track(TRACK_USAGE_COMPLETION_CONFIG, context, key, 1)
+
+          _completion_config(key:, context:, default: default || AIConfig.disabled, variables:)
+        end
+
+        # @deprecated Use {#completion_config} instead.
+        def config(key:, context:, default: nil, variables: nil)
+          warn '[DEPRECATION] `config` is deprecated. Use `completion_config` instead.'
+          completion_config(key:, context:, default:, variables:)
+        end
+
+        private
 
+        def _completion_config(key:, context:, default:, variables: nil)
           variation = @ld_client.variation(
-            config_key,
+            key,
             context,
-            default_value.respond_to?(:to_h) ? default_value.to_h : nil
+            default.respond_to?(:to_h) ? default.to_h : nil
           )
 
           all_variables = variables ? variables.dup : {}
           all_variables[:ldctx] = context.to_h
 
-          # Process messages and provider configuration
           messages = nil
           if variation[:messages].is_a?(Array) && variation[:messages].all? { |msg| msg.is_a?(Hash) }
             messages = variation[:messages].map do |message|
@@ -188,18 +229,18 @@ module LaunchDarkly
           tracker = LaunchDarkly::Server::AI::AIConfigTracker.new(
             ld_client: @ld_client,
             variation_key: variation.dig(:_ldMeta, :variationKey) || '',
-            config_key: config_key,
+            config_key: key,
             version: variation.dig(:_ldMeta, :version) || 1,
             model_name: model&.name || '',
             provider_name: provider_config&.name || '',
-            context: context
+            context:
           )
 
           AIConfig.new(
             enabled: variation.dig(:_ldMeta, :enabled) || false,
-            messages: messages,
-            tracker: tracker,
-            model: model,
+            messages:,
+            tracker:,
+            model:,
             provider: provider_config
           )
         end

data/lib/server/ai/sdk_info.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module LaunchDarkly
+  module Server
+    module AI
+      SDK_NAME = 'launchdarkly-server-sdk-ai'
+      SDK_LANGUAGE = 'ruby'
+    end
+  end
+end

data/lib/server/ai/version.rb

@@ -3,7 +3,7 @@
 module LaunchDarkly
   module Server
     module AI
-      VERSION = '0.2.1' # x-release-please-version
+      VERSION = '0.3.0' # x-release-please-version
     end
   end
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: launchdarkly-server-sdk-ai
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - LaunchDarkly
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: launchdarkly-server-sdk
@@ -51,20 +52,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -168,6 +155,7 @@ files:
 - lib/launchdarkly-server-sdk-ai.rb
 - lib/server/ai/ai_config_tracker.rb
 - lib/server/ai/client.rb
+- lib/server/ai/sdk_info.rb
 - lib/server/ai/version.rb
 homepage: https://github.com/launchdarkly/ruby-server-sdk-ai
 licenses:
@@ -175,6 +163,7 @@ licenses:
 metadata:
   source_code_uri: https://github.com/launchdarkly/ruby-server-sdk-ai
   changelog_uri: https://github.com/launchdarkly/ruby-server-sdk-ai/blob/main/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -182,14 +171,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.3.27
+signing_key:
 specification_version: 4
 summary: LaunchDarkly AI SDK for Ruby
 test_files: []