agent-framework

.NET: Python: Add AGENTS.md files and update coding standards (#3644 )

* Add AGENTS.md files and update coding standards for Python

- Add root python/AGENTS.md with project structure and package links
- Add AGENTS.md for each package describing purpose and main classes
- Update .github/copilot-instructions.md with improved structure
- Update python/CODING_STANDARD.md with API review guidance:
  - Future annotations convention (#3578)
  - TypeVar naming convention (#3594)
  - Mapping vs MutableMapping (#3577)
  - Avoid shadowing built-ins (#3583)
  - Explicit exports (#3605)
  - Exception documentation guidelines (#3410)
- Simplify python/.github/instructions/python.instructions.md to reference AGENTS.md
- Remove AGENTS.md from .gitignore

* Fix purview import path in AGENTS.md

* Address PR review comments and restructure instructions

- Slim down .github/copilot-instructions.md to reference language-specific docs
- Add ADR section explaining templates and purpose
- Create dotnet/AGENTS.md with .NET-specific build commands, conventions, and sample guidance
- Update Python build/test instructions for core vs isolated changes
- Fix Microsoft.Extensions.AI package references
- Update kwargs guidance per issue #3642
- Fix Python sample helper placement (top, not bottom)
- Document new 'typing' poe task in DEV_SETUP.md

* Add 'typing' poe task to run both pyright and mypy

* Add kwargs guidelines from issue #3642 to CODING_STANDARD.md

* Clarify that connector packages pull in core as dependency

Eduard van Valkenburg · 2026-02-05 10:27:46 +00:00

eaad042241

[BREAKING] Python: Move orchestrations to dedicated package (#3685 )

* Move orchestrations to dedicated package

* Merge main

* Fix markdown links

* Fix links

Evan Mattson · 2026-02-05 03:05:13 +00:00

0daa7700c6

[BREAKING] Python: Refactor SharedState to State with sync methods and superstep caching (#3667 )

* Refactor SharedState to State with sync methods and superstep caching

* Fixes

* Address PR feedback

* Remove dead links

* Fix lab test import

Evan Mattson · 2026-02-05 01:42:52 +00:00

10afb86213

[BREAKING] Python: Fix workflow as agent streaming output (#3649 )

* WIP: with_output_from

* Add with_output_from to other modules; next: workflow as agent

* WIP: remove agent run events

* orchestrations

* WIP: update samples; next start at guessing_game_With_human_input.py

* Update all samples

* WIP: consolidate workflow as agent streaming vs non-streaming

* Consolidate workflow as agent streaming vs non-streaming

* Move request info event processing to a share method

* Final pass on the samples

* Fix mypy

* Fix mypy

* Comments

---------

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

Tao Chen · 2026-02-05 00:16:45 +00:00

a971d24f1e

Python: [BREAKING] Types API Review improvements (#3647 )

* Replace Role and FinishReason classes with NewType + Literal

- Remove EnumLike metaclass from _types.py
- Replace Role class with NewType('Role', str) + RoleLiteral
- Replace FinishReason class with NewType('FinishReason', str) + FinishReasonLiteral
- Update all usages across codebase to use string literals
- Remove .value access patterns (direct string comparison now works)
- Add backward compatibility for legacy dict serialization format
- Update tests to reflect new string-based types

Addresses #3591, #3615

* Simplify ChatResponse and AgentResponse type hints (#3592)

- Remove overloads from ChatResponse.__init__
- Remove text parameter from ChatResponse.__init__
- Remove | dict[str, Any] from finish_reason and usage_details params
- Remove **kwargs from AgentResponse.__init__
- Both now accept ChatMessage | Sequence[ChatMessage] | None for messages
- Update docstrings and examples to reflect changes
- Fix tests that were using removed kwargs
- Fix Role type hint usage in ag-ui utils

* Remove text parameter from ChatResponseUpdate and AgentResponseUpdate (#3597)

- Remove text parameter from ChatResponseUpdate.__init__
- Remove text parameter from AgentResponseUpdate.__init__
- Remove **kwargs from both update classes
- Simplify contents parameter type to Sequence[Content] | None
- Update all usages to use contents=[Content.from_text(...)] pattern
- Fix imports in test files
- Update docstrings and examples

* Rename from_chat_response_updates to from_updates (#3593)

- ChatResponse.from_chat_response_updates → ChatResponse.from_updates
- ChatResponse.from_chat_response_generator → ChatResponse.from_update_generator
- AgentResponse.from_agent_run_response_updates → AgentResponse.from_updates

* Remove try_parse_value method from ChatResponse and AgentResponse (#3595)

- Remove try_parse_value method from ChatResponse
- Remove try_parse_value method from AgentResponse
- Remove try_parse_value calls from from_updates and from_update_generator methods
- Update samples to use try/except with response.value instead
- Update tests to use response.value pattern
- Users should now use response.value with try/except for safe parsing

* Add agent_id to AgentResponse and clarify author_name documentation (#3596)

- Add agent_id parameter to AgentResponse class
- Document that author_name is on ChatMessage objects, not responses
- Update ChatResponse docstring with author_name note
- Update AgentResponse docstring with author_name note

* Simplify ChatMessage.__init__ signature (#3618)

- Make contents a positional argument accepting Sequence[Content | str]
- Auto-convert strings in contents to TextContent
- Remove overloads, keep text kwarg for backward compatibility with serialization
- Update _parse_content_list to handle string items
- Update all usages across codebase to use new format: ChatMessage("role", ["text"])

* Allow Content as input on run and get_response

- Update prepare_messages and normalize_messages to accept Content
- Update type signatures in _agents.py and _clients.py
- Add tests for Content input handling

* Fix ChatMessage usage across packages and samples

Update all remaining ChatMessage(role=..., text=...) to use new
ChatMessage('role', ['text']) signature.

* Fix Role string usage and response format parsing

- Fix redis provider: remove .value access on string literals
- Fix durabletask ensure_response_format: set _response_format before accessing .value

* Fix ollama .value and ai_model_id issues, handle None in content list

- Fix ollama _chat_client: remove .value on string literals
- Fix ollama _chat_client: rename ai_model_id to model_id
- Fix _parse_content_list: skip None values gracefully

* Fix A2AAgent type signature to include Content

* Fix Role/FinishReason NewType dict annotations and improve test coverage to 95%

* Fix mypy errors for Role/FinishReason NewType usage

* Fix Role.TOOL and Role.ASSISTANT usage in _orchestrator_helpers.py

* Fix Role NewType usage in durabletask _models.py

Eduard van Valkenburg · 2026-02-04 10:13:23 +00:00

838a7fd61d

Python: Add BaseAgent implementation for Claude Agent SDK (#3509 )

* Added ClaudeAgent implementation

* Updated streaming logic

* Small updates

* Small update

* Fixes

* Small fix

* Naming improvements

* Updated imports

* Addressed comments

* Updated package versions

Dmytro Struk · 2026-01-30 18:11:41 +00:00

8b475afe17

Python: added generic types to ChatOptions and ChatResponse/AgentResponse for Response Format (#3305 )

* added generic types to ChatOptions and ChatResponse/AgentResponse for response format

* fix typevar import

* fix for older python versions

* fix missing import

* fixed imports

* fixed mypy

* mypy fix

Eduard van Valkenburg · 2026-01-28 21:23:02 +00:00

1226828ec2

.NET: Python: [BREAKING] Renamed Github to GitHub (#3486 )

* Renamed Github to GitHub

* Small fix

* Updated package versions

Dmytro Struk · 2026-01-28 19:58:31 +00:00

45a020be43

Updated package versions (#3462 )

Dmytro Struk · 2026-01-27 18:16:55 +00:00

968621e817

update package versions (#3421 )

Giles Odigwe · 2026-01-23 23:40:20 +00:00

330c2607ad

Python: [Breaking] Simplified Content types to a single class with classmethod constructors. (#3252 )

* ported Content to a new model

* fixed linting

* fixes

* fixed data format handling

* fix for 3.10 mypy

* fix

* fix int test

Eduard van Valkenburg · 2026-01-20 22:09:39 +00:00

83e6229c11

Bump tar from 7.4.3 to 7.5.3 in /python/packages/devui/frontend (#3267 )

Bumps [tar](https://github.com/isaacs/node-tar) from 7.4.3 to 7.5.3.
- [Release notes](https://github.com/isaacs/node-tar/releases)
- [Changelog](https://github.com/isaacs/node-tar/blob/main/CHANGELOG.md)
- [Commits](https://github.com/isaacs/node-tar/compare/v7.4.3...v7.5.3)

---
updated-dependencies:
- dependency-name: tar
  dependency-version: 7.5.3
  dependency-type: indirect
...

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

dependabot[bot] · 2026-01-20 07:26:34 +00:00

8ee379d344

fix #3171 , ensure proper form rendering for int (#3201 )

Victor Dibia · 2026-01-20 07:25:12 +00:00

0f29637b86

Python: Update package version (#3258 )

* package version 260116

* removed name tags

Giles Odigwe · 2026-01-16 21:06:30 +00:00

9e3b2fa09a

Python: fix(ag-ui): add MCP tool support for AG-UI approval flows (#3212 )

* add MCP tool support for AG-UI approval flows

* use attribute in place of property

Evan Mattson · 2026-01-15 02:34:11 +00:00

620da7a829

fix(workflows): rename WorkflowOutputEvent.source_executor_id to executor_id for API consistency (#3166 )

Evan Mattson · 2026-01-15 02:11:25 +00:00

80b25a782b

update package versions (#3223 )

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

Giles Odigwe · 2026-01-14 23:26:50 +00:00

cb2862d4c3

renamed all (#3207 )

Eduard van Valkenburg · 2026-01-14 05:54:07 +00:00

d8cf8361bd

Python: [BREAKING]: Introducing Options as TypedDict and Generic (#3140 )

* WIP typeddict for options

* updated all clients and ChatAgents

* updated everything

* added ADR

* fix mypy

* proper typevar imports

* fixed import

* fixed other imports

* slight update in the sample

* updated from feedback

* fixes

* fixed missing covariants and test fixes

* fixed typing

* updated anthropic thinking config

* ruff fixes

* fixed int tests

* fix tests and mypy

* updated integration tests

* updated docstring and test fix

* improved options handling in obser

* mypy fix

* updated a host of integration tests

* fix tests

* bedrock fix

Eduard van Valkenburg · 2026-01-13 16:41:05 +00:00

3e97425245

Python: [BREAKING]: removed display_name, renamed context_providers, middleware and AggregateContextProvider (#3139 )

* removed display_name, renamed context_providers, middleware and AggregateContextProvider

* fixes

* fixed test

* testfix

* removed mistakenly put back test

* updated new test

* rename middlewares to middleware

* middleware fixes

Eduard van Valkenburg · 2026-01-13 02:24:07 +00:00

203fb7b1c4

Bump js-yaml from 4.1.0 to 4.1.1 in /python/packages/devui/frontend (#3123 )

Bumps [js-yaml](https://github.com/nodeca/js-yaml) from 4.1.0 to 4.1.1.
- [Changelog](https://github.com/nodeca/js-yaml/blob/master/CHANGELOG.md)
- [Commits](https://github.com/nodeca/js-yaml/compare/4.1.0...4.1.1)

---
updated-dependencies:
- dependency-name: js-yaml
  dependency-version: 4.1.1
  dependency-type: indirect
...

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

dependabot[bot] · 2026-01-08 20:49:49 +00:00

9c04196491

Python: Bump python version to 1.0.0b260107 for a release (#3128 )

* Bump python version to 1.0.0b260107 for a release

* Update changelog

Evan Mattson · 2026-01-08 08:49:28 +09:00

f508f1d6da

Python: Improve DevUI, add Context Inspector view as new tab under traces (#2742 )

* Improve DevUI, add Context Inspector view as new tab under traces

* fix mypy errors

* fix: Handle stale MCP connections in DevUI executor

MCP tools can become stale when HTTP streaming responses end - the underlying
stdio streams close but `is_connected` remains True. This causes subsequent
requests to fail with `ClosedResourceError`.

Add `_ensure_mcp_connections()` to detect and reconnect stale MCP tools before
agent execution. This is a workaround for an upstream Agent Framework issue
where connection state isn't properly tracked.

Fixes MCP tools failing on second HTTP request in DevUI.

fixes  #1476 #1515 #2865

* fix #1572 report import dependency errors more clearly

* Ensure there is streaming toggle where users can select streaming vs non streaming mode in devui . Fixes .NET: [Python] DevUI tool call rendering in non-streaming mode?

* remove unused dead code

* improve ux - workflows with agents show a chat component in execution timelien, also ensure magentic final output shows correctly

* update ui build

* update devui to use instrumentation instead of tracing, other instrumentation and type/instance check fixes

Victor Dibia · 2026-01-07 08:26:08 +00:00

2e1189ca65

Bump versions to 1.0.0b260106 for a release. Update CHANGELOG.md (#3109 )

Evan Mattson · 2026-01-07 00:09:49 +00:00

202f557c71

Python: Updated package versions (#3024 )

* Updated package versions

* Updated changelog

Dmytro Struk · 2025-12-23 16:04:53 +00:00

5ab47596ff

Python: Bump Py version to 1.0.0b251218 for a release. Update CHANGELOG (#2968 )

* Bump Py version to 1.0.0b251218 for a release. Update CHANGELOG

* update lock

* Fix formatting

* Fix ChatKit typing

Evan Mattson · 2025-12-19 01:31:57 +00:00

e15eab7da6

Python: cleanup and refactoring of chat clients (#2937 )

* refactoring and unifying naming schemes of internal methods of chat clients

* set tool_choice to auto

* fix for mypy

* added note on naming and fix #2951

* fix responses

* fixes in azure ai agents client

Eduard van Valkenburg · 2025-12-18 12:02:23 +00:00

e5c11d38d6

Updated package versions (#2913 )

Dmytro Struk · 2025-12-16 18:51:44 +00:00

e319707058

Python: [BREAKING] Observability updates (#2782 )

* fixes Python: Add env_file_path parameter to setup_observability() similar to AzureOpenAIChatClient
Fixes #2186

* WIP on updates using configure_azure_monitor

* improved setup and clarity

* fixed root .env.example

* revert changes

* updated files

* updated sample

* updated zero code

* test fixes and fixed links

* fix devui

* removed planning docs

* added enable method and updated readme and samples

* clarified docstring

* add return annotation

* updated naming

* update capatilized version

* updated readme and some fixes

* updated decorator name inline with the rest

* feedback from comments addressed

Eduard van Valkenburg · 2025-12-16 06:56:30 +00:00

3139347526

Python: Updated package versions (#2784 )

* Updated package versions

* Small fix

Dmytro Struk · 2025-12-11 18:39:08 +00:00

8d53b20026

Python: Updated package versions (#2737 )

* Updated package versions

* Updated changelog

Dmytro Struk · 2025-12-09 22:58:45 +00:00

43302fb4cd

Python: Title: DevUI Fix WorkflowFailedEvent error extraction (#2706 )

* Title: Fix WorkflowFailedEvent error extraction to use details instead of error Body:
Summary
Fixed WorkflowFailedEvent mapping to extract error message from details.message instead of non-existent error attribute
Added support for including details.extra context in error messages when present
Problem
The WorkflowFailedEvent handler in _mapper.py was reading event.error, but WorkflowFailedEvent uses a details attribute (of type WorkflowErrorDetails), not error. This caused all workflow failures to display "Unknown error" in the UI instead of the actual error message.
Fix
Updated the handler to match the pattern already used by ExecutorFailedEvent:
Read from event.details instead of event.error
Extract details.message for the error text
Include details.extra context when available

* improve error handling consistency

Victor Dibia · 2025-12-08 21:44:32 +00:00

d889fa6f87

fixes Python: DevUI fails when uploading Pdf file (tested on Python Foundry Agent) (#2675 )

Fixes #2652

Victor Dibia · 2025-12-08 17:00:57 +00:00

0675000f4b

Python: DevUI, Fix message serialization issue, improve tests (#2674 )

* fix message serialization issue, improve tests for devui

* update tests

Victor Dibia · 2025-12-06 02:20:54 +00:00

8c6b12e664

Updated package versions (#2643 )

Dmytro Struk · 2025-12-04 22:08:47 +00:00

f5786b2c5b

Python: DevUI fixes : Add multimodal input support for workflows and refactor chat input (#2593 )

* show app version in devui .NET: Python: Improved Versioning for DevUI
Fixes #2059

* feat: Add multimodal input support for workflows and refactor chat input

This PR adds support for multimodal content (images, files) in workflow
inputs and refactors the chat input into a reusable component.

## Multimodal Workflow Support
- Add `isChatMessageSchema()` to detect ChatMessage input schemas
- Update `RunWorkflowButton` to use `ChatMessageInput` for ChatMessage workflows
- Wrap multimodal content in OpenAI message format for backend processing
- Add `_is_openai_multimodal_format()` to detect OpenAI ResponseInputParam
- Update `_parse_workflow_input()` to route multimodal input through
  existing `_convert_input_to_chat_message()` converter

## Reusable ChatMessageInput Component
- Extract chat input logic from agent-view into `ChatMessageInput` component
- Support file upload, drag & drop, paste handling, and attachments
- Add `useDragDrop` hook for parent-level drag handling with full-area
  drop zones
- Refactor agent-view to use the new shared component

## Other Improvements
- Add `isStreaming` prop to executor nodes for animation control
- Clean up unused imports and state variables in agent-view
- Add tests for multimodal workflow input handling

Fixes workflow input not receiving images when using AgentExecutor nodes.

* add self loop edge, fix #2470

* fix test

Victor Dibia · 2025-12-03 20:15:51 +00:00

411ee7a60f

Fix MangenticAgentExecutor producing repr str for tool call content (#2566 )

Evan Mattson · 2025-12-02 08:40:11 +00:00

c2d285e614

Python: make tool call view optional in DevUI + other link fixes (#2243 )

* make tool call view optional in devui + other link fixes

* fix #2310, ensure correct port is shown in command

* fix dialog bug

* ensure executor ids are tracked per items, fix bug where data from concurrent executors where not seperated properly fix #2351

* fix: Enable multi-round human-in-the-loop (HIL) in DevUI workflows

- Backend: Enrich RequestInfoEvents with response schemas in send_responses_streaming path
- Frontend: Replace old HIL requests with new ones instead of accumulating them
- Frontend: Fix HIL response state management to prevent sending stale request responses

This allows workflows to properly handle sequential HIL requests, showing only the
current request to users and progressing through multiple input rounds correctly.

fixes #2334

* fix bug to ensure in memory entities cannot be reloaded in ui

Victor Dibia · 2025-11-24 07:22:53 +00:00

f0f1051c7d

Updated package versions (#2360 )

Dmytro Struk · 2025-11-20 16:07:10 -08:00

cf13e35c73

Python: Clean up imports (#2318 )

* chore: tidy imports

* Update python/packages/azurefunctions/agent_framework_azurefunctions/_errors.py

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

* Update python/packages/azurefunctions/agent_framework_azurefunctions/_callbacks.py

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

* chore: revert stub file change

* chore: trigger pre-commit hook, re-add `annotations` import

---------

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

Brandon McConnell · 2025-11-19 23:41:01 +00:00

79bb87061b

Python: fix for Incomplete URL substring sanitization (#2274 )

* Potential fix for code scanning alert no. 29: Incomplete URL substring sanitization

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

* Python: Fix URL parsing to handle trailing punctuation in deployment progress detection (#2296)

* Initial plan

* Fix URL parsing to handle trailing punctuation correctly

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

---------

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

* updated lock

---------

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: eavanvalkenburg <13749212+eavanvalkenburg@users.noreply.github.com>
Co-authored-by: Victor Dibia <chuvidi2003@gmail.com>

Eduard van Valkenburg · 2025-11-18 22:16:58 +00:00

293abf5b56

Bump js-yaml from 4.1.0 to 4.1.1 in /python/packages/devui/frontend (#2230 )

Bumps [js-yaml](https://github.com/nodeca/js-yaml) from 4.1.0 to 4.1.1.
- [Changelog](https://github.com/nodeca/js-yaml/blob/master/CHANGELOG.md)
- [Commits](https://github.com/nodeca/js-yaml/compare/4.1.0...4.1.1)

---
updated-dependencies:
- dependency-name: js-yaml
  dependency-version: 4.1.1
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>

dependabot[bot] · 2025-11-18 13:47:27 +00:00

03b74bfad4

Python: Add checkpoint save and restore hooks to executor (#2097 )

* Add checkpoint hooks

* Deprecate get_executor_state and set_executor_state

* Fix tests and samples

* Add doc strings

* Add sample

* Fix import

* Address comments and fix tests

* Address comments

* conditional import

Tao Chen · 2025-11-17 18:19:01 +00:00

c361ad8d33

Python: Updated package versions (#2238 )

* Updated package versions

* Small fix

* Small fix

Dmytro Struk · 2025-11-15 00:42:41 +00:00

c7e7020c32

Python: Fix HIL regression (#2167 )

* fix devui regression from #2021 where all input is stringified but devui HIL input does not handle stringified json strings correctly.

* update incorrect test

* add devui hil input tests

Victor Dibia · 2025-11-13 05:26:24 +00:00

7e5de8f920

Python: Updated package versions (#2165 )

* Updated package versions

* Reverted package version update for ag-ui

* Updated changelog file

Dmytro Struk · 2025-11-13 04:23:57 +00:00

3c874d0073

Updated package versions (#2154 )

Dmytro Struk · 2025-11-12 23:58:02 +00:00

e8243b7d11

.NET: Expose more agent metadata through DevUI discovery endpoint (#2138 )

* Exposes more agent metadata through DevUI discovery endpoint

* Exposes more agent metadata through DevUI discovery endpoint

* pr feedback

* pr feedback

* Don't expose Workflows as agents to DevUI

Reuben Bond · 2025-11-12 23:38:06 +00:00

4b0f724e62

Updated package versions (#2104 )

Dmytro Struk · 2025-11-11 23:30:34 +00:00

863a632ccf

DevUI: support having both an agent and a workflow with the same id in discovery (#2023 )

Reuben Bond · 2025-11-10 21:36:07 +00:00

12fc19b360

90 Commits