login
Sign an ACP agent in when doctor reports auth_required: check authentication status or start a background sign-in, then share the returned link and poll the job.
Instructions
Sign an ACP agent in once, for an agent that doctor reports as auth_required.
Some agents open no session until a client has called ACP authenticate, then cache the credential
themselves (Google Antigravity is one). No other Rutherford call signs in; this is the explicit place.
Without method it is read-only: status=authenticated if a session already opens, else
status=method_required with the agent's advertised methods (id, name, kind). With method (an
agent-kind id) it starts the sign-in as a background job, waits up to wait_s for the agent to print its
sign-in link, and returns status=pending with job_id and signin_urls -- give the first link to the
user, who completes the sign-in in a browser, then poll job_status / job_result. The job finishes
authenticated once a session opens with the new credential (lifting any cooldown bench), fails with
AUTH_FAILED (declined, the agent still refused a session afterwards, or no sign-in within timeout_s,
which bounds the authenticate step), or with the agent's own handshake error if the confirming session
fails for another reason. status=authenticated without method means a session opens and no ACP
sign-in is needed; a turn may still need a provider key, which doctor checks. A repeated login while
one is running returns that job (joined=true) instead of starting another (and status=cancelled if
cancel_job ends it while the call waits); a different method then is
refused with INVALID_INPUT until it finishes or is cancelled. The links are agent-authored, taken only
from sign-in prompt lines, and never opened by Rutherford. An env_var
method returns the variables to set (status=configure_env) and a terminal method returns the command to
run (status=run_in_terminal); Rutherford never asks for or stores a credential value.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | Yes | ||
| method | No | ||
| wait_s | No | ||
| timeout_s | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |