chore: import upstream snapshot with attribution

python/packages/azure-ai-search/AGENTS.md

@@ -0,0 +1,48 @@
+# Azure AI Search Package (agent-framework-azure-ai-search)
+
+Integration with Azure AI Search for RAG (Retrieval-Augmented Generation).
+
+## Main Classes
+
+- **`AzureAISearchContextProvider`** - Context provider that retrieves relevant documents from Azure AI Search
+- **`AzureAISearchSettings`** - Pydantic settings for Azure AI Search configuration
+
+## API versions: stable vs preview
+
+The package depends on `azure-search-documents>=12.0.0,<13`, which spans both channels, and
+auto-detects which build is installed — there is no `api_version` parameter:
+
+| Channel | Install | SDK | Data-plane `api-version` (chosen by the SDK) |
+| --- | --- | --- | --- |
+| **Stable / GA** | `pip install azure-search-documents` | `12.0.0` | `2026-04-01` |
+| **Preview** | `pip install --pre azure-search-documents` | `12.1.0b1` | `2026-05-01-preview` |
+
+The provider never pins an `api-version`; the installed build picks its own default, so newer
+releases work without code changes (single source of truth = the install).
+
+Capability gating keys off `_preview_agentic_features_available` — whether the preview build's
+agentic symbols (`KnowledgeRetrieval{Low,Medium}ReasoningEffort`, `KnowledgeRetrievalOutputMode`)
+can be imported. Agentic **output mode** (`answer_synthesis`) and **extended reasoning effort**
+(`low`/`medium`) ship only in the preview build; on a stable build the provider omits them
+(extractive + minimal) and raises an actionable `ValueError` (citing the installed version) if
+they are explicitly requested. Semantic mode is unaffected.
+
+## Usage
+
+```python
+from agent_framework.azure import AzureAISearchContextProvider
+
+provider = AzureAISearchContextProvider(
+    endpoint="https://your-search.search.windows.net",
+    index_name="your-index",
+)
+agent = Agent(..., context_provider=provider)
+```
+
+## Import Path
+
+```python
+from agent_framework.azure import AzureAISearchContextProvider
+# or directly:
+from agent_framework_azure_ai_search import AzureAISearchContextProvider
+```

python/packages/azure-ai-search/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/azure-ai-search/README.md

@@ -0,0 +1,41 @@
+# Get Started with Microsoft Agent Framework Azure AI Search
+
+Please install this package via pip:
+
+```bash
+pip install agent-framework-azure-ai-search --pre
+```
+
+## Azure AI Search Integration
+
+The Azure AI Search integration provides context providers for RAG (Retrieval Augmented Generation) capabilities with two modes:
+
+- **Semantic Mode**: Fast hybrid search (vector + keyword) with semantic ranking
+- **Agentic Mode**: Multi-hop reasoning using Knowledge Bases for complex queries
+
+### API versions: stable vs preview
+
+The integration auto-detects which build of `azure-search-documents` is installed — there is
+nothing to configure in code:
+
+| Channel | Install | Data-plane `api-version` (chosen by the SDK) |
+| --- | --- | --- |
+| **Stable** | `pip install azure-search-documents` (`>=12.0.0`) | `2026-04-01` |
+| **Preview** | `pip install --pre azure-search-documents` (e.g. `12.1.0b1`) | `2026-05-01-preview` |
+
+The provider never pins an `api-version`; the installed build selects its own, so newer
+releases work without code changes.
+
+Agentic **output modes** (`answer_synthesis`) and **extended reasoning effort** (`low`/`medium`)
+ship only in the preview build. When a stable build is installed, the provider uses extractive
+output with minimal reasoning effort and raises an actionable error if a preview-only option is
+explicitly requested. Switching channels is a single change — the install — with no code edits.
+
+### Basic Usage Example
+
+See the [Azure AI Search context provider examples](../../samples/02-agents/context_providers/azure_ai_search/) which demonstrate:
+
+- Semantic search with hybrid (vector + keyword) queries
+- Agentic mode with Knowledge Bases for complex multi-hop reasoning
+- Environment variable configuration with Settings class
+- API key and managed identity authentication

