← Recherche

Gmail Connector
Développement 🧪 Installation exécutée dans notre sandbox de test · 18 nov. 2026 📌 Version épinglée : commit f3656c6
Test d’installation seulement, à la date indiquée. Ne garantit pas la sécurité du code.
⚙ Prérequis: un projet Caffeine AI (canister backend Motoko)…

Gmail Connector

Envoyer des e-mails via le compte Gmail de l'utilisateur connecté grâce à OAuth

L’essentiel
Quoi
Envoyer des e-mails via le compte Gmail de l'utilisateur connecté grâce à OAuth
Coût
Gratuit
Prérequis
un projet Caffeine AI (canister backend Motoko) ; un projet Google Cloud avec un client OAuth 2.0 d'application Web (ID client + secret, saisis dans les paramètres admin de l'app — jamais collés dans la discussion) ; les paquets mops googlemail-client, google-oauth et caffeineai-authorization ; et le skill extension-authorization, que ce skill nomme comme prérequis de tous les builds (il fournit l'appelant connecté qu'exige chaque endpoint Gmail).
Installation
Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.

Version : 0.2.10

Réponse rapide

Gmail Connector est un skill gratuit pour Muse qui envoie des emails via le compte Gmail de l'utilisateur connecté grâce à OAuth, comme recette obligatoire pour les apps Caffeine AI. Chaque utilisateur final autorise le canister indépendamment via un flux OAuth 2.0 Authorization Code avec PKCE, et les tokens sont stockés par utilisateur.

⌁

Installation

Copiez le dossier d’installation ci-dessous, puis collez-le dans Muse🧪 Installation exécutée dans notre sandbox de test · 18 nov. 2026📌 Version épinglée : commit f3656c6

