The Archive · Desktop reference

Events

What a TALOS Desktop session streams: the AG-UI events, the events TALOS adds, and the stream of a workflow run.

Reference for TALOS Desktop 0.1.25 generated from the source of the release · released Oct 9, 2026

A session streams what happens in it as it happens: GET /api/v1/sessions/{sessionId}/events (server-sent events, see Local API). The events follow the AG-UI protocol; TALOS adds its own, marked below. A field TALOS adds to a standard event is optional for a client that does not know it.

On connection the stream first replays what the session already recorded, then continues live; talos.fine-rigiocata marks the boundary.

Session events

`RunStarted`

AG-UI

A turn of the model starts.

threadId: The session.
runId: The turn.
inputoptional: What the turn was started with.
contestooptional: Where it runs: { progetto, cartella, branch }.

`RunFinished`

AG-UI

The turn ended well.

threadId: The session.
runId: The turn.
outcomeoptional: { type: "success" }.
resultoptional: { detto, compattazioni, premesseNegate, usage }: the final answer, how many compactions happened, the premises the model denied, and the token usage (null when no provider reported it).

`RunError`

AG-UI

The turn ended without success: an error, a stop, or the turn limit.

message: What happened, in words.
codeoptional: How it ended (for example fermato for a stop), or an error code.
classeoptional: The kind of provider failure, when the kernel classified it.
messageChiaveoptional: Not yet described.
messageParamsoptional: Not yet described.

`RunRedirectRequested`

TALOS

You sent a message to redirect the turn in progress.

redirectId: Pairs the request with its outcome.
testo: Your message.

`RunRedirectApplied`

TALOS

The redirect reached the model.

redirectId: The request.
testo: Your message.
immaginioptional: Images attached to it.

`RunRedirectCancelled`

TALOS

The redirect was withdrawn before it reached the model.

redirectId: The request.

`RunRedirectFailed`

TALOS

The redirect could not be applied.

redirectId: The request.
message: Why.
codeoptional: An error code.
reasonoptional: Not yet described.
paramsoptional: Not yet described.

`TextMessageStart`

AG-UI

A message of the model begins.

messageId: The message.
role: assistant.

`TextMessageContent`

AG-UI

A piece of the message, as it streams.

messageId: The message.
delta: The text to append.

`TextMessageEnd`

AG-UI

The message is complete.

messageId: The message.

`ReasoningMessageStart`

AG-UI

The model’s reasoning begins (models and providers that expose it).

messageId: The reasoning.
role: reasoning.

`ReasoningMessageContent`

AG-UI

A piece of the reasoning.

messageId: The reasoning.
delta: The text to append.

`ReasoningMessageEnd`

AG-UI

The reasoning is complete.

messageId: The reasoning.

`ToolCallStart`

AG-UI

The model calls a tool.

toolCallId: The call.
toolCallName: The tool (see Tools).
parentMessageIdoptional: The message the call belongs to.
avviatoAoptional: When it started, in milliseconds since the epoch (server clock).

`ToolCallArgs`

AG-UI

The arguments of the call, as JSON text (streamed in pieces).

toolCallId: The call.
delta: The text to append.

`ComandoUtenteIniziato`

TALOS

A command you typed yourself (! in the composer) starts: it is not a turn of the model and can run beside one.

comandoId: The command.
comando: What you typed.

`ComandoUtenteFinito`

TALOS

Your command ended.

comandoId: The command.
codiceoptional: Its exit code.
enforcementoptional: How the sandbox ran it.
erroreoptional: Why it did not start, when it did not.

`ToolCallOutput`

TALOS

Output of a command while it runs: progress to show, not the result.

toolCallId: The call.
delta: The output to append.

`ToolCallResult`

AG-UI

The result of the call, as the model reads it.

messageId: The result’s message.
toolCallId: The call.
content: The result, as text.
role: tool.
isErroroptional: Not yet described.
durataMsoptional: How long it ran, in milliseconds, when measured.
comandooptional: The command that ran, for a command.
cwdoptional: Where it ran.
stdoutoptional: Standard output, when the command produced some.
stderroptional: Standard error, when there was some (not necessarily an error).
exitCodeoptional: The exit code, when known.
inSfondooptional: Not yet described.
fileSfondooptional: Not yet described.
sfondoDaoptional: Not yet described.
receiptoptional: Not yet described.
outcomeoptional: Not yet described.
suspiciousoptional: Not yet described.

`StateDelta`

AG-UI

A change of the session’s state, as JSON Patch operations.

