[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.
• 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, and retry_transport_errors. A custom HTTP client that overrides call must accept and honor them.
• 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 98.31461% with 3 lines in your changes missing coverage. Please review.
✅ Project coverage is 95.73%. Comparing base (f6be852) to head (54b3c52).
⚠️ Report is 1 commits behind head on master.

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

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1153      +/-   ##
==========================================
+ Coverage   95.67%   95.73%   +0.06%     
==========================================
  Files          61       62       +1     
  Lines        6473     6638     +165     
==========================================
+ Hits         6193     6355     +162     
- Misses        280      283       +3     

Flag	Coverage Δ
integration	91.03% <81.46%> (-0.56%)	⬇️
unit	90.68% <98.31%> (+0.31%)	⬆️

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.

[Pijukatel]

@Pijukatel Thanks, good idea, I've implemented it. The methods now live on a new ActorServerClient, which you get from ActorClient.server() (so actor.server().request(...), .get_url(), .get_openapi_spec()). I kept a deprecated Standby alias, ActorClient.standby(), which returns the same client, and I updated the docs page. Could you give it a final check?

Also tagging @janbuchar, since one more pair of eyes on the design of this new feature would be great.

I like this implementation. It is well separated and even though the distinction is quite blurry on the platform, here it feels well separated.

[janbuchar]

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