Python: Introduce Agent Framework Lab with GAIA Benchmark and Lighting project for RL (#719)

* prepare eval package

* add gaia benchmark to eval package

* update telemetry

* renaming

* organization

* organize into namespace packages; rename to labs

* update cookie cutter instruction

* update gaia runner

* use temp directory

* Rename "labs" --> "lab"

* update

* update gaia sample

* update status

* Add lighting project

* Add listing for lighting

python/packages/lab/lighting/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Microsoft Corporation.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

python/packages/lab/lighting/README.md

@@ -0,0 +1,56 @@
+# Agent Framework Lab - Agent Framework x Agent Lighting
+
+RL Module for Microsoft Agent Framework
+
+## Installation
+
+```bash
+pip install agent-framework-lab-lighting
+```
+
+## Usage
+
+```python
+from agent_framework.lab.lighting import YourClass
+
+# Your usage example here
+instance = YourClass()
+```
+
+## Overview
+
+Brief description of what this lab package provides and its main features.
+
+## Features
+
+- Feature 1: Description
+- Feature 2: Description
+- Feature 3: Description
+
+## Examples
+
+### Basic Usage
+
+```python
+from agent_framework.lab.lighting import YourClass
+
+# Example usage
+```
+
+### Advanced Usage
+
+```python
+# More advanced examples
+```
+
+## API Reference
+
+Document your main classes and functions here.
+
+## Contributing
+
+This package is part of the Microsoft Agent Framework Lab. Please see the main repository for contribution guidelines.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

python/packages/lab/lighting/agent_framework/__init__.py

@@ -0,0 +1,4 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+# This makes agent_framework a namespace package
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)

python/packages/lab/lighting/agent_framework/lab/__init__.py

@@ -0,0 +1,4 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+# This makes agent_framework.lab a namespace package
+__path__ = __import__("pkgutil").extend_path(__path__, __name__)

python/packages/lab/lighting/agent_framework/lab/lighting/__init__.py

@@ -0,0 +1,4 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+# Import and re-export from the actual implementation
+from agent_framework_lab_lighting import *  # noqa: F403, F401

python/packages/lab/lighting/agent_framework_lab_lighting/__init__.py

@@ -0,0 +1,16 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+"""
+RL Module for Microsoft Agent Framework
+"""
+
+# Import your main exports here
+# from .main_module import MainClass, main_function
+
+__all__ = [
+    # List your exports here
+    # "MainClass",
+    # "main_function",
+]
+
+__version__ = "0.1.0b1"

python/packages/lab/lighting/pyproject.toml

@@ -0,0 +1,87 @@
+[project]
+name = "agent-framework-lab-lighting"
+description = "RL Module for Microsoft Agent Framework"
+authors = [{ name = "Microsoft", email = "SK-Support@microsoft.com"}]
+readme = "README.md"
+requires-python = ">=3.10"
+version = "0.1.0b1"
+license-files = ["LICENSE"]
+urls.homepage = "https://learn.microsoft.com/en-us/semantic-kernel/overview/"
+urls.source = "https://github.com/microsoft/agent-framework/tree/main/python"
+urls.release_notes = "https://github.com/microsoft/agent-framework/releases?q=tag%3Apython-1&expanded=true"
+urls.issues = "https://github.com/microsoft/agent-framework/issues"
+classifiers = [
+  "License :: OSI Approved :: MIT License",
+  "Development Status :: 2 - Pre-Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+  "agent-framework",
+  "pydantic>=2.0.0",
+  # Add your specific dependencies here
+]
+
+
+[project.scripts]
+lighting = "agent_framework_lab_lighting:main"
+
+
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["agent_framework_lab_lighting", "agent_framework.lab.lighting"]
+
+[tool.setuptools.package-data]
+agent_framework_lab_lighting = ["py.typed"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+extend-exclude = ["tests", "__pycache__"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "UP", "C4", "N"]
+ignore = ["N803", "N806", "N999", "UP007"]
+
+[tool.ruff.format]
+quote-style = "double"
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+check_untyped_defs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+disallow_untyped_decorators = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_return_any = true
+warn_unreachable = true
+show_error_codes = true
+implicit_reexport = true
+packages = ["agent_framework_lab_lighting"]
+
+
+[tool.poe]
+executor.type = "uv"
+include = "../../../shared_tasks.toml"
+[tool.poe.tasks]
+test = "pytest --cov=agent_framework_lab_lighting --cov-report=term-missing:skip-covered tests"
+mypy = "mypy agent_framework_lab_lighting"
+
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]
+addopts = "--strict-markers --strict-config"
+markers = [
+  "unit: marks tests as unit tests",
+  "integration: marks tests as integration tests",
+]

python/packages/lab/lighting/tests/__init__.py

@@ -0,0 +1 @@
+# Copyright (c) Microsoft. All rights reserved.

python/packages/lab/lighting/tests/test_lighting.py

@@ -0,0 +1,15 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+"""Tests for lighting module."""
+
+import pytest
+from agent_framework_lab_lighting import __version__
+
+
+class TestLighting:
+    """Test the lighting module."""
+    
+    def test_version(self):
+        """Test package version is defined."""
+        assert __version__ is not None
+        assert __version__ == "0.1.0b1"