agent-framework 1.20.0__tar.gz → 1.22.0__tar.gz

agent_framework-1.20.0/README.md → agent_framework-1.22.0/PKG-INFO

@@ -1,3 +1,29 @@
+Metadata-Version: 2.5
+Name: agent-framework
+Version: 1.22.0
+Summary: Microsoft Agent Framework for building AI Agents with Python. This package contains core and a curated set of optional integrations.
+Author-email: Microsoft <af-support@microsoft.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Typing :: Typed
+License-File: LICENSE
+Requires-Dist: agent-framework-core[all]==1.22.0
+Project-URL: homepage, https://aka.ms/agent-framework
+Project-URL: issues, https://github.com/microsoft/agent-framework/issues
+Project-URL: release_notes, https://github.com/microsoft/agent-framework/releases?q=tag%3Apython-1&expanded=true
+Project-URL: source, https://github.com/microsoft/agent-framework/tree/main/python
+Import-Name: agent_framework_meta
+
 # Get Started with Microsoft Agent Framework for Python Developers
 
 ## Quick Install
@@ -39,9 +65,27 @@ This selective approach is useful when you know which integrations you need, and
 
 Supported Platforms:
 
-- Python: 3.10+
+- Python: 3.10–3.15
 - OS: Windows, macOS, Linux
 
+Python 3.10 remains supported and tested for this release, but it is deprecated
+because upstream Python 3.10 has reached end of life. New environments should
+use Python 3.11 or later. A future Agent Framework release will raise the
+minimum version separately; this release does not remove Python 3.10 from
+package metadata or CI.
+
+### Python 3.15 limitations
+
+`pip install agent-framework` resolves and imports on Python 3.15, but it does
+not provide exactly the same feature set as Python 3.14:
+
+| Area | Python 3.15 impact |
+| --- | --- |
+| Declarative Power Fx | `agent-framework-declarative` is installed, but its `powerfx` dependency is not. YAML values beginning with `=` produce a warning and remain unchanged instead of being evaluated. Declarative agents or workflows that rely on expressions may therefore use invalid literal values or fail later. |
+| Redis | `agent-framework-redis` is omitted from the standard install because RedisVL declares `Requires-Python <3.15`. Redis imports and Redis-backed history, context, and vector storage are unavailable. |
+| Hyperlight | `agent-framework-hyperlight` is omitted because no compatible Python 3.15 sandbox backend wheel is published. Hyperlight CodeAct and its `execute_code` tool are unavailable. |
+| AG-UI A2UI | The base `agent-framework-ag-ui` package works, but pip cannot install its optional `a2ui` extra because `ag-ui-a2ui-toolkit` declares `Requires-Python <3.15`. |
+
 ## 1. Setup API Keys
 
 Set as environment variables, or create a .env file at your project root:
