feat: add multi-owner Dynamic Workflow ownership and isolation by TsuyoshiUshio · Pull Request #151 · Azure/azure-functions-agents-runtime

Tsuyoshi Ushio (TsuyoshiUshio) · 2026-08-10T23:23:48Z

Summary

enable Dynamic Workflows for any agent with a supported trigger, chat API, or MCP starter, while preserving main.agent.md support
register one app-wide Durable engine with complete handler and Agent catalogs plus immutable per-owner workflow policies
scope workflow identity and management to (owner_slug, session_id) with a 128-bit ownership digest and Activity-time policy reauthorization
add the runnable Engineering Operations Hub sample with two non-main owners, deterministic local tools, isolated policies, Storage/DTS verification, and a simple sender for a manually started host
synchronize architecture, workflow, trigger, frontmatter, migration, and sample documentation

Design

FRD 0009 is finalized after human ratification of Decisions #8–#10 and #13. It uses ID 0009 because open PR #111 and draft PR #121 reserved 0008 when this work began.

Compatibility

This includes one intentional breaking change within the experimental Dynamic Workflows surface: legacy session-only workflow IDs continue running in Durable but are not manageable through the new owner-scoped agent APIs. The documentation includes drain guidance and continued Durable/DTS operator access.

Validation

python -m ruff check src tests
python -m mypy src with CI's mypy 2.3.0
python -m pytest --cache-clear --cov=.\src\azure_functions_agents --cov-report=xml --cov-branch tests — 976 passed, 52 deselected
exact Outlook sample startup E2E that previously failed in CI — passed
Engineering Operations Hub verifier with Azure Storage — both owners completed; capability, status, and list isolation passed
Engineering Operations Hub verifier with DTS — both owners completed; capability, status, and list isolation passed
manual sender/sample targeted tests — passed

References:

Support Dynamic Workflows for agents other than main.agent.md #109
Azure/azure-functions-bucees-planning#1274
Azure/azure-functions-bucees-planning#1275

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Preserve Activity failures, isolate compatibility registration tokens, align workflow starter validation, and make the chat UI the primary sample walkthrough. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Keep FRD 0004 as the initial Dynamic Workflows record while linking its evolution to the separate ownership, authorization, and identity design in FRD 0009. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Simplify workflow ownership eligibility, keep customer samples minimal, and type Durable workflow boundaries. Move the E2E verifier to engineering tooling and preserve actionable trigger diagnostics. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Rename the internal workflow owner identity and Durable payload contract to workflow_agent_slug across composition, execution, tests, and documentation. Make the E2E verifier isolate Storage runs from local DTS host configuration. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Remove the unreleased drain-mode environment variable and its runtime, policy, test, and documentation surface. Record the superseding FRD decision and defer final-agent lifecycle ownership to the tracked issue. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Laveesh Rohra (larohra)

1 small comment else LGTM

Move the sample-only verifier from eng/scripts to tests/scripts and update its tests and design record to match the repository's script ownership conventions. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Tsuyoshi Ushio added 6 commits August 10, 2026 16:23

docs: propose per-agent Dynamic Workflows

2375aeb

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

docs: link per-agent workflows design PR

6ef8e31

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

docs: finalize per-agent Dynamic Workflows FRD

198172b

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

feat: enable Dynamic Workflows per agent

4529e98

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

feat: add per-agent workflows sample

3e0c02c

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Document per-agent Dynamic Workflows

3711eaa

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Tsuyoshi Ushio (TsuyoshiUshio) changed the title ~~docs: propose per-agent Dynamic Workflows architecture~~ feat: enable per-agent Dynamic Workflows Aug 11, 2026

Tsuyoshi Ushio added 3 commits August 11, 2026 09:44

Record per-agent workflow E2E

014bda0

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Add manual workflow sender sample

f0ca21f

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Clarify agent roles and reachability

3461183

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Tsuyoshi Ushio (TsuyoshiUshio) mentioned this pull request Aug 11, 2026

Add DTS dashboard links to Dynamic Workflow chat cards #153

Open

Tsuyoshi Ushio added 2 commits August 11, 2026 11:19

Fix CI trigger and typing regressions

23f5b2a

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Tsuyoshi Ushio (TsuyoshiUshio) marked this pull request as ready for review August 11, 2026 21:49

Tsuyoshi Ushio (TsuyoshiUshio) requested a review from a team as a code owner August 11, 2026 21:49

Merge branch 'main' into tsuyoshiushio-per-agent-dynamic-workflows

bc94f2f

Laveesh Rohra (larohra) requested changes Aug 12, 2026

View reviewed changes

Tsuyoshi Ushio (TsuyoshiUshio) changed the title ~~feat: enable per-agent Dynamic Workflows~~ feat: add multi-owner Dynamic Workflow ownership and isolation Aug 12, 2026

hallvictoria reviewed Aug 12, 2026

View reviewed changes

Comment thread samples/outlook-reply-agent/src/OnNewEmail.agent.md Outdated

Comment thread samples/per-agent-workflows/src/requirements.txt Outdated

Comment thread samples/per-agent-workflows/README.md Outdated

Comment thread src/azure_functions_agents/app.py

fix: retain workflow runtime during drain

2680ca2

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Laveesh Rohra (larohra) reviewed Aug 13, 2026

View reviewed changes

Comment thread docs/frds/0004-dynamic-workflows.md Outdated

Comment thread docs/workflows.md Outdated

Comment thread docs/workflows.md Outdated

Tsuyoshi Ushio added 3 commits August 12, 2026 19:56

Merge origin/main into tsuyoshiushio-per-agent-dynamic-workflows

7303380

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

docs: consolidate workflow design in FRD 0004

371c845

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: ade5207c-a0f4-4865-82d6-1d0d61f18570

Tsuyoshi Ushio (TsuyoshiUshio) mentioned this pull request Aug 13, 2026

Define safe lifecycle behavior when the final workflow-enabled agent is removed #161

Open

hallvictoria previously approved these changes Aug 14, 2026

View reviewed changes

Laveesh Rohra (larohra) previously approved these changes Aug 14, 2026

View reviewed changes

Comment thread eng/scripts/verify_per_agent_workflows.py Outdated

Tsuyoshi Ushio (TsuyoshiUshio) dismissed stale reviews from Laveesh Rohra (larohra) and hallvictoria via 6c99724 August 14, 2026 18:21

Laveesh Rohra (larohra) approved these changes Aug 14, 2026

View reviewed changes

Tsuyoshi Ushio (TsuyoshiUshio) merged commit 96b3be4 into main Aug 14, 2026
16 checks passed

Navigation Menu

Uh oh!

feat: add multi-owner Dynamic Workflow ownership and isolation - #151

feat: add multi-owner Dynamic Workflow ownership and isolation#151
Tsuyoshi Ushio (TsuyoshiUshio) merged 20 commits into
mainfrom
tsuyoshiushio-per-agent-dynamic-workflows

Tsuyoshi Ushio (TsuyoshiUshio) commented Aug 10, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Laveesh Rohra (larohra) left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

Tsuyoshi Ushio (TsuyoshiUshio) commented Aug 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Design

Compatibility

Validation

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Laveesh Rohra (larohra) left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Tsuyoshi Ushio (TsuyoshiUshio) commented Aug 10, 2026 •

edited

Loading