Regenerate Azure AI Projects client

[Mike Guo (guotuofeng)]

Description

Bottom of the active three-PR stack. Regenerates azure-ai-projects from Azure/azure-rest-api-specs commit 96dc35d7b34f57fafb8fea1f636f9c3072a7042b and keeps generation customization, metadata, the TypeSpec pin, changelog, and Projects build configuration together.

The Projects refresh at e1acd6b5031 updates the previous spec pin and metadata crossLanguageVersion from 65a4180171bb to 11c315e3a4e7. Regeneration with Java emitter 0.47.0 produced no Java source or public API changes relative to the previous PR head. EOL/blank-line-only regeneration changes were removed before committing.

Latest RevApi Fix

Commit 92ccfe2307e:

• Adds the Projects equivalent of Release azure-ai-agents and azure-ai-projects 2.6.0 #50426's RevApi POM configuration: appends revapi.filter to the inherited filter allowlist, retaining the existing package filter.
• Enables the shared configuration's existing Projects @Beta API exclusions.
• Removes the entire SDK-local revapi-suppressions.json file.
• Changes Projects build configuration only; no SDK Java source or TypeSpec pin changes.

Stack

1. This PR: Projects generated foundation, based on main, at 92ccfe2307e.
2. Regenerate Azure AI Agents client #50412: Agents generated foundation, based on this PR, at ce726ac73fc.
3. Add voice agent WebSocket transport, tests, samples, and AI Projects parity #50408: Handwritten WebSocket transport, AI Projects parity improvements, tests, samples, and documentation, based on Regenerate Azure AI Agents client #50412, at 14d246c723b.

The latest Projects fix was normal-pushed only to this branch. Agents and Core branches were deliberately left untouched per the requested Projects-only scope; propagation of this commit into the upper branch histories is pending. Stack PR bases remain unchanged.

On 2026-09-15, all three branches were previously rebased onto main at d269069710b7ca939c95dc880e0044e537fa9b97 with explicit user authorization to rewrite history. The original merge topology and merge resolutions were preserved. All 19 non-merge patches across the stack at that point were unchanged according to range-diff; each branch tree exactly equaled its pre-rebase tree plus the new upstream changes. All three branches were published atomically with explicit force-with-lease guards against their old remote tips. Subsequent updates were normal pushes.

The Agents beta-annotation CSV update and builder simplifications remain in the upper layers. The tests and samples previously split into #50409 and #50410 are included in #50408, not separate active layers.

Latest Local Validation

Independent Projects foundation validation for 92ccfe2307e:

• Clean Maven package: 103 tests total, 79 passed, 24 skipped, zero failures or errors.
• Main, test, and sample sources compiled.
• Checkstyle passed with zero violations.
• Strict RevApi against the official Projects 2.5.0 artifact passed with no SDK-local suppression file.
• The final diff passed the Git whitespace check.

Baseline provenance: the locally cached Projects 2.5.0 JAR did not match Maven Central. It was backed up and replaced with the official artifact, verified against Central's SHA-1 7b3cdadba896d429186f2a78b2aaf28e770c3aee, before the successful validation above. Earlier Projects compatibility results using the mismatched artifact are not reliable. Because both the baseline and filter changed, the removal of every suppression cannot be attributed solely to enabling the filter.

Agents was not modified or tested in this step. No live-service, Javadoc, enabled SpotBugs, or regeneration run was performed for this build-configuration fix. These are local results, not a statement that current CI or merge requirements are complete; see the PR checks for current CI status.

Earlier Validation

Post-rebase validation on the combined Core tree at 1f8bdd1b852:

• Clean Projects package: 148 tests total, 124 passed, 24 skipped, zero failures or errors.
• Clean Agents package: 463 tests total, 437 passed, 26 skipped, zero failures or errors.
• Both packages passed Checkstyle with zero violations.
• Historical Projects RevApi success is superseded by the verified official-baseline result above.
• The lower foundation trees were verified exactly against their pre-rebase trees plus upstream changes; their independent test suites were not rerun during that rebase.

Earlier Projects regeneration validation:

• tsp-client update --no-prompt completed with Java emitter 0.47.0.
• A clean Maven package build compiled main, test, and sample sources, including the Java 8 baseline executions.
• All 36 focused tests passed: FoundryFeaturesHeaderVerificationTest, AzureAIAgentTargetToolsTest, RecurrenceTriggerSerializationTest, and WeeklyRecurrenceScheduleSerializationTest.
• Checkstyle passed with zero violations. Generation reported npm dependency-audit warnings.

All SDK Contribution checklist

• The pull request does not introduce breaking changes. Intentional preview API changes from the earlier foundation are documented in CHANGELOG.md; strict RevApi now passes with the existing shared beta exclusions enabled and without SDK-local suppressions. The latest POM change adds no Java API changes.
• CHANGELOG is updated for significant changes.
• I have read the contribution guidelines.

General Guidelines and Best Practices

• Title is clear and informative.
• Changes are limited to the Projects generated foundation.

Testing Guidelines

• Latest regeneration preserved Java sources and compiled independently.
• Independent foundation tests and strict API compatibility checks passed for the latest build-configuration fix.

[Copilot]

🟡 Changes recommended

Unresolved metadata, preview annotation, changelog, compatibility-note, and whitespace updates remain.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Regenerates the azure-ai-projects client from the updated Foundry TypeSpec while preserving compatibility customizations and API metadata.

Changes:

• Updates generated clients, implementations, and data-generation models.
• Adds target, trace, insight, and output-write-mode APIs.
• Refreshes customizations, metadata, RevApi acknowledgements, and release notes.

