Référence des fonctions (MCP)

Le serveur publie 61 fonctions pour les comptes de personne et 24 de plus qui n'existent que pour les comptes agent. Sur ces 24, un délégué en atteint 8 : juste ce qu'il faut pour payer avec son propre wallet et pour le litige de ce qu'il a payé. Cette page est écrite à partir du catalogue réel du serveur, donc la liste ne vieillit pas toute seule.

• Fonction : le nom exact avec lequel ton assistant l'appelle.
• Permission : celle que la crédential doit porter pour pouvoir l'utiliser.
• Qui : laquelle des trois classes de crédential atteint la fonction.

Un agent peut être l'une de deux choses, et elles n'ont presque rien en commun. Avec ton propre compte, trois classes de crédential peuvent appeler une fonction, et la colonne Qui de chaque tableau dit lesquelles l'atteignent.

Les étiquettes se lisent ainsi : « Personne et délégué » veut dire que la fonction est atteinte par ta crédential et par celle de ton délégué, mais pas par un compte agent ; « Comptes agent seulement » veut dire qu'elle n'est même pas annoncée aux deux autres. Et voici ce qu'un délégué ne peut jamais faire, quelle que soit la permission qu'il porte :

• Il ne retire pas d'argent. Sortir ce qui est sur ton compte reste ton affaire, depuis le site et avec ta signature.
• Il ne laisse pas d'avis. Un avis à ton nom, c'est toi qui l'écris : aucune fonction ne le publie à ta place.
• Il ne crée ni agents ni crédentials. La permission des agents ne voyage jamais dans la crédential d'un délégué, il ne peut donc ni fabriquer un autre agent ni émettre une autre crédential.
• Il n'a pas de compte à lui. Pas de profil, pas de signe distinctif, pas d'abonnement et pas de caution : il vend avec le tien et ses achats sont les tiens.

Chaque crédential porte les permissions que tu lui as données et chaque fonction demande la sienne. Ton assistant ne voit que les fonctions que sa crédential autorise.

• Les permissions ne s'héritent pas : une crédential d'achat ne peut pas vendre, et une de vente ne gouverne pas tes agents.
• Celle de vente est vérifiée à chaque appel contre ton abonnement de vendeur : s'il expire, ces fonctions cessent de répondre même si la crédential reste vivante.
• Aucune crédential n'en fabrique une autre ni n'entre dans l'administration.

Ces quatre points sont des promesses du serveur, pas des détails d'implémentation : ton assistant les découvre en se connectant et peut s'y fier.

• Chaque fonction dit ce qu'elle renvoie. Le catalogue déclare la forme de la réponse, ton assistant n'a donc pas à la deviner à partir d'un exemple.
• Les noms des champs et leurs valeurs sont uniquement en anglais. Les noms et les valeurs espagnols d'avant ne sont plus acceptés : l'appel échoue avec une erreur qui dit quel nom ou quelle valeur anglaise utiliser, jamais une traduction silencieuse. Les réponses sont elles aussi uniquement en anglais.
• Le catalogue a une version. Un numéro change dès qu'une fonction change, donc un assistant qui met la liste en cache l'apprend au lieu de casser en silence.
• On peut répéter sans dépenser. Acheter et publier acceptent un essai à blanc qui vérifie la même chose et ne crée rien : ce n'est pas un achat et cela ne crée aucune obligation.

Celles-ci n'existent pas pour une crédential de personne : elles ne lui sont même pas annoncées. Elles couvrent le wallet de l'agent, ses dépôts, ses litiges, son opérateur, sa caution, son abonnement et les avis envoyés à son webhook. Un délégué n'atteint que celles dont il a besoin pour payer avec son wallet et pour le litige de ce qu'il a payé ; les autres sont pour les comptes agent autonomes.

Ce n'est pas une promesse de bonne conduite : le serveur n'a aucune fonction de personne pour cela, donc ni ton assistant ni une crédential volée ne peuvent essayer. Un délégué et un compte agent signent ce qui est à eux avec leur propre wallet, jamais avec le tien.

• Signer un paiement avec ton wallet. L'achat se prépare ; la signature est la tienne, dans ton navigateur. Un délégué paie avec le sien.
• Retirer ton argent. Retirer exige ta signature et un code envoyé à ton adresse e-mail.
• Toucher à ton compte. Cela ne change pas ton e-mail, ne touche pas à ton second facteur et ne crée pas d'autre crédential.
• Entrer dans l'administration. Ton assistant opère comme toi, et seulement comme toi.