Standardize SWAIG webhook auth: use canonical web_hook_auth_password param

[hey-august]

Description

Problem

Previously, the SWAIG reference pages disagreed on the webhook basic-auth password key. Examples used web_hook_auth_pass while the sidecar and includes pages used web_hook_auth_password, and neither was formally documented on the ai verb.

Solution

Looking at the parser in source code revealed that web_hook_auth_password is the canonical parameter, and web_hook_auth_pass is a back-compatibility alias that's currently broken. (issue filed)

This PR does 3 things:

1. Document web_hook_auth_user/web_hook_auth_password with proper ParamFields at both defaults and function level on the ai SWAIG pages
2. Mark web_hook_auth_pass as a deprecated function-level-only alias
3. Fix the examples (including the includes block, which used incorrect user/pass keys instead of auth_user/auth_password)
4. Update the ai SWAIG models and the fabric AI Agent REST models in TypeSpec so the published schema stops rejecting the canonical names
   • Bedrock is deliberately excluded. Its parser reads no auth keys, so BedrockSWAIG now gets its own defaults model instead of inheriting the ai one.

Type of Change

• Bug fix
• New feature
• Breaking change
• Documentation update
• Code cleanup / refactor

Related Issues

#521
signalwire/cloud-product#20511

Testing

Verified with yarn build:specs, yarn fern-check, and yarn fern-md-check.

• Added/updated unit tests
• Tested manually
• Tested with live SignalWire credentials (if applicable)

Checklist

• I have read the CONTRIBUTING guidelines
• My code follows the project's style guidelines
• I have added tests for my changes (if applicable)
• I have updated documentation (if applicable)
• All existing tests pass

[github-actions]

🌿 Preview

https://signalwire-preview-docs-615.docs.buildwithfern.com/docs

---

View workflow run