René's URL Explorer Experiment


Title: [Async stack 0/6] Async orchestrator contract by andystaples · Pull Request #356 · microsoft/durabletask-python · GitHub

Open Graph Title: [Async stack 0/6] Async orchestrator contract by andystaples · Pull Request #356 · microsoft/durabletask-python

X Title: [Async stack 0/6] Async orchestrator contract by andystaples · Pull Request #356 · microsoft/durabletask-python

Description: WarningNeither this PR nor any other PR in this stack should be merged on its own. The whole stack will be squash-merged once every PR in it is approved. This is the contract-documentation layer (0/6) of a review-only stack that splits the closed #293. The APIs documented here are implemented in later layers; this PR changes documentation only. Later layers extend docs/async-orchestrators.md as they implement each area, and the final version of the contract is in #364. Explain the motivation (#294), goals, non-goals, and alternatives considered for native coroutine orchestrators. Define native coroutine authoring across the core SDK, Azure Managed, and Azure Functions, including supported asyncio composition, cold operations versus reusable eager handles, and how orchestrators are classified as async or generator at registration. Specify ownership, cancellation, timeout, and dispatch-teardown behavior, including the limits of cancelling already-issued remote work. Establish deterministic replay constraints, unsupported I/O/composition APIs (asyncio.wait / asyncio.as_completed are documented as unsupported), and migration and Python-runtime compatibility limits, including keeping the Python minor version fixed for in-flight instances (#337). Differences from #293 The stack adds 5,488 lines and removes 126, compared with 4,669 added and 99 removed in #293, so it adds roughly 820 more lines. Most of the difference is hardening: A dedicated dispatch-local loop module (durabletask/internal/asyncio_loop.py). Cycle detection when classifying wrapped orchestrator callables. Skipping entity lock-release scheduling during async dispatch cleanup. An Any-typed overload for async sub-orchestration calls without return_type. Closing cold operations that never started when a dispatch tears down. Actionable errors for every asyncio loop API the durable loop does not implement. Additional replay, cleanup, and typing tests.

