feat: REL-10782 Introduce server-ai and langchain packages with initial configurations

Author: edwinokonkwo

.github/actions/build/action.yml

@@ -10,10 +10,11 @@ runs:
   steps:
     - name: Build distribution files
       shell: bash
+      working-directory: ./packages/sdk/server-ai
       run: poetry build
     - name: Hash build files for provenance
       id: package-hashes
       shell: bash
-      working-directory: ./dist
+      working-directory: ./packages/sdk/server-ai/dist
       run: |
         echo "package-hashes=$(sha256sum * | base64 -w0)" >> "$GITHUB_OUTPUT"

.github/workflows/ci.yml

@@ -59,7 +59,9 @@ jobs:
         uses: abatilo/actions-poetry@7b6d33e44b4f08d7021a1dee3c044e9c253d6439
 
       - name: Install requirements
-        run: poetry install
+        run: |
+          cd packages/sdk/server-ai
+          poetry install
 
       - name: Run tests
         run: make test

.release-please-manifest.json

@@ -1,3 +1,4 @@
 {
-  ".": "0.10.1"
+  "packages/sdk/server-ai": "0.10.1",
+  "packages/ai-providers/server-ai-langchain": "0.1.0"
 }

Makefile

@@ -6,6 +6,10 @@ SPHINXPROJ    = launchdarkly-server-sdk
 SOURCEDIR     = docs
 BUILDDIR      = $(SOURCEDIR)/build
 
+# Package paths
+SERVER_AI_PKG = packages/sdk/server-ai
+LANGCHAIN_PKG = packages/ai-providers/server-ai-langchain
+
 .PHONY: help
 help: #! Show this help message
 	@echo 'Usage: make [target] ... '
@@ -14,31 +18,59 @@ help: #! Show this help message
 	@grep -h -F '#!' $(MAKEFILE_LIST) | grep -v grep | sed 's/:.*#!/:/' | column -t -s":"
 
 .PHONY: install
-install:
-	@poetry install
+install: #! Install all packages
+	@cd $(SERVER_AI_PKG) && poetry install
+	@cd $(LANGCHAIN_PKG) && poetry install
+
+.PHONY: install-server-ai
+install-server-ai: #! Install server-ai package
+	@cd $(SERVER_AI_PKG) && poetry install
+
+.PHONY: install-langchain
+install-langchain: #! Install langchain provider package
+	@cd $(LANGCHAIN_PKG) && poetry install
 
 #
 # Quality control checks
 #
 
 .PHONY: test
-test: #! Run unit tests
-test: install
-	@poetry run pytest $(PYTEST_FLAGS)
+test: #! Run unit tests for all packages
+test: test-server-ai
+
+.PHONY: test-server-ai
+test-server-ai: #! Run unit tests for server-ai package
+test-server-ai: install-server-ai
+	@cd $(SERVER_AI_PKG) && poetry run pytest $(PYTEST_FLAGS)
+
+.PHONY: test-langchain
+test-langchain: #! Run unit tests for langchain provider package
+test-langchain: install-langchain
+	@cd $(LANGCHAIN_PKG) && poetry run pytest $(PYTEST_FLAGS)
 
 .PHONY: lint
-lint: #! Run type analysis and linting checks
-lint: install
-	@poetry run mypy ldai
-	@poetry run isort --check --atomic ldai
-	@poetry run pycodestyle ldai
+lint: #! Run type analysis and linting checks for all packages
+lint: lint-server-ai
+
+.PHONY: lint-server-ai
+lint-server-ai: #! Run type analysis and linting checks for server-ai package
+lint-server-ai: install-server-ai
+	@cd $(SERVER_AI_PKG) && poetry run mypy src/ldai
+	@cd $(SERVER_AI_PKG) && poetry run isort --check --atomic src/ldai
+	@cd $(SERVER_AI_PKG) && poetry run pycodestyle src/ldai
+
+.PHONY: lint-langchain
+lint-langchain: #! Run type analysis and linting checks for langchain provider package
+lint-langchain: install-langchain
+	@cd $(LANGCHAIN_PKG) && poetry run mypy src/ldai_langchain
+	@cd $(LANGCHAIN_PKG) && poetry run pycodestyle src/ldai_langchain
 
 #
 # Documentation generation
 #
 
 .PHONY: docs
 docs: #! Generate sphinx-based documentation
-	@poetry install --with docs
+	@cd $(SERVER_AI_PKG) && poetry install --with docs
 	@cd docs
-	@poetry run $(SPHINXBUILD) -M html "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@cd $(SERVER_AI_PKG) && poetry run $(SPHINXBUILD) -M html "../../../$(SOURCEDIR)" "../../../$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/conf.py

@@ -19,7 +19,8 @@
 import os
 import sys
 
-sys.path.insert(0, os.path.abspath('..'))
+# Add the server-ai package source to the path
+sys.path.insert(0, os.path.abspath('../packages/sdk/server-ai/src'))
 
 import ldai
 

ldai/testing/__init__.py

@@ -0,0 +1,31 @@
+# LaunchDarkly AI SDK - LangChain Provider
+
+This package provides LangChain integration for the LaunchDarkly Server-Side AI SDK.
+
+## Status
+
+🚧 **Coming Soon** - This package is a placeholder for future LangChain integration.
+
+## Installation
+
+```bash
+pip install launchdarkly-server-sdk-ai-langchain
+```
+
+## Usage
+
+```python
+# Coming soon
+```
+
+## Documentation
+
+For full documentation, please refer to the [LaunchDarkly AI SDK documentation](https://docs.launchdarkly.com/sdk/ai/python).
+
+## Contributing
+
+See [CONTRIBUTING.md](../../../CONTRIBUTING.md) in the repository root.
+
+## License
+
+Apache-2.0

packages/ai-providers/server-ai-langchain/README.md

@@ -0,0 +1,51 @@
+[tool.poetry]
+name = "launchdarkly-server-sdk-ai-langchain"
+version = "0.1.0"
+description = "LaunchDarkly AI SDK LangChain Provider"
+authors = ["LaunchDarkly <[email protected]>"]
+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_langchain", from = "src" }]
+
+[tool.poetry.dependencies]
+python = ">=3.9,<4"
+launchdarkly-server-sdk-ai = ">=0.10.1"
+# langchain-core = ">=0.1.0"  # Uncomment when implementing
+
+
+[tool.poetry.group.dev.dependencies]
+pytest = ">=2.8"
+pytest-cov = ">=2.4.0"
+pytest-asyncio = ">=0.21.0"
+mypy = "==1.18.2"
+
+[tool.mypy]
+python_version = "3.9"
+ignore_missing_imports = true
+install_types = true
+non_interactive = true
+
+
+[tool.pytest.ini_options]
+addopts = ["-ra"]
+testpaths = ["tests"]
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

packages/ai-providers/server-ai-langchain/pyproject.toml

@@ -0,0 +1,14 @@
+"""LaunchDarkly AI SDK - LangChain Provider.
+
+This package provides LangChain integration for the LaunchDarkly Server-Side AI SDK.
+"""
+
+__version__ = "0.1.0"
+
+# Placeholder for future LangChain provider implementation
+# from ldai_langchain.langchain_provider import LangChainProvider
+
+__all__ = [
+    '__version__',
+    # 'LangChainProvider',  # Uncomment when implemented
+]

packages/ai-providers/server-ai-langchain/src/ldai_langchain/__init__.py

@@ -0,0 +1 @@
+"""Tests for LangChain provider."""