python/packages/azure-ai-search/agent_framework_azure_ai_search/__init__.py

@@ -0,0 +1,16 @@
+# Copyright (c) Microsoft. All rights reserved.
+
+import importlib.metadata
+
+from ._context_provider import AzureAISearchContextProvider, AzureAISearchSettings
+
+try:
+    __version__ = importlib.metadata.version(__name__)
+except importlib.metadata.PackageNotFoundError:
+    __version__ = "0.0.0"  # Fallback for development mode
+
+__all__ = [
+    "AzureAISearchContextProvider",
+    "AzureAISearchSettings",
+    "__version__",
+]

python/packages/azure-ai-search/pyproject.toml

@@ -0,0 +1,102 @@
+[project]
+name = "agent-framework-azure-ai-search"
+description = "Azure AI Search integration for Microsoft Agent Framework."
+authors = [{ name = "Microsoft", email = "af-support@microsoft.com"}]
+readme = "README.md"
+requires-python = ">=3.10"
+version = "1.0.0b260709"
+license-files = ["LICENSE"]
+urls.homepage = "https://aka.ms/agent-framework"
+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 :: 4 - Beta",
+  "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",
+  "Programming Language :: Python :: 3.14",
+  "Typing :: Typed",
+]
+dependencies = [
+    "agent-framework-core>=1.11.0,<2",
+    # Stable/GA (12.0.0) targets Azure AI Search api-version 2026-04-01; the preview
+    # line (e.g. 12.1.0b1, installed with --pre) targets api-version 2026-05-01-preview.
+    "azure-search-documents>=12.0.0,<13",
+]
+
+[tool.uv]
+prerelease = "if-necessary-or-explicit"
+environments = [
+    "sys_platform == 'darwin'",
+    "sys_platform == 'linux'",
+    "sys_platform == 'win32'"
+]
+
+[tool.uv-dynamic-versioning]
+fallback-version = "0.0.0"
+
+[tool.pytest.ini_options]
+testpaths = 'tests'
+addopts = "-ra -q -r fEX"
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+filterwarnings = [
+    "ignore:Support for class-based `config` is deprecated:DeprecationWarning:pydantic.*"
+]
+timeout = 120
+markers = [
+    "integration: marks tests as integration tests that require external services",
+]
+
+[tool.ruff]
+extend = "../../pyproject.toml"
+exclude = ["examples"]
+
+[tool.coverage.run]
+omit = [
+    "**/__init__.py"
+]
+
+[tool.pyright]
+extends = "../../pyproject.toml"
+include = ["agent_framework_azure_ai_search"]
+exclude = ['tests']
+
+[tool.mypy]
+plugins = ['pydantic.mypy']
+strict = true
+python_version = "3.10"
+ignore_missing_imports = true
+disallow_untyped_defs = true
+no_implicit_optional = true
+check_untyped_defs = true
+warn_return_any = true
+show_error_codes = true
+warn_unused_ignores = false
+disallow_incomplete_defs = true
+disallow_untyped_decorators = true
+
+[tool.bandit]
+targets = ["agent_framework_azure_ai_search"]
+exclude_dirs = ["tests"]
+
+[tool.poe]
+executor.type = "uv"
+include = "../../shared_tasks.toml"
+
+[tool.poe.tasks.mypy]
+help = "Run MyPy for this package."
+cmd = "mypy --config-file $POE_ROOT/pyproject.toml agent_framework_azure_ai_search"
+
+[tool.poe.tasks.test]
+help = "Run the default unit test suite for this package."
+cmd = 'pytest -m "not integration" --cov=agent_framework_azure_ai_search --cov-report=term-missing:skip-covered tests'
+
+[build-system]
+requires = ["flit-core >= 3.11,<4.0"]
+build-backend = "flit_core.buildapi"