La main courante · Documentation Subagent

La main courante dit qui a fait quoi, et quand, dans votre espace : votre agent, vous depuis votre assistant, ou le service lui-même. Dans l’application, chaque objet porte la sienne, et l’on demande à l’agent au pied de ce journal.

Qui a fait quoi

Chaque ligne a un auteur, l’actor :

`kind`	Qui	Ce que montre l’application
`agent`	Une clé d’API : un agent qui travaille avec sa propre clé.	Le nom de la clé.
`human`	La connexion d’un assistant (Claude, ChatGPT…) : un humain et son assistant.	« Vous » quand c’est la connexion qui lit (`you` = `true`), sinon son nom.
`service`	Subagent lui-même : réception, envoi, coupe-circuit, administration.	« Subagent ».

Une connexion d’assistant agit au nom de son humain : ce que l’assistant fait par elle, et ce que l’humain fait dans la vue, portent le même auteur.

Chaque ligne a aussi une phrase en français (« Brouillon validé », « Réponse reçue de … », « Campagne mise en pause »). Elle ne reprend jamais ce qu’un tiers a écrit : ni l’objet ni le corps d’un e-mail reçu, seulement une adresse.

Par jour, ou par objet

list_events sans objet rend la journée demandée (aujourd’hui par défaut, heure de Paris). Avec un objet (une boîte, un fil, un message, une campagne, une audience, un contact ou un domaine), il rend tout ce qui le touche, du plus récent au plus ancien. Une clé limitée à certaines boîtes n’en voit que les lignes de ses boîtes.

L’auteur d’un message, et la version d’avant

Tout message sortant porte created_by : l’auteur qui l’a écrit, au même format. Un brouillon que quelqu’un corrige garde la version qu’il remplace, dans previous : son objet, son texte, son HTML, l’heure et l’auteur de la correction. Corriger le brouillon avec ces valeurs, c’est revenir en arrière, et l’on peut revenir du retour. Une campagne et un modèle gardent de même leur version d’avant (voir Campagnes). Un message validé ou annulé n’a plus de version d’avant.

Les outils

workspace_snapshot sert l’application elle-même : il prépare d’un coup les premières pages des rubriques qu’une connexion peut lire, pour que la navigation dans la vue ne relise pas tout. Un agent n’a pas à l’appeler.

`list_events`

Lit la main courante de l’espace : qui a fait quoi, et quand (votre agent, vous depuis votre assistant, ou le service). Accès : read.

Paramètre	Type	Obligatoire	Description
`day`	texte	non	Un jour de Paris, AAAA-MM-JJ. Absent : aujourd’hui, sauf si un objet est donné (alors tout son historique).
`inbox_id`	identifiant `inb_…`	non	Une boîte (inb_…).
`thread_id`	identifiant `thr_…`	non	Un fil (thr_…).
`message_id`	identifiant `msg_…`	non	Un message (msg_…).
`campaign_id`	identifiant `cmp_…`	non	Une campagne (cmp_…).
`audience_id`	identifiant `aud_…`	non	Une audience (aud_…).
`contact`	texte	non	Une adresse : ses fils, sa fiche, ses blocages.
`domain`	texte	non	Un domaine : ses vérifications et ses boîtes.
`cursor`	texte	non	Curseur de la page suivante : la valeur next_cursor de l’appel précédent.
`limit`	entier	non	Le nombre de lignes rendues, de 1 à 200. 50 par défaut.

Référence complète

`workspace_snapshot`

Précharge les premières pages des rubriques autorisées pour cette connexion. Accès : toute clé.

Paramètre	Type	Obligatoire	Description
`known_revision`	texte	non	Révision opaque précédemment reçue, facultative.

Référence complète