agent-framework

Python: DevUI Fix Serialization, Timestamp and Other Issues (#1584 )

* refactor(devui): adopt standard OpenAI lifecycle events for agents and workflows

- Replace custom workflow events with OpenAI Responses API standard lifecycle events
- Add AgentStartedEvent, AgentCompletedEvent, AgentFailedEvent for clean separation
- Implement ExecutorActionItem for workflow executor tracking
- Convert informational events to trace events to reduce noise
- Update README mapper table with comprehensive event mappings
- Maintain full backward compatibility with legacy events

* fix(devui): resolve timestamp overwriting and Content serialization errors

- Fix tool call timestamps being overwritten on each render (#1483)
- Add recursive Content serialization to handle ChatMessage and nested objects (#1548)
- Implement proper MCP tool cleanup on server shutdown
- Add timestamp field to function_result.complete events
- Enhance credential and client resource cleanup

Fixes #1483, #1548
Partial improvements for #1476

Victor Dibia · 2025-10-23 18:19:20 +00:00

6b66a34609

Python: Update lab test trigger (#1632 )

* Update lab test trigger

* fix tests

Eric Zhu · 2025-10-23 18:11:57 +00:00

064ee8afbe

Python: MCP Error Handling Fix + Added Unit Tests (#1621 )

* mcp error fix

* test docstring fixes

Giles Odigwe · 2025-10-23 18:01:10 +00:00

1f19a6da5c

Python: Skip flaky openai vector store file tests (#1667 )

* Add poll interval to fix integration test

* skip flaky tests

Eric Zhu · 2025-10-23 17:31:41 +00:00

905e730dc2

Python: Add Handoff orchestration pattern support (#1469 )

* Add Handoff orchestration pattern support

* PR feedback

* Use AOAI client in samples

* Adjust to tool

* Handoff to sub-agent via ai function

* PR feedback

* More cleanup

* Improvements

* PR feedback cleanup

* Add handoff migration sample.

* Remove type ignore

* fix markdown link formatting

* Remove readme link for non-existent sample

Evan Mattson · 2025-10-22 01:51:51 +00:00

b66619a544

Python: Added Samples for HostedCodeInterpreterTool with files (#1583 )

* code interpreter with files

* import fix

Giles Odigwe · 2025-10-21 01:37:53 +00:00

e8a7d3b1b7

Bump vite from 7.1.5 to 7.1.11 in /python/packages/devui/frontend (#1586 )

Bumps [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite) from 7.1.5 to 7.1.11.
- [Release notes](https://github.com/vitejs/vite/releases)
- [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md)
- [Commits](https://github.com/vitejs/vite/commits/v7.1.11/packages/vite)

---
updated-dependencies:
- dependency-name: vite
  dependency-version: 7.1.11
  dependency-type: direct:development
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Victor Dibia <chuvidi2003@gmail.com>

dependabot[bot] · 2025-10-21 01:17:40 +00:00

acfbc4bc3c

Code clean up: Checkpoint and WorkflowBuilder (#1557 )

Co-authored-by: Evan Mattson <35585003+moonbox3@users.noreply.github.com>

Tao Chen · 2025-10-20 16:34:06 +00:00

083d0de3f3

Python: Updated merge test jobs (#1578 )

* Updated merge test jobs

* Small fix

Dmytro Struk · 2025-10-20 16:22:46 +00:00

9c3f52566f

Python: Remove deprecated add_agent() calls from workflow samples (#1508 )

* Initial plan

* Remove add_agent calls from workflow samples

Co-authored-by: moonbox3 <35585003+moonbox3@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: moonbox3 <35585003+moonbox3@users.noreply.github.com>

Copilot · 2025-10-17 02:25:31 +00:00

151efd2e80

Python: Updated package version (#1528 )

* Updated package version

* Update python/CHANGELOG.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Updated metadata for Purview

* Updated test

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Dmytro Struk · 2025-10-16 22:32:25 +00:00

8c24a72107

Python: Add Purview Middleware (#1142 )

* [Py Purview] Purview Python Initial Commit

* [Py Purview] Purview Python Minor Fixes

* [Py Purview] Purview Python Comment Fixesish

* [Py Purview] Purview Python Agent Middleware Done

* [Py Purview] Purview Python Agent Middleware Done

* [Py Purview] Purview Python Lint Errors

* [Py Purview] Purview Python Final Hopefully

* [Py Purview] Purview Python Final Hopefully

* [Py Purview] Purview Python Fix ReadMe

* [Py Purview] Purview Python Fix MyPy

* [Py Purview] Purview Python Minor Updates on comments

* [Py Purview] Purview Python Fix Build Error

---------

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Rishabh Chawla · 2025-10-16 21:46:04 +00:00

59da578902

Python: Agent Name Sanitization (#1523 )

* a2a agent name sanitization

* fix

* small fix

---------

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Giles Odigwe · 2025-10-16 20:33:25 +00:00

76ae0a62ac

Small fix in OpenAI Responses client (#1509 )

Dmytro Struk · 2025-10-16 14:27:39 +00:00

3b9193c15e

Python: Added MCP headers for AzureAI (#1506 )

* add mcp headers

* small fix

Giles Odigwe · 2025-10-16 05:42:45 +00:00

db7f767180

Python: Add Function Approval UI to DevUI (#1401 )

* ensure function aproval is parsed correctly

* udpate ui, add deployment guide button, other debug panel fixes

* feat(devui): Implement lazy loading architecture with enhanced security and state management

Major architectural improvements to DevUI for better performance, security, and developer experience:

Performance & Architecture:
- Implement lazy loading for entity discovery - entities loaded on-demand instead of at startup
- Add hot reload capability for development workflow via new reload endpoint
- Reduce startup time and memory footprint by deferring module imports

Security Enhancements:
- Remove remote entity loading capabilities (POST /v1/entities/add, DELETE endpoints)
- DevUI now strictly local development tool - no remote code execution
- Add explicit security documentation and best practices in README

Frontend Improvements:
- Migrate to Zustand for centralized state management (replacing prop drilling)
- Add lightweight zero-dependency markdown renderer with code block copy support
- Improve gallery UX with setup instructions modal instead of direct URL loading
- Enhanced message UI with copy functionality and better token usage display

Testing & Quality:
- Expand test coverage for lazy loading, type detection, and cache invalidation
- Add comprehensive tests for new behaviors (+231 lines of test code)
- Improve type safety and documentation throughout

Breaking Changes:
- Remote entity loading via URLs is no longer supported
- Entities must be loaded from local filesystem only

* update ui issues, uupdate test descripion

Victor Dibia · 2025-10-15 21:36:29 +00:00

b64358df7e

Python: Added instructions for GitHub Copilot (#1468 )

* Python instructions for GitHub Copilot

* Changed file location

* Revert "Changed file location"

This reverts commit 54a4723f8a.

Dmytro Struk · 2025-10-15 17:40:49 +00:00

a4ba6eed57

Python: Post-Fix GH008 - Re-Upload missing favicons via LFS (#1490 )

* Stop tracking favicons via LFS and store as regular files

* Cleanup fav icons

Roger Barreto · 2025-10-15 16:35:50 +00:00

49455ad1b9

Temp: re-upload missing favicons via LFS (#1479 )

Roger Barreto · 2025-10-15 15:34:36 +00:00

f593bb535a

Python: Enhanced documentation for dependency injection and serialization features (#1324 )

* improvements in dep injection and sample

* fix for falsy default

* fix mypy

* update to use a nested dict instead of a string.

* clarify docs

* Update python/packages/core/agent_framework/_tools.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/packages/core/agent_framework/_tools.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/packages/core/agent_framework/_tools.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/packages/core/agent_framework/_serialization.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* format

---------

Co-authored-by: eavanvalkenburg <github@vanvalkenburg.eu>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Eric Zhu · 2025-10-13 20:34:27 +00:00

9148392d00

Python: Refactor RequestInfoExecutor (#1403 )

* Refactor RequestInfoExecutor

* Update AI script

* Fix formatting

* Address comments

* fix unit test

Tao Chen · 2025-10-13 19:18:17 +00:00

fc12ab9fed

Python: Added URL Citation Support to Azure AI Agent (#1397 )

* added url citation to agentrunresponse

* small fix

* fix

* Update python/packages/azure-ai/agent_framework_azure_ai/_chat_client.py

Co-authored-by: Tao Chen <taochen@microsoft.com>

---------

Co-authored-by: Tao Chen <taochen@microsoft.com>

Giles Odigwe · 2025-10-13 19:04:08 +00:00

baf59ca1ed

Update uv requirement from <0.9.0,>=0.8.2 to >=0.8.2,<0.10.0 in /python (#1430 )

Updates the requirements on [uv](https://github.com/astral-sh/uv) to permit the latest version.
- [Release notes](https://github.com/astral-sh/uv/releases)
- [Changelog](https://github.com/astral-sh/uv/blob/main/CHANGELOG.md)
- [Commits](https://github.com/astral-sh/uv/compare/0.8.2...0.9.2)

---
updated-dependencies:
- dependency-name: uv
  dependency-version: 0.9.2
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

dependabot[bot] · 2025-10-13 18:26:26 +00:00

166aa8fd54

Python: Update README to list all available examples (#1394 )

* Initial plan

* Update Python samples README with comprehensive example tables

Co-authored-by: dmytrostruk <13853051+dmytrostruk@users.noreply.github.com>

* Fix relative links to use ./ prefix in README

Co-authored-by: dmytrostruk <13853051+dmytrostruk@users.noreply.github.com>

* Remove ./ prefix from link display text while keeping it in URLs

Co-authored-by: dmytrostruk <13853051+dmytrostruk@users.noreply.github.com>

* Add missing MCP authentication example to README

Co-authored-by: dmytrostruk <13853051+dmytrostruk@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: dmytrostruk <13853051+dmytrostruk@users.noreply.github.com>

Copilot · 2025-10-13 17:17:03 +00:00

d1ac2d9331

Added example with MCP and authentication (#1389 )

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

Dmytro Struk · 2025-10-10 19:10:24 +00:00

29cb87b805

Python: Fix AI Search Tool Sample and improve AI Search Exceptions (#1206 )

* Python: Fix AI Search Tool Sample and improve AI Search Exceptions

* Python: Fix AI Search Tool Test

---------

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Hassan Warsi · 2025-10-10 18:46:57 +00:00

350cdfc1cd

Python: Fix Failure with Function Approval Messages in Chat Clients (#1322 )

* Python: set role=tool when processing approval responses

* Python: set role=tool when processing approval responses

* Fix approval mode with OpenAIChatClient and threads: add approval requests to assistant message, fix deduplication/rejection call_id, filter approval content, add tests and example

* update test tools after change

* Rename _collect_approval_todos to _collect_approval_responses and filter empty call_ids

Victor Dibia · 2025-10-10 18:38:23 +00:00

e032fe3993

Python: AzureAI Bing Connection Name Support (#1364 )

* bing connection name support

* error handling + unit tests

* connection id and name handling

Giles Odigwe · 2025-10-09 21:13:07 +00:00

7238cde5af

Python: A2A AuthInterceptor Support (#1317 )

* a2a authinterceptor support

* Update python/packages/a2a/agent_framework_a2a/_agent.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* small fix

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Giles Odigwe · 2025-10-09 18:56:54 +00:00

2f53ce4abd

Python: Added function approval example with streaming (#1365 )

* Added function approval example with streaming

* Update python/samples/getting_started/tools/ai_tool_with_approval.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Dmytro Struk · 2025-10-09 17:31:36 +00:00

9fe4a61dd0

Python: Fixed instructions duplication in model clients (#1332 )

* Small fix

* Updated instruction handling in chat clients

Dmytro Struk · 2025-10-09 14:49:03 +00:00

a02b82f022

Python: Fix deadlock in Magentic workflow (#1325 )

* Fix deadlock in Magentic workflow

* Fix unit test

Tao Chen · 2025-10-09 00:23:46 +00:00

2397795c1d

Python: samples: add api_key for Ollama sample usage (#1240 )

* samples: add api_key for Ollama sample usage

* Update python/samples/getting_started/agents/ollama/ollama_with_openai_chat_client.py

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

* fix: update Ollama API key to an unused constant

---------

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Mars Wang · 2025-10-08 20:45:24 +00:00

3d31a4a204

Python: Included existing agent definition in requests to Azure AI (#1285 )

* Fixed instructions handling for existing Azure AI agents

* Updated tool handling for existing agents

* Small update

* Added more comments

Dmytro Struk · 2025-10-08 20:33:57 +00:00

7e891fab39

Python: DevUI - Internal Refactor, Conversations API support, and per… (#1235 )

* Python: DevUI - Internal Refactor, Conversations API support, and performance improvements

Comprehensive refactor of DevUI package including samples relocation,
frontend reorganization, OpenAI Conversations API support, and critical
performance and code quality improvements.

Key Changes:

Architecture & Organization
- Moved DevUI samples to python/samples/getting_started/devui/
- Consolidated with other framework samples for better discoverability
- Added .env.example files and comprehensive README
- Restructured frontend components into feature-based folders (agent, workflow, gallery, layout)
- Created new OpenAI-compliant message renderers (devui should render oai responses types primarily)

New Features
- Added _conversations.py (467 lines) - Full conversation storage abstraction, replaces the /threads endpoint to better match oai conversations api
- Implements OpenAI Conversations API for thread management, Supports in-memory and extensible storage backends

API Simplification
- Use 'model' field as entity_id (agent/workflow name) instead of extra_body
- Use standard OpenAI 'conversation' field for conversation context.

Performance & Quality Improvements
- Improved context management in MessageMapper with bounded memory (~500KB max)
- Implemented hybrid LRU + cleanup approach to prevent unbounded memory growth
- General QOL improvement - Eliminated ~150 lines of dead/duplicate code, Consolidated helper functions into _utils.py, Extracted magic numbers to module-level constants, Optimized conversation item lookups with index-based approach

Testing
- Added test_conversations.py (13 tests)
- Added test_performance_fixes.py (9 tests)
- Updated existing tests for code consolidation
- 53 tests passing

Impact: 76 files changed: +4,106 insertions, -2,373 deletions
All linting and formatting checks passing. No breaking changes - backward compatible.

Migration: Samples moved to python/samples/getting_started/devui/

* readme lint fixes

* initial support for function approval and minor ui fixes

Victor Dibia · 2025-10-08 19:34:30 +00:00

c341ee7ed2

Python: sample with Foundry Redteams (#1306 )

* sample with evals

* remove demo output

Eduard van Valkenburg · 2025-10-08 19:16:44 +00:00

f5abbc67ae

Python: improved thread serialization and deser with better tests (#1316 )

* improved thread serialization and deser with better tests

* update redis with the same

Eduard van Valkenburg · 2025-10-08 19:04:11 +00:00

a36e183600

Python: Reorganize workflows modules (#1282 )

* Reorganize modules

* Fix unit tests

* Remove submodules

Tao Chen · 2025-10-08 17:04:06 +00:00

c2c8ec3d4e

Python: fix tool call content not showing up in workflow events (#1290 )

* fix tool call content not showing up in workflow events

* fix lint

* touch up

* add another sample to show function bridge

* missing sample

Eric Zhu · 2025-10-08 16:39:08 +00:00

1c5e607a1f

Python: AzureAI Agent AI Search Sample (#1281 )

* azure ai search sample

* small fix

Giles Odigwe · 2025-10-08 15:52:02 +00:00

334d52f300

Python: bump version and update changelog (#1277 )

* bump version and update changelog

* undo lab package version bump

* add changelog to exclude pattern for links

* fix for ignore path

* exclude file

Eduard van Valkenburg · 2025-10-07 21:41:59 +00:00

8b73b5b1be

Python: [BREAKING] parameter naming and other fixes (#1255 )

* parameter naming and other fixes

* fix test

* fix azure openai responses decorator ordering

* fix test

* fix mypy

* fixes in options handling

* fix tests

* final fixes

* exclude macos tests

* fix model param

Eduard van Valkenburg · 2025-10-07 21:18:48 +00:00

76900f0eab

Python: Add CHANGELOG.md to python folder with all merged PRs since first release (#1205 )

* Initial plan

* Add CHANGELOG.md to python folder with all merged PRs since 1.0.0b251001

Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>

* Update python/CHANGELOG.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/CHANGELOG.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fixed headers in changelog

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>
Co-authored-by: Eduard van Valkenburg <eavanvalkenburg@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: eavanvalkenburg <github@vanvalkenburg.eu>

Copilot · 2025-10-07 18:34:10 +00:00

93577f76b1

Python: Added method to expose agent as MCP server (#1248 )

* Added method to expose agent as MCP server

* Update python/packages/core/agent_framework/_agents.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update python/packages/core/agent_framework/_agents.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Addressed PR feedback

* Updated doc string

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Dmytro Struk · 2025-10-07 17:21:53 +00:00

a45e2ab28e

Python: Add PDF file support to OpenAI content parser with filename mapping (#1121 )

* Add mapping for application media type in OpenAI responses client

* Enhance multimodal input samples: Add PDF testing functionality and fix image sample

* Standardize filename handling and add multimodal samples

- Standardized filename extraction logic between chat and responses clients
- Both clients now omit filename when not provided (no default fallback)
- Added Azure Responses API multimodal sample with PDF support
- Cleaned up Azure Chat sample to focus on supported features only
- Fixed test comment placement for better code documentation
- Updated README with clear API capability differences

* Enhance multimodal input samples with image and PDF handling

- Refactor image and PDF handling in `azure_chat_multimodal.py` and `openai_chat_multimodal.py` to use new utility functions.
- Add `load_sample_pdf` and `create_sample_image` functions for better test asset management.
- Remove redundant code for creating sample images and PDFs.
- Introduce a sample PDF file in `sample_assets` for testing purposes.

* Fix formatting in OpenAI chat client

---------

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Christian Glessner · 2025-10-07 17:04:33 +00:00

8bb1266020

Python: ollama + azureai openapi samples fix (#1244 )

* ollama + azureai openapi samples fix

* small fix

Giles Odigwe · 2025-10-07 16:14:34 +00:00

1d27b57672

Python: Introduce add_agent functionality and added output_response to AgentExecutor; agent streaming behavior to follow workflow invocation (#1184 )

* refactor AgentExecutor, add output_response flag for switching on or off workflow output for each agent.

* introduce add_agent

* make default agent's streaming to false

* address comments

* fix test

* add is_streaming to RunnerContext and WorkflowContext

* fix add_agent return

* fix tests

* address comments

* resolve conflict

* update to address comments

* fix

Eric Zhu · 2025-10-07 16:11:40 +00:00

d01d9afb92

Python: Sample on integration of Azure OpenAI Responses Client with a local MCP server (#1215 )

* added a sample on integration of Azure OpenAI Responses Client with hosted Model Context Protocol (MCP)

* added additional comments mentioning that the Microsoft Learn MCP server can be replaced by any other desired MCP server

* corrected the MCP server type to local

* added a newline at the end

* Update python/samples/getting_started/agents/azure_openai/azure_responses_client_with_local_mcp.py

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

---------

Co-authored-by: Dmytro Struk <13853051+dmytrostruk@users.noreply.github.com>

Saurabh Vartak · 2025-10-07 07:54:29 +00:00

49f25358d7

Python: added approval_mode and allowed_tools to local MCP (#1203 )

* added approval_mode and allowed_tools to local MCP

* updated docs

Eduard van Valkenburg · 2025-10-07 07:44:08 +00:00

b49395fa3d

docs: update dev.md to fix "Get the Code" section (#1217 )

Co-authored-by: Eric Zhu <ekzhu@users.noreply.github.com>

Kim · 2025-10-06 19:53:34 +00:00

66009c617d

252 Commits