[BREAKING] Python: Refactor workflows kwargs

[TaoChenOSU]

Motivation and Context

Closes #4850

Description

This is considered breaking even with backward compatibility because it no longer supports passing runtime options to the agents.

Contribution Checklist

• The code builds clean without any errors or warnings
• The PR follows the Contribution Guidelines
• All unit tests pass, and I have added new tests where possible
• Is this a breaking change? If yes, add "[BREAKING]" prefix to the title of the PR.

[markwallace-microsoft]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
packages/core/agent_framework
_evaluation.py	627	73	88%	159, 167, 476, 478, 604, 607, 686–688, 693, 730–733, 789–790, 793, 799–801, 805, 838–840, 894, 929, 941–943, 948, 972–977, 1068, 1146–1147, 1149–1153, 1159, 1198, 1543, 1545, 1553, 1563, 1567, 1612, 1630–1631, 1702, 1708, 1723, 1727–1729, 1759, 1765–1769, 1801, 1832–1833, 1835, 1860–1861, 1866
packages/core/agent_framework/_workflows
_agent.py	359	70	80%	66, 74–80, 116–117, 214, 277, 279, 348, 350, 410, 416, 426–427, 434, 436, 442, 504–505, 514, 521, 547, 580–582, 584, 586, 588, 593, 598, 645, 675, 692, 731–734, 740, 746, 750–751, 754–760, 764–765, 773, 834, 841, 847–848, 859, 891, 898, 919, 928, 932, 934–936, 943
_agent_executor.py	187	15	91%	109, 133, 174, 200–201, 281–283, 285, 295–296, 401–402, 474, 480
_const.py	7	0	100%
_workflow.py	280	19	93%	88, 267–269, 271–272, 290, 294, 441, 636, 657, 713, 725, 731, 736, 756–758, 809
_workflow_executor.py	187	31	83%	94, 404, 464, 487, 489, 497–498, 503, 505, 510, 512, 565, 593–599, 603–605, 613, 618, 629, 639, 643, 649, 653, 663, 667
TOTAL	27003	3188	88%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
5348	20 💤	0 ❌	0 🔥	1m 24s ⏱️

[Copilot]

Pull request overview

Refactors Python workflow run() kwarg handling by introducing explicit function_invocation_kwargs / client_invocation_kwargs routing (including per-executor targeting) and updating samples/tests to reflect the new model, as part of removing legacy workflow-kwargs compatibility paths (Issue #4850).

Changes:

• Add per-executor/global resolution for function_invocation_kwargs and client_invocation_kwargs and plumb them through workflow state → executors → agents.
• Update workflow state-management samples to demonstrate global vs per-agent targeting.
• Adjust workflow/executor tests to validate new routing behavior and logging.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
python/samples/03-workflows/state-management/workflow_kwargs.py	Removes old sample demonstrating legacy kwargs flow.
python/samples/03-workflows/state-management/workflow_kwargs_per_agent.py	New sample showing per-agent (per-executor-id) function_invocation_kwargs.
python/samples/03-workflows/state-management/workflow_kwargs_global.py	New sample showing global function_invocation_kwargs delivery to all agents.
python/packages/core/tests/workflow/test_workflow_kwargs.py	Updates/extends tests for new invocation kwargs behavior, removes options-merging coverage.
python/packages/core/tests/workflow/test_agent_executor.py	Updates _prepare_agent_run_args tests and adds executor-kwargs resolution tests.
python/packages/core/agent_framework/_workflows/_workflow.py	Adds new invocation kwargs params, state persistence, and resolution logic.
python/packages/core/agent_framework/_workflows/_const.py	Introduces GLOBAL_KWARGS_KEY="__global__" sentinel.
python/packages/core/agent_framework/_workflows/_agent_executor.py	Extracts invocation kwargs from workflow state and routes per-executor/global into agent.run().
python/packages/core/agent_framework/_evaluation.py	Minor formatting-only changes.

[eavanvalkenburg]

Looks good overall, couple of comments