Keyboard navigation
Every Agent-mode action and field displays its shortcut beside its label. Shortcuts are sequences, not simultaneous key combinations: g e means press g, then e. Press Esc to leave an input before using them.- ? opens the page directory, which lists each page, its
gocommand and shortcut. - g h / g e / g m / g n / g k opens Home / Equities / Macro / News / Calendar.
- m m opens More; m h returns to Human mode.
- : focuses the command prompt; Enter runs a command.
- d 01, d 02, etc. selects the labelled dataset; t t opens sections.
- p opens parameters; f 01, f 02, etc. focuses the labelled field.
- r / s / c refreshes data / saves filters / cancels a request.
- v j / v t / v f selects JSON / table / focuses the response for scrolling.
- y / x copies / exports the result. Resource links and alert controls show their own keys.
- n p fetches the next API page when the API supplies a continuation.
- v n / v p moves through rows already received, without another request.
Command prompt
Agent mode uses compact terminal panels with a command prompt on the current page. Typepages for the directory, help for commands, ls for that page’s datasets and describe for
the selected dataset’s parameter schema and MCP mapping.
use <operation-id> selects a dataset from ls; get reads it with named
filters. run --body '{...}' supplies a documented calculation body. context
shows the native page and effective request parameters. Quoted values retain
spaces and equals signs. Normal account and data permissions still apply.
Use Up/Down for command history, Tab for completion, Ctrl+C to cancel
the request, and : or Ctrl + backtick to focus the prompt outside a text field.
clear clears the transcript. Parameter forms are available in a collapsible
panel alongside the command interface.
The layout uses the human app’s shared content-width cap (currently 1440px).
Fields, command history and response panes also have size limits, so panels
stay compact on large displays. Copy and export retain the original API response;
the displayed response uses the row and field view described below.
Predictable state and bounded reads
status returns JSON containing the request ID, operation, exact parameters,
completion state, HTTP status, timing, quota headers and available next actions.
States distinguish idle, loading, ready, error, cancelled and downloaded requests;
an entitlement lock is reported as blocked. context adds the native page,
editable draft, navigation commands, dataset IDs and transport selectors.
The completed request remains separate from subsequent filter edits.
rows selects a zero-based window of received rows: 20 by default, at most 100.
fields selects comma-separated fields; identity and source, accession, period,
basis, unit and currency fields are retained. Names refer to row keys or top-level
object keys; inspect available_fields in status. Unknown names are rejected.
These are local display operations,
not server-side query projections. The state reports the received count, displayed
range and field selection. The original payload remains available through Copy
response and Export JSON. Table views report when columns are omitted; JSON
contains every field in the selected view. Some object responses contain several
collections; row windows apply to the primary recognized collection.
next follows the API’s returned cursor, next offset or page/total metadata using
the parameters of the completed request. It preserves filters and does not guess
from the number of rows. A missing continuation is reported as unknown, rather
than claiming the collection is complete. News continuation uses before and
removes the polling after parameter. Revision-bound cursors are passed through
unchanged; a stale-cursor error requires restarting the request without its cursor.
Errors expose a code, HTTP status, retryability, optional retry_at and recovery
guidance. retry repeats the failed request only when its error is retryable,
and enforces the server’s retry time. Transient data failures are not retried
automatically. The shared authenticated transport may refresh an expired login
token once before returning an authorization failure. Account access failures
require resolving authorization; retry does not bypass them.
Browser automation contract
After the signed-in page mounts, its structured state uses contractastreus.agent-page.v1. Automation can inspect these stable DOM targets within
the active page, without parsing the visual layout:
Scope child selectors to the active root: inactive app tabs may retain their own
state. Wait for a new request ID and terminal status when issuing a request;
waiting only for existing response text can read a previous result. The response
state links the payload to its request ID. These targets expose data already
authorized for the signed-in browser session. They do not provide an external API
or a background execution service. Exported snapshots include the request and
original response for reproducible review.