feat: Add optimization package stub

.github/workflows/ci.yml

@@ -138,3 +138,56 @@ jobs:
 
       - name: Run tests
         run: make -C packages/ai-providers/server-ai-openai test
+
+  server-ai-optimization-linux:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ./.github/actions/ci
+        with:
+          workspace_path: packages/optimization
+          python_version: ${{ matrix.python-version }}
+
+      - uses: ./.github/actions/build
+        with:
+          workspace_path: packages/optimization
+
+  server-ai-optimization-windows:
+    runs-on: windows-latest
+    defaults:
+      run:
+        shell: powershell
+
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install poetry
+        uses: abatilo/actions-poetry@7b6d33e44b4f08d7021a1dee3c044e9c253d6439
+
+      - name: Configure poetry for local virtualenvs
+        run: poetry config virtualenvs.in-project true
+
+      - name: Install server-ai dependency first
+        working-directory: packages/sdk/server-ai
+        run: poetry install
+
+      - name: Install requirements
+        working-directory: packages/optimization
+        run: poetry install
+
+      - name: Run tests
+        run: make -C packages/optimization test

.github/workflows/release-please.yml

@@ -27,6 +27,7 @@ on:
           - packages/sdk/server-ai
           - packages/ai-providers/server-ai-langchain
           - packages/ai-providers/server-ai-openai
+          - packages/optimization
       dry_run:
         description: 'Is this a dry run. If so no package will be published.'
         type: boolean
@@ -46,6 +47,8 @@ jobs:
       package-server-ai-langchain-tag-name: ${{ steps.release.outputs['packages/ai-providers/server-ai-langchain--tag_name'] }}
       package-server-ai-openai-released: ${{ steps.release.outputs['packages/ai-providers/server-ai-openai--release_created'] }}
       package-server-ai-openai-tag-name: ${{ steps.release.outputs['packages/ai-providers/server-ai-openai--tag_name'] }}
+      package-server-ai-optimization-released: ${{ steps.release.outputs['packages/optimization--release_created'] }}
+      package-server-ai-optimization-tag-name: ${{ steps.release.outputs['packages/optimization--tag_name'] }}
     steps:
       - uses: googleapis/release-please-action@16a9c90856f42705d54a6fda1823352bdc62cf38 # v4
         id: release
@@ -222,3 +225,57 @@ jobs:
       base64-subjects: "${{ needs.release-server-ai-openai.outputs.package-hashes }}"
       upload-assets: true
       upload-tag-name: ${{ needs.release-please.outputs.package-server-ai-openai-tag-name }}