@@ -262,3 +306,4 @@ For more advanced orchestration patterns including Sequential, Concurrent, Group
 - [Learn: Agent Framework Overview](https://learn.microsoft.com/agent-framework/overview/agent-framework-overview)
 - [Learn: Quick Start](https://learn.microsoft.com/agent-framework/tutorials/quick-start)
 - [Learn: Tutorials](https://learn.microsoft.com/agent-framework/get-started/)
+

agent_framework-1.20.0/PKG-INFO → agent_framework-1.22.0/README.md

@@ -1,28 +1,3 @@
-Metadata-Version: 2.5
-Name: agent-framework
-Version: 1.20.0
-Summary: Microsoft Agent Framework for building AI Agents with Python. This package contains all the core and optional packages.
-Author-email: Microsoft <af-support@microsoft.com>
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Typing :: Typed
-License-File: LICENSE
-Requires-Dist: agent-framework-core[all]==1.20.0
-Project-URL: homepage, https://aka.ms/agent-framework
-Project-URL: issues, https://github.com/microsoft/agent-framework/issues
-Project-URL: release_notes, https://github.com/microsoft/agent-framework/releases?q=tag%3Apython-1&expanded=true
-Project-URL: source, https://github.com/microsoft/agent-framework/tree/main/python
-Import-Name: agent_framework_meta
-
 # Get Started with Microsoft Agent Framework for Python Developers
 
 ## Quick Install
@@ -64,9 +39,27 @@ This selective approach is useful when you know which integrations you need, and
 
 Supported Platforms:
 
-- Python: 3.10+
+- Python: 3.10–3.15
 - OS: Windows, macOS, Linux
 
+Python 3.10 remains supported and tested for this release, but it is deprecated
+because upstream Python 3.10 has reached end of life. New environments should
+use Python 3.11 or later. A future Agent Framework release will raise the
+minimum version separately; this release does not remove Python 3.10 from
+package metadata or CI.
+
+### Python 3.15 limitations
+
+`pip install agent-framework` resolves and imports on Python 3.15, but it does
+not provide exactly the same feature set as Python 3.14:
+
+| Area | Python 3.15 impact |
+| --- | --- |
+| Declarative Power Fx | `agent-framework-declarative` is installed, but its `powerfx` dependency is not. YAML values beginning with `=` produce a warning and remain unchanged instead of being evaluated. Declarative agents or workflows that rely on expressions may therefore use invalid literal values or fail later. |
+| Redis | `agent-framework-redis` is omitted from the standard install because RedisVL declares `Requires-Python <3.15`. Redis imports and Redis-backed history, context, and vector storage are unavailable. |
+| Hyperlight | `agent-framework-hyperlight` is omitted because no compatible Python 3.15 sandbox backend wheel is published. Hyperlight CodeAct and its `execute_code` tool are unavailable. |
+| AG-UI A2UI | The base `agent-framework-ag-ui` package works, but pip cannot install its optional `a2ui` extra because `ag-ui-a2ui-toolkit` declares `Requires-Python <3.15`. |
+
 ## 1. Setup API Keys
 
 Set as environment variables, or create a .env file at your project root:
@@ -287,4 +280,3 @@ For more advanced orchestration patterns including Sequential, Concurrent, Group
 - [Learn: Agent Framework Overview](https://learn.microsoft.com/agent-framework/overview/agent-framework-overview)
 - [Learn: Quick Start](https://learn.microsoft.com/agent-framework/tutorials/quick-start)
 - [Learn: Tutorials](https://learn.microsoft.com/agent-framework/get-started/)
-

{agent_framework-1.20.0 → agent_framework-1.22.0}/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "agent-framework"
-description = "Microsoft Agent Framework for building AI Agents with Python. This package contains all the core and optional packages."
+description = "Microsoft Agent Framework for building AI Agents with Python. This package contains core and a curated set of optional integrations."
 authors = [{ name = "Microsoft", email = "af-support@microsoft.com"}]
 readme = "README.md"
 requires-python = ">=3.10"
-version = "1.20.0"
+version = "1.22.0"
 license-files = ["LICENSE"]
 urls.homepage = "https://aka.ms/agent-framework"
 urls.source = "https://github.com/microsoft/agent-framework/tree/main/python"
@@ -20,46 +20,46 @@ classifiers = [
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3.15",
   "Typing :: Typed",
 ]
 dependencies = [
-    "agent-framework-core[all]==1.20.0",
+    "agent-framework-core[all]==1.22.0",
 ]
 
 [dependency-groups]
 dev = [
-    "uv==0.12.22",
-    "flit==4.1.0",
-    "ruff==0.16.10",
+    "uv==0.13.1",
     "pytest==9.1.1",
     "pytest-asyncio==1.4.0",
     "pytest-cov==7.1.0",
     "pytest-xdist[psutil]==3.8.0",
     "pytest-timeout==2.4.0",
     "pytest-retry==1.7.0",
-    "mypy==2.4.0",
-    "pyright==1.1.414",
-    "pyrefly==1.3.2",
-    "ty==0.0.84",
-    "zuban==0.10.0",
-    "opentelemetry-sdk",
-    #tasks
-    "poethepoet==0.48.0",
-    "rich>=13.7.1,<16.0.0",
-    "tomli==2.4.1",
-    "prek==0.5.4",
-    "griffe==2.3.0",
-]
-test = [
     "azure-monitor-opentelemetry>=1.8.10,<2",
     "mcp[ws]",
     # Optional SDK used by the agent-hooks tests and isolated source checks.
     "agent-hooks-sdk>=0.1.0a4,<0.2",
+    "opentelemetry-sdk",
+    # Task runtime used by every supported Python version.
+    "poethepoet==0.48.0",
+]
+tool-runtime = [
+    "packaging==26.3",
+    "rich>=13.7.1,<16.0.0",
+    'tomli==2.5.0; python_version < "3.11"',
+]
+tool-hooks = [
+    "prek==0.5.5",
+]
+tool-markdown = [
+    "pygments==2.21.0",
 ]
 
 [tool.uv]
 package = false
 prerelease = "if-necessary"
+required-version = "==0.13.1"
 # Security floors for transitive dependencies.
 override-dependencies = ["mcp[ws]>=1.27.0,<2", "uvicorn[standard]>=0.34.0", "python-multipart>=0.0.31"]
 environments = [
@@ -105,6 +105,7 @@ agent-framework-mongodb = { workspace = true }
 agent-framework-monty = { workspace = true }
 agent-framework-ollama = { workspace = true }
 agent-framework-openai = { workspace = true }
+agent-framework-oracle = { workspace = true }
 agent-framework-orchestrations = { workspace = true }
 agent-framework-postgres = { workspace = true }
 agent-framework-sql-server = { workspace = true }
@@ -250,13 +251,15 @@ unused-type-ignore-comment = "ignore"
 targets = ["agent_framework"]
 exclude_dirs = ["tests", "scripts", "samples"]
 
-[tool.poe]
-executor.type = "uv"
+[tool.poe.executor]
+type = "uv"
+locked = true
+group = "tool-runtime"
 
 # Workspace setup
 [tool.poe.tasks.install]
 help = "Install all workspace packages, extras, and dependency groups from the lockfile."
-cmd = "uv sync --all-packages --all-extras --all-groups --frozen --prerelease=if-necessary"
+cmd = "uv sync --all-packages --all-extras --all-groups --no-group tool-runtime --no-group tool-hooks --no-group tool-markdown --frozen --prerelease=if-necessary"
 
 [tool.poe.tasks.setup]
 help = "Create the workspace virtual environment for -P/--python, install dependencies, and install prek hooks."
@@ -274,77 +277,52 @@ args = [{ name = "python", default = "3.13", options = ['-P', '-p', '--python']
 
 [tool.poe.tasks.prek-install]
 help = "Install or refresh the prek git hooks."
+executor = { group = "tool-hooks", locked = true }
 cmd = "prek install --overwrite"
 
 # Syntax, typing, and validation
 [tool.poe.tasks.syntax]
 help = "Run Ruff formatting and Ruff checks for -P/--package packages, or use -S/--samples; add -F/--format or -C/--check to narrow the mode."
-cmd = "python scripts/workspace_poe_tasks.py syntax"
-
-[tool.poe.tasks.fmt]
-help = "DEPRECATED: Use `syntax --format` instead."
-cmd = "python scripts/workspace_poe_tasks.py syntax --format"
-
-[tool.poe.tasks.format]
-help = "DEPRECATED: Use `syntax --format` instead."
-cmd = "python scripts/workspace_poe_tasks.py syntax --format"
-
-[tool.poe.tasks.lint]
-help = "DEPRECATED: Use `syntax --check` instead."
-cmd = "python scripts/workspace_poe_tasks.py syntax --check"
-
-[tool.poe.tasks.samples-lint]
-help = "DEPRECATED: Use `syntax --samples --check` instead."
-cmd = "python scripts/workspace_poe_tasks.py syntax --samples --check"
+cmd = "python -m scripts.workspace_poe_tasks syntax"
 
 [tool.poe.tasks.pyright]
 help = "Run Pyright for -P/--package packages, use -A/--all for one aggregate sweep, or use -S/--samples for sample checks."
-cmd = "python scripts/workspace_poe_tasks.py pyright"
+cmd = "python -m scripts.workspace_poe_tasks pyright"
 
 [tool.poe.tasks.mypy]
 help = "Run MyPy over -P/--package test suites (alias for `test-typing --checker mypy`)."
-cmd = "python scripts/workspace_poe_tasks.py mypy"
+cmd = "python -m scripts.workspace_poe_tasks mypy"
 
 [tool.poe.tasks.test-typing]
 help = "Run the tests/samples type checkers (mypy, pyrefly, ty, zuban) for -P/--package, -A/--all, or -S/--samples. Narrow with `--checker NAME` (repeatable)."
-cmd = "python scripts/workspace_poe_tasks.py test-typing"
+cmd = "python -m scripts.workspace_poe_tasks test-typing"
 
 [tool.poe.tasks.typing]
 help = "Run Pyright over source and the tests/samples checkers for -P/--package packages, or use -A/--all."
-cmd = "python scripts/workspace_poe_tasks.py typing"
-
-[tool.poe.tasks.samples-syntax]
-help = "DEPRECATED: Use `pyright --samples` instead."
-cmd = "python scripts/workspace_poe_tasks.py pyright --samples"
+cmd = "python -m scripts.workspace_poe_tasks typing"
 
 [tool.poe.tasks.check-packages]
 help = "Run `syntax` and `pyright` for -P/--package packages."
-cmd = "python scripts/workspace_poe_tasks.py check-packages"
+cmd = "python -m scripts.workspace_poe_tasks check-packages"
 
 [tool.poe.tasks.check]
 help = "Run package syntax, pyright, and tests for -P/--package packages; without -P also include sample checks and markdown code lint, or use -S/--samples for sample-only checks."
-cmd = "python scripts/workspace_poe_tasks.py check"
+executor = { group = ["tool-runtime", "tool-markdown"], locked = true }
+cmd = "python -m scripts.workspace_poe_tasks check"
 
 [tool.poe.tasks.markdown-code-lint]
 help = "Lint Python code blocks embedded in README and sample markdown files."
-cmd = "uv run python scripts/check_md_code_blocks.py 'README.md' './packages/**/README.md' './samples/**/*.md' --exclude cookiecutter-agent-framework-lab --exclude tau2 --exclude 'packages/devui/frontend' --exclude context_providers/azure_ai_search"
+executor = { group = "tool-markdown", locked = true }
+cmd = "python -m scripts.check_md_code_blocks 'README.md' './packages/**/README.md' './samples/**/*.md' --exclude cookiecutter-agent-framework-lab --exclude tau2 --exclude 'packages/devui/frontend' --exclude context_providers/azure_ai_search"
 
 # Testing
 [tool.poe.tasks.test]
 help = "Run tests for -P/--package packages, or use -A/--all for one aggregate sweep; add -C/--cov for coverage."
-cmd = "python scripts/workspace_poe_tasks.py test"
-
-[tool.poe.tasks.all-tests]
-help = "DEPRECATED: Use `test --all` instead."
-cmd = "python scripts/workspace_poe_tasks.py test --all"
-
-[tool.poe.tasks.all-tests-cov]
-help = "DEPRECATED: Use `test --all --cov` instead."
-cmd = "python scripts/workspace_poe_tasks.py test --all --cov"
+cmd = "python -m scripts.workspace_poe_tasks test"
 
 # Build and publishing
 [tool.poe.tasks._clean-dist-packages]
-cmd = "python scripts/workspace_poe_tasks.py clean-dist"
+cmd = "python -m scripts.workspace_poe_tasks clean-dist"
 
 [tool.poe.tasks._clean-dist-meta]
 cmd = "rm -rf dist"
@@ -358,10 +336,10 @@ sequence = [
 args = [{ name = "project", default = "*", options = ["-P", "--package"] }]
 
 [tool.poe.tasks._build-packages]
-cmd = "python scripts/workspace_poe_tasks.py build"
+cmd = "python -m scripts.workspace_poe_tasks build"
 
 [tool.poe.tasks._build-meta]
-cmd = "python -m flit build"
+cmd = "uv build"
 
 [tool.poe.tasks.build]
 help = "Build -P/--package packages and the root meta package."
@@ -377,7 +355,7 @@ cmd = "uv publish"
 
 # Dependency maintenance
 [tool.poe.tasks.upgrade-dev-dependency-pins]
-help = "Repin exact workspace development dependency versions used in pyproject.toml."
+help = "Repin exact workspace development dependencies and on-demand tool requirements."
 cmd = "python -m scripts.dependencies.upgrade_dev_dependencies"
 
 [tool.poe.tasks._upgrade-lockfile]
@@ -431,7 +409,11 @@ args = [
 [tool.poe.tasks.validate-dependency-bounds-project]
 help = "Validate lower and upper dependency bounds for a -P/--package workspace package, optionally narrowed with -M/--mode and -D/--dependency."
 shell = """
-command=(python -m scripts.dependencies.validate_dependency_bounds --mode "${mode}" --package "${project}")
+command=(
+    python -m scripts.dependencies.validate_dependency_bounds
+    --mode "${mode}"
+    --package "${project}"
+)
 if [ -n "${dependency}" ]; then
     command+=(--dependencies "${dependency}")
 fi