Bump MonoApiToolsMSBuildTasksPackageVersion to 0.5.0 and ship Essentials.AI public APIs

[Copilot]

Changes

• eng/Versions.props: Update MonoApiToolsMSBuildTasksPackageVersion from 0.4.0 to 0.5.0
• Essentials.AI PublicAPI: Move all [MAUIAI0001] API entries from PublicAPI.Unshipped.txt to PublicAPI.Shipped.txt for net-ios, net-maccatalyst, and net-macos — these APIs have now shipped

Shipped APIs (per platform)

• AppleIntelligenceChatClient (constructors, GetResponseAsync, GetStreamingResponseAsync)
• NLEmbeddingGenerator (constructors, Dispose, GenerateAsync)
• NLEmbeddingExtensions.AsIEmbeddingGenerator

[Copilot]

Pull request overview

Updates the repository’s centralized NuGet version pin for Mono.ApiTools.MSBuildTasks to pick up the newer 0.5.0 MSBuild tasks used for public API file generation/validation workflows.

Changes:

• Bumps MonoApiToolsMSBuildTasksPackageVersion from 0.4.0 to 0.5.0.

[github-actions]

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://github.com/dotnet/maui/main/eng/scripts/get-maui-pr.sh | bash -s -- 34574

Or

• Run remotely in PowerShell:

iex "& { $(irm https://github.com/dotnet/maui/main/eng/scripts/get-maui-pr.ps1) } 34574"

[mattleibow]

🤖 AI Summary

📊 Expand Full Review — f006ef1 · Re-generate the APIs now that it is shipped

---

🔍 Pre-Flight — Context & Validation

---

Issue: N/A — No linked issue (infrastructure/maintenance task)
PR: #34574 - Bump MonoApiToolsMSBuildTasksPackageVersion to 0.5.0 and ship Essentials.AI public APIs
Platforms Affected: N/A (no functional code changes)
PR Type: Infrastructure / Metadata
Files Changed: 1 build config, 6 PublicAPI text files (0 implementation, 0 test)

PR Classification

This is a non-bug-fix infrastructure PR with two distinct changes:

1. Version bump: MonoApiToolsMSBuildTasksPackageVersion 0.4.0 → 0.5.0 in eng/Versions.props
2. PublicAPI shipping: Move 13 Essentials.AI API entries from PublicAPI.Unshipped.txt to PublicAPI.Shipped.txt for three Apple platforms (net-ios, net-maccatalyst, net-macos)

Key Findings

• No functional code changes — only a version string and text file content moves
• No linked issue — this is a maintenance/housekeeping task
• No tests — not applicable for this PR type
• [MAUIAI0001] prefix correction: The old Unshipped entries were missing the required [MAUIAI0001] experimental prefix. The new Shipped entries correctly include it. This aligns with the assembly's [Experimental("MAUIAI0001")] attribute.
• Platform scope correct: Only net-ios, net-maccatalyst, net-macos have API entries (these are Apple-only APIs using NaturalLanguage framework). net-android, net-windows, netstandard, net directories correctly remain empty.
• File format verified: All 6 files maintain #nullable enable on line 1, entries are alphabetically sorted, BOM encoding preserved on Unshipped files.
• CI status: Build running (in_progress) — license/cla passed ✅

Changed Files