delta: The operations: /file/<path> when the agent wrote a file (value the new text, prima the text before, allegato a reference for binary files), /usage for the running token totals, /recuperoCronologia when the history was recovered on resume.

`ArtifactCreated`

TALOS

The agent made an interactive visual (artifact_create).

messageId: The message it belongs to.
id: The artifact: read it with GET /api/v1/artifacts/{artifactId}.
titolo: Its title.
voceLibreriaIdoptional: Not yet described.

`WorkspaceChanged`

TALOS

Files of the session’s folder changed on disk.

percorsi: The paths that changed.

`ApprovalRequested`

TALOS

The agent waits for your approval before an action.

requestId: Answer with POST /api/v1/sessions/{sessionId}/approve.
azione: The action: the tool and its arguments.

`QueuedMessageDelivered`

TALOS

A message you queued reached the model.

testo: The message.

`ApprovalResolved`

TALOS

The approval was answered.

requestId: The request.
approvato: true or false.
ambitooptional: Not yet described.
motivooptional: Not yet described.
rispostoDaoptional: Not yet described.

`UserQuestionRequested`

TALOS

The agent asks you a question (ask_user_question).

requestId: Answer with POST /api/v1/sessions/{sessionId}/question.
questions: The questions, each with its options.
atoptional: When it was asked.
toolCallIdoptional: The call that asked.
origineoptional: Who asked.
ripristinabileoptional: Whether the question survives a restart of the server.

`McpElicitationRequested`

TALOS

Not yet described: the fields below are read from the release.

requestId: Not yet described.
server: Not yet described.
mode: Not yet described.
message: Not yet described.
requestedSchemaoptional: Not yet described.
urloptional: Not yet described.
dominiooptional: Not yet described.
elicitationIdoptional: Not yet described.
atoptional: Not yet described.

`McpElicitationResolved`

TALOS

Not yet described: the fields below are read from the release.

requestId: Not yet described.
action: Not yet described.
atoptional: Not yet described.
daoptional: Not yet described.
motivooptional: Not yet described.

`UserQuestionResolved`

TALOS

The question was answered, skipped, cancelled or expired.

requestId: The request.
status: How it was resolved.
answersoptional: The answers.
skippedoptional: Not yet described.
notesoptional: Not yet described.
atoptional: When.
daoptional: Who resolved it.
motivooptional: Why, when it did not get an answer.
rispostoDaoptional: Not yet described.

`HookInvoked`

TALOS

A trusted hook ran (see Hooks).

hookId: The hook.
tipo: The event it ran for.
azione: The tool, for a tool event.
esito: Its verdict: { consentito, motivo? }.

`RuntimeFallback`

TALOS

The local engine failed and the turn continues on a cloud model (only with fallbackConsent).

from: local.
to: openrouter.
reason: The error of the local engine.
provider: local.
runtimeId: The local engine.
modelId: The local model.
backend: The engine that failed.
at: When.

Custom events

A CUSTOM event is { "type": "CUSTOM", "name": "…", "value": … }:

talos.agenti: An agent below this session (a child, or a child’s child) started, changed state or ended: a snapshot of it.
talos.coda: The queue of messages waiting for the model changed: { voci, inPausa }.
talos.compattazione: A compaction of the conversation: fase is inizio, fine or annullata, with the tokens before and after and whether it can be undone.
talos.processo-sfondo: Not yet described.
attesa-approvazione-silenzio: Not yet described.
talos.plan: A plan in Plan mode (talos.plan.v1): proposed, revised, approved or rejected.
talos.agent-dialogue: A question or an answer between this agent and its parent or child.
talos.impostazioni-sessione: The session’s settings changed (mode, permissions), for example after a plan is approved.
talos.richiesta-piano-fallita: A request to switch to Plan mode could not be applied.
talos.journal-riparato: The session’s journal was repaired when it was read back.
talos.provider-retry: Not yet described.
talos.fornitore-a-valle: Not yet described.
avviso-fornitore: Not yet described.
cambio-fornitore: The turn continued on another provider or model (a fallback).
consumo-fornitore: What a provider call consumed: tokens and, when known, cost.
talos.fine-rigiocata: The replay is over: the events before this one were already recorded, the ones after are live.

Workflow run stream

GET /api/v1/sessions/{sessionId}/workflows/{runId}/events streams named events; it closes when the run is over.

event: run-update: What changed in the run since the last sequence: steps, groups and states. id is the run’s new sequence number.
event: run-error: The stream failed: { code }. The stream closes.