[vdusek]

Adds ActorClient.server() and ActorClientAsync.server(), which return an ActorServerClient / ActorServerClientAsync for Server Actors (formerly Actor Standby):

actor_server_client = client.actor('username/actor-name').server()
response = actor_server_client.request('/search', params={'q': 'apify'})
url = actor_server_client.get_url()
spec = actor_server_client.get_openapi_spec()

• request() sends a request to the Actor's server. The host always comes from the Actor's standbyUrl. The token goes in the X-Apify-Authorization header, which the platform strips, so headers the caller passes, Authorization included, reach the Actor as they are. It doesn't follow redirects and returns a redirect response as it is, so the token can't reach a host the Actor's code picked.
• request() returns the server's response whatever its status. Only 429 and 503 are retried, since other statuses may come from the Actor's code. Network errors and timeouts aren't retried, since the Actor may have already handled the request. It raises only when it gets no response: the Actor doesn't exist or isn't a Server Actor, or the request fails or times out.
• request() sends bodies uncompressed unless compression is set, returns the body unread with stream=True, and defaults to the long timeout to cover a cold start.
• get_url() returns the server URL. It's fetched once per ActorClient, by get_url() or get_openapi_spec().
• get_openapi_spec() returns the web server schema from the build that serves the server (actorStandby.build, or latest), or None if there's none. The schema field comes from fix(openapi): add missing fields to the Actor definition schema apify-docs#3115.
• get_url() and get_openapi_spec() take a timeout.

ActorClient.standby() is a deprecated alias of server() and will be removed in v4.

Other changes:

• HttpClient.call and HttpClientAsync.call take new arguments: compression, authorization_header, raise_for_status, retry_status_codes, retry_transport_errors, and follow_redirects. A custom HTTP client that overrides call must accept and honor them, and one that implements send_request must honor follow_redirects.
• Request params are appended with & to a URL that already has a query.
• The docstring sync script no longer turns ApifyClientError into a nonexistent ApifyClientAsyncError.
• A Server Actors concepts page, unit tests, and an integration test against a temporary echo Server Actor.

Closes: #973

✍️ Drafted by Claude Code

[codecov]

Codecov Report

❌ Patch coverage is 97.39583% with 5 lines in your changes missing coverage. Please review.
✅ Project coverage is 95.72%. Comparing base (f6be852) to head (ddd6a06).
⚠️ Report is 4 commits behind head on master.

Files with missing lines	Patch %	Lines
src/apify_client/_resource_clients/actor_server.py	97.43%	3 Missing ⚠️
src/apify_client/types.py	0.00%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1153      +/-   ##
==========================================
+ Coverage   95.67%   95.72%   +0.05%     
==========================================
  Files          61       62       +1     
  Lines        6473     6651     +178     
==========================================
+ Hits         6193     6367     +174     
- Misses        280      284       +4     

Flag	Coverage Δ
integration	91.08% <81.25%> (-0.52%)	⬇️
unit	90.66% <96.35%> (+0.28%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[janbuchar]

LGTM, even though apify/apify-client-js#1179 (comment) applies here as well