Check your connection

Identify the local command

lys --version

The CLI reports its version and source commit. The remote plugin connection uses HTTP and the host’s OAuth support; it does not require this local command.

Read service metadata

GET /api/health
GET /api/openapi.json

Health describes the serving directory. OpenAPI describes its declared operations. Neither provides the caller with authority to exercise those operations.

Discover the connection’s authority

{"name":"what-can-I-do","arguments":{}}

Read the returned resources and actions before selecting a route. A connected-app agent and the person responsible for it are distinct callers. An operation requiring a person session cannot use the agent’s connection in its place.

Answer the refusal

A missing sign-in needs host authentication. A refused signature needs the enrolled agent id and matching key. A missing resource action needs an authorised grant. Preserve an uncertain operation’s identifier and reconcile it before attempting another change.