File summaries

File	Summary
sdk/ai/azure-ai-projects/tsp-location.yaml	Pins the updated TypeSpec source and directories.
sdk/ai/azure-ai-projects/src/main/resources/META-INF/azure-ai-projects_metadata.json	Updates generated package and cross-language metadata.
sdk/ai/azure-ai-projects/src/main/resources/META-INF/azure-ai-projects_apiview_properties.json	Refreshes APIView metadata.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/TracesDataGenerationJobSource.java	Adds the trace data-generation source model.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/TracesDataGenerationJobOptions.java	Adds trace data-generation options.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/ToolUseFineTuningDataGenerationJobOptions.java	Adds tool-use fine-tuning options.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/SimulationSeedDataGenerationJobOptions.java	Adds simulation-seed data-generation options.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/SimpleQnADataGenerationJobOptions.java	Adds simple Q&A data-generation options.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/FoundryEvaluationTarget.java	Adds the Foundry evaluation target model.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/DataGenerationJobOutputWriteMode.java	Adds output write-mode support.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/DataGenerationJobOutputOptions.java	Updates data-generation output configuration.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/DataGenerationJobOptions.java	Updates data-generation job options.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/AzureAIModelTarget.java	Updates the Azure AI model target.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/AzureAIAgentTarget.java	Updates the Azure AI agent target.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/AgentTaxonomyInput.java	Updates agent taxonomy input.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/models/AgentInsightHighlightedTrace.java	Updates highlighted trace insights.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/BetaDatasetsImpl.java	Regenerates datasets implementation plumbing.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/implementation/BetaAgentInsightMonitorsImpl.java	Regenerates agent insight monitor implementation plumbing.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaSkillsClient.java	Regenerates the synchronous skills client.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaSkillsAsyncClient.java	Regenerates the asynchronous skills client.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaRoutinesClient.java	Updates the synchronous routines client and overloads.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaRoutinesAsyncClient.java	Updates the asynchronous routines client and overloads.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaDatasetsClient.java	Regenerates the synchronous datasets client.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaDatasetsAsyncClient.java	Regenerates the asynchronous datasets client.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaAgentInsightMonitorsClient.java	Regenerates the synchronous agent insight monitors client.
sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaAgentInsightMonitorsAsyncClient.java	Regenerates the asynchronous agent insight monitors client.
sdk/ai/azure-ai-projects/revapi.json	Acknowledges intentional preview API changes.
sdk/ai/azure-ai-projects/customizations/src/main/java/ProjectsCustomizations.java	Preserves compatibility overloads and helper renaming.
sdk/ai/azure-ai-projects/CHANGELOG.md	Documents the regenerated API changes.

Review details

Suppressed comments (3)

sdk/ai/azure-ai-projects/CHANGELOG.md:11

• The top release notes omit two user-facing changes in this regeneration: the new DataGenerationJobOutputOptions.writeMode/DataGenerationJobOutputWriteMode API and the Target to FoundryEvaluationTarget rename (the latter is acknowledged in revapi.json). Please add a feature entry and a breaking-change entry so the changelog matches the generated API.

- Moved `maxSamples` from `DataGenerationJobOptions` to supported scenario-specific models. `SimulationSeedDataGenerationJobOptions` no longer accepts it, while `TracesDataGenerationJobOptions` now has a no-argument constructor and optional `Integer` value configured through `setMaxSamples(...)`.

sdk/ai/azure-ai-projects/src/main/java/com/azure/ai/projects/BetaRoutinesClient.java:757

• This compatibility overload keeps the previous five-argument routine API, but the 2.5.0 changelog says the methods now require the new authorization parameter. Update the release note to explain that the six-argument overload adds authorization while the five-argument overload remains available.

    public Routine createOrUpdateRoutine(String routineName, String description, Boolean enabled,
        Map<String, RoutineTrigger> triggers, RoutineAction action) {
        return createOrUpdateRoutine(routineName, description, enabled, triggers, action, null);

sdk/ai/azure-ai-projects/tsp-location.yaml:4

• This added trailing space after additionalDirectories: is picked up by repository whitespace checks and differs from the neighboring tsp-location.yaml format. Remove the trailing space.

additionalDirectories: 

• Files reviewed: 28/29 changed files
• Comments generated: 2
• Review effort level: Lite

---

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

[azure-pipelines]

Azure Pipelines:
Successfully started running 279 pipeline(s).
35 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

[azure-pipelines]

Azure Pipelines:
Successfully started running 279 pipeline(s).
35 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

[Mike Guo (guotuofeng)]

Stack sync completed on 2026-09-15. This supersedes the description's note that propagation of the Projects Revapi fix was pending.

• Regenerate Azure AI Projects client #50407 Projects remains unchanged at 92ccfe2307e.
• Regenerate Azure AI Agents client #50412 Agents now includes that Projects tip through merge 2ca57f2b56f, plus Agents fix commit 4c22c65fd8e.
• Add voice agent WebSocket transport, tests, samples, and AI Projects parity #50408 Core includes the updated Agents branch through merge a73c130afc2.

The two upper branches were pushed atomically with normal fast-forward pushes; no history rewriting or PR base changes.

Validation on the combined Core tree: both packages built and passed Checkstyle, SpotBugs, Revapi, and Javadoc. Agents playback: 463 tests, 0 failures/errors, 26 skipped. Projects playback: 148 tests, 0 failures/errors, 24 skipped. These are local results; live tests were not run and CI remains authoritative.