Cline SDK

Qu’est-ce que Cline SDK ?

Cline SDK (@cline/sdk) est une base d’exécution d’agents TypeScript extraite de Cline, destinée à alimenter des workflows de codage agentiques sur plusieurs surfaces (IDE et CLI inclus). Son objectif principal est de fournir un « agent harness » modulaire et réutilisable ainsi qu’une architecture permettant aux équipes de créer et d’étendre des agents sans dépendre du cycle de vie d’une seule interface utilisateur.

Au lieu de coupler la boucle d’agent à une extension VS Code, la refonte de Cline traite le runtime comme un service partagé. Cela permet aux tâches de longue durée de se poursuivre indépendamment des redémarrages de l’interface et de déplacer les sessions entre surfaces tout en gardant la boucle d’agent de bas niveau réutilisable et sans état.

Fonctionnalités clés

• Architecture de runtime d’agent partagé : Sépare le runtime d’une implémentation IDE spécifique afin que le travail dépende moins des redémarrages de l’interface.
• Agent harness réutilisable (boucle sans état) : Maintient la boucle d’agent de bas niveau sans état et réutilisable, tandis qu’un runtime environnant peut être durable et portable.
• Pile TypeScript en couches : Utilise une conception en couches où chaque couche a une responsabilité unique ; vous pouvez choisir la pile complète ou des packages individuels selon vos besoins.
• Système de plugins au niveau du runtime : Les plugins peuvent enregistrer des outils, observer les événements du cycle de vie, ajouter des règles/commandes et façonner ce que le modèle voit.
• Chargement et packaging flexibles des plugins : Les plugins peuvent être chargés depuis des chemins configurés ou des emplacements de l’espace de travail et démarrer comme modules locaux .ts/.js avant d’évoluer vers des modules packagés via un manifeste cline.plugins.
• Support LLM via la couche provider (choix ouvert) : La couche provider prend en charge plusieurs fournisseurs et points de terminaison compatibles OpenAI ; le changement de fournisseur est conçu pour être piloté par la configuration.

Comment utiliser Cline SDK

1. Installer le SDK : Installez la pile complète avec npm i -g @cline/sdk.
2. Choisir la surface : Utilisez Cline SDK pour alimenter des agents dans VS Code, JetBrains et la CLI (les propres surfaces de Cline sont construites sur le SDK).
3. Étendre le comportement avec des plugins runtime : Créez un module de plugin (ou packagez-en un) capable d’enregistrer des outils et de réagir aux événements du cycle de vie.
4. Configurer l’accès au modèle/fournisseur : Utilisez la couche provider pour sélectionner le modèle/fournisseur qu’un agent doit appeler via la configuration.

Cas d’usage

• Travail agentique de longue durée entre redémarrages : Exécutez des tâches agentiques sans qu’elles « meurent » lors du redémarrage d’une interface, car le runtime est conçu pour être durable et non lié à un seul cycle de vie d’interface.
• Création d’agents persistants sur plusieurs surfaces : Déplacez des sessions entre différentes interfaces (par ex. IDE et CLI) tout en gardant la boucle d’agent sans état et réutilisable.
• Personnalisation d’agents spécifiques à l’équipe via plugins : Ajoutez un comportement propre au domaine (outils, règles ou commandes supplémentaires) en chargeant des plugins sans forker le runtime.
• Prototypage local, packaging ultérieur : Commencez avec un plugin implémenté comme module local .ts/.js, puis packagez-le dans un répertoire réutilisable lorsque l’équipe consolide la fonctionnalité avec un manifeste cline.plugins.
• Runtimes agentiques serverless ou composables : Utilisez des parties plus petites de la pile en couches (par ex. logique provider ou boucle sans état) lorsque vous souhaitez intégrer le comportement agentique dans un autre modèle de runtime.

FAQ

• Cline SDK est-il lié uniquement à l’extension VS Code ? Non. Le SDK est destiné à alimenter Cline sur VS Code, JetBrains et la CLI, et il est conçu pour que les équipes puissent construire sur le runtime plutôt que de réutiliser uniquement une implémentation spécifique à un IDE.

• Que signifie « sans état » dans la boucle d’agent ? La refonte maintient la boucle d’agent de bas niveau sans état et réutilisable, tandis que le runtime environnant assure la durabilité et la portabilité.

• Comment les plugins influencent-ils le comportement du modèle ? Les plugins peuvent enregistrer des outils, observer les événements du cycle de vie et façonner ce que l’agent voit (règles et commandes incluses) avant ou pendant l’exécution.

• Puis-je changer de fournisseur LLM sans réécrire l’agent ? La couche provider est décrite comme pilotée par la configuration, avec prise en charge de plusieurs fournisseurs et de points de terminaison compatibles OpenAI.

• Dois-je installer la pile complète du SDK pour commencer ? Le SDK est décrit comme en couches : vous pouvez installer la pile complète ou utiliser des packages individuels (tels que la couche provider ou la boucle sans état) pour des surfaces plus petites.

Alternatives

• Utiliser un framework d’agents existant avec un runtime personnalisé : Si vous avez besoin d’un contrôle total sur la persistance des sessions et l’orchestration des outils, les approches basées sur des frameworks d’agents existants peuvent être plus adaptées lorsque vous maintenez déjà votre propre runtime.
• Construire sur un modèle d’extension d’agent spécifique à un IDE : Certaines solutions conservent la boucle d’agent dans un plugin IDE ; elles peuvent être plus simples à démarrer, mais le comportement du runtime reste souvent lié au cycle de vie de l’interface utilisateur.
• Utiliser une couche générale d’orchestration d’outils LLM : Au lieu d’une architecture agent harness + runtime, une approche d’orchestration d’outils se concentre sur l’appel des modèles et des outils, laissant généralement la persistance des sessions et la gestion du cycle de vie à votre code applicatif.