agent-framework

Python: AG-UI protocol support (#1826 )

* Add AG-UI integration

* Fix tests. PR feedback

* Cleanup

* PR Feedback

* Improve README and getting started experience

* Fix links

Evan Mattson · 2025-11-05 05:25:24 +00:00

35a8565495

Python: feat: Add ChatKit integration with a sample application (#1273 )

* feat: Add ChatKit integration with a new frontend application

- Created a new frontend application using React and Vite for the ChatKit integration.
- Added essential files including package.json, vite.config.ts, and Tailwind CSS configuration.
- Implemented core components: App, Home, ChatKitPanel, ThemeToggle, and hooks for color scheme management.
- Established SQLite-based store implementation for ChatKit data persistence in store.py.
- Integrated theme toggling functionality for light and dark modes.
- Set up ESLint and TypeScript configurations for better development experience.

* git ignore

* fix mypy

* add mising file

* minimal frontend for chatkit sample

* update ignore files

* version

* set python version lowerbound on chatkit

* update project settings for chatkit

* update setup

* update setup

* update setup

* update setup

* weather widget

* add select city widget sample

* remove widget helper

* update chatkit to include file attachments and cover more thread item types

* update readme with mermaid diagram

* update diagram

* update instructions

* update chatkit dependency

* fix converter imports

* move to demos/

* move to demos/ -- rename references

* support multiple session instead of using global variable in sample

* support chunk streaming

* fix tests

* Update python/samples/demos/chatkit-integration/store.py

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

* use local host

---------

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

Eric Zhu · 2025-11-05 02:11:40 +00:00

0c862e97a6

Fix mcp tool cloning for handoff pattern (#1883 )

Evan Mattson · 2025-11-04 22:49:34 +00:00

d5040236c9

Python: .NET: Updated package version and small fix (#1911 )

* Removed public key

* Updated package version

* Updated Python package versions

Dmytro Struk · 2025-11-04 22:42:07 +00:00

9e1b3c9b85

Python: [BREAKING] consolidate workflow run APIs (#1723 )

* consolidate workflow run apis

* improve validation, add tests

* Proper code tags for docs

* Update sample output

* Remove cycle validation

* PR feedback

* Validation

* Cleanup

Evan Mattson · 2025-11-03 23:34:59 +00:00

50d9b13bfc

Python: Introducing the Anthropic Client (#1819 )

* initial version of anthropic connector

* updated implementation and added tests

* fix type and readme

* mypy fix and int tests enabled

* add integration test setup

* updated based on comments

* improved function result handling

* added extra unordered test

* updated from review

* fix tool choice handling

* same fix for chat client

Eduard van Valkenburg · 2025-11-03 19:32:28 +00:00

12d17acdc0

a2a workflows fix (#1860 )

Giles Odigwe · 2025-11-03 18:47:09 +00:00

a766a81243

Python: fix middleware and cleanup confusing function (#1865 )

* fix middleware and cleanup redundant function

* added test to validate

Eduard van Valkenburg · 2025-11-03 18:42:59 +00:00

e462d209fd

Python: Azure AI top_p and temperature parameters fix (#1839 )

* azure ai parameters fix

* added unit tests

* unit test fix

* fix

Giles Odigwe · 2025-10-31 20:46:38 +00:00

a9a1b1e567

Python: Ensure agent thread is part of checkpoint (#1756 )

* ensure agent thread is part of checkpoint

* Update python/packages/core/agent_framework/_workflows/_agent_executor.py

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

* remove data copying for server side thread.

* refine warning check

---------

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

Eric Zhu · 2025-10-31 15:48:43 +00:00

889f45a7ef

[BREAKING] Python: Remove request_type param from ctx.request_info() (#1824 )

* Remove request_type param from ctx.request_info()

* Address comments

Tao Chen · 2025-10-31 14:31:15 +00:00

68b6a55757

Python: Lab: Updates to GAIA module (#1763 )

* Lab: Updates to GAIA module

* update

* emoj!

* fix lint

* update lab test workflow to only trigger for python changes

* lint

* lint

* Fix broken OpenAI agents JS documentation link

Eric Zhu · 2025-10-30 22:02:31 +00:00

1543370027

Python: [BREAKING] Cleanup of dependencies (#1803 )

* removed extra and non-released deps

* added comments

* added space and lock

* fix pyright config

Eduard van Valkenburg · 2025-10-30 15:24:29 +00:00

434ffb8ab8

fix: Remove strict thread id validation for tool results (#1769 )

* fix: remove strict thread id validation for tool results

* test: remove corresponding test for strict thread_id validation

Kurt · 2025-10-30 14:32:46 +00:00

abfdf75cfb

Python: Azure AI Search Support Update + Refactored Samples & Unit Tests (#1683 )

* azure ai search sample update

* azure ai search update

* small fix

Giles Odigwe · 2025-10-30 02:30:06 +00:00

2059e7b3e8

[BREAKING] Python: Replace RequestInfoExecutor with request_info API and @response_handler (#1466 )

* Prototype: Add request_info API and @response_handler

* Add original_request as a parameter to the response handler

* Prototype: request interception in sub workflows

* Prototype: request interception in sub workflows 2

* WIP: Make checkpointing work

* checkpointing with sub workflow

* Fix function executor

* Allow sub-workflow to output directly

* Remove ReqeustInfoExecutor and related classes; Debugging checkpoint_with_human_in_the_loop

* Fix Handoff and sample

* fix pending requests in checkpoint

* Fix unit tests

* Fix formatting

* Resolve comments

* Address comment

* Add checkpoint tests

* Add tests

* misc

* fix mypy

* fix mypy

* Use request type as part of the key

* Log warning if there is not response handler for a request

* Update Internal edge group comments

* REcord message type in executor processing span

* Update sample

* Improve tests

Tao Chen · 2025-10-29 23:31:23 +00:00

943d92674e

Python: Fix type compatibility check (#1753 )

* Fix type compatibility check

* Address comments

Tao Chen · 2025-10-29 00:48:01 +00:00

1fbdcf8268

Updated Python and .NET package versions (#1758 )

Dmytro Struk · 2025-10-28 18:49:50 +00:00

eed7e59f3f

Python: Added thread to AgentRunContext (#1732 )

* Added thread to agent run context

* Added sample

* Update python/samples/getting_started/middleware/thread_behavior_middleware.py

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

* Small fix

---------

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

Dmytro Struk · 2025-10-28 16:31:09 +00:00

adba312cd6

Python: AutoGen migration samples (#1738 )

* add autogen migration samples

* fix typo

* remove comment

* fix typo

* fix lab pyright

* fix for HuggingFace change

Eric Zhu · 2025-10-28 00:47:31 +00:00

3194851c11

Python: reject @executor on staticmethod/classmethod with clear error message (#1719 )

* reject executor on static method w clear error

* Simplify

* Cleanup

Evan Mattson · 2025-10-27 05:31:58 +00:00

e2d1ba3192

Python: [BREAKING] Python: Intro group chat and refactor orchestrations. Fix as_agent(). Standardize orchestration start msg types. (#1538 )

* Intro group chat and refactor magentic. Fix as_agent()

* Cleanup and improvements

* Add as_agent docstring clarification

* Standardize orchestration messages to use agent-style inputs.

* Simplify group chat constructs

* Further cleanup

* Add sk to af group chat migration sample. Update README.

* Improvements and simplifications

* consolidating shared orchestration logic

* Further clean up

* Add group chat sample

* Improve typing

* Fix test imports

* Fix readme links

* Cleanup per PR Feedback

Evan Mattson · 2025-10-25 00:14:06 +00:00

e3aad8e4e0

Python: Update lab packages and installation instructions (#1687 )

* update lab packages and installation instructions

* fix dep

Eric Zhu · 2025-10-24 21:12:08 +00:00

aba505df77

Python: [BREAKING] Update Agent Framework Lab Lightning to use Agent-lightning v0.2.0 API (#1644 )

* Merge changes from AGL release

* Merge changes from AGL release

* fix mypy

* fix tool call with pydantic

* Apply suggestion from @ekzhu

* fix lint

---------

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

Yuge Zhang · 2025-10-24 17:02:56 +00:00

458819a12b

[BREAKING] Python: Refactor Checkpointing for runner and runner context (#1645 )

* Refactor Checkpointing for runner and runner context

* exception

* Fix formatting

* Comments

* rename

* Add detailed doc string

Tao Chen · 2025-10-24 03:34:55 +00:00

31701dbb92

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

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 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: 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

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: 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: 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: 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

229 Commits