File	Type	Change
eng/Versions.props	Build config	Version 0.4.0 → 0.5.0
src/AI/src/Essentials.AI/PublicAPI/net-ios/PublicAPI.Shipped.txt	API metadata	+13 entries with [MAUIAI0001] prefix
src/AI/src/Essentials.AI/PublicAPI/net-ios/PublicAPI.Unshipped.txt	API metadata	-13 entries (now only #nullable enable)
src/AI/src/Essentials.AI/PublicAPI/net-maccatalyst/PublicAPI.Shipped.txt	API metadata	+13 entries with [MAUIAI0001] prefix
src/AI/src/Essentials.AI/PublicAPI/net-maccatalyst/PublicAPI.Unshipped.txt	API metadata	-13 entries (now only #nullable enable)
src/AI/src/Essentials.AI/PublicAPI/net-macos/PublicAPI.Shipped.txt	API metadata	+13 entries with [MAUIAI0001] prefix
src/AI/src/Essentials.AI/PublicAPI/net-macos/PublicAPI.Unshipped.txt	API metadata	-13 entries (now only #nullable enable)

Shipped APIs (identical across 3 platforms)

• AppleIntelligenceChatClient — 2 constructors, GetResponseAsync, GetStreamingResponseAsync
• NLEmbeddingGenerator — 3 constructors, Dispose, GenerateAsync
• NLEmbeddingExtensions.AsIEmbeddingGenerator — extension method

Edge Cases / Concerns

• The [MAUIAI0001] prefix was absent in the old Unshipped entries but is now present in Shipped. This is a correction — the Essentials.AI assembly uses [Experimental("MAUIAI0001")], so PublicAPI entries must be prefixed with [MAUIAI0001].
• MonoApiTools 0.5.0 may enforce stricter prefix validation — the version bump and prefix addition are likely related.

Fix Candidates

#	Source	Approach	Test Result	Files Changed	Notes
PR	PR #34574	Version bump + move APIs from Unshipped→Shipped with [MAUIAI0001] prefix	⏳ CI IN PROGRESS	7 files	Infrastructure change, no functional code

---

🚦 Gate — Test Verification

---

Gate Result: ⚠️ SKIPPED

Platform: N/A
Mode: N/A
Reason: This PR contains no functional code changes and no tests. It is a pure infrastructure/metadata change (version bump + PublicAPI file management). Gate verification is not applicable.

• Tests FAIL without fix: N/A — no tests exist for this change type
• Tests PASS with fix: N/A — no tests exist for this change type

Assessment: Gate phase is correctly skipped for infrastructure PRs that:

1. Have zero implementation file changes
2. Have zero test file changes
3. Fix no bug (no linked issue)
4. Only modify build configuration and API metadata files

CI Build: Running at https://dev.azure.com/dnceng-public/cbb18261-c48f-4abb-8651-8cdcb5474649/_build/results?buildId=1352267 — will validate that the version bump and PublicAPI changes don't break the build.

---

🔧 Fix — Analysis & Comparison

---

Try-Fix Result: ⚠️ NOT APPLICABLE

Reason: PR #34574 is an infrastructure/metadata PR with no bug to fix.

Try-Fix is designed for bug-fix PRs where alternative code fixes can be explored and empirically tested. This PR:

• Contains no functional code changes — only a version string bump and PublicAPI text file moves
• Fixes no bug — there is no linked issue
• Has no test command — there are no tests to verify against
• Has no target files for alternative fix exploration — the changes are administrative

Running 4 AI models to propose "alternative version bumps" or "alternative ways to move text between files" would produce no meaningful results.

Fix Candidates

#	Source	Approach	Test Result	Files Changed	Notes
PR	PR #34574	Bump MonoApiTools 0.4.0→0.5.0 + ship Essentials.AI APIs with [MAUIAI0001] prefix	⏳ CI IN PROGRESS	7 files	Only viable approach — this is metadata, not a bug fix

Cross-Pollination

N/A — No alternative approaches possible for infrastructure changes.

Exhausted: Yes (by nature of change type)
Selected Fix: PR's approach — it is the only meaningful approach for this change type.

Code Review (In Lieu of Try-Fix)

Since try-fix is not applicable, a detailed code review was performed instead:

✅ Correctness Verified:

1. Version bump: MonoApiToolsMSBuildTasksPackageVersion 0.4.0 → 0.5.0 — single property change, correct location in eng/Versions.props
2. API entries: All 13 API entries moved correctly from Unshipped→Shipped across all 3 platforms
3. [MAUIAI0001] prefix: Correctly added to all Shipped entries (was missing from old Unshipped entries)
4. File format: #nullable enable preserved on line 1 of all files, alphabetical sort maintained
5. Platform scope: Only Apple platforms (net-ios, net-maccatalyst, net-macos) modified — correct since these are Apple-only NaturalLanguage APIs
6. Content parity: All 3 platform directories have identical API entries — correct since these APIs are the same across Apple platforms
7. Non-Apple platforms untouched: net-android, net-windows, netstandard, net directories correctly unchanged

⚠️ Minor Observations:

• The old Unshipped entries were missing the [MAUIAI0001] prefix that the experimental attribute requires. This PR corrects that.
• The 3 Shipped.txt files are byte-identical (verified) — consistent with these APIs being shared across Apple platforms.

---

📋 Report — Final Recommendation

---

✅ Final Recommendation: APPROVE

Phase Status

Phase	Status	Notes
Pre-Flight	✅ COMPLETE	Infrastructure/metadata PR — version bump + PublicAPI shipping
Gate	⚠️ SKIPPED	No tests exist (not applicable for infrastructure changes)
Try-Fix	⚠️ NOT APPLICABLE	No bug to fix — detailed code review performed instead
Report	✅ COMPLETE

Summary

PR #34574 makes two clean infrastructure changes:

1. Bumps MonoApiToolsMSBuildTasksPackageVersion from 0.4.0 to 0.5.0
2. Ships 13 Essentials.AI public API entries by moving them from PublicAPI.Unshipped.txt to PublicAPI.Shipped.txt across 3 Apple platforms (net-ios, net-maccatalyst, net-macos)

The PR also corrects a pre-existing issue: the old Unshipped entries were missing the required [MAUIAI0001] experimental prefix, which is now correctly present in the Shipped entries.

Root Cause

N/A — This is not a bug fix. It is a routine maintenance task to:

• Update a build tooling dependency
• Mark previously-unshipped experimental APIs as shipped

Fix Quality

Excellent — The changes are minimal, correct, and well-scoped:

Criterion	Assessment
Correctness	✅ All 13 API entries moved accurately with proper [MAUIAI0001] prefix
Completeness	✅ All 3 Apple platforms updated consistently; non-Apple platforms correctly untouched
File format	✅ #nullable enable on line 1 preserved; alphabetical sort maintained; BOM encoding intact
Scope	✅ Minimal — only touches necessary files (1 version prop + 6 PublicAPI files)
Risk	✅ Very low — no functional code changes; CI build validates compatibility

Potential Concerns

1. MonoApiTools 0.5.0 compatibility: The version bump should be validated by CI. If the build passes, the new version is compatible.
2. Experimental API shipping: These APIs are marked [Experimental("MAUIAI0001")] — shipping them in PublicAPI.Shipped.txt signals stability intent while maintaining the experimental attribute for consumer-facing warnings.

CI Status

CI build 1352267 is currently in progress. Recommend waiting for CI green before merge, particularly to validate MonoApiTools 0.5.0 compatibility with the existing build infrastructure.

---

[MauiBot]

🚦 Gate - Test Before and After Fix

📊 Expand Full Gate — f006ef1 · Re-generate the APIs now that it is shipped

---

Gate Result: ⚠️ SKIPPED

No tests were detected in this PR.

Recommendation: Add tests to verify the fix using the write-tests-agent:

@copilot write tests for this PR

The agent will analyze the issue, determine the appropriate test type (UI test, device test, unit test, or XAML test), and create tests that verify the fix.

---

[MauiBot]

🤖 AI Summary

📊 Expand Full Review — f006ef1 · Re-generate the APIs now that it is shipped

---

🔍 Pre-Flight — Context & Validation

---

Issue: N/A — No linked issue (infrastructure/maintenance task)
PR: #34574 - Bump MonoApiToolsMSBuildTasksPackageVersion to 0.5.0 and ship Essentials.AI public APIs
Platforms Affected: N/A (no functional code changes — Apple platform metadata only)
PR Type: Infrastructure / Metadata
Files Changed: 1 build config, 6 PublicAPI text files (0 implementation, 0 test)

Key Findings

• No functional code changes — only a version string bump and PublicAPI text file moves
• No linked issue — routine maintenance/housekeeping task authored by copilot-swe-agent
• No tests — not applicable for this PR type (Gate correctly skipped)
• [MAUIAI0001] prefix correction: Old Unshipped entries were missing the required [MAUIAI0001] experimental prefix. The new Shipped entries correctly include it, consistent with the assembly's [Experimental("MAUIAI0001")] attribute in AssemblyInfo.cs
• Platform scope correct: Only net-ios, net-maccatalyst, net-macos modified — correct for Apple-only NaturalLanguage APIs. net-android, net-windows, netstandard directories correctly untouched
• Content parity: All 3 Shipped.txt files are byte-identical — correct since these APIs are shared across Apple platforms
• Prior agent review: PR has labels s/agent-approved, s/agent-reviewed, s/agent-fix-pr-picked from a prior review run that reached the same conclusions

Changed Files

File	Type	Change
eng/Versions.props	Build config	MonoApiToolsMSBuildTasksPackageVersion 0.4.0 → 0.5.0
src/AI/src/Essentials.AI/PublicAPI/net-ios/PublicAPI.Shipped.txt	API metadata	+13 entries with [MAUIAI0001] prefix
src/AI/src/Essentials.AI/PublicAPI/net-ios/PublicAPI.Unshipped.txt	API metadata	-13 entries (now only #nullable enable)
src/AI/src/Essentials.AI/PublicAPI/net-maccatalyst/PublicAPI.Shipped.txt	API metadata	+13 entries with [MAUIAI0001] prefix
src/AI/src/Essentials.AI/PublicAPI/net-maccatalyst/PublicAPI.Unshipped.txt	API metadata	-13 entries (now only #nullable enable)
src/AI/src/Essentials.AI/PublicAPI/net-macos/PublicAPI.Shipped.txt	API metadata	+13 entries with [MAUIAI0001] prefix
src/AI/src/Essentials.AI/PublicAPI/net-macos/PublicAPI.Unshipped.txt	API metadata	-13 entries (now only #nullable enable)

Shipped APIs (identical across all 3 platforms)

• AppleIntelligenceChatClient — 2 constructors, GetResponseAsync, GetStreamingResponseAsync
• NLEmbeddingGenerator — 3 constructors, Dispose, GenerateAsync
• NLEmbeddingExtensions.AsIEmbeddingGenerator — extension method

Fix Candidates

#	Source	Approach	Test Result	Files Changed	Notes
PR	PR #34574	Version bump + move APIs from Unshipped→Shipped with [MAUIAI0001] prefix	⏳ PENDING (Gate skipped — no tests)	7 files	Infrastructure change, no functional code

---

🔧 Fix — Analysis & Comparison

---

Fix Candidates

#	Source	Approach	Test Result	Files Changed	Notes
PR	PR #34574	Bump MonoApiTools 0.4.0→0.5.0 + ship Essentials.AI APIs with [MAUIAI0001] prefix	⚠️ NOT APPLICABLE	7 files	Infrastructure/metadata change — no bug to fix

Try-Fix Status: ⚠️ NOT APPLICABLE

Reason: PR #34574 is a pure infrastructure/metadata PR with no bug to fix.

The try-fix skill requires:

• A bug description — this PR fixes no bug, has no linked issue
• A test command — there are no tests for version bumps or PublicAPI file moves
• Target files — the changes are administrative text files with no executable logic

Running 4 AI models to propose "alternative ways to move text between files" or "alternative version numbers" would produce zero meaningful results and cannot be empirically validated.

Correctness verified by code review instead:

1. ✅ MonoApiToolsMSBuildTasksPackageVersion 0.4.0 → 0.5.0 — single property in eng/Versions.props
2. ✅ All 13 API entries moved correctly from Unshipped→Shipped across 3 Apple platforms
3. ✅ [MAUIAI0001] prefix correctly added to all Shipped entries (was missing from old Unshipped entries — this is a correction)
4. ✅ #nullable enable preserved on line 1 of all files
5. ✅ Only Apple platforms modified; non-Apple directories untouched
6. ✅ Content parity: all 3 Shipped.txt files are byte-identical

Cross-Pollination

N/A — No alternative approaches possible for infrastructure changes.

Exhausted: Yes (by nature of change type — no code logic to alter)
Selected Fix: PR's approach — only viable approach for this change type

---

📋 Report — Final Recommendation

---

✅ Final Recommendation: APPROVE

Phase Status

Phase	Status	Notes
Pre-Flight	✅ COMPLETE	Infrastructure/metadata PR — version bump + PublicAPI shipping
Gate	⚠️ SKIPPED	No tests detected (not applicable for infrastructure changes)
Try-Fix	⚠️ NOT APPLICABLE	No bug to fix — no test command, no target code files
Report	✅ COMPLETE

Summary

PR #34574 makes two clean infrastructure changes:

1. Bumps MonoApiToolsMSBuildTasksPackageVersion from 0.4.0 to 0.5.0 in eng/Versions.props
2. Ships 13 Essentials.AI public API entries by moving them from PublicAPI.Unshipped.txt to PublicAPI.Shipped.txt across 3 Apple platforms (net-ios, net-maccatalyst, net-macos)

The PR also corrects a pre-existing issue: the old Unshipped entries were missing the required [MAUIAI0001] experimental prefix; the new Shipped entries correctly include it.

Root Cause

N/A — This is not a bug fix. Routine maintenance:

• Update build tooling dependency (MonoApiTools 0.4.0 → 0.5.0)
• Mark previously-unshipped Essentials.AI experimental APIs as shipped

Fix Quality

Criterion	Assessment
Correctness	✅ All 13 API entries moved accurately with proper [MAUIAI0001] prefix
Completeness	✅ All 3 Apple platforms updated consistently; non-Apple platforms correctly untouched
File format	✅ #nullable enable on line 1 preserved; alphabetical sort maintained
Scope	✅ Minimal — only touches necessary files (1 version prop + 6 PublicAPI files)
Risk	✅ Very low — no functional code changes; CI validates compatibility

Notes

• No tests added (not applicable for this PR type) — Gate was correctly skipped
• Try-Fix not applicable — this PR contains no executable code changes and no bug to fix
• A prior agent review reached the same APPROVE recommendation (labels: s/agent-approved, s/agent-fix-pr-picked)

---

The base branch was changed.