feat(provider/azure): add shell in azure Responses tools

[tsuzaki430]

Background

The Azure OpenAI Responses API supports the shell and local_shell tools, and they are now available through azure.tools.* in @ai-sdk/azure.
The @ai-sdk/azure documentation also clarifies that some features are currently not supported on the Azure platform.

Summary

• Exposed shell and localShell in @ai-sdk/azure by wiring them into azureOpenaiTools (re-exported from @ai-sdk/openai/internal).

• Added Azure provider documentation for:

  • Local Shell Tool (azure.tools.localShell) for Codex models

  • Shell Tool (azure.tools.shell) with clear warnings:

    • Azure limitation notes: no container environments (containerAuto / containerReference), no Skills, and environment currently not supported

Manual Verification

local_shell tool

• pnpm tsx src/generate-text/azure/local-shell-tool.ts
• pnpm tsx src/stream-text/azure/local-shell-tool.ts

shell tool

• pnpm tsx src/generate-text/azure/responses-shell-tool.ts
• pnpm tsx src/stream-text/azure/responses-shell-tool.ts

shell tool (reference-only; comments for unsupported features)

• pnpm tsx src/generate-text/azure/responses-shell-local-skills.ts
• pnpm tsx src/stream-text/azure/responses-shell-local-skills.ts
• pnpm tsx src/generate-text/azure/responses-shell-container.ts
• pnpm tsx src/stream-text/azure/responses-shell-container.ts
• pnpm tsx src/generate-text/azure/responses-shell-container-skills.ts
• pnpm tsx src/stream-text/azure/responses-shell-container-skills.ts

Checklist

• Tests have been added / updated (for bug fixes / features)
• Documentation has been added / updated (for bug fixes / features)
• A patch changeset for relevant packages has been added (for bug fixes / features - run pnpm changeset in the project root)
• I have reviewed this pull request (self-review)

Future Work

When Microsoft Azure adds support for skills and hosted container execution for the Shell Tool, the “reference-only” comments and the Azure docs notes can be updated to reflect full parity with the OpenAI provider.

Related Issues

[tsuzaki430]

I have reviewed this pull request (self-review)

[rahulbhadja]

Hi @tsuzaki430 , I also reviewed the PR. Great work! I'm looking for Azure docs that show which tools are actively supported in the responses API. Do you know where we can find this docs?

[tsuzaki430]

@rahulbhadja

Thank you for message and review😊

Do you know where we can find this docs?

I couldn't find the shell document in azure web site.

But the REST API specification does include a definition for the shell tool.
https://github.com/Azure/azure-rest-api-specs/blob/main/specification/ai/data-plane/OpenAI.v1/azure-v1-v1-generated.json
After checking the API, I found that skills and containers are not yet included.
I also found that trying the latest shell property returns an error.
I'll share any official references I find shell page in the future.
We are looking forward to updates.✨