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.
- agent_framework-1.21.0/README.md → agent_framework-1.22.0/PKG-INFO +46 -1
- agent_framework-1.21.0/PKG-INFO → agent_framework-1.22.0/README.md +19 -27
- {agent_framework-1.21.0 → agent_framework-1.22.0}/pyproject.toml +45 -64
- {agent_framework-1.21.0 → agent_framework-1.22.0}/LICENSE +0 -0
- {agent_framework-1.21.0 → agent_framework-1.22.0}/agent_framework_meta/__init__.py +0 -0
|
@@ -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
|
|
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.
|
|
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.
|
|
27
|
+
"agent-framework-core[all]==1.22.0",
|
|
27
28
|
]
|
|
28
29
|
|
|
29
30
|
[dependency-groups]
|
|
30
31
|
dev = [
|
|
31
|
-
"uv==0.
|
|
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
|
-
"
|
|
41
|
-
"
|
|
42
|
-
|
|
43
|
-
"
|
|
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
|
-
#
|
|
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
|
-
|
|
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
|
-
|
|
54
|
-
"
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
339
|
+
cmd = "python -m scripts.workspace_poe_tasks build"
|
|
363
340
|
|
|
364
341
|
[tool.poe.tasks._build-meta]
|
|
365
|
-
cmd = "
|
|
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
|
|
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=(
|
|
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
|
|
File without changes
|
|
File without changes
|