Skip to content

docs: ADR-0032 — propose durable/Azure Functions repo extraction#7247

Open
cgillum wants to merge 4 commits into
mainfrom
adr-0032-durable-extraction
Open

docs: ADR-0032 — propose durable/Azure Functions repo extraction#7247
cgillum wants to merge 4 commits into
mainfrom
adr-0032-durable-extraction

Conversation

@cgillum

@cgillum cgillum commented Jul 21, 2026

Copy link
Copy Markdown
Member

Summary

Adds ADR-0032 (status: proposed) proposing that the Durable Task and Azure Functions hosting integrations (agent-framework-durabletask, agent-framework-azurefunctions) be extracted from this monorepo into a dedicated repository, microsoft/agent-framework-durable-extension.

This PR contains only the ADR — no code is moved or removed. Its purpose is to get independent stakeholder signoff on the direction before a follow-up PR performs the actual extraction/removal.

What the ADR proposes

  • Extract the integrations for independent release cadence, dependency & CI isolation, and clear ownership.
  • Preserve backward compatibility (Option 3): keep core's lazy agent_framework.azure re-export shim and both packages in the [all] extra, so existing imports and pip install agent-framework[all] keep working — the move is invisible to consumers.
  • Documents the resulting cross-repo coupling (shim publish-cadence + the .NET InternalsVisibleTo grant) as a known trade-off.

Proposes extracting the Durable Task and Azure Functions hosting integrations into a dedicated repository (microsoft/agent-framework-durable-extension), keeping a backward-compatible shim and the [all] extra so the move is invisible to consumers. Status: proposed, for stakeholder signoff ahead of the code-removal PR.

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

Copilot-Session: 6181dcf9-857b-43ea-9fd2-fcd6b175ffdd
Copilot AI review requested due to automatic review settings July 21, 2026 21:39
@giles17 giles17 added the documentation Usage: [Issues, PRs], Target: documentation in the code base and learn docs label Jul 21, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated Code Review

Reviewers: 5 | Confidence: 76% | Result: All clear

Reviewed: Correctness, Security Reliability, Test Coverage, Failure Modes, Design Approach


Automated review by cgillum's agents

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a proposed architectural decision record (ADR-0032) describing a plan to extract the Durable Task and Azure Functions hosting integrations into a dedicated repository while preserving backward compatibility via the existing agent_framework.azure shim.

Changes:

  • Introduces ADR-0032 (status: proposed) outlining motivations, options, and the recommended extraction approach (Option 3).
  • Documents expected compatibility strategy (lazy re-export shim + [all] extra) and known trade-offs (cross-repo coupling).
  • Specifies validation expectations and highlights publish-cadence risk for shim symbols.

Comment thread docs/decisions/0032-durable-azure-functions-extraction.md Outdated
Comment thread docs/decisions/0032-durable-azure-functions-extraction.md Outdated
cgillum added 2 commits July 21, 2026 14:46
Replace the WorkflowHitlContext-specific illustration with a generic description of the publish-lag mechanism. The named symbol is currently exported by the extension and present in core's shim, so using it as an 'unpublished' example read as internally inconsistent.

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

Copilot-Session: 6181dcf9-857b-43ea-9fd2-fcd6b175ffdd
@cgillum
cgillum marked this pull request as ready for review July 21, 2026 21:58

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated Code Review

Reviewers: 5 | Confidence: 85% | Result: All clear

Reviewed: Correctness, Security Reliability, Test Coverage, Failure Modes, Design Approach


Automated review by cgillum's agents

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Usage: [Issues, PRs], Target: documentation in the code base and learn docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants