Le connecteur CoRoid est le programme qui permet aux agents de codage sur votre propre machine d'effectuer des tâches pour CoRoid (voir Agents de codage sur votre propre machine). Il est open source sous la licence Apache-2.0 et son code source complet se trouve à github.com/COROID-AI/coroid-connector. Cette page s'adresse à toute personne qui décide si ce connecteur peut être exécuté sur les machines de votre organisation.
Flux des données
Votre machine
Connecteur CoRoid
Logiciel open source. Démarre l'agent pour une session dans un répertoire vide et l'arrête ensuite.
Votre agent de codage
L'agent que vous utilisez, connecté en votre nom, avec ses propres outils désactivés.
- 1Demande du travail. Chaque requête est maintenue jusqu'à 25 secondes ; le connecteur transmet les commentaires de l'agent toutes les 3 secondes.
- 2Utilise les outils associés au rôle. Un jeton valable uniquement pour cette session, qui devient inactif à la fin de celle-ci.
- 3Interroge son modèle. Comme cela se passerait sans CoRoid. CoRoid ne voit jamais cet identifiant.
CoRoid
Orchestrateur
Attribue le travail lié au rôle à la machine de la personne ayant lancé la tâche (1).
Les outils associés au rôle
Exécution dans l'environnement isolé de la tâche, où votre code reste conservé (2).
Le fournisseur de l'agent
Répond aux requêtes du modèle de l'agent sous votre propre identifiant, selon votre abonnement (3).
Rien n'accède à la machine : le connecteur n'ouvre aucun port, n'envoie aucun fichier et n'exécute aucune commande propre.
Sur la machine restent votre identifiant pour l'agent et tout ce que l'agent conserve de la session.
- Uniquement sortant. Le connecteur n'ouvre aucun port, sauf pendant un court instant
127.0.0.1lorsque vous vous connectez. Il demande du travail à CoRoid via HTTPS. Chaque requête est conservée jusqu'à 25 secondes avant d'être renouvelée ; c'est aussi ainsi que CoRoid sait que la machine est connectée. - Votre code reste dans CoRoid. Le dépôt n'est jamais copié sur la machine. Les outils associés au rôle (lire un fichier, exécuter les tests, modifier le code) s'exécutent dans l'environnement isolé de la tâche dans CoRoid. Ce qui arrive sur la machine, ce sont les instructions du rôle et les résultats de ces outils, comme le contenu d'un fichier lu par l'agent ou les résultats d'un test.
- Les requêtes du modèle de l'agent sont envoyées à son fournisseur, sous votre propre connexion et selon votre abonnement, comme cela se ferait sans CoRoid. Ce que l'agent envoie à son modèle inclut les résultats des outils du rôle ; votre accord avec ce fournisseur s'applique donc à ces données.
- Le travail est attribué uniquement à la personne qui l'a lancé. Un rôle s'exécute sur une machine uniquement si son affectation désigne un agent, si la personne ayant lancé la tâche dispose d'une machine connectée dans cette organisation et si la politique de l'organisation autorise cet agent. Le travail non initié par quelqu'un, comme une automatisation, s'exécute sur son propre modèle.
Ce que fait le connecteur
- Se connecter via OAuth 2.1 et PKCE dans votre navigateur, pour un seul périmètre (
connector.turns). Le jeton d'accès est valable 15 minutes ; le jeton de rafraîchissement 30 jours et il est remplacé à chaque utilisation. Se déconnecter dans Vos machines révoque les deux. - Conserver ces jetons dans le porte-clés macOS ou le service Secret Service d'un bureau Linux, en les transmettant à ces outils en entrée standard, jamais en ligne de commande. Lorsqu'aucun de ces moyens n'est disponible, ils sont stockés dans un fichier accessible uniquement par vous.
coroid-connector statusindique où se trouvent les vôtres. - Informe CoRoid, lors de sa première requête, du nom de la machine, de son système d'exploitation, de sa propre version, ainsi que de la version, de l'état et des modèles proposés par chaque agent.
- Exécuter un tour : lance l'agent dans un répertoire vide et nouveau, avec ses propres outils désactivés, lui fournit un ensemble d'outils (les outils du rôle pour ce tour), transmet ce qu'il dit, refuse toute demande de permission qui ne concerne pas ces outils, puis l'arrête. Ensuite, le répertoire est supprimé.
Ce qu'il ne fait pas
- Lire ou envoyer vos fichiers, ou exécuter une commande propre. Le seul fichier qu'il lit qui n'est pas le sien est la configuration de Cursor, pour les deux valeurs déterminant s'il peut utiliser Cursor (voir Limites) ; rien de ces données ne quitte la machine.
- Permettre à l'agent d'utiliser son shell, l'édition de fichiers, la recherche web ou ses propres serveurs et connecteurs MCP. Chaque agent est lancé avec son propre paramètre pour cela, selon les versions d'agent testées ; un agent sur une autre version est listé mais non utilisé.
- Ouvrir un port accessible à d'autres, ou recevoir des instructions de quiconque sauf CoRoid via la connexion qu'il a établie.
- Télécharger quoi que ce soit lors de son exécution.
coroid-connector addinstalle l'adaptateur d'un agent une fois, à partir exactement des paquets indiqués dans le fichier lockfile de sa version (chaque paquet étant verrouillé par sa version et son hash SHA-512), avec les scripts d'installation désactivés.
Les requêtes qu'il émet
| Vers | Quand | À quelle fin |
|---|---|---|
Le API de CoRoid (https://api.coroid.ai) | Se connecter et se déconnecter | Enregistrer le connecteur, échanger, renouveler et révoquer ses jetons (/oauth/…) |
| Le API de CoRoid | Pendant son exécution | Demander du travail (/connector/v1/poll) et signaler un tour (/connector/v1/turns/…/events) |
| Le registre npm | Uniquement pendant coroid-connector add | Les paquets de l'adaptateur correspondent aux noms du fichier lockfile de la version. |
C'est l'agent, et non le connecteur, qui appelle les outils du rôle (une adresse sous
/connector/v1/turns/, avec le jeton de ce tour) et son propre fournisseur.
Ce pour quoi il est conçu
| Si | Alors |
|---|---|
| Quelqu'un d'autre demande à connecter une machine à votre place | L'approbation se fait dans votre navigateur, en vous connectant en tant que vous, et la connexion n'est validée que sur la machine qui l'a initiée (à 127.0.0.1, avec PKCE). N'approuvez qu'un connecteur que vous avez démarré il y a peu. |
| Les jetons d'un connecteur sont volés. | Ils n'accèdent qu'à un seul périmètre : demander les tâches de cette personne et en rendre compte. Le jeton d'accès expire en moins de 15 minutes, et la fonction Déconnexion révoque les deux. |
| Le jeton d'une itération est réutilisé. | Il fonctionne uniquement pour cette itération et cesse de fonctionner à la fin de celle-ci. |
| Une itération demande autre chose à l'agent. | Les outils propres à l'agent sont désactivés et le connecteur refuse d'autres demandes d'autorisation. Les outils du rôle sont identiques à ceux d'un modèle cloud, avec les mêmes contrôles de qualité, revues, seuils et limites d'étapes. |
| Une version publiée ne correspond pas à ce que sa source indique. | Chaque version est générée par les Actions de GitHub à partir d'une validation du dépôt public, attestée, puis publiée sur npm avec provenance. La formule Homebrew n'accepte une nouvelle version que après avoir vérifié son attestation. Vous pouvez en vérifier une vous-même (ci-dessous). |
Limites
- L'agent s'exécute sous votre identité, avec les droits de votre utilisateur sur la machine. Le fait de le limiter aux outils de CoRoid dépend du commutateur propre à chaque agent ; c'est pourquoi le connecteur n'utilise un agent que pour les versions sur lesquelles il a été testé.
- Ce qu'un agent conserve d'une itération dans son propre stockage dépend de l'agent (voir Ce qui reste sur votre machine). La politique de votre organisation détermine quels agents ses membres peuvent utiliser (voir Ce que votre organisation autorise).
- Cursor demande une autorisation avant d'effectuer des requêtes web, des recherches web et d'utiliser le navigateur, uniquement dans ses paramètres par défaut. Le connecteur lit deux de ces paramètres sur la machine (le mode d'approbation et la possibilité d'accepter automatiquement les recherches web) et n'utilise pas Cursor lorsque ces paramètres lui permettent d'exécuter ces outils sans demander.
- Le connecteur n'a pas été testé sous Windows.
Vérifier une version publiée
Chaque version sur GitHub contient le paquet publié, le fichier du connecteur, une liste de composants CycloneDX et SHA256SUMS. Remplacez <version> par la version que vous vérifiez.
La signature du registre et la provenance du paquet npm :
mkdir check && cd check && npm init -y
npm install @coroid/connector@<version>
npm audit signaturesL'attestation, qui indique la validation et le workflow ayant généré le fichier :
gh release download v<version> --repo COROID-AI/coroid-connector
gh attestation verify coroid-connector-<version>.tgz --repo COROID-AI/coroid-connector \
--signer-workflow COROID-AI/coroid-connector/.github/workflows/release.ymlLe fichier, généré vous-même à partir de la source validée :
git clone https://github.com/COROID-AI/coroid-connector && cd coroid-connector
git checkout v<version> && npm ci && npm run build
shasum -a 256 dist/coroid-connector.mjs # the same as its line in SHA256SUMSPour signaler une vulnérabilité, utilisez la politique de sécurité du dépôt (le système privé de signalement de vulnérabilités de GitHub).