Python: Promote python declarative workflows to stable version (#7065)

* Promote python declarative workflows to stable version

* Updated changelog with PR detail.

* Updated to address pr comments.

* Remove changelog update

python/PACKAGE_STATUS.md

@@ -27,7 +27,7 @@ Status is grouped into these buckets:
 | `agent-framework-claude` | `python/packages/claude` | `beta` |
 | `agent-framework-copilotstudio` | `python/packages/copilotstudio` | `beta` |
 | `agent-framework-core` | `python/packages/core` | `released` |
-| `agent-framework-declarative` | `python/packages/declarative` | `rc` |
+| `agent-framework-declarative` | `python/packages/declarative` | `released` |
 | `agent-framework-devui` | `python/packages/devui` | `beta` |
 | `agent-framework-durabletask` | `python/packages/durabletask` | `beta` |
 | `agent-framework-foundry` | `python/packages/foundry` | `released` |

python/packages/declarative/README.md

@@ -3,7 +3,7 @@
 Please install this package via pip:
 
 ```bash
-pip install agent-framework-declarative --pre
+pip install agent-framework-declarative
 ```
 
 ## Release stage
@@ -11,8 +11,7 @@ pip install agent-framework-declarative --pre
 This package ships at two different stability levels:
 
 - **Declarative workflows** (`WorkflowFactory`, executors, handlers, and the
-  `_workflows` surface) are at **release-candidate** stability and may receive only
-  minor refinements before GA.
+  `_workflows` surface) are **stable**.
 - **Declarative agents** (`AgentFactory` and the YAML agent loading/parsing path:
   `DeclarativeLoaderError`, `ProviderLookupError`, `ProviderTypeMapping`) are
   **experimental** and may change or be removed in future versions without notice.

python/packages/declarative/agent_framework_declarative/__init__.py

@@ -5,7 +5,7 @@
 Release stage:
 
 * The declarative-workflows surface (``WorkflowFactory``, executors, handlers,
-  etc.) is at release-candidate stability.
+  etc.) is stable.
 * The declarative-agents surface (``AgentFactory`` and the YAML agent
   loading/parsing path: ``DeclarativeLoaderError``, ``ProviderLookupError``,
   ``ProviderTypeMapping``) is *experimental* and may change or be removed in

python/packages/declarative/pyproject.toml

@@ -4,7 +4,7 @@ description = "Declarative specification support for Microsoft Agent Framework."
 authors = [{ name = "Microsoft", email = "af-support@microsoft.com"}]
 readme = "README.md"
 requires-python = ">=3.10"
-version = "1.0.0rc2"
+version = "1.0.0"
 license-files = ["LICENSE"]
 urls.homepage = "https://aka.ms/agent-framework"
 urls.source = "https://github.com/microsoft/agent-framework/tree/main/python"
@@ -12,7 +12,7 @@ urls.release_notes = "https://github.com/microsoft/agent-framework/releases?q=ta
 urls.issues = "https://github.com/microsoft/agent-framework/issues"
 classifiers = [
   "License :: OSI Approved :: MIT License",
-  "Development Status :: 4 - Beta",
+  "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3.10",

python/samples/02-agents/declarative/README.md

@@ -7,9 +7,11 @@ This folder contains sample code demonstrating how to use the **Microsoft Agent
 Install the declarative package via pip:
 
 ```bash
-pip install agent-framework-declarative --pre
+pip install agent-framework-declarative
 ```
 
+> **Note:** These samples use `AgentFactory` (declarative agents), which is **experimental** and emits an `ExperimentalWarning` on first use. The declarative *workflows* surface is stable.
+
 ## What is Declarative Agent Framework?
 
 The declarative package provides support for building agents based on YAML specifications. This approach offers several benefits:

python/samples/02-agents/declarative/inline_yaml.py

@@ -15,7 +15,8 @@ This sample shows how to create an agent using an inline YAML string rather than
 It uses a Azure AI Client so it needs the credential to be passed into the AgentFactory.
 
 Prerequisites:
-- `pip install agent-framework-foundry agent-framework-declarative --pre`
+- `pip install agent-framework-foundry agent-framework-declarative`
+- Note: this sample uses `AgentFactory` (declarative agents), which is experimental and emits an `ExperimentalWarning` on first use.
 - Set the following environment variables in a .env file or your environment:
     - FOUNDRY_PROJECT_ENDPOINT
     - FOUNDRY_MODEL

python/samples/02-agents/declarative/mcp_tool_yaml.py

@@ -18,7 +18,8 @@ Authentication Options:
   (no secrets passed in API calls - connection name references pre-configured auth)
 
 Prerequisites:
-- `pip install agent-framework-openai agent-framework-declarative --pre`
+- `pip install agent-framework-openai agent-framework-declarative`
+- Note: this sample uses `AgentFactory` (declarative agents), which is experimental and emits an `ExperimentalWarning` on first use.
 - For OpenAI example: Set OPENAI_API_KEY and GITHUB_PAT environment variables
 - For Azure AI example: Set up a Foundry connection in your Azure AI project
 """

python/uv.lock

@@ -462,7 +462,7 @@ dev = [
 
 [[package]]
 name = "agent-framework-declarative"
-version = "1.0.0rc2"
+version = "1.0.0"
 source = { editable = "packages/declarative" }
 dependencies = [
     { name = "agent-framework-core", marker = "sys_platform == 'darwin' or sys_platform == 'linux' or sys_platform == 'win32'" },