session_start

Open an observability session so your work shows up as a live, timestamped thread in the Sonenta dashboard. Call this ONCE at the very start of a task, before touching anything. After it returns, every later MCP call you make is automatically attached to this session's thread (no extra wiring) - so real mutations (keys created, translations proposed, variants set…) are captured even if you never call annotate. Returns {session_id, status, channel}. Idempotent per (project, session_ref) while a running session with that ref exists. Observability is always free (0 credits).

Parameters

Name	Type		Description
project_uuid	string	optional	Project UUID. Required when multiple projects are configured (SONENTA_PROJECTS); defaults to the single configured project otherwise.
agent	string	required	Stable agent label shown in the dashboard thread, e.g. 'sonenta-source-health' or 'sonenta-a11y'. Use your own agent name.
agent_type	string	optional	Your kind, for the dashboard filter/badge: one of i18n | a11y | surface | source-health, or a free string for a custom agent.
agent_version	string	optional	1.0.0).
title	string	optional	Optional one-line human-readable title for this run, e.g. 'Repair placeholder drift'.
session_ref	string	optional	Optional client idempotency key; reusing it while a session is still running returns that same session.
metadata	object	optional	Optional opaque object echoed back in the session detail (free-form run context).

Example

{
  "tool": "session_start",
  "arguments": {
    "agent": "<agent>"
  }
}