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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,29 @@
1
+ Metadata-Version: 2.5
2
+ Name: agent-framework
3
+ Version: 1.22.0
4
+ Summary: Microsoft Agent Framework for building AI Agents with Python. This package contains core and a curated set of optional integrations.
5
+ Author-email: Microsoft <af-support@microsoft.com>
6
+ Requires-Python: >=3.10
7
+ Description-Content-Type: text/markdown
8
+ Classifier: License :: OSI Approved :: MIT License
9
+ Classifier: Development Status :: 5 - Production/Stable
10
+ Classifier: Intended Audience :: Developers
11
+ Classifier: Programming Language :: Python :: 3
12
+ Classifier: Programming Language :: Python :: 3.10
13
+ Classifier: Programming Language :: Python :: 3.11
14
+ Classifier: Programming Language :: Python :: 3.12
15
+ Classifier: Programming Language :: Python :: 3.13
16
+ Classifier: Programming Language :: Python :: 3.14
17
+ Classifier: Programming Language :: Python :: 3.15
18
+ Classifier: Typing :: Typed
19
+ License-File: LICENSE
20
+ Requires-Dist: agent-framework-core[all]==1.22.0
21
+ Project-URL: homepage, https://aka.ms/agent-framework
22
+ Project-URL: issues, https://github.com/microsoft/agent-framework/issues
23
+ Project-URL: release_notes, https://github.com/microsoft/agent-framework/releases?q=tag%3Apython-1&expanded=true
24
+ Project-URL: source, https://github.com/microsoft/agent-framework/tree/main/python
25
+ Import-Name: agent_framework_meta
26
+
1
27
  # Get Started with Microsoft Agent Framework for Python Developers
2
28
 
3
29
  ## Quick Install
@@ -39,9 +65,27 @@ This selective approach is useful when you know which integrations you need, and
39
65
 
40
66
  Supported Platforms:
41
67
 
42
- - Python: 3.10+
68
+ - Python: 3.10–3.15
43
69
  - OS: Windows, macOS, Linux
44
70
 
71
+ Python 3.10 remains supported and tested for this release, but it is deprecated
72
+ because upstream Python 3.10 has reached end of life. New environments should
73
+ use Python 3.11 or later. A future Agent Framework release will raise the
74
+ minimum version separately; this release does not remove Python 3.10 from
75
+ package metadata or CI.
76
+
77
+ ### Python 3.15 limitations
78
+
79
+ `pip install agent-framework` resolves and imports on Python 3.15, but it does
80
+ not provide exactly the same feature set as Python 3.14:
81
+
82
+ | Area | Python 3.15 impact |
83
+ | --- | --- |
84
+ | 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. |
85
+ | 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. |
86
+ | 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. |
87
+ | 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`. |
88
+
45
89
  ## 1. Setup API Keys
46
90
 
47
91
  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
262
306
  - [Learn: Agent Framework Overview](https://learn.microsoft.com/agent-framework/overview/agent-framework-overview)
263
307
  - [Learn: Quick Start](https://learn.microsoft.com/agent-framework/tutorials/quick-start)
264
308
  - [Learn: Tutorials](https://learn.microsoft.com/agent-framework/get-started/)
309
+
@@ -1,28 +1,3 @@
1
- Metadata-Version: 2.5
2
- Name: agent-framework
3
- Version: 1.21.0
4
- Summary: Microsoft Agent Framework for building AI Agents with Python. This package contains all the core and optional packages.
5
- Author-email: Microsoft <af-support@microsoft.com>
6
- Requires-Python: >=3.10
7
- Description-Content-Type: text/markdown
8
- Classifier: License :: OSI Approved :: MIT License
9
- Classifier: Development Status :: 5 - Production/Stable
10
- Classifier: Intended Audience :: Developers
11
- Classifier: Programming Language :: Python :: 3
12
- Classifier: Programming Language :: Python :: 3.10
13
- Classifier: Programming Language :: Python :: 3.11
14
- Classifier: Programming Language :: Python :: 3.12
15
- Classifier: Programming Language :: Python :: 3.13
16
- Classifier: Programming Language :: Python :: 3.14
17
- Classifier: Typing :: Typed
18
- License-File: LICENSE
19
- Requires-Dist: agent-framework-core[all]==1.21.0
20
- Project-URL: homepage, https://aka.ms/agent-framework
21
- Project-URL: issues, https://github.com/microsoft/agent-framework/issues
22
- Project-URL: release_notes, https://github.com/microsoft/agent-framework/releases?q=tag%3Apython-1&expanded=true
23
- Project-URL: source, https://github.com/microsoft/agent-framework/tree/main/python
24
- Import-Name: agent_framework_meta
25
-
26
1
  # Get Started with Microsoft Agent Framework for Python Developers
27
2
 
28
3
  ## Quick Install
@@ -64,9 +39,27 @@ This selective approach is useful when you know which integrations you need, and
64
39
 
65
40
  Supported Platforms:
66
41
 
67
- - Python: 3.10+
42
+ - Python: 3.10–3.15
68
43
  - OS: Windows, macOS, Linux
69
44
 
45
+ Python 3.10 remains supported and tested for this release, but it is deprecated
46
+ because upstream Python 3.10 has reached end of life. New environments should
47
+ use Python 3.11 or later. A future Agent Framework release will raise the
48
+ minimum version separately; this release does not remove Python 3.10 from
49
+ package metadata or CI.
50
+
51
+ ### Python 3.15 limitations
52
+
53
+ `pip install agent-framework` resolves and imports on Python 3.15, but it does
54
+ not provide exactly the same feature set as Python 3.14:
55
+
56
+ | Area | Python 3.15 impact |
57
+ | --- | --- |
58
+ | 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. |
59
+ | 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. |
60
+ | 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. |
61
+ | 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`. |
62
+
70
63
  ## 1. Setup API Keys
