2.1.0b2 (2026-08-21)

Bugs Fixed

• Restored JSON-string encoding for response-level internal_metadata so resilient response checkpoints round-trip through Foundry storage.
• Restored get_request_context() identity values while stored Responses handlers run inside durable tasks.
• get_history_item_ids on InMemoryResponseProvider and FileResponseStore now keeps the newest item IDs when applying limit. (#48514)

1.0.0b3 (2026-08-21)

Features Added

• FoundryStorage adapter backed by FoundryStateStore — Implements the M365 AsyncStorageBase interface on top of the durable Foundry state store KV layer. Each M365 storage key maps to a per-key FoundryStateStore with user-scoped key isolation. Hosted Activity agents default to FoundryStorage in Foundry containers and MemoryStorage for local development.

Breaking Changes

• Removed the POST /api/messages route alias. Inbound activities are served only at POST /activity/messages, which is the endpoint the Foundry platform routes to. Callers that posted to /api/messages must use /activity/messages.
• Removed public SSE keepalive helper.

Other Changes

• Fixed activity typing and claims test compatibility with M365 SDK 1.4.0. The package now handles the new py.typed marker in microsoft-agents-hosting-core 1.4.0 and the deprecated is_authenticated property.
• Updated FoundryStorage compatibility with microsoft-agents-hosting-core 1.3.0+ (target_cls is now a keyword-only argument in AsyncStorageBase.read).

2.1.0 (2026-08-13)

Features Added

• Model CloudEndpointCreateParametersProperties added property change_enumeration_interval_days
• Model CloudEndpointProperties added property change_enumeration_interval_days
• Model ServerEndpointSyncActivityStatus added property in_progress_large_file_path
• Model ServerEndpointSyncActivityStatus added property in_progress_large_file_percent_complete
• Model ServerEndpointSyncActivityStatus added property in_progress_large_file_size_bytes
• Model ServerEndpointSyncActivityStatus added property is_remaining_final
• Model ServerEndpointSyncActivityStatus added property recent_items_per_second
• Model ServerEndpointSyncActivityStatus added property recent_megabytes_per_second
• Model ServerEndpointSyncActivityStatus added property remaining_delete_count
• Model ServerEndpointSyncActivityStatus added property remaining_directory_count
• Model ServerEndpointSyncActivityStatus added property remaining_file_count
• Model ServerEndpointSyncActivityStatus added property remaining_logical_size_bytes
• Model ServerEndpointSyncActivityStatus added property warning
• Added model CloudEndpointUpdateParameters
• Added model CloudEndpointUpdateProperties
• Added enum ServerEndpointSyncSessionWarningType
• Operation group CloudEndpointsOperations added method begin_update

2.5.0 (2026-08-20)

Dependency update

• Dependency on openai has changed to openai>=3.0.0, which requires httpx2 instead of httpx.
• Support for Python 3.9 was dropped. The new minimum supported Python version is 3.10.

Features Added

• Added stable Agent-to-Agent (A2A) tools A2ATool and A2AToolboxTool, with the new A2AProtocolVersion enum for selecting protocol version 1.0.
• Method .beta.agents.begin_create_optimization_job now returns a custom LRO poller named AgentOptimizationLROPoller. Its details property exposes the created job ID as job_id.
• Method .beta.datasets.begin_create_generation_job now returns a custom LRO poller named DatasetGenerationLROPoller. Its details property exposes the created job ID as job_id.
• Method .beta.evaluators.begin_create_generation_job now returns a custom LRO poller named EvaluatorGenerationLROPoller. Its details property exposes the created job ID as job_id.
• Added the optional read-only state_source property to AgentDetails and the new AgentStateSource enum.
• Added programmatic tool calling through ProgrammaticToolCallingParam and SpecificProgrammaticToolCallingParam, with new ToolType.PROGRAMMATIC_TOOL_CALLING and ToolChoiceParamType.PROGRAMMATIC_TOOL_CALLING enum members.
• Added the optional allowed_callers property to ApplyPatchToolParam, CodeInterpreterTool, CodeInterpreterToolboxTool, CustomToolParam, FunctionShellToolParam, FunctionTool, FunctionToolParam, MCPTool, and MCPToolboxTool. Added the new CallableToolAllowedCaller enum values direct and programmatic.
• Expanded Reasoning with optional mode and context properties. Added ReasoningModeEnum for standard and pro; effort now uses the new ReasoningEffort enum, including the new max effort.

Breaking Changes

All breaking changes are associated with beta features.

• Methods .beta.routines.list and .beta.routines.list_runs replaced the before argument with after and now use the service-provided next_link for continuation.
• Renamed class TaskGenerationDataGenerationJobOptions to SimulationSeedDataGenerationJobOptions. The corresponding DataGenerationJobType.TASK_GENERATION enum member was renamed to DataGenerationJobType.SIMULATION_SEED, and its wire value changed from task_generation to simulation_seed.
• Renamed enum OptimizationDatasetInputType to AgentOptimizationDatasetInputType.
• Renamed class OptimizationAgentIdentifier to OptimizedAgentIdentifier.
• Renamed class OptimizationCandidate to AgentOptimizationCandidate.
• Renamed class OptimizationDatasetCriterion to AgentOptimizationDatasetCriterion.
• Renamed class OptimizationDatasetInput to AgentOptimizationDatasetInput.
• Renamed class OptimizationDatasetItem to AgentOptimizationDatasetItem.
• Renamed class OptimizationEvaluatorRef to AgentOptimizationEvaluatorRef.
• Renamed class OptimizationInlineDatasetInput to AgentOptimizationInlineDatasetInput.
• Renamed class OptimizationJob to AgentOptimizationJob.
• Renamed class OptimizationJobInputs to AgentOptimizationJobInputs.
• Renamed class OptimizationJobListItem to AgentOptimizationJobListItem.
• Renamed class OptimizationJobProgress to AgentOptimizationJobProgress.
• Renamed class OptimizationJobResult to AgentOptimizationJobResult.
• Renamed class OptimizationOptions to AgentOptimizationOptions.
• Renamed class OptimizationReferenceDatasetInput to AgentOptimizationReferenceDatasetInput.

Sample updates

• Added sample_dataset_generation_job_simpleqna_for_finetuning_async.py under samples/datasets/, demonstrating asynchronous generation of a SimpleQnA dataset for fine-tuning.
• Added sample_dataset_generation_job_simpleqna_for_finetuning_with_app_polling.py under samples/datasets/, demonstrating application-managed polling for a SimpleQnA fine-tuning data generation job.
• Added logging samples under samples/logs/:
  • sample_log_all.py demonstrating combined logging for Azure SDK and .get_openai_client() operations.
  • sample_log_from_openai_client.py demonstrating logging for an OpenAI client created from .get_openai_client().
  • sample_log_from_sdk.py demonstrating logging for Azure AI Projects SDK client operations.
  • sample_log_to_console.py demonstrating console logging configuration.
  • sample_log_with_logging_disabled.py demonstrating redacted logging behavior when logging_enable is not enabled.
• Renamed optimization polling samples sample_optimization_job_basic_polling.py and sample_optimization_job_basic_polling_async.py to sample_optimization_job_advanced_app_polling.py and sample_optimization_job_advanced_app_polling_async.py.

0.1.0b6728330 (2026-08-21)

Features Added

• Some feature

Breaking Changes

• Some breaking change

Bugs Fixed

• Some bug fix

Other Changes

• Some other change

1.0.0b3 (2026-08-13)

Features Added

• Model BulkCreateCustomProperties added property min_capacity
• Model BulkCreateCustomProperties added property partial_fulfillment_policy
• Model BulkCreateCustomProperties added property resources
• Model ExecutionParameters added property capacity_recommendation_parameters
• Model ResourceOperationDetails added property capacity_recommendation
• Added model BulkCreateCustomResource
• Added model BulkCreateCustomVirtualMachineInfo
• Added model CapacityRecommendation
• Added model CapacityRecommendationDetails
• Added model CapacityRecommendationParameters
• Added model CapacityRecommendationPlacementScore
• Added model CapacityRecommendationSize
• Added enum CapacityRecommendationStatus
• Added enum PartialFulfillmentMode
• Added model PartialFulfillmentPolicy
• Added enum PartialFulfillmentReason
• Operation group BulkCreateCustomOperations added method virtual_machines_get_operation_status

Breaking Changes

• Renamed enum RecurringScheduledActionsDeadlineType to ScheduledActionsDeadlineType
• Renamed model RecurringScheduledActionsExecutionParameters to ScheduledActionsExecutionParameters
• Renamed enum RecurringScheduledActionsProvisioningState to ScheduledActionsProvisioningState
• Renamed enum RecurringScheduledActionsResourceOperationType to ScheduledActionsResourceOperationType
• Renamed model RecurringScheduledActionsRetryPolicy to ScheduledActionsRetryPolicy
• Renamed enum ResourceProvisioningState to OccurrenceResourceProvisioningState

3.0.0b2 (2026-07-28)

Features Added

• Client ChaosManagementClient added operation group connections
• Model PermissionError added property error_message
• Model ScenarioConfigurationProperties added property resource_targeting
• Model ScenarioRunProperties added property excluded_resources
• Model ScenarioRunProperties added property resource_snapshot_id
• Model ValidationProperties added property excluded_resources
• Model ValidationProperties added property resources
• Model WorkspaceEvaluationProperties added property num_templates_evaluated_cancelled
• Model WorkspaceEvaluationProperties added property num_templates_evaluated_failed
• Model WorkspaceEvaluationProperties added property num_templates_evaluated_succeeded
• Model WorkspaceEvaluationProperties added property num_templates_to_evaluate
• Model WorkspaceEvaluationProperties added property resource_snapshot_id
• Added model Connection
• Added enum ConnectionKind
• Added model ConnectionProperties
• Added enum ConnectionStatus
• Added model ResourceTargeting
• Added model ResourceTargetingCriteria
• Added model TemplateEvaluationResultItem
• Added model WorkspaceDiscovery
• Added model WorkspaceDiscoveryProperties
• Added enum WorkspaceDiscoveryStatus
• Operation group ScenarioConfigurationsOperations added method begin_execute
• Operation group ScenarioRunsOperations added method begin_cancel
• Operation group WorkspacesOperations added method begin_discover
• Operation group WorkspacesOperations added method begin_evaluate
• Added operation group ConnectionsOperations

Breaking Changes

• Model ScenarioConfigurationProperties deleted or renamed its instance variable exclusions
• Model ScenarioConfigurationProperties deleted or renamed its instance variable filters
• Model WorkspaceEvaluationProperties deleted or renamed its instance variable num_scenarios_evaluated_cancelled
• Model WorkspaceEvaluationProperties deleted or renamed its instance variable num_scenarios_evaluated_failed
• Model WorkspaceEvaluationProperties deleted or renamed its instance variable num_scenarios_evaluated_succeeded
• Model WorkspaceEvaluationProperties deleted or renamed its instance variable num_scenarios_to_evaluate
• Deleted or renamed model ConfigurationExclusions
• Deleted or renamed model ConfigurationFilters
• Deleted or renamed model ScenarioEvaluationResultItem
• Deleted or renamed method ScenarioConfigurationsOperations.execute
• Deleted or renamed method ScenarioRunsOperations.cancel
• Deleted or renamed method WorkspacesOperations.begin_refresh_recommendations

1.10.0b1 (2026-08-19)

Features Added

• Added FeatureFlagClient (sync and async) for managing feature flags through a dedicated endpoint (requires API version 2026-05-01-preview or later):
  • Exposes set_feature_flag(), get_feature_flag(), list_feature_flags(), delete_feature_flag(), add_feature_flag(), list_feature_flag_revisions(), and list_labels().
  • FeatureFlagClient is available from azure.appconfiguration (sync) and azure.appconfiguration.aio (async).
  • Added the FeatureFlag model along with FeatureFlagConditions, FeatureFilter, FeatureFlagVariantDefinition, FeatureFlagAllocation, FeatureFlagTelemetryConfiguration, PercentileAllocation, UserAllocation, and GroupAllocation, plus the RequirementType and StatusOverride enums.
  • FeatureFlagClient.list_labels() always lists feature-flag labels, while AzureAppConfigurationClient.list_labels() always lists key-value labels.

Other Changes

• Updated the default service API version to 2026-05-01-preview.

1.0.0 (2026-08-18)

Features Added

• Client ServiceGroupsMgmtClient added operation group operations
• Model ServiceGroupProperties added property attributes
• Added enum ActionType
• Added model Operation
• Added model OperationDisplay
• Added enum Origin
• Added model ServiceGroupAttributes
• Added operation group Operations

Breaking Changes

• Deleted or renamed model ServiceGroupCollectionResponse
• Deleted or renamed method ServiceGroupsOperations.list_ancestors

38.3.0 (2026-08-12)

Features Added

• Client ComputeManagementClient added operation group virtual_machine_diagnostic_run_commands
• Client ComputeManagementClient added operation group virtual_machine_scale_set_vm_diagnostic_run_commands
• Model CapacityReservationInstanceView added property reservation_state_info
• Model CapacityReservationInstanceViewWithName added property reservation_state_info
• Model CapacityReservationProfile added property disable_capacity_reservation_assignment
• Model CapacityReservationUtilization added property used_reserved_count_by_subscription
• Model HardwareProfile added property processor_mode
• Model HostEndpointSettings added property use_local_file_rules
• Model ManagedDiskParameters added property additional_disk_properties
• Enum ReservationType added member OPEN
• Model ScheduleProfile added property minimum_commitment_days
• Model ScheduleProfile added property modifiable_until
• Model StorageProfile added property disk_api_version
• Model VirtualMachineExtensionImageProperties added property extension_feature_metadata
• Model VirtualMachineExtensionImageProperties added property release_category
• Model VirtualMachineExtensionImageProperties added property release_notes
• Model VirtualMachineExtensionImageProperties added property run_profile
• Model VirtualMachineExtensionImageProperties added property urgency_level
• Model VirtualMachineInstanceView added property capacity_reservation_type
• Model VirtualMachineIpTag added property first_party_service_tag_id
• Enum VirtualMachinePriorityTypes added member SPOT_PLUS
• Model VirtualMachineScaleSetHardwareProfile added property processor_mode
• Model VirtualMachineScaleSetIpTag added property first_party_service_tag_id
• Model VirtualMachineScaleSetManagedDiskParameters added property additional_disk_properties
• Model VirtualMachineScaleSetStorageProfile added property disk_api_version
• Model VirtualMachineScaleSetUpdateStorageProfile added property disk_api_version
• Model VirtualMachineScaleSetVMInstanceView added property capacity_reservation_type
• Model VirtualMachineScaleSetVMProperties added property capacity_reservation
• Added model AdditionalDiskProperties
• Added model CapacityReservationStateInfo
• Added enum CapacityReservationType
• Added enum DiskApiVersion
• Added model DiskAvailabilityPolicy
• Added model ExtensionFeatureMetadata
• Added model ExtensionFeatureTag
• Added enum ListVersionsExpandOptions
• Added model MigrateVMAvailabilityZoneInput
• Added enum ProcessorMode
• Added enum ReleaseCategory
• Added enum ReservationState
• Added enum RunProfile
• Added enum UrgencyLevel
• Added model VirtualMachineDiagnosticRunCommand
• Added enum VirtualMachineDiskDelayAction
• Added enum VirtualMachineDiskNetworkAccessPolicy
• Added model VirtualMachineDiskProperties
• Operation group VirtualMachineExtensionImagesOperations added parameter expand in method list_versions
• Operation group VirtualMachineScaleSetsOperations added method begin_migrate_vm_availability_zone
• Added operation group VirtualMachineDiagnosticRunCommandsOperations
• Added operation group VirtualMachineScaleSetVMDiagnosticRunCommandsOperations