Browser

The built-in browser: reading pages, framing local previews, and the live browser the agent drives. Paths are relative to /api/v1.

GET /favicon

The icon of a website cited as a source, fetched once by the server and cached.

The browser never contacts the cited site: it asks the local server, which fetches the icon once and keeps it. Answers the image bytes, or 204 when the site has no icon.

Query

dominio

The domain of the site (for example example.com).

Answers The bytes themselves (a file or an image), not JSON.

GET /browser/incorniciabile

Whether a page can be shown inside the Browser panel, and by which way (via) it should be shown, with the reason (percheVia).

Query

urlrequired

the address of the page (up to 2048 characters).

Answers The JSON envelope.

Errors1

Code	Status	Meaning
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

GET /browser/proxy

A page of a local development server, served from TALOS’s own origin with the Browser overlay injected.

Query

urlrequired

the address of the local page (up to 2048 characters).

Answers The bytes themselves (a file or an image), not JSON.

Errors1

Code	Status	Meaning
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

GET /browser/leggi

Read a web page on the server, the way the agent’s naviga tool reads it, so the model sees the page the person is looking at.

The server has none of the person’s cookies: of a site behind a login it reads the public version.

Query

urlrequired

the address of the page (up to 2048 characters).

Answers The JSON envelope.

Errors1

Code	Status	Meaning
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

POST /browser/vivo/chiudi

Close the live page of a session.

Query

sessionerequired

the session id.

Body

None: the body is empty.

Answers The JSON envelope.

POST /browser/vivo/apri

Open a page in the live browser of a session (a real Chromium page the agent can drive).

Query

sessionerequired

the session id.

Body

urlrequired

The address to open (up to 2048 characters).

larghezza

Viewport width in pixels (default 1280).

altezza

Viewport height in pixels (default 800).

Answers The JSON envelope.

Errors1

Code	Status	Meaning
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

POST /browser/vivo/gesto

Send a gesture of the person to the live browser: a click, a key or the wheel, in page coordinates.

Query

sessionerequired

the session id.

Body

tiporequired

clic, tasto or rotella.

x

For clic and rotella: the horizontal position in the page.

y

For clic and rotella: the vertical position in the page.

tasto

For clic: sinistro (default) or another mouse button.

doppio

For clic: true for a double click.

chiave

For tasto: the key.

testo

For tasto: the text it types.

dx

For rotella: horizontal scroll.

dy

For rotella: vertical scroll.

modificatori

The modifier keys held, as a bit mask (default 0).

Answers The JSON envelope.

POST /browser/vivo/descrivi

Describe the element of the live page at a point, so the agent knows what the person is pointing at.

Query

sessionerequired

the session id.

Body

x

Horizontal position in the page.

y

Vertical position in the page.

Answers The JSON envelope.

POST /browser/vivo/misura

Resize the live page to the panel the person is looking at (the viewport changes; the page does not reload).

Query

sessionerequired

the session id.

Body

larghezza

Width in pixels.

altezza

Height in pixels.

Answers The JSON envelope.

GET /browser/vivo/schermo

The screen of the live browser, streamed: one frame per server-sent event (dati, metadati, numero, url).

Closing the stream stops the transmission. A problem after the stream has started arrives as an event with errore and codice, then the stream closes.

Query

sessionerequired

the session id.

Answers An event stream (text/event-stream).

GET /browser/vivo/stato

The state of the live browser: which sessions have a page open.

Query

sessionerequired

the session id.

Answers The JSON envelope.