Release: merge main into alpha/v2.0.0

packages/a2aprotocol/pyproject.toml

@@ -25,11 +25,13 @@ external = true
 
 
 [build-system]
-requires = ["hatchling", "hatch-nbgv"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]
-source = "nbgv-fallback"
+source = "teams-build"
+
+[tool.hatch.metadata.hooks.teams-build]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/microsoft_teams", "src/microsoft"]

packages/ai/pyproject.toml

@@ -13,11 +13,13 @@ dependencies = [
 ]
 
 [build-system]
-requires = ["hatchling", "hatch-nbgv"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]
-source = "nbgv-fallback"
+source = "teams-build"
+
+[tool.hatch.metadata.hooks.teams-build]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/microsoft_teams", "src/microsoft"]

packages/api/pyproject.toml

@@ -25,11 +25,13 @@ dependencies = [
 Homepage = "https://github.com/microsoft/teams.py/tree/main/packages/api/src/microsoft/teams/api"
 
 [build-system]
-requires = ["hatchling", "hatch-nbgv"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]
-source = "nbgv-fallback"
+source = "teams-build"
+
+[tool.hatch.metadata.hooks.teams-build]
 
 [dependency-groups]
 dev = [

packages/apps/pyproject.toml

@@ -35,11 +35,13 @@ test = [
 ]
 
 [build-system]
-requires = ["hatchling", "hatch-nbgv"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]
-source = "nbgv-fallback"
+source = "teams-build"
+
+[tool.hatch.metadata.hooks.teams-build]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/microsoft_teams", "src/microsoft"]

packages/botbuilder/pyproject.toml

@@ -21,11 +21,13 @@ Homepage = "https://github.com/microsoft/teams.py/tree/main/packages/botbuilder/
 
 
 [build-system]
-requires = ["hatchling", "hatch-nbgv"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]
-source = "nbgv-fallback"
+source = "teams-build"
+
+[tool.hatch.metadata.hooks.teams-build]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/microsoft_teams", "src/microsoft"]

packages/cards/pyproject.toml

@@ -21,11 +21,11 @@ dev = [
 Homepage = "https://github.com/microsoft/teams.py/tree/main/packages/cards/src/microsoft/teams/cards"
 
 [build-system]
-requires = ["hatchling", "hatch-nbgv"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]
-source = "nbgv-fallback"
+source = "teams-build"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/microsoft_teams", "src/microsoft"]

packages/common/pyproject.toml

@@ -27,11 +27,11 @@ Homepage = "https://github.com/microsoft/teams.py/tree/main/packages/common/src/
 
 
 [build-system]
-requires = ["hatchling", "hatch-nbgv"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]
-source = "nbgv-fallback"
+source = "teams-build"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/microsoft_teams", "src/microsoft"]

packages/devtools/pyproject.toml

@@ -25,11 +25,13 @@ Homepage = "https://github.com/microsoft/teams.py/tree/main/packages/devtools/sr
 
 
 [build-system]
-requires = ["hatchling", "hatch-nbgv"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]
-source = "nbgv-fallback"
+source = "teams-build"
+
+[tool.hatch.metadata.hooks.teams-build]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/microsoft_teams", "src/microsoft"]

packages/graph/pyproject.toml

@@ -26,11 +26,13 @@ testpaths = ["tests"]
 python_paths = ["src"]
 
 [build-system]
-requires = ["hatchling", "hatch-nbgv"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]
-source = "nbgv-fallback"
+source = "teams-build"
+
+[tool.hatch.metadata.hooks.teams-build]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/microsoft_teams", "src/microsoft"]

packages/mcpplugin/pyproject.toml

@@ -20,11 +20,13 @@ dependencies = [
 external = true
 
 [build-system]
-requires = ["hatchling", "hatch-nbgv"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]
-source = "nbgv-fallback"
+source = "teams-build"
+
+[tool.hatch.metadata.hooks.teams-build]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/microsoft_teams", "src/microsoft"]

packages/openai/pyproject.toml

@@ -16,11 +16,13 @@ dependencies = [
 ]
 
 [build-system]
-requires = ["hatchling", "hatch-nbgv"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
 [tool.hatch.version]
-source = "nbgv-fallback"
+source = "teams-build"
+
+[tool.hatch.metadata.hooks.teams-build]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/microsoft_teams", "src/microsoft"]

pyproject.toml

@@ -10,7 +10,7 @@
 "microsoft-teams-mcpplugin" = { workspace = true }
 "microsoft-teams-a2a" = { workspace = true }
 "microsoft-teams-botbuilder" = { workspace = true }
-"hatch-nbgv" = { path = "tools/hatch-nbgv" }
+"hatch-teams-build" = { path = "tools/hatch-teams-build" }
 
 [tool.uv.workspace]
 members = ["packages/*", "examples/*"]
@@ -31,7 +31,7 @@ dev = [
     "pytest-cov>=6.0.0",
 ]
 release = [
-    "hatch-nbgv",
+    "hatch-teams-build",
 ]
 
 [tool.ruff]
@@ -55,6 +55,7 @@ select = ["E", "F", "W", "B", "Q", "I", "ASYNC"]
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
+testpaths = ["packages"]
 
 [tool.poe.tasks]
 fmt = "ruff format"

templates/package/cookiecutter.json

@@ -1,7 +1,6 @@
 {
   "pypi_package_name": "subpackage-name",
   "project_short_description": "project description",
-  "version": "0.0.1-alpha.1",
   "core": true,
   "__prompts__": {
     "core": "Core package? (I.e. not an external integration?)"

templates/package/{{cookiecutter.pypi_package_name}}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "{{cookiecutter.pypi_package_name}}"
-version = "{{cookiecutter.version}}"
+dynamic = ["version"]
 description = "{{cookiecutter.project_short_description}}"
 authors = [{ name = "Microsoft", email = "TeamsAISDKFeedback@microsoft.com" }]
 readme = "README.md"
@@ -15,9 +15,14 @@ external = true
 {% endif %}
 
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-teams-build"]
 build-backend = "hatchling.build"
 
+[tool.hatch.version]
+source = "teams-build"
+
+[tool.hatch.metadata.hooks.teams-build]
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/microsoft_teams"]
 

tools/hatch-teams-build/README.md

@@ -0,0 +1,46 @@
+# hatch-teams-build
+
+Hatchling plugin for the Teams Python SDK. Provides two build-time hooks:
+
+## Version Source (`teams-build`)
+
+Wraps [nbgv-python](https://pypi.org/project/nbgv-python/) to resolve package versions from git history via [Nerdbank.GitVersioning](https://github.com/dotnet/Nerdbank.GitVersioning). Falls back to `0.0.0` when the `nbgv` CLI is not installed, so local development works without .NET SDK. Set `NBGV_REQUIRED=1` to make the missing CLI a hard error (used in CI).
+
+```toml
+[tool.hatch.version]
+source = "teams-build"
+```
+
+## Metadata Hook (`teams-build`)
+
+Rewrites bare `microsoft-teams-*` dependencies to include `>=<current_version>` at build time. This ensures published wheels enforce compatible sibling package versions.
+
+```toml
+[tool.hatch.metadata.hooks.teams-build]
+```
+
+**Example:** if the current nbgv version is `2.0.0a49`, a dependency listed as `microsoft-teams-common` becomes `microsoft-teams-common>=2.0.0a49` in the built wheel metadata.
+
+When nbgv is unavailable (fallback `0.0.0`), the hook skips rewriting entirely — dependencies stay bare, which is correct for local development where UV workspace resolution handles everything.
+
+## Usage
+
+Each package pyproject.toml needs:
+
+```toml
+[build-system]
+requires = ["hatchling", "hatch-teams-build"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "teams-build"
+
+[tool.hatch.metadata.hooks.teams-build]
+```
+
+## Verification
+
+```bash
+uv build packages/apps --sdist
+# Inspect PKG-INFO — workspace deps should show >=<version>
+```

tools/hatch-nbgv/pyproject.toml → tools/hatch-teams-build/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
-name = "hatch-nbgv"
+name = "hatch-teams-build"
 version = "0.1.0"
-description = "Hatchling version source plugin wrapping nbgv-python with graceful fallback"
+description = "Hatchling plugin for Teams SDK: nbgv version source with graceful fallback and workspace dependency versioning"
 authors = [{ name = "Microsoft", email = "TeamsAISDKFeedback@microsoft.com" }]
 requires-python = ">=3.12"
 license = "MIT"
@@ -12,10 +12,10 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [project.entry-points.hatch]
-hatch-nbgv = "hatch_nbgv.hooks"
+hatch-teams-build = "hatch_teams_build.hooks"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/hatch_nbgv"]
+packages = ["src/hatch_teams_build"]
 
 [tool.hatch.build.targets.sdist]
 include = ["src"]

tools/hatch-teams-build/src/hatch_teams_build/__init__.py

@@ -0,0 +1,9 @@
+"""
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the MIT License.
+"""
+
+from hatch_teams_build.metadata_hook import TeamsBuildMetadataHook
+from hatch_teams_build.version_source import TeamsBuildVersionSource
+
+__all__ = ["TeamsBuildMetadataHook", "TeamsBuildVersionSource"]

tools/hatch-teams-build/src/hatch_teams_build/hooks.py

@@ -0,0 +1,19 @@
+"""
+Copyright (c) Microsoft Corporation. All rights reserved.
+Licensed under the MIT License.
+"""
+
+from hatchling.plugin import hookimpl
+
+from hatch_teams_build.metadata_hook import TeamsBuildMetadataHook
+from hatch_teams_build.version_source import TeamsBuildVersionSource
+
+
+@hookimpl
+def hatch_register_version_source():
+    return TeamsBuildVersionSource
+
+
+@hookimpl
+def hatch_register_metadata_hook():
+    return TeamsBuildMetadataHook