Open Graph Description: WarningNeither this PR nor any other PR in this stack should be merged on its own. The whole stack will be squash-merged once every PR in it is approved. This is the contract-documentation layer (...

X Description: WarningNeither this PR nor any other PR in this stack should be merged on its own. The whole stack will be squash-merged once every PR in it is approved. This is the contract-documentation layer (...

Opengraph URL: https://github.com/microsoft/durabletask-python/pull/356

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:85dc490a-14b0-1734-f9ec-53322526787c
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idDE9C:3DF912:313A37:43E6D9:6AFE2D11
html-safe-nonce4165ac9b8b5ca120e392420b0824e8afc92d07fbe7b76c4f573eee8752179d37
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJERTlDOjNERjkxMjozMTNBMzc6NDNFNkQ5OjZBRkUyRDExIiwidmlzaXRvcl9pZCI6IjM1NTc5ODUxMTM4OTY1MDE5MyIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmaca12b0947bfa303bbb7ff46a8fd59c4082392d1c9731c4234eabb5220822085e7
hovercard-subject-tagpull_request:5265444359
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/microsoft/durabletask-python/pull/356/files
twitter:imagehttps://avatars.githubusercontent.com/u/77818326?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/77818326?s=400&v=4
og:image:altWarningNeither this PR nor any other PR in this stack should be merged on its own. The whole stack will be squash-merged once every PR in it is approved. This is the contract-documentation layer (...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
Nonee973f9ec3625f3faad8cac5c2d11a214b7ffe45f3cc563b828459b290ecaeed3
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/microsoft/durabletask-python git https://github.com/microsoft/durabletask-python.git
octolytics-dimension-user_id6154722
octolytics-dimension-user_loginmicrosoft
octolytics-dimension-repository_id627664515
octolytics-dimension-repository_nwomicrosoft/durabletask-python
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id627664515
octolytics-dimension-repository_network_root_nwomicrosoft/durabletask-python
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release1f92c367595b9190e0be293896078033886b1913
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/microsoft/durabletask-python/pull/356/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmicrosoft%2Fdurabletask-python%2Fpull%2F356%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmicrosoft%2Fdurabletask-python%2Fpull%2F356%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=microsoft%2Fdurabletask-python
Reloadhttps://github.com/microsoft/durabletask-python/pull/356/files
Reloadhttps://github.com/microsoft/durabletask-python/pull/356/files
Reloadhttps://github.com/microsoft/durabletask-python/pull/356/files
microsofthttps://github.com/microsoft
durabletask-pythonhttps://github.com/microsoft/durabletask-python
Codehttps://github.com/microsoft/durabletask-python
Issues15 (15)https://github.com/microsoft/durabletask-python/issues
Pull requests12 (12)https://github.com/microsoft/durabletask-python/pulls
Actionshttps://github.com/microsoft/durabletask-python/actions
Projectshttps://github.com/microsoft/durabletask-python/projects
Security and qualityhttps://github.com/microsoft/durabletask-python/security
Insightshttps://github.com/microsoft/durabletask-python/insights
Sign up for GitHub https://github.com/signup?return_to=%2Fmicrosoft%2Fdurabletask-python%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fmicrosoft%2Fdurabletask-python%2Fissues%2Fnew%2Fchoose
andystapleshttps://github.com/andystaples
mainhttps://github.com/microsoft/durabletask-python/tree/main
andystaples-async-stack-0-contract-docshttps://github.com/microsoft/durabletask-python/tree/andystaples-async-stack-0-contract-docs
Conversation 4 https://github.com/microsoft/durabletask-python/pull/356
Commits 4 https://github.com/microsoft/durabletask-python/pull/356/commits
Checks 25 https://github.com/microsoft/durabletask-python/pull/356/checks
Files changed https://github.com/microsoft/durabletask-python/pull/356/files
Please reload this pagehttps://github.com/microsoft/durabletask-python/pull/356/files
[Async stack 0/6] Async orchestrator contract https://github.com/microsoft/durabletask-python/pull/356/files#top
Show all changes 4 commits https://github.com/microsoft/durabletask-python/pull/356/files
73cac11 Document async orchestrator authoring contract andystaples Nov 11, 2026 https://github.com/microsoft/durabletask-python/pull/356/commits/73cac11f9812ce792b95c4c262d4a494c2f4ecf0
1782b69 docs: distinguish eager commands in async orchestrator contract andystaples Nov 12, 2026 https://github.com/microsoft/durabletask-python/pull/356/commits/1782b6925bfcf1c35928b5f198cafac239eab0da
3c6b1c8 docs: clarify async orchestrator scope, classification, and replay wa… andystaples Nov 12, 2026 https://github.com/microsoft/durabletask-python/pull/356/commits/3c6b1c87a4e1a939204be334d2d23cafc1e51c5e
bea1c8e docs: limit the Functions test helper note to generator orchestrators andystaples Nov 16, 2026 https://github.com/microsoft/durabletask-python/pull/356/commits/bea1c8eef4f435790e57b93da11f23da8ed15b4a
Clear filters https://github.com/microsoft/durabletask-python/pull/356/files
Please reload this pagehttps://github.com/microsoft/durabletask-python/pull/356/files
Please reload this pagehttps://github.com/microsoft/durabletask-python/pull/356/files
async-orchestrators.md https://github.com/microsoft/durabletask-python/pull/356/files#diff-4041f5af72d58e9641665b5b94354c8039eedd8ff6b1d3356ae76eecd8a22fcc
features.md https://github.com/microsoft/durabletask-python/pull/356/files#diff-aff15ced1fe37506f41f2e1d93a4d8312529259f7803f8634ffb5eac4de47823
supported-patterns.md https://github.com/microsoft/durabletask-python/pull/356/files#diff-ad1c71a2a02957a84278c89004cad2ce24d6a0f74b97413b72774f4eb20f266f
docs/async-orchestrators.mdhttps://github.com/microsoft/durabletask-python/pull/356/files#diff-4041f5af72d58e9641665b5b94354c8039eedd8ff6b1d3356ae76eecd8a22fcc
View file https://github.com/microsoft/durabletask-python/blob/bea1c8eef4f435790e57b93da11f23da8ed15b4a/docs/async-orchestrators.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/microsoft/durabletask-python/pull/356/{{ revealButtonHref }}
andystapleshttps://github.com/andystaples
Nov 12, 2026https://github.com/microsoft/durabletask-python/pull/356/files#r4557149306
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
Document Python runtime compatibility and safe upgrade guidance for durable orchestrations #337https://github.com/microsoft/durabletask-python/issues/337
Please reload this pagehttps://github.com/microsoft/durabletask-python/pull/356/files
docs/features.mdhttps://github.com/microsoft/durabletask-python/pull/356/files#diff-aff15ced1fe37506f41f2e1d93a4d8312529259f7803f8634ffb5eac4de47823
View file https://github.com/microsoft/durabletask-python/blob/bea1c8eef4f435790e57b93da11f23da8ed15b4a/docs/features.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/microsoft/durabletask-python/pull/356/{{ revealButtonHref }}
https://github.com/microsoft/durabletask-python/pull/356/files#diff-aff15ced1fe37506f41f2e1d93a4d8312529259f7803f8634ffb5eac4de47823
https://github.com/microsoft/durabletask-python/pull/356/files#diff-aff15ced1fe37506f41f2e1d93a4d8312529259f7803f8634ffb5eac4de47823
Please reload this pagehttps://github.com/microsoft/durabletask-python/pull/356/files
Please reload this pagehttps://github.com/microsoft/durabletask-python/pull/356/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.