71
64
 
72
65
  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
287
280
  - [Learn: Agent Framework Overview](https://learn.microsoft.com/agent-framework/overview/agent-framework-overview)
288
281
  - [Learn: Quick Start](https://learn.microsoft.com/agent-framework/tutorials/quick-start)
289
282
  - [Learn: Tutorials](https://learn.microsoft.com/agent-framework/get-started/)
290
-
@@ -1,10 +1,10 @@
1
1
  [project]
2
2
  name = "agent-framework"
3
- description = "Microsoft Agent Framework for building AI Agents with Python. This package contains all the core and optional packages."
3
+ description = "Microsoft Agent Framework for building AI Agents with Python. This package contains core and a curated set of optional integrations."
4
4
  authors = [{ name = "Microsoft", email = "af-support@microsoft.com"}]
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.10"
7
- version = "1.21.0"
7
+ version = "1.22.0"
8
8
  license-files = ["LICENSE"]
9
9
  urls.homepage = "https://aka.ms/agent-framework"
10
10
  urls.source = "https://github.com/microsoft/agent-framework/tree/main/python"
@@ -20,46 +20,46 @@ classifiers = [
20
20
  "Programming Language :: Python :: 3.12",
21
21
  "Programming Language :: Python :: 3.13",
22
22
  "Programming Language :: Python :: 3.14",
23
+ "Programming Language :: Python :: 3.15",
23
24
  "Typing :: Typed",
24
25
  ]
25
26
  dependencies = [
26
- "agent-framework-core[all]==1.21.0",
27
+ "agent-framework-core[all]==1.22.0",
27
28
  ]
28
29
 
29
30
  [dependency-groups]
30
31
  dev = [
31
- "uv==0.12.23",
32
- "flit==4.1.0",
33
- "ruff==0.16.10",
32
+ "uv==0.13.1",
34
33
  "pytest==9.1.1",
35
34
  "pytest-asyncio==1.4.0",
36
35
  "pytest-cov==7.1.0",
37
36
  "pytest-xdist[psutil]==3.8.0",
38
37
  "pytest-timeout==2.4.0",
39
38
  "pytest-retry==1.7.0",
40
- "mypy==2.4.0",
41
- "pyright==1.1.414",
42
- "pyrefly==1.3.2",
43
- "ty==0.0.85",
44
- "zuban==0.10.0",
39
+ "azure-monitor-opentelemetry>=1.8.10,<2",
40
+ "mcp[ws]",
41
+ # Optional SDK used by the agent-hooks tests and isolated source checks.
42
+ "agent-hooks-sdk>=0.1.0a4,<0.2",
45
43
  "opentelemetry-sdk",
46
- #tasks
44
+ # Task runtime used by every supported Python version.
47
45
  "poethepoet==0.48.0",
46
+ ]
47
+ tool-runtime = [
48
+ "packaging==26.3",
48
49
  "rich>=13.7.1,<16.0.0",
49
- "tomli==2.5.0",
50
+ 'tomli==2.5.0; python_version < "3.11"',
51
+ ]
52
+ tool-hooks = [
50
53
  "prek==0.5.5",
51
- "griffe==2.3.0",
52
54
  ]
53
- test = [
54
- "azure-monitor-opentelemetry>=1.8.10,<2",
55
- "mcp[ws]",
56
- # Optional SDK used by the agent-hooks tests and isolated source checks.
57
- "agent-hooks-sdk>=0.1.0a4,<0.2",
55
+ tool-markdown = [
56
+ "pygments==2.21.0",
58
57
  ]
59
58
 
60
59
  [tool.uv]
61
60
  package = false
62
61
  prerelease = "if-necessary"
62
+ required-version = "==0.13.1"
63
63
  # Security floors for transitive dependencies.
64
64
  override-dependencies = ["mcp[ws]>=1.27.0,<2", "uvicorn[standard]>=0.34.0", "python-multipart>=0.0.31"]
65
65
  environments = [
@@ -251,13 +251,15 @@ unused-type-ignore-comment = "ignore"
251
251
  targets = ["agent_framework"]
252
252
  exclude_dirs = ["tests", "scripts", "samples"]
253
253
 
254
- [tool.poe]
255
- executor.type = "uv"
254
+ [tool.poe.executor]
255
+ type = "uv"
256
+ locked = true
257
+ group = "tool-runtime"
256
258
 
257
259
  # Workspace setup
258
260
  [tool.poe.tasks.install]
259
261
  help = "Install all workspace packages, extras, and dependency groups from the lockfile."
260
- cmd = "uv sync --all-packages --all-extras --all-groups --frozen --prerelease=if-necessary"
262
+ 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"
261
263
 
262
264
  [tool.poe.tasks.setup]
263
265
  help = "Create the workspace virtual environment for -P/--python, install dependencies, and install prek hooks."
@@ -275,77 +277,52 @@ args = [{ name = "python", default = "3.13", options = ['-P', '-p', '--python']
275
277
 
276
278
  [tool.poe.tasks.prek-install]
277
279
  help = "Install or refresh the prek git hooks."
280
+ executor = { group = "tool-hooks", locked = true }
278
281
  cmd = "prek install --overwrite"
279
282
 
280
283
  # Syntax, typing, and validation
281
284
  [tool.poe.tasks.syntax]
282
285
  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."
283
- cmd = "python scripts/workspace_poe_tasks.py syntax"
284
-
285
- [tool.poe.tasks.fmt]
286
- help = "DEPRECATED: Use `syntax --format` instead."
287
- cmd = "python scripts/workspace_poe_tasks.py syntax --format"
288
-
289
- [tool.poe.tasks.format]
290
- help = "DEPRECATED: Use `syntax --format` instead."
291
- cmd = "python scripts/workspace_poe_tasks.py syntax --format"
292
-
293
- [tool.poe.tasks.lint]
294
- help = "DEPRECATED: Use `syntax --check` instead."
295
- cmd = "python scripts/workspace_poe_tasks.py syntax --check"
296
-
297
- [tool.poe.tasks.samples-lint]
298
- help = "DEPRECATED: Use `syntax --samples --check` instead."
299
- cmd = "python scripts/workspace_poe_tasks.py syntax --samples --check"
286
+ cmd = "python -m scripts.workspace_poe_tasks syntax"
300
287
 
301
288
  [tool.poe.tasks.pyright]
302
289
  help = "Run Pyright for -P/--package packages, use -A/--all for one aggregate sweep, or use -S/--samples for sample checks."
303
- cmd = "python scripts/workspace_poe_tasks.py pyright"
290
+ cmd = "python -m scripts.workspace_poe_tasks pyright"
304
291
 
305
292
  [tool.poe.tasks.mypy]
306
293
  help = "Run MyPy over -P/--package test suites (alias for `test-typing --checker mypy`)."
307
- cmd = "python scripts/workspace_poe_tasks.py mypy"
294
+ cmd = "python -m scripts.workspace_poe_tasks mypy"
308
295
 
309
296
  [tool.poe.tasks.test-typing]
310
297
  help = "Run the tests/samples type checkers (mypy, pyrefly, ty, zuban) for -P/--package, -A/--all, or -S/--samples. Narrow with `--checker NAME` (repeatable)."
311
- cmd = "python scripts/workspace_poe_tasks.py test-typing"
298
+ cmd = "python -m scripts.workspace_poe_tasks test-typing"
312
299
 
313
300
  [tool.poe.tasks.typing]
314
301
  help = "Run Pyright over source and the tests/samples checkers for -P/--package packages, or use -A/--all."
315
- cmd = "python scripts/workspace_poe_tasks.py typing"
316
-
317
- [tool.poe.tasks.samples-syntax]
318
- help = "DEPRECATED: Use `pyright --samples` instead."
319
- cmd = "python scripts/workspace_poe_tasks.py pyright --samples"
302
+ cmd = "python -m scripts.workspace_poe_tasks typing"
320
303
 
321
304
  [tool.poe.tasks.check-packages]
322
305
  help = "Run `syntax` and `pyright` for -P/--package packages."
323
- cmd = "python scripts/workspace_poe_tasks.py check-packages"
306
+ cmd = "python -m scripts.workspace_poe_tasks check-packages"
324
307
 
325
308
  [tool.poe.tasks.check]
326
309
  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."
327
- cmd = "python scripts/workspace_poe_tasks.py check"
310
+ executor = { group = ["tool-runtime", "tool-markdown"], locked = true }
311
+ cmd = "python -m scripts.workspace_poe_tasks check"
328
312
 
329
313
  [tool.poe.tasks.markdown-code-lint]
330
314
  help = "Lint Python code blocks embedded in README and sample markdown files."
331
- 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"
315
+ executor = { group = "tool-markdown", locked = true }
316
+ 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"
332
317
 
333
318
  # Testing
334
319
  [tool.poe.tasks.test]
335
320
  help = "Run tests for -P/--package packages, or use -A/--all for one aggregate sweep; add -C/--cov for coverage."
336
- cmd = "python scripts/workspace_poe_tasks.py test"
337
-
338
- [tool.poe.tasks.all-tests]
339
- help = "DEPRECATED: Use `test --all` instead."
340
- cmd = "python scripts/workspace_poe_tasks.py test --all"
341
-
342
- [tool.poe.tasks.all-tests-cov]
343
- help = "DEPRECATED: Use `test --all --cov` instead."
344
- cmd = "python scripts/workspace_poe_tasks.py test --all --cov"
321
+ cmd = "python -m scripts.workspace_poe_tasks test"
345
322
 
346
323
  # Build and publishing
347
324
  [tool.poe.tasks._clean-dist-packages]
348
- cmd = "python scripts/workspace_poe_tasks.py clean-dist"
325
+ cmd = "python -m scripts.workspace_poe_tasks clean-dist"
349
326
 
350
327
  [tool.poe.tasks._clean-dist-meta]
351
328
  cmd = "rm -rf dist"
@@ -359,10 +336,10 @@ sequence = [
359
336
  args = [{ name = "project", default = "*", options = ["-P", "--package"] }]
360
337
 
361
338
  [tool.poe.tasks._build-packages]
362
- cmd = "python scripts/workspace_poe_tasks.py build"
339
+ cmd = "python -m scripts.workspace_poe_tasks build"
363
340
 
364
341
  [tool.poe.tasks._build-meta]
365
- cmd = "python -m flit build"
342
+ cmd = "uv build"
366
343
 
367
344
  [tool.poe.tasks.build]
368
345
  help = "Build -P/--package packages and the root meta package."
@@ -378,7 +355,7 @@ cmd = "uv publish"
378
355
 
379
356
  # Dependency maintenance
380
357
  [tool.poe.tasks.upgrade-dev-dependency-pins]
381
- help = "Repin exact workspace development dependency versions used in pyproject.toml."
358
+ help = "Repin exact workspace development dependencies and on-demand tool requirements."
382
359
  cmd = "python -m scripts.dependencies.upgrade_dev_dependencies"
383
360
 
384
361
  [tool.poe.tasks._upgrade-lockfile]
@@ -432,7 +409,11 @@ args = [
432
409
  [tool.poe.tasks.validate-dependency-bounds-project]
433
410
  help = "Validate lower and upper dependency bounds for a -P/--package workspace package, optionally narrowed with -M/--mode and -D/--dependency."
434
411
  shell = """
435
- command=(python -m scripts.dependencies.validate_dependency_bounds --mode "${mode}" --package "${project}")
412
+ command=(
413
+ python -m scripts.dependencies.validate_dependency_bounds
414
+ --mode "${mode}"
415
+ --package "${project}"
416
+ )
436
417
  if [ -n "${dependency}" ]; then
437
418
  command+=(--dependencies "${dependency}")
438
419
  fi