chore: deprecate document.execute() in favor of document.generate() (v0.19.0)

[devin-ai-integration]

chore: deprecate document.execute() in favor of generate() (v0.19.0)

Summary

Aligns the Python SDK with vlm-lab PR #1595 which removes the /document/execute endpoint and unifies redaction domains under /document/generate.

The execute() method on FilePredictions (used by client.document, client.audio, client.video) is now a thin deprecation wrapper that:

1. Emits a DeprecationWarning
2. Converts the name param from slash to dot notation (healthcare/phi-redaction → healthcare.phi-redaction)
3. Delegates to self.generate() with the converted domain

No new functionality — this is purely a deprecation shim.

Review & Testing Checklist for Human

• FilePredictions is shared across document, audio, and video routes. Verify that audio.execute() and video.execute() are also intended to be deprecated, or if only document.execute() should be affected. The current change deprecates ALL routes.
• The version parameter is silently dropped — the old execute() sent version to the API; the new delegation to generate() does not forward it. Confirm this is acceptable.
• The model parameter defaults to "vlm-1" in generate() — old execute() never sent a model field. Verify the backend handles this correctly for former execute use cases.
• Run make test to confirm existing tests pass (especially test_document_execute in tests/test_predictions.py), since the mock expectations may have changed.

Notes

• Companion PRs: Docs #183 (now also covers the new healthcare.phi-edit-replace domain from PR #1576), Node SDK #124
• Link to Devin run: https://app.devin.ai/sessions/a17c2daad8af4a55bc57261c9c01f31f
• Requested by: dinesh@vlm.run

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring