diff --git a/python/PACKAGE_STATUS.md b/python/PACKAGE_STATUS.md index c0080f0cbbf..360b0f80e2a 100644 --- a/python/PACKAGE_STATUS.md +++ b/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` | diff --git a/python/packages/declarative/README.md b/python/packages/declarative/README.md index 02c1a354726..0ab3f8c9fc1 100644 --- a/python/packages/declarative/README.md +++ b/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. diff --git a/python/packages/declarative/agent_framework_declarative/__init__.py b/python/packages/declarative/agent_framework_declarative/__init__.py index fd864a70686..e9023149abc 100644 --- a/python/packages/declarative/agent_framework_declarative/__init__.py +++ b/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 diff --git a/python/packages/declarative/pyproject.toml b/python/packages/declarative/pyproject.toml index 378ec70f4c3..de02e57f7dd 100644 --- a/python/packages/declarative/pyproject.toml +++ b/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", diff --git a/python/samples/02-agents/declarative/README.md b/python/samples/02-agents/declarative/README.md index e1453e7d52b..bbffa144137 100644 --- a/python/samples/02-agents/declarative/README.md +++ b/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: diff --git a/python/samples/02-agents/declarative/inline_yaml.py b/python/samples/02-agents/declarative/inline_yaml.py index de6ad8fb4fd..6afd446fe69 100644 --- a/python/samples/02-agents/declarative/inline_yaml.py +++ b/python/samples/02-agents/declarative/inline_yaml.py @@ -15,7 +15,8 @@ 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 diff --git a/python/samples/02-agents/declarative/mcp_tool_yaml.py b/python/samples/02-agents/declarative/mcp_tool_yaml.py index 3931d19ae1a..9e89dbef568 100644 --- a/python/samples/02-agents/declarative/mcp_tool_yaml.py +++ b/python/samples/02-agents/declarative/mcp_tool_yaml.py @@ -18,7 +18,8 @@ (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 """ diff --git a/python/uv.lock b/python/uv.lock index 1e29e68513f..d7d87fe6fc9 100644 --- a/python/uv.lock +++ b/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'" },