docs: present per-deployment subdomains as the gateway's URL shape

[sundar-svg]

Description

Comfy Cloud deployments now serve on per-deployment subdomains (https://{dep_id}.run.comfy.app); the path-mounted gateway shape (platformapi.comfy.org/deployment/{id}) is being retired. Docs/tests cleanup only — no client code changes (the SDK is base-URL-agnostic and already works with both shapes):

• test_follow_up_links.py: docstring reframed (subdomain is the current gateway shape; origin-resolution stays pinned for any path-carrying base, e.g. a proxy mount), fixture renamed PATH_MOUNTED_BASE with a neutral example host, and a new test_subdomain_links_resolve_against_base covering the modern shape.
• test_gateway_e2e.py: the COMFY_BASE_URL example now shows the subdomain form.

How tested

pytest tests/test_follow_up_links.py — 6 passed (5 existing + 1 new).

🤖 Generated with Claude Code

https://claude.ai/code/session_01KV7wUb2hyzKHsR52ZJTvAm

Summary by CodeRabbit

• Tests

  • Expanded coverage for deployments using subdomains and path-mounted gateway URLs.
  • Added validation for correct link origins and internal /jobs and /assets paths.
  • Updated authorization and absolute-link test coverage for path-mounted gateways.

• Documentation

  • Updated the documented COMFY_BASE_URL example to use a deployment-specific serverless gateway URL.

[github-actions]

✅ All contributors have signed the CLA. Thank you! This PR is ready to be merged.
_{Posted by the CLA Assistant Lite bot.}

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: fc741a56-259a-43c3-8b68-ab23fbd2db19

📥 Commits

Reviewing files that changed from the base of the PR and between e2f4022 and b8f53a6.

⛔ Files ignored due to path filters (1)

• uv.lock is excluded by !**/*.lock

📒 Files selected for processing (2)

• tests/integration/test_gateway_e2e.py
• tests/test_follow_up_links.py

---

📝 Walkthrough

Walkthrough

The change updates the gateway URL example and expands follow-up-link tests for subdomain and path-mounted deployments. Tests verify origin resolution, internal path prefixes, absolute-link passthrough, and authorization setup.

Changes

Gateway URL coverage

Layer / File(s)	Summary
Gateway URL fixtures and setup tests/integration/test_gateway_e2e.py, tests/test_follow_up_links.py	The setup example uses the deployment-specific gateway URL. Tests define separate subdomain and path-mounted gateway bases.
Follow-up-link resolution coverage tests/test_follow_up_links.py	Tests cover subdomain links, mounted-link origin resolution, internal /jobs and /assets prefixes, absolute-link passthrough, and authorization setup.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested reviewers: alexisrolland

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the documentation and test changes for per-deployment subdomain gateway URLs.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch sundar-svg/subdomain-url-docs

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[sundar-svg]

I have read and agree to the Contributor License Agreement