Merge branch 'feature/storage/content-validation' into feature/storage/content-validation-content-length-override

Author: gunjansingh-msft

.github/CODEOWNERS

@@ -1,5 +1,7 @@
 # Prompt for GitHub Copilot
 
+> **Note**: For general AI agent guidance and repository overview, see [AGENTS.md](https://github.com/Azure/azure-sdk-for-java/blob/main/AGENTS.md) at the repository root. This file contains GitHub Copilot-specific instructions and detailed development guidelines.
+
 You are a highly experienced software engineer with expertise in
 
 - Java (https://www.java.com)
@@ -103,7 +105,7 @@ Always attempt to browse the following resources and incorporate relevant inform
     - https://github.com/Azure/azure-sdk/blob/main/docs/policies/repostructure.md
     - https://azure.github.io/azure-sdk/java_introduction.html
     - https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md
-    - https://github.com/Azure/azure-sdk-for-java/wiki/Building
+    - https://github.com/Azure/azure-sdk-for-java/blob/main/docs/contributor/building.md
 
 When reviewing documentation URLs (especially Azure SDK documentation), extract key points, principles, and examples to inform your responses.
 Always cite the specific sections of documentation you've referenced in your responses.
@@ -206,4 +208,4 @@ Ask the user for clarification if repository path or configuration file is ambig
 
 ## SDK release
 
-For detailed workflow instructions, see [SDK Release](../eng/common/instructions/copilot/sdk-release.instructions.md).
+For detailed workflow instructions, see [SDK Release](https://github.com/Azure/azure-sdk-for-java/blob/main/.github/skills/azsdk-common-sdk-release/SKILL.md).

.github/copilot-instructions.md

@@ -6,7 +6,7 @@ metadata:
   distribution: shared
 description: "Create and manage release plan work items for Azure SDK releases across languages. **UTILITY SKILL**. USE FOR: \"create release plan\", \"update release plan\", \"link SDK PR to plan\", \"namespace approval\", \"check release plan status\". DO NOT USE FOR: SDK code generation, pipeline troubleshooting, API review feedback. INVOKES: azure-sdk-mcp:azsdk_create_release_plan, azure-sdk-mcp:azsdk_get_release_plan, azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan."
 compatibility:
-  requires: "azure-sdk-mcp server, API spec PR in Azure/azure-rest-api-specs"
+  requires: "azure-sdk-mcp server, API spec PR, or TypeSpec project path"
 ---
 
 # Prepare Release Plan
@@ -26,8 +26,8 @@ compatibility:
 
 ## Steps
 
-1. **Prerequisites** — Check for API spec PR; prompt if unavailable.
-2. **Check Existing** — Query by plan number or spec PR link.
+1. **Prerequisites** — Check for API spec PR link or a TypeSpec project path; prompt if unavailable.
+2. **Check Existing** — Query by release plan number or spec PR link (do not query by work item ID).
 3. **Gather Info** — Collect Service Tree IDs, timeline. See [details](references/release-plan-details.md).
 4. **Create** — Run `azure-sdk-mcp:azsdk_create_release_plan`.
 5. **Namespace** — For mgmt plane first releases, link approval issue.
@@ -36,9 +36,10 @@ compatibility:
 ## Examples
 
 - "Create a release plan for my spec PR"
+- "Create a release plan for my TypeSpec project"
 - "Link my SDK PR to release plan"
 
 ## Troubleshooting
 
 - Requires `azure-sdk-mcp` server; no CLI fallback.
-- If creation fails, verify spec PR URL and Service Tree IDs.
+- If creation fails, verify Service Tree IDs and the provided spec PR URL or TypeSpec project path.

.github/skills/azsdk-common-prepare-release-plan/SKILL.md

@@ -22,6 +22,7 @@ compatibility:
 
 1. **Collect Info** — Get `packageName` and `language` from the user. Optionally get `branch` (defaults to main).
 2. **Check Readiness** — Run `azure-sdk-mcp:azsdk_release_sdk` with `checkReady: true` to verify API review approval, changelog, package name approval, and release date.
+  - If APIView approval is pending display the link or guidance to find the link if not provided.
 3. **Review Results** — If not ready, display failing checks and guide user to resolve.
 4. **Trigger Release** — Once ready, run `azure-sdk-mcp:azsdk_release_sdk` with `checkReady: false`. Show pipeline link and inform user they must approve the release stage.
 

.github/skills/azsdk-common-sdk-release/SKILL.md

@@ -35,7 +35,7 @@ jobs:
         uses: azure/login@v3
         if: ${{ github.event_name == 'issues' && github.event.action == 'opened' }}
         with:
-            client-id: a6dd2dfe-7352-41a7-9020-05301c3bca1a
+            client-id: e4cb9fd5-0875-4ca1-bc43-56196f5dfb8f
             tenant-id: 72f988bf-86f1-41af-91ab-2d7cd011db47
             allow-no-subscriptions: true
 

.github/workflows/event-processor.yml

@@ -111,6 +111,7 @@
     "sdk/cosmos/azure-cosmos-spark_4-1_2-13/**",
     "sdk/cosmos/azure-cosmos-spark-account-data-resolver-sample/**",
     "sdk/cosmos/fabric-cosmos-spark-auth_3/**",
+    "sdk/cosmos/fabric-cosmos-spark-auth_4-0_2-13/**",
     "sdk/cosmos/azure-cosmos-encryption/**",
     "sdk/cosmos/azure-cosmos-spark_3_2-12/**",
     "sdk/spring/azure-spring-data-cosmos/**",
@@ -278,6 +279,7 @@
     "Deserialization",
     "destfile",
     "Dcheckstyle",
+    "Dexec",
     "Dgenerate",
     "Dinclude",
     "Dincludes",
@@ -293,6 +295,7 @@
     "doclinting",
     "doctitle",
     "dlocal",
+    "Dmdep",
     "dtlk",
     "dtlksd",
     "dummyrg",
@@ -314,6 +317,7 @@
     "FOURX",
     "filereports",
     "gapra",
+    "gitmcp",
     "gltf",
     "gmavenplus",
     "gson",
@@ -341,6 +345,7 @@
     "Iscsi",
     "jacksonavro",
     "jacoco",
+    "javac",
     "javadoc",
     "javadocs",
     "Jdbc",
@@ -1492,6 +1497,10 @@
         "FILLER",
         "foundry",
         "FOUNDRY",
+        "genai",
+        "GENAI",
+        "HDOMNI",
+        "SSML",
         "Unpooled",
         "viseme",
         "VISEME",

.vscode/cspell.json

@@ -0,0 +1,216 @@
+# AGENTS.md
+
+This file provides guidance for AI agents (e.g., GitHub Copilot, Model Context Protocol servers, or other LLM-based assistants) interacting with the Azure SDK for Java repository.
+
+## Repository Purpose
+
+The Azure SDK for Java provides developers with libraries for accessing Azure services. The SDK is organized into client libraries, with each library corresponding to an Azure service. The repository follows a specific structure:
+
+- **Client Libraries**: Located in `/sdk` directory, containing individual service clients
+- **Data plane Libraries**: Libraries with Maven group `com.azure`
+- **Management Libraries**: Libraries with Maven group `com.azure.resourcemanager`
+- **Spring Libraries**: Libraries with Maven group `com.azure.spring`
+
+## Repository Structure
+
+```
+/sdk/                    # Individual service client libraries
+/eng/                    # Engineering system files and automation
+/doc/                    # Documentation
+/samples/                # Sample code and tutorials
+/.github/                # GitHub-specific configuration
+  /copilot-instructions.md  # Detailed Copilot-specific instructions
+```
+
+## Agent Capabilities
+
+### Supported Actions
+
+AI agents interacting with this repository can assist with:
+
+1. **Code Generation and Modification**
+   - Creating new client libraries following Azure SDK design guidelines
+   - Adding features to existing libraries
+   - Writing unit and integration tests
+   - Refactoring code while maintaining backward compatibility
+
+2. **Documentation**
+   - Writing and updating README files
+   - Creating JavaDoc comments for public APIs
+   - Updating CHANGELOG files
+   - Creating code samples and snippets
+
+3. **Issue Triage and PR Review**
+   - Analyzing and categorizing issues
+   - Suggesting labels and assignees
+   - Reviewing pull requests for adherence to guidelines
+   - Identifying potential breaking changes
+
+4. **Build and Test Automation**
+   - Running Maven builds
+   - Executing unit tests
+   - Analyzing test failures
+   - Checking code style with Checkstyle and SpotBugs
+
+5. **SDK Release Support**
+   - Checking package release readiness
+   - Updating version numbers following semantic versioning
+   - Verifying API review status
+
+### Boundaries and Limitations
+
+Agents should **NOT**:
+
+- Disable or modify Checkstyle or SpotBugs rules to resolve linting issues
+- Re-record tests as a fix to failing tests
+- Make breaking changes to GA'd APIs without explicit approval
+- Turn off security checks or introduce security vulnerabilities
+- Suggest third-party alternatives to Azure SDK packages in official samples
+
+## Key Workflows
+
+### Building the SDK
+
+```bash
+# Build all modules
+mvn clean install -DskipTests
+
+# Build a specific module
+mvn -f sdk/{service}/pom.xml clean install -DskipTests
+
+# Run tests for a specific module
+mvn -f sdk/{service}/pom.xml test
+```
+
+### Running Code Quality Checks
+
+```bash
+# Run Checkstyle
+mvn checkstyle:check
+
+# Run SpotBugs
+mvn spotbugs:check
+
+# Run both style checks
+mvn checkstyle:check spotbugs:check
+```
+
+### Testing
+
+```bash
+# Run unit tests for a specific module (playback by default)
+mvn -f sdk/{service}/pom.xml test
+
+# Run live tests for a specific module (requires Azure resources and environment variables)
+AZURE_TEST_MODE=LIVE mvn -f sdk/{service}/pom.xml -Dmaven.wagon.http.pool=false --batch-mode --fail-at-end test
+
+# See eng/common/TestResources/New-TestResources.ps1 for setting up test resources
+```
+
+### Versioning
+
+- Version files are located in `/eng/versioning/`
+- Follow semantic versioning: `major.minor.patch[-beta.N]`
+- Use the `update_versions.py` script for version updates
+- See [CONTRIBUTING.md](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md) for detailed versioning guidelines
+
+### SDK Generation
+
+Many client libraries are generated from OpenAPI specifications using AutoRest:
+
+```bash
+# Typical codegen command
+autorest --version=3.9.7 --java --use=@autorest/java@4.1.59 \
+  --input-file=<spec-file> --namespace=<namespace> --output-folder=<output>
+```
+
+## Design Guidelines
+
+All contributions must follow the [Azure SDK Design Guidelines for Java](https://azure.github.io/azure-sdk/java_introduction.html).
+
+### Core Principles
+
+- **Idiomatic**: Use natural Java patterns (try-with-resources, Streams, Optional)
+- **Consistent**: Follow consistent naming and design patterns across all libraries
+- **Approachable**: Provide clear documentation and intuitive APIs
+- **Diagnosable**: Include comprehensive logging and telemetry
+- **Dependable**: Ensure reliability through robust error handling and retries
+
+### API Design Requirements
+
+- Service client classes with "Client" suffix
+- Fluent builder patterns for client instantiation
+- Synchronous and asynchronous clients (async suffixed with "AsyncClient")
+- Options bags for additional parameters (e.g., `<MethodName>Options`)
+- Standard verbs: create, upsert, set, get, list, delete
+- Comprehensive JavaDoc for all public APIs
+
+### Java Compatibility
+
+- **Baseline**: Java 8
+- **Testing**: Up to latest Java LTS (currently Java 21)
+- **Best Practices**: Use modern Java features where appropriate
+
+## CI/CD Pipeline
+
+The repository uses Azure Pipelines for continuous integration:
+
+- Each service has a `ci.yml` file defining its build pipeline
+- PRs must pass all CI checks before merging
+- Daily builds publish to the dev feed at [Azure Artifacts](https://dev.azure.com/azure-sdk/public/_packaging?_a=feed&feed=azure-sdk-for-java)
+
+## Security and Compliance
+
+- Never commit secrets or credentials
+- Use Azure Identity for authentication in samples
+- Follow secure coding practices
+- Report security issues to <secure@microsoft.com>
+- See [SECURITY.md](https://github.com/Azure/azure-sdk-for-java/blob/main/SECURITY.md) for more information
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md) for detailed contribution guidelines, including:
+
+- Pull request requirements
+- Code review process
+- Testing requirements
+- Documentation standards
+- Version management
+
+## Agent-Specific Instructions
+
+For detailed GitHub Copilot-specific instructions, including behavior guidelines, data sources, and SDK-specific patterns, see [.github/copilot-instructions.md](https://github.com/Azure/azure-sdk-for-java/blob/main/.github/copilot-instructions.md).
+
+## Resources
+
+### Documentation
+
+- [Azure SDK for Java Documentation](https://aka.ms/java-docs)
+- [Azure for Java Developers](https://docs.microsoft.com/java/azure/)
+- [Azure SDK Design Guidelines](https://azure.github.io/azure-sdk/)
+- [Java Guidelines](https://azure.github.io/azure-sdk/java_introduction.html)
+- [Building the SDK](https://github.com/Azure/azure-sdk-for-java/blob/main/docs/contributor/building.md)
+
+### Repository Links
+
+- [Latest Releases](https://azure.github.io/azure-sdk/releases/latest/java.html)
+- [GitHub Issues](https://github.com/Azure/azure-sdk-for-java/issues)
+- [Stack Overflow](https://stackoverflow.com/questions/tagged/azure-java-sdk)
+- [Support](https://github.com/Azure/azure-sdk-for-java/blob/main/SUPPORT.md)
+
+### External References
+
+- [Maven](https://maven.apache.org/)
+- [JUnit 5](https://junit.org/junit5/)
+- [Semantic Versioning](https://semver.org/)
+- [Azure Artifacts Dev Feed](https://dev.azure.com/azure-sdk/public/_packaging?_a=feed&feed=azure-sdk-for-java)
+
+## Feedback and Questions
+
+- For issues or feature requests, file a [GitHub Issue](https://github.com/Azure/azure-sdk-for-java/issues/new/choose)
+- For questions, use [Stack Overflow with the `azure-java-sdk` tag](https://stackoverflow.com/questions/tagged/azure-java-sdk)
+- For contributions, see [CONTRIBUTING.md](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md)
+
+---
+
+This file aligns with the [AGENTS.md standard](https://agents.md) and provides a comprehensive guide for AI agents interacting with the Azure SDK for Java repository.

AGENTS.md

@@ -69,6 +69,8 @@ For details on contributing to this repository, see the [contributing guide](htt
 
 The consolidated documentation hub for contributors (building, testing, versioning, release checklist, etc.) is at [`docs/`](https://github.com/Azure/azure-sdk-for-java/blob/main/docs/README.md).
 
+> **For AI Agents**: If you're an AI agent (e.g., GitHub Copilot, MCP server, or LLM assistant) working with this repository, please refer to [AGENTS.md](https://github.com/Azure/azure-sdk-for-java/blob/main/AGENTS.md) for guidance on repository structure, workflows, and best practices for agent interactions.
+
 This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, view [Microsoft's CLA](https://cla.microsoft.com).
 
 When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.
@@ -82,7 +84,7 @@ Many people all over the world have helped make this project better.  You'll wan
 - [What are some good first issues for new contributors to the repo?](https://github.com/azure/azure-sdk-for-java/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)
 - [How to build and test your change](https://github.com/Azure/azure-sdk-for-java/blob/main/docs/contributor/building.md)
 - [How you can make a change happen!](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md#pull-requests)
-- Frequently Asked Questions (FAQ) and Conceptual Topics in the detailed [Azure SDK for Java wiki](https://github.com/azure/azure-sdk-for-java/wiki).
+- Frequently Asked Questions (FAQ) and Conceptual Topics in the detailed [Azure SDK for Java wiki](https://github.com/Azure/azure-sdk-for-java/tree/main/docs).
 
 ### Reporting security issues and security bugs
 

README.md

@@ -74,22 +74,22 @@
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-core-http-netty</artifactId>
-      <version>1.16.3</version> <!-- {x-version-update;com.azure:azure-core-http-netty;dependency} -->
+      <version>1.16.4</version> <!-- {x-version-update;com.azure:azure-core-http-netty;dependency} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-core-http-okhttp</artifactId>
-      <version>1.13.3</version> <!-- {x-version-update;com.azure:azure-core-http-okhttp;dependency} -->
+      <version>1.13.4</version> <!-- {x-version-update;com.azure:azure-core-http-okhttp;dependency} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-core-http-jdk-httpclient</artifactId>
-      <version>1.1.3</version> <!-- {x-version-update;com.azure:azure-core-http-jdk-httpclient;dependency} -->
+      <version>1.1.4</version> <!-- {x-version-update;com.azure:azure-core-http-jdk-httpclient;dependency} -->
     </dependency>
     <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-core-http-vertx</artifactId>
-      <version>1.1.3</version> <!-- {x-version-update;com.azure:azure-core-http-vertx;dependency} -->
+      <version>1.1.4</version> <!-- {x-version-update;com.azure:azure-core-http-vertx;dependency} -->
     </dependency>
     <dependency>
       <groupId>io.vertx</groupId>

common/perf-test-core/pom.xml

@@ -15,6 +15,7 @@ This wiki page is used to track the timeline for Spring Cloud Azure. So we can g
 4. In "java - spring - compatibility - tests" pipeline, it will tests versions from sdk/spring/spring-cloud-azure-supported-spring.json file which supportedStatus is `SUPPORTED`, so when the supported version changed, this page should be updated.
 
 ## Timeline
+ - **2026-04-29**: Released spring-cloud-azure-dependencies:6.3.0, which depends on: SpringBoot:3.5.14 and SpringCloud:2025.0.2.
  - **2026-04-17**: Released spring-cloud-azure-dependencies:7.2.0, which depends on: SpringBoot:4.0.5 and SpringCloud:2025.1.1.
  - **2026-03-25**: Released spring-cloud-azure-dependencies:6.2.0, which depends on: SpringBoot:3.5.5 and SpringCloud:2025.0.0.
  - **2026-03-11**: Released spring-cloud-azure-dependencies:7.1.0, which depends on: SpringBoot:4.0.3 and SpringCloud:2025.1.0.