Python: Add Durabletask samples and minor fixes

[Laveesh Rohra (larohra)]

Motivation and Context

This PR adds the remaining samples to the durabletask package.
It also addresses a bug where a new uuid was being created for orchestration replays causing thread disruption.

Description

This pull request introduces several improvements and refactors to the durable agent task execution system, focusing on better task completion handling, improved error propagation, and enhanced test coverage for edge cases. The changes also update dependencies and clarify sample documentation for easier onboarding and testing.

Core improvements to task execution and error handling:

• Refactored DurableAgentTask to inherit from both CompositeTask and CompletableTask, and updated its completion logic to use the new complete() and fail() methods for more robust and standardized task state management. This improves error propagation and prevents duplicate completion. [1][2][3][4]
• Changed the type of entity_task to CompletableTask[Any] throughout the executor code to reflect the new task interface and ensure type safety. [1][2]

Testing enhancements and coverage:

• Added new pytest fixtures to configure mock entity tasks for both successful and failed scenarios, simplifying test setup and increasing reliability. [1][2]
• Expanded test coverage for DurableAgentTask to include cases for malformed responses, invalid response formats, empty and multiple messages, and initial state checks. This ensures the task handles edge cases and errors gracefully.

Dependency and configuration updates:

• Updated durabletask and durabletask-azuremanaged dependencies to version 1.2.0.dev10 in pyproject.toml for compatibility with new features and bug fixes.
• Added RUF067 to the list of ignored ruff lint rules to allow version detection in __init__.py.

Sample and documentation improvements:

• Improved the README.md for the single agent sample to clarify the combined and separate worker/client approaches, enhancing the onboarding experience for new users. [1][2][3]
• Removed an unnecessary debug log in the content_generation_hitl_orchestration sample for cleaner output.

Minor logging and utility enhancements:

• Enhanced logging in AgentEntity.run to include the thread ID, aiding in debugging concurrent executions.
• Added a utility method generate_unique_id() to the executor for safer UUID generation within orchestrations.

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.

[Copilot]

Pull request overview

This PR adds comprehensive samples for the durabletask package demonstrating advanced orchestration patterns including human-in-the-loop workflows, conditional branching, and concurrency. It also updates dependencies (durabletask 1.2.0, aiohttp 3.13.3, etc.) and refactors existing samples for better maintainability.

Key Changes:

• Added Sample 06: Multi-agent orchestration with conditional branching (spam detection + email assistant)
• Added Sample 07: Human-in-the-loop pattern with external events, timeouts, and iterative refinement
• Refactored Sample 05: Extracted helper functions for better code reuse
• Updated README with comprehensive sample catalog and improved setup instructions
• Updated dependencies to durabletask 1.2.0 and other minor version bumps

Reviewed changes

Copilot reviewed 34 out of 35 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
python/uv.lock	Updated dependencies including durabletask to 1.2.0, aiohttp to 3.13.3, and various other minor version updates
python/samples/getting_started/durabletask/README.md	Enhanced README with sample catalog categorization, PowerShell commands, and uv package manager instructions
python/samples/getting_started/durabletask/07_single_agent_orchestration_hitl/*	New HITL sample with WriterAgent demonstrating external events, timeouts, and feedback loops
python/samples/getting_started/durabletask/06_multi_agent_orchestration_conditionals/*	New conditional orchestration sample with spam detection and email assistant agents
python/samples/getting_started/durabletask/05_multi_agent_orchestration_concurrency/*	Refactored to extract helper functions (get_worker, setup_worker, get_client) for reusability

[Mark Wallace (markwallace-microsoft)]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
packages/azurefunctions/agent_framework_azurefunctions
_orchestration.py	60	4	93%	129–130, 134, 149
TOTAL	16760	2716	83%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
2686	154 💤	0 ❌	0 🔥	1m 0s ⏱️

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.