workspace_events · Documentation Subagent

Réservé à la vue : attend jusqu’à 18 secondes une navigation de cette instance.

En bref

Propriété	Valeur
Titre	Synchroniser l’établi
Outil MCP	`workspace_events`, sur `https://api.subagent.fr/mcp`
Appelé par	la vue uniquement : synchronisation de l’établi
Appel HTTP	`POST https://api.subagent.fr/v1/workspace_events`
Accès	toute clé
État de l’espace	vérifié ou non
Effet	lecture seule
Vue dans l’assistant	non

Ce que fait l’outil

Le serveur décrit l’outil ainsi à l’agent qui se branche :

Réservé à la vue : attend jusqu’à 18 secondes une navigation de cette instance. after_sequence est la dernière commande reçue ; ack_sequence la dernière appliquée. Les lectures et permissions sont revérifiées. Aucun envoi.

Paramètres

workspace_events accepte ces paramètres. Un paramètre inconnu est refusé avec le code invalid_argument.

Paramètre	Type	Obligatoire	Description
`instance_id`	texte	oui	Instance de cet établi.
`after_sequence`	entier	oui	Dernière commande reçue par cette vue ; zéro avant la première réception.
`ack_sequence`	entier	non	Dernière commande traitée par la vue. Ne peut dépasser la séquence déjà disponible.
`close`	booléen	non	Libère cette instance à la fermeture de la vue, sans attendre.
`local_navigation`	booléen	non	Barrière de séquence après un geste de navigation local. Invalide les commandes précédentes sans relire la page.

Résultat

L’outil rend un texte lisible en français et un objet structuré (structuredContent). En HTTP, la réponse est cet objet.

Champ	Type	Contenu
`_navigation`	objet	Nouvelle page à traiter dans cette instance : `instance_id`, sequence, route et result. Absent si unchanged ou closed vaut `true`.
`closed`	booléen	Instance libérée.
`instance_id`	texte	Instance de cet établi.
`sequence`	entier	Numéro de séquence de cette instance ; sert à ignorer les commandes anciennes. Présent selon la forme du résultat.
`status`	texte	pending ou superseded : navigation demandée, pas confirmation de son affichage.
`unchanged`	booléen	Aucune nouvelle page à appliquer.

Exemple d’appel

Les valeurs sont fictives.

HTTP

curl -X POST https://api.subagent.fr/v1/workspace_events \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "instance_id": "7e4b6dc2-3a91-4d85-8cf0-1e692b4c3a70",
  "after_sequence": 1,
  "ack_sequence": 1
}'

MCP · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "workspace_events",
    "arguments": {
      "instance_id": "7e4b6dc2-3a91-4d85-8cf0-1e692b4c3a70",
      "after_sequence": 1,
      "ack_sequence": 1
    }
  }
}

Refus possibles

Code	HTTP	Ce qui s’est passé	Que faire
`workspace_expired`	404	L’instance de l’établi a expiré, a été fermée, ou n’est pas accessible avec cette connexion.	Rouvrir avec `open_workspace`, puis reprendre le nouvel `instance_id` fourni par cette conversation.
`workspace_busy`	429	Deux synchronisations attendent déjà pour cette instance, ou le service a atteint sa limite de 64 attentes simultanées.	Garder une seule attente à la fois dans la vue, puis réessayer avec un délai.
`access_changed`	409	Les droits de la connexion ont changé pendant une lecture ou la synchronisation de l’établi.	Rouvrir l’établi avec l’accès actuel ; le contexte de l’ancien accès ne vaut plus.

S’y ajoutent les refus communs à tous les outils (unauthorized, forbidden, invalid_argument, rate_limited, internal) : voir Erreurs.

`workspace_events`