agent_checkin

Rete di agenti · macOS · Windows

Effetto: scrittura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Annuncia questa sessione dell'agente alla mesh: il suo ruolo, il repository su cui sta lavorando e cosa può fare. La voce scade dopo ttl_seconds, quindi una sessione che resta in silenzio esce dalla directory invece di sembrare viva per sempre; un nuovo check-in la rinnova. agent_inbox consegna solo a una sessione che ha effettuato il check-in, e solo ciò che arriva dopo di esso, non l'arretrato. La prima chiamata restituisce un'anteprima e non annuncia nulla; confirm=true effettua il check-in.

Input obbligatori

agent_id

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — macOS

{
  "properties": {
    "agent_id": {
      "description": "Stable name for this agent session (e.g. 'builder', 'qa', 'release'). Reuse it across check-ins.",
      "type": "string"
    },
    "caps": {
      "description": "What this agent can do (e.g. ['merge','deploy'])",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "confirm": {
      "description": "Must be true to act. Without it the call returns a preview and changes nothing.",
      "type": "boolean"
    },
    "herdr_pane": {
      "description": "If you are running inside a Herdr-managed pane (check HERDR_ENV=1 first), your own pane id — e.g. $HERDR_PANE_ID. Registers this agent for #2540's automatic wake: when a Mesh message arrives, a fixed local prompt ('[auto-wake #2540] Hay N mensajes de Agent Mesh; llamá agent_inbox') is submitted to this pane via `herdr agent prompt`, so you get a real turn instead of a silent notification. The '[auto-wake #2540]' prefix is what tells you the turn came from the mesh and not from a person typing the same sentence. Never send the value of a remote message here — only your own pane id. Purely local: never sent to the mesh backend. Omit if you are not in Herdr.",
      "type": "string"
    },
    "repo": {
      "description": "Repo you are working on (e.g. 'local-mcp')",
      "type": "string"
    },
    "role": {
      "description": "What you are doing (e.g. 'builder', 'reviewer', 'release')",
      "type": "string"
    },
    "status": {
      "description": "What you are doing RIGHT NOW, one line (e.g. 'porting evernote to Go', 'measuring #1164 on 3674da7e'). agents_list shows it with its age, so peers can tell working from stuck — update it when your task changes.",
      "type": "string"
    },
    "ttl_seconds": {
      "description": "Seconds until this entry goes stale, 60-86400. Omit it and the default comes from `role`: 3600 for an agent that works (builder, reviewer…), 900 for 'ping' and 'verification'. Your presence also renews itself with every mesh call you make, so this is the silence you can afford, not how often you must check in.",
      "type": "integer"
    }
  },
  "required": [
    "agent_id"
  ],
  "type": "object"
}

Esempio documentale

Esempio di documentazione per agent_checkin. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "agent_id": "demo-reviewer",
  "confirm": false,
  "repo": "demo-project",
  "role": "reviewer",
  "status": "Reviewing the documentation example."
}

Windows