+
+  release-server-ai-optimization:
+    runs-on: ubuntu-latest
+    needs: ['release-please']
+    permissions:
+      id-token: write # Needed for OIDC to get release secrets from AWS.
+    if: ${{ needs.release-please.outputs.package-server-ai-optimization-released == 'true' }}
+    outputs:
+      package-hashes: ${{ steps.build.outputs.package-hashes }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install poetry
+        uses: abatilo/actions-poetry@7b6d33e44b4f08d7021a1dee3c044e9c253d6439 # 7b6d33e44b4f08d7021a1dee3c044e9c253d6439
+
+      - uses: ./.github/actions/ci
+        with:
+          workspace_path: packages/optimization
+
+      - uses: ./.github/actions/build
+        id: build
+        with:
+          workspace_path: packages/optimization
+
+      - uses: launchdarkly/gh-actions/actions/release-secrets@release-secrets-v1.2.0
+        name: 'Get PyPI token'
+        with:
+          aws_assume_role: ${{ vars.AWS_ROLE_ARN }}
+          ssm_parameter_pairs: '/production/common/releasing/pypi/token = PYPI_AUTH_TOKEN'
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # v1.13.0
+        with:
+          password: ${{ env.PYPI_AUTH_TOKEN }}
+          packages-dir: packages/optimization/dist/
+
+  release-server-ai-optimization-provenance:
+    needs: ['release-please', 'release-server-ai-optimization']
+    if: ${{ needs.release-please.outputs.package-server-ai-optimization-released == 'true' }}
+    permissions:
+      actions: read # Needed for detecting the GitHub Actions environment.
+      id-token: write # Needed for provenance signing.
+      contents: write # Needed for uploading assets to the release.
+    uses: slsa-framework/slsa-github-generator/.github/workflows/generator_generic_slsa3.yml@v2.0.0
+    with:
+      base64-subjects: "${{ needs.release-server-ai-optimization.outputs.package-hashes }}"
+      upload-assets: true
+      upload-tag-name: ${{ needs.release-please.outputs.package-server-ai-optimization-tag-name }}

packages/optimization/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.0.0 (2026-03-24)
+
+### Features
+
+* Initial package scaffolding for optimization helpers.

packages/optimization/Makefile

@@ -0,0 +1,29 @@
+PYTEST_FLAGS=-W error::SyntaxWarning
+
+.PHONY: help
+help: #! Show this help message
+	@echo 'Usage: make [target] ... '
+	@echo ''
+	@echo 'Targets:'
+	@grep -h -F '#!' $(MAKEFILE_LIST) | grep -v grep | sed 's/:.*#!/:/' | column -t -s":"
+
+.PHONY: install
+install: #! Install package dependencies
+	poetry install
+
+.PHONY: test
+test: #! Run unit tests
+test: install
+	poetry run pytest $(PYTEST_FLAGS)
+
+.PHONY: lint
+lint: #! Run type analysis and linting checks
+lint: install
+	poetry run mypy src/ldai_optimization
+	poetry run isort --check --atomic src/ldai_optimization
+	poetry run pycodestyle src/ldai_optimization
+
+.PHONY: build
+build: #! Build distribution files
+build: install
+	poetry build

packages/optimization/README.md

@@ -0,0 +1,25 @@
+# LaunchDarkly AI SDK — optimization
+
+[![PyPI](https://img.shields.io/pypi/v/launchdarkly-server-sdk-ai-optimization.svg?style=flat-square)](https://pypi.org/project/launchdarkly-server-sdk-ai-optimization/)
+
+> [!CAUTION]
+> This package 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](CHANGELOG.md) before upgrading.
+
+This package will provide helpers to run selected tools against the [LaunchDarkly API](https://apidocs.launchdarkly.com/) from SDK-based workflows. The public surface is not yet finalized; see [CHANGELOG.md](CHANGELOG.md) for updates.
+
+## Installation
+
+```bash
+pip install launchdarkly-server-sdk-ai-optimization
+```
+
+## Status
+
+- 3/24/26: Initial package creation
+
+## License
+
+Apache-2.0

packages/optimization/pyproject.toml

@@ -0,0 +1,57 @@
+[tool.poetry]
+name = "launchdarkly-server-sdk-ai-optimization"
+version = "0.0.0"
+description = "LaunchDarkly AI SDK optimization helpers"
+authors = ["LaunchDarkly <dev@launchdarkly.com>"]
+license = "Apache-2.0"
+readme = "README.md"
+homepage = "https://docs.launchdarkly.com/sdk/ai/python"
+repository = "https://github.com/launchdarkly/python-server-sdk-ai"
+classifiers = [
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Libraries",
+]
+packages = [{ include = "ldai_optimization", from = "src" }]
+
+[tool.poetry.dependencies]
+python = ">=3.9,<4"
+launchdarkly-server-sdk-ai = ">=0.16.0"
+
+[tool.poetry.group.dev.dependencies]
+pytest = ">=2.8"
+pytest-cov = ">=2.4.0"
+pytest-asyncio = ">=0.21.0,<1.0.0"
+mypy = "==1.18.2"
+pycodestyle = ">=2.11.0"
+isort = ">=5.12.0"
+
+[tool.mypy]
+python_version = "3.9"
+ignore_missing_imports = true
+install_types = true
+non_interactive = true
+
+[tool.isort]
+profile = "black"
+known_third_party = ["ldai"]
+sections = ["FUTURE", "STDLIB", "THIRDPARTY", "FIRSTPARTY", "LOCALFOLDER"]
+
+
+[tool.pytest.ini_options]
+addopts = ["-ra"]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

packages/optimization/setup.cfg

@@ -0,0 +1,2 @@
+[pycodestyle]
+max-line-length = 120

packages/optimization/src/ldai_optimization/__init__.py

@@ -0,0 +1,13 @@
+"""LaunchDarkly AI SDK — optimization.
+
+This package will provide helpers to run selected tools against the LaunchDarkly API from SDK-based workflows.
+"""
+
+from ldai_optimization.client import ApiAgentOptimizationClient
+
+__version__ = "0.0.0"
+
+__all__ = [
+    '__version__',
+    'ApiAgentOptimizationClient',
+]

packages/optimization/src/ldai_optimization/client.py

@@ -0,0 +1,20 @@
+"""Client placeholder for LaunchDarkly API tool execution."""
+
+from typing import Any, Dict
+
+
+class ApiAgentOptimizationClient:
+    """Coordinates running supported tools against the LaunchDarkly API.
+
+    This type is scaffolding; concrete behavior will be added in a future release.
+    """
+
+    def optimize(self, tool_name: str, parameters: Dict[str, Any]) -> Any:
+        """Execute a supported LaunchDarkly API tool by name.
+
+        :param tool_name: Identifier of the tool to invoke.
+        :param parameters: Tool-specific request parameters.
+        :return: Tool-specific response data.
+        :raises NotImplementedError: Until the API integration is implemented.
+        """
+        raise NotImplementedError

packages/optimization/tests/test_package.py

@@ -0,0 +1,16 @@
+"""Smoke tests for ldai_optimization."""
+
+import pytest
+
+from ldai_optimization import ApiAgentOptimizationClient, __version__
+
+
+def test_version_is_string():
+    assert isinstance(__version__, str)
+    assert len(__version__) > 0
+
+
+def test_optimize_not_implemented():
+    client = ApiAgentOptimizationClient()
+    with pytest.raises(NotImplementedError):
+        client.optimize("example", {})

pyproject.toml

@@ -8,14 +8,16 @@
 #   - packages/sdk/server-ai         (launchdarkly-server-sdk-ai)
 #   - packages/ai-providers/server-ai-openai   (launchdarkly-server-sdk-ai-openai)
 #   - packages/ai-providers/server-ai-langchain (launchdarkly-server-sdk-ai-langchain)
-
+#   - packages/optimization          (launchdarkly-server-sdk-ai-optimization)
+#
+# For development, use the package-specific pyproject.toml files in each member.
 [tool.uv.workspace]
 members = [
     "packages/sdk/server-ai",
     "packages/ai-providers/server-ai-openai",
     "packages/ai-providers/server-ai-langchain",
+    "packages/optimization",
 ]
-
 # Resolve launchdarkly-server-sdk-ai from the local workspace member rather
 # than PyPI. This applies to all workspace members automatically.
 [tool.uv.sources]

release-please-config.json

@@ -25,6 +25,14 @@
       "include-v-in-tag": false,
       "extra-files": ["src/ldai_openai/__init__.py"],
       "component": "launchdarkly-server-sdk-ai-openai"
+    },
+    "packages/optimization": {
+      "release-type": "python",
+      "versioning": "default",
+      "bump-minor-pre-major": true,
+      "include-v-in-tag": false,
+      "extra-files": ["src/ldai_optimization/__init__.py"],
+      "component": "launchdarkly-server-sdk-ai-optimization"
     }
   }
 }