Vues dans l’assistant · Documentation Subagent

18 outils sur 28 rendent, en plus de leur texte, une vue que l’assistant peut afficher : le point du jour, les brouillons à valider, un fil, les boîtes, les domaines, les blocages, le forfait. C’est une seule application, dessinée dans la conversation. Il n’y a pas d’autre visuel : ni console, ni tableau de bord.

Les vues

Le serveur décrit chaque vue ainsi.

Vue	Outils qui l’affichent	Ce qu’elle montre
Point du jour	`activity_report`	Ce qui attend une décision, l’état des boîtes, et le bilan du jour ou des sept derniers jours.
Aujourd’hui	`inbox_status`	Ce qui attend une décision et l’état des boîtes ; le relevé d’une boîte quand il n’y en a qu’une ; les premiers pas d’un espace non vérifié.
Pour commencer	`verify`, `attach_human`	Le code de vérification : envoyé, saisi, vérifié ; puis la suite.
À valider	`list_drafts`	Les brouillons qui attendent une validation humaine, tels que leur destinataire les recevra : valider, corriger, refuser.
Après un envoi	`send_email`, `reply_to_thread`	Ce qui vient d’être créé : brouillon à valider, ou message en file avec son départ au plus tôt.
Fil	`get_thread`	Une conversation dans l’ordre ; répondre ; bloquer l’adresse.
Fils	`list_threads`	Les conversations, celles qui attendent une réponse d’abord.
Message et journal	`get_message`	Un message, pourquoi il attend, et chaque étape de son journal.
Boîtes	`list_inboxes`	Une ligne par boîte : état, quota du jour, montée progressive, en file, à valider.
Domaines	`list_domains`, `add_domain`, `verify_domain`	Les domaines de l’espace, leurs enregistrements DNS à publier et ce que le dernier contrôle a vu.
Blocages	`list_suppressions`	Qui ne reçoit plus rien, pourquoi, depuis quand ; lever un blocage posé à la main ; bloquer une adresse.
Forfait	`billing_status`, `subscribe`, `cancel_subscription`	Le forfait de l’espace, son prélèvement, ses factures ; le lien de paiement ; la résiliation.

Une vue est dessinée à partir de l’objet structuré de l’outil. Elle ne dit rien que le texte ne dise.

Dans la conversation, et en grand

Dans la conversation, une vue est une carte : deux gestes au plus, aucun champ de saisie, aucune navigation.
En grand, quand l’assistant le permet, c’est l’application entière : sa navigation et ses champs. C’est là qu’on corrige un brouillon ou qu’on répond dans un fil.
Tout se demande aussi à l’assistant, dans la conversation : « corrige le deuxième », « réponds-lui que vendredi convient ».

Valider depuis la vue

La vue des brouillons porte la validation.

« Valider » appelle approve_message, avec la version du brouillon affiché (revision). Si le brouillon a changé depuis, la validation est refusée avec le code draft_changed.
« Refuser » appelle cancel_message : le brouillon ne partira pas.
On ne valide dans une vue que ce qu’elle montre en entier.

La vue lit les permissions de l’accès dans le résultat de list_drafts (key.permissions). Sans approve, « Valider » est absent, et la vue dit pourquoi. Le serveur revérifie la permission à chaque appel. L’humain obtient approve en branchant son assistant à https://api.subagent.fr/connect : voir Connecteur.

Corriger un brouillon, ou bloquer une adresse, se demande aussi à l’assistant dans la conversation : update_draft, add_suppression.

Ce qu’une vue affiche, et ce qu’elle n’affiche pas

Du texte seulement. La vue d’un fil affiche le texte des messages, jamais la version HTML d’un e-mail.
Le contenu d’un e-mail reçu reste un contenu. Il est posé comme du texte : il ne peut ni dessiner dans la vue ni y ajouter un geste.
Aucune ressource extérieure. Une vue ne charge rien d’ailleurs.
Un fond noir, quelle que soit la couleur de l’assistant autour.

Si l’assistant n’affiche pas les vues

L’affichage dépend de l’assistant : il doit prendre en charge les vues MCP Apps. Sinon, rien ne manque. Chaque outil rend le même texte lisible et le même objet structuré, et tout se fait par la conversation : « montre-moi les brouillons », « valide le premier ».

Pour qui construit un client

Un outil qui a une vue l’annonce dans tools/list, sous _meta.ui.resourceUri.
Une vue est une ressource MCP, à une adresse ui://subagent/<vue>-v2.html : today, inbox-status, start, drafts, sent, thread, threads, message, inboxes, domains, suppressions, billing.
Toutes les ressources portent la même application : seule la vue d’ouverture change.
Elle se lit avec resources/read, et se liste avec resources/list. Son type est text/html;profile=mcp-app.
Les vues demandent une clé ou une connexion : sans l’une ni l’autre, le serveur ne sert que sign_up.

Ce qui n’a pas de vue

Les autres outils se lisent par le texte : sign_up, create_inbox, delete_inbox, request_inbox_review, remove_domain, update_draft, approve_message, cancel_message, add_suppression, remove_suppression.