github-featured/microsoft--agent-framework
2
0
Fork 0
Code Issues Pull Requests Deployments Models Agent Notes Packages Projects Releases Wiki Activity
Files
main
microsoft--agent-framework/python/PACKAGE_STATUS.md
T
Evan Mattson 4aa737eee5 Python: [BREAKING] Require building functional workflow instances (#7521) 
* Harden functional workflow continuation authority

Use a versioned opaque single-use token on WorkflowRunResult, validate it before request correlation, consume it immediately before replayed user code, and rotate it on each pause. Carry the same explicit authority through streaming and non-streaming FunctionalWorkflowAgent responses.

Files changed: functional workflow/runtime result APIs, functional HITL regression tests, core agent guidance, and the functional HITL sample.

Next iteration: enforce pending-state overlap and token-authorized abandonment, then document and test checkpoint authorization boundaries.

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

* Enforce one pending functional continuation

Reject fresh messages and checkpoint restores while an in-memory continuation is pending. Add token-authorized abandonment on FunctionalWorkflow and FunctionalWorkflowAgent, and clear retained replay state atomically when authority is consumed while preserving the active message for token rotation and checkpoints.

Files changed: functional workflow runtime and agent adapter, functional lifecycle regression tests, and core workflow guidance.

Next iteration: preserve and document authorized checkpoint continuation boundaries.

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

* Preserve authorized functional checkpoint continuation

Treat checkpoint restore as a host- and storage-authorized path independent of process-local continuation tokens, and issue fresh authority whenever restored execution pauses again. Cover default and per-run storage, deterministic and custom request IDs, token rotation, and checkpoint-plus-response restore.

Files changed: functional workflow and checkpoint interface guidance, functional checkpoint lifecycle tests, the functional HITL sample, and core workflow guidance.

Next iteration: run the final repository-wide Python validation gates.

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

* Validate Python continuation hardening

Run the complete Python workspace checks, aggregate coverage suite, repository hooks, and core package build from the final combined worktree. Keep the validation iteration code-neutral because all gates pass without corrective changes.

Files changed: none; this commit records the final validation gate.

Blockers: none. Next iteration: no remaining AFK tasks.

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

* Handle functional checkpoint continuation failures

Publish retained continuation state only after checkpoint persistence succeeds, and cover reuse after a transient save failure.

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

Copilot-Session: a8f47743-1cdc-4924-8e1b-667d0d790b78

* Address functional continuation review findings

Add owner recovery for lost tokens, harden malformed token validation, preserve consistent failure surfaces, and keep agent pending state aligned with resumable workflow state.

Document process-local single-use continuation semantics and extend regression coverage across direct, streaming, checkpoint, and agent paths.

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

Copilot-Session: a8f47743-1cdc-4924-8e1b-667d0d790b78

* Handle functional continuation cancellation

Release the workflow run guard when cancellation interrupts resumed user code while keeping the single-use continuation token consumed.

Replace sample assertions with explicit runtime checks and add cancellation regression coverage.

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

Copilot-Session: a8f47743-1cdc-4924-8e1b-667d0d790b78

* Simplify functional workflow instance isolation

Remove continuation-token handling and align functional workflows with the graph workflow ownership model: one stateful instance per logical caller or session.

Add create_instance() for independent callers, document the ownership contract, and cover pending-state isolation between instances.

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

Copilot-Session: a8f47743-1cdc-4924-8e1b-667d0d790b78

* Scope functional workflow checkpoint storage

Do not inherit checkpoint storage when creating an independent workflow instance. Allow hosts to provide an explicitly caller-scoped storage adapter and document that shared checkpoint access requires host authorization and tenant isolation.

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

Copilot-Session: a8f47743-1cdc-4924-8e1b-667d0d790b78

* Require building functional workflow instances

Make @workflow return a stateless FunctionalWorkflowDefinition and require build() before run() or as_agent(). This aligns functional workflows with the graph definition/build lifecycle and prevents module-level decorated definitions from retaining caller state.

Move checkpoint configuration to build(), export the definition type, migrate samples, and cover isolated built instances.

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

Copilot-Session: a8f47743-1cdc-4924-8e1b-667d0d790b78

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: a8f47743-1cdc-4924-8e1b-667d0d790b78
2026-08-14 00:31:52 +00:00

7.6 KiB
Raw Permalink Blame History

Python Package Status

This file tracks the current lifecycle state of the Python packages in this workspace. Some packages at later stages might have features within them that are not ready yet, these have feature stage decorators on the relevant APIs, and for experimental features warnings are raised. See the Feature-level staged APIs section below for details on which features are in which stage and where to find them.

Status is grouped into these buckets:

  • alpha - initial release and early development packages that are not yet ready for general use
  • beta - prerelease packages that are not currently release candidates
  • rc - release candidate packages, these are close to ready for release but may still have some breaking changes before the final release
  • released - stable packages without a prerelease suffix, these are stable packages that should not have breaking changes between versions
  • deprecated - removed or deprecated packages that should not be used for new work

Current packages

Package Path State
agent-framework python/ released
agent-framework-a2a python/packages/a2a beta
agent-framework-ag-ui python/packages/ag-ui released
agent-framework-anthropic python/packages/anthropic beta
agent-framework-azure-contentunderstanding python/packages/azure-contentunderstanding beta
agent-framework-azure-ai-search python/packages/azure-ai-search beta
agent-framework-azure-cosmos python/packages/azure-cosmos beta
agent-framework-azure-cosmos-memory python/packages/azure-cosmos-memory alpha
agent-framework-bedrock python/packages/bedrock beta
agent-framework-chatkit python/packages/chatkit beta
agent-framework-claude python/packages/claude beta
agent-framework-copilotstudio python/packages/copilotstudio beta
agent-framework-core python/packages/core released
agent-framework-declarative python/packages/declarative released
agent-framework-devui python/packages/devui beta
agent-framework-foundry python/packages/foundry released
agent-framework-foundry-hosting python/packages/foundry_hosting beta
agent-framework-foundry-local python/packages/foundry_local beta
agent-framework-gemini python/packages/gemini beta
agent-framework-github-copilot python/packages/github_copilot released
agent-framework-hosting python/packages/hosting alpha
agent-framework-hosting-a2a python/packages/hosting-a2a alpha
agent-framework-hosting-mcp python/packages/hosting-mcp alpha
agent-framework-hosting-responses python/packages/hosting-responses alpha
agent-framework-hosting-telegram python/packages/hosting-telegram alpha
agent-framework-hyperlight python/packages/hyperlight beta
agent-framework-lab python/packages/lab beta
agent-framework-mem0 python/packages/mem0 beta
agent-framework-mistral python/packages/mistral beta
agent-framework-monty python/packages/monty beta
agent-framework-ollama python/packages/ollama beta
agent-framework-openai python/packages/openai released
agent-framework-orchestrations python/packages/orchestrations released
agent-framework-purview python/packages/purview beta
agent-framework-redis python/packages/redis beta
agent-framework-tools python/packages/tools beta

Deprecated / removed packages

Package Previous path State Notes
agent-framework-azure-ai python/packages/azure-ai deprecated The client classes within the azure-ai package were renamed, sometimes changed, and moved to agent-framework-foundry.

Feature-level staged APIs

The following feature IDs have explicit feature-stage decorators on public APIs in the packages listed below.

Experimental features

AGENT_HOOKS

  • agent-framework-core: create_agent_hooks_middleware and create_agent_hooks_middleware_from_emitter from agent_framework/_agent_hooks.py, the AGENT-HOOKS-0.1 enforcement middleware bundle, and the MiddlewareBundle container from agent_framework/_middleware.py that both factories produce (MiddlewareBundle itself needs no extra). Requires the opt-in agent-framework-core[agent-hooks] extra (agent-hooks-sdk), which is deliberately not part of agent-framework-core[all]. Known limitation: service-side (hosted) tool execution never passes through the framework's function-invocation seam, so the pre_tool_call/post_tool_call points cannot intercept it; hosted tool calls and outputs are surfaced in the post_model_call content projection instead.

DECLARATIVE_AGENTS

  • agent-framework-declarative: declarative agent loading APIs from agent_framework_declarative, including AgentFactory, DeclarativeLoaderError, ProviderLookupError, and ProviderTypeMapping from agent_framework_declarative/_loader.py

EVALS

  • agent-framework-core: exported evaluation APIs from agent_framework, including LocalEvaluator, evaluate_agent, evaluate_workflow, and the related evaluation types and helper checks defined in agent_framework/_evaluation.py
  • agent-framework-foundry: FoundryEvals, evaluate_traces, and evaluate_foundry_target

FILE_HISTORY

  • agent-framework-core: FileHistoryProvider from agent_framework/_sessions.py

FIDES

  • agent-framework-core: security labeling, content indirection, policy enforcement, and secure MCP APIs from agent_framework/security.py, including IntegrityLabel, ConfidentialityLabel, ContentLabel, ContentVariableStore, SecureAgentConfig, and SecureMCPToolProxy

FOUNDRY_TOOLS

  • agent-framework-foundry: released-service tool helpers on FoundryChatClient, currently get_bing_grounding_tool and get_azure_ai_search_tool

FOUNDRY_PREVIEW_TOOLS

  • agent-framework-foundry: preview-service tool helpers on FoundryChatClient, including Bing Custom Search, SharePoint, Fabric, Memory Search, Computer Use, Browser Automation, and A2A

FUNCTIONAL_WORKFLOWS

  • agent-framework-core: functional workflow APIs from agent_framework/_workflows/_functional.py, including RunContext, step, FunctionalWorkflowDefinition, FunctionalWorkflow, workflow, and FunctionalWorkflowAgent

HARNESS

  • agent-framework-core: experimental harness APIs for background agents, file access, looping, memory, and file-backed todo storage under agent_framework/_harness/

MCP_LONG_RUNNING_TASKS

  • agent-framework-core: MCPTaskOptions from agent_framework/_mcp.py

MCP_SKILLS

  • agent-framework-core: MCPSkillResource, MCPSkill, and MCPSkillsSource from agent_framework/_skills.py

PROGRESSIVE_TOOLS

  • agent-framework-core: FunctionInvocationContext.add_tools and FunctionInvocationContext.remove_tools from agent_framework/_middleware.py

SESSION_STORE

  • agent-framework-core: SessionStore and FileSessionStore from agent_framework/_sessions.py
  • agent-framework-foundry-hosting: FoundryAgentSessionStore from agent_framework_foundry_hosting/_state_store.py

TO_PROMPT_AGENT

  • agent-framework-foundry: to_prompt_agent from agent_framework_foundry/_to_prompt_agent.py

Release-candidate features

There are currently no feature-level rc APIs.

Reference in New Issue View Git Blame Copy Permalink