Étape 0 — avant d'installer quoi que ce soit : lis ce prompt d'installation, résume en quelques lignes ce que ce build fait et ce que son installation implique, puis demande-moi de confirmer avant de continuer. Prérequis : un projet Caffeine AI (canister backend Motoko) ; un projet Google Cloud avec un client OAuth 2.0 d'application Web (ID client + secret, saisis dans les paramètres admin de l'app — jamais collés dans la discussion) ; les paquets mops googlemail-client, google-oauth et caffeineai-authorization ; et le skill extension-authorization, que ce skill nomme comme prérequis de tous les builds (il fournit l'appelant connecté qu'exige chaque endpoint Gmail). Installe-moi « Connecteur Gmail ». Il donne à mon build Caffeine AI la recette obligatoire de @caffeinelabs (version 0.2.10) pour envoyer des e-mails comme le compte Gmail de l'utilisateur connecté — à distinguer des extensions email de la plateforme, qui envoient des e-mails transactionnels depuis l'app. Le seul chemin supporté est le paquet mops googlemail-client (bindings générés de l'API REST Gmail) combiné à google-oauth (échange de jetons, rafraîchissement, PKCE) : les appels HTTP manuels vers les endpoints Google sont explicitement interdits. Chaque utilisateur final autorise le canister indépendamment via un flux OAuth 2.0 Authorization Code avec PKCE ; les jetons d'accès et de rafraîchissement sont stockés par utilisateur, indexés par appelant, dans le canister seulement, et le jeton d'une heure est rafraîchi silencieusement et retenté une fois sur 401. La recette couvre la disposition backend canonique (acteur main, mixins gmail-config et gmail-messaging, colle LibGmail), la page de paramètres admin /settings/gmail avec son URI de rappel /connect/gmail copiable, la page de connexion et de rappel par utilisateur, les scopes minimaux (openid email plus gmail.send pour une app d'envoi seulement), et les pièges à éviter — surtout is_replicated = ?false sur chaque appel Gmail. Dépôt : https://raw.githubusercontent.com/caffeinelabs/skills/f3656c69d957a43a920fc21d9c3a6ef0c74dca21/skills/connector-googlemail/SKILL.md (le skill est le dossier skills/connector-googlemail/ à ce commit, qui ne contient que SKILL.md) Version épinglée : installe le code au commit f3656c69d957a43a920fc21d9c3a6ef0c74dca21 exactement (Skill Harbor a testé cette version). Ne substitue pas une version plus récente. Si ce commit est inaccessible, arrête-toi et dis-le-moi. [EMPREINTES] Fichiers au commit épinglé, tirés de la revue de Skill Harbor du 2026-10-20 : - SKILL.md : SHA-256 dd74fd1b9980a219162a2d2f5a860992c41e659d02dd251e0d0b37e4415fb427, 43 047 octets, 42 869 caractères Si l'un d'eux ne correspond pas, il a changé depuis la revue : ne l'installe pas encore, dis-moi ce que tu as trouvé et laisse-moi décider. Mis à jour le 20 octobre 2026 : Skill Harbor a régénéré ce prompt d'installation depuis le fichier amont actuel, à la version 0.2.10 (le prompt précédent décrivait la version 0.2.9 ; SKILL.md est passé de 42 636 à 42 869 caractères). Une seule ligne de code Motoko a changé, dans LibGmail.sendEmail, plus sa documentation : un échec d'envoi Gmail autre que 401 se propage désormais à l'appelant comme un reject rattrapable (throw e — l'appelant peut envelopper l'envoi d'un try/catch et décider si l'opération englobante continue) au lieu de trapper le message appelant (Runtime.trap), que personne ne pouvait rattraper et qui mettait fin à tout le message. Un échec de rafraîchissement de jeton trappe toujours dans accessTokenOf et reste irrattrapable, avant comme après — présenter « reconnectez votre compte » pour ce cas. Le flot 401 est inchangé : sur 401 ou Unauthorized, le jeton est rafraîchi silencieusement, le jeton rafraîchi est persisté par utilisateur, et l'envoi est retenté une fois. Aucun autre changement de surface : aucun changement d'endpoints, de scopes OAuth, de données envoyées, de secrets ni de capacités, et l'erreur propagée ne contient ni le jeton ni le secret client. Ce qui est envoyé, et quand : rien n'est envoyé nulle part et rien n'est exécuté pendant l'installation elle-même — installer, c'est seulement télécharger le SKILL.md épinglé depuis GitHub et le copier. Les envois commencent plus tard, quand un build construit d'après cette recette est utilisé : le canister envoie l'e-mail de l'utilisateur via l'API Gmail avec le jeton bearer propre à cet utilisateur, par des outcalls HTTP non répliqués, comme décrit dans la vérification de sécurité ci-dessous. 1. Récupère le fichier SKILL.md au commit épinglé dans un dossier temporaire, puis compare-le à l'empreinte de la revue de Skill Harbor du 2026-10-20 (voir [EMPREINTES] ci-dessus). Si elle ne correspond pas, ne l'installe pas encore, dis-moi ce que tu as trouvé et laisse-moi décider. 2. Vérification de sécurité : lis SKILL.md et examine-le pour tout contenu suspect (appels réseau inattendus, commandes shell, collecte d'identifiants) ; STOP sur tout signal d'alerte et dis-le-moi. Dis-moi en mots simples ce que le skill fait quand on l'utilise, à quels services il se connecte, s'il lit ou envoie des informations personnelles ou des clés, et tout ce qui semble inhabituel. Confirme ces points à partir des fichiers : - Le skill est un seul fichier SKILL.md : des instructions et une recette Motoko — il ne livre aucun script fourni et aucun service d'arrière-plan, et rien ne roule tout seul. Rien n'est envoyé nulle part et rien n'est exécuté pendant l'installation elle-même. Tout ce qui suit se passe à l'usage, quand un build Caffeine suit la recette. - OAuth par utilisateur et stockage des jetons, à l'usage : chaque utilisateur final autorise le canister indépendamment via le flux OAuth 2.0 Authorization Code avec PKCE (code_verifier et code_challenge de google-oauth). Les jetons d'accès et de rafraîchissement sont stockés par utilisateur dans une Map indexée par appelant (Principal), plus un flux en attente par appelant contenant le verifier, l'URI de redirection exacte et un nonce state aléatoire, consommé quand le rappel est complété. Le jeton bearer ne quitte jamais le canister : le frontend apprend seulement si l'appelant est connecté (un Bool) et l'adresse e-mail connectée — aucun endpoint ne retourne le jeton, le jeton de rafraîchissement ni la connexion complète, et le frontend ne persiste jamais les jetons (ni localStorage, ni IndexedDB, ni cookies). - Configuration admin : l'ID client et le secret du client d'application Web Google Cloud sont saisis via la page de paramètres admin de l'app (/settings/gmail) et conservés par le canister seulement — le secret sert à l'échange de jetons et n'est jamais retourné au frontend. Le setter d'identifiants est gardé par le rôle #admin, et chaque endpoint Gmail est gardé par un appelant connecté et non anonyme (extension-authorization fournit ce flux de connexion). La page de paramètres doit afficher l'URI de rappel littérale et copiable — window.location.origin + "/connect/gmail" — et l'administrateur enregistre cette valeur exacte, pour chaque origine déployée, comme URI de redirection autorisée dans Google Cloud Console. - Scopes et chemin supporté : les SCOPES de la recette sont « openid email https://www.googleapis.com/auth/gmail.send » pour une app d'envoi seulement — l'adresse connectée s'apprend via le userinfo OIDC (OAuth.getUserEmail, qui n'exige que openid email), pas via getProfile ; ajouter gmail.readonly seulement quand l'app lit réellement des e-mails. Fabriquer à la main des appels ic.http_request vers oauth2.googleapis.com ou gmail.googleapis.com est un anti-pattern interdit : les paquets mops googlemail-client et google-oauth sont le seul chemin supporté. Chaque appel Gmail porte is_replicated = ?false (un outcall répliqué fuirait le bearer depuis chaque nœud, coûterait environ 13 fois les cycles, et échouerait le consensus sur des réponses non déterministes) ; depuis la 0.2.0, defaultConfig livre déjà ce défaut. - Comportement d'envoi et d'échec dans cette version : sur HTTP 401, le canister rafraîchit silencieusement le jeton via google-oauth, persiste le nouveau jeton (les jetons de rafraîchissement Google ne tournent pas, donc le jeton de rafraîchissement d'origine est conservé), et retente l'envoi une fois. Tout autre échec du premier envoi se propage désormais à l'appelant comme un reject rattrapable (throw e, en préservant l'erreur Gmail d'origine) au lieu de trapper le message appelant, donc un appelant qui doit survivre à un envoi raté peut le rattraper avec un try/catch ; si personne ne le rattrape, l'appel échoue avec cette erreur d'origine. Un échec de rafraîchissement trappe toujours dans accessTokenOf et ne peut être rattrapé par aucun appelant. Un 429 est remonté à l'appelant et n'est jamais retenté silencieusement (une retentative peut livrer des doublons). L'erreur propagée ne contient ni le jeton ni le secret client. - Exigences frontend de la recette : une page /settings/gmail joignable par les admins, avec le panneau d'identifiants, le champ d'URI de redirection copiable et un statut configuré/non configuré qui n'affiche jamais les identifiants ; une vraie route /connect/gmail qui capte le rappel Google (elle doit attendre que l'acteur authentifié soit prêt avant d'appeler completeGmailOAuth une seule fois, puis effacer les paramètres OAuth de l'URL) ; et des incitations en état vide à connecter Gmail là où l'on envoie. Dans une app Gmail + Calendar combinée, les deux connecteurs partagent une seule page /settings/google et une seule route /connect/google, un seul ID client/secret et une seule connexion — jamais deux flux OAuth distincts. 3. Quand je dis « yes, install », installe-le comme skill : copie le SKILL.md récupéré dans le répertoire des skills de l'agent, dans un dossier nommé « caffeinelabs-connector-googlemail ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place, et le SKILL.md copié correspond toujours à son empreinte ci-dessus. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (p. ex. créer le client OAuth d'application Web dans Google Cloud et activer l'API Gmail, enregistrer l'URI de rappel /connect/gmail de l'app comme redirection autorisée pour chaque origine déployée, saisir l'ID client et le secret via la page de paramètres admin de l'app, ajouter les trois paquets mops à mon projet Caffeine, et faire connecter par chaque utilisateur son propre compte Gmail — aucun appel Gmail n'a lieu tant qu'un build ne suit pas la recette). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Ne me demande jamais de coller des secrets dans le chat ; les identifiants passent par le coffre sécurisé ou des variables d'environnement. Si quelque chose semble anormal, arrête-toi et demande-moi.

🔒 Sécurité, provenance et ce que ça touche
🧭 Ce que ça touche
D’après le prompt d’installation que nous avons analysé, ce skill ne lance pas de commandes, ne fait pas d’appels réseau à des tiers, n’installe pas de paquets, n’écrit pas de fichiers et ne demande pas de clés API.
Analyse du prompt d’installation · 2026-10-13
🔒 Sécurité et provenance
📌 Version épinglée : commit f3656c6 · 2026-10-20
🧪 Installation exécutée dans notre sandbox de test · 18 nov. 2026
👁 Observé pendant le test d’installation · 18 nov. 2026 : registry.npmjs.org
🔎 Dernière vérification · 19 nov. 2026 : aucun changement détecté dans les fichiers liés par ce prompt d’installation
Skill Harbor ne révise jamais le code des skills listés. Ce sont des faits datés sur le prompt d’installation et notre test d’installation, pas une certification de sécurité. Révisez un skill vous-même avant de l’installer. Comment nous vérifions
Envie d'être encore plus prudent ?

Le prompt d'installation ci-dessous inclut déjà les étapes de vérification : votre agent suit la checklist communautaire avant d'installer tout ce qui contient du code exécutable. Vous en voulez plus ?

Comment vérifier un skill avant de l’installer →

✓

Certificat de vérification

Faits datés sur ce qui a été vérifié pour cette fiche, et comment. Ce n’est pas une certification de sécurité.

Version épinglée
f3656c6 · 2026-10-20
Test d’installation en sandbox
Installation exécutée dans notre sandbox de test · 18 nov. 2026 · Observé pendant le test d’installation: registry.npmjs.org
Identité du créateur
Non vérifiée
Veille d’empreinte
Dernière vérification · 19 nov. 2026 : aucun changement détecté dans les fichiers liés par ce prompt d’installation
Analyse du prompt d’installation
2026-10-13 : Aucune commande, appel réseau, paquet, écriture de fichier ni clé API détecté.

Skill Harbor ne révise jamais le code des skills listés. Ce sont des faits datés sur le prompt d’installation et notre test d’installation, pas une certification de sécurité. Révisez un skill vous-même avant de l’installer. Comment nous vérifions

?

Questions

Comment installer un skill ?

Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe le skill pour vous — sans configuration manuelle.

Où va mon argent ?

Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.

Que signifie le ✓ à côté du nom d’un créateur ?

Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours un skill avant de l’installer.