@ai-for-dev/providers0.4.1

@ai-for-dev/providers

Providers Pi pour la formation AI4Dev. Le paquet ajoute deux fournisseurs de modèles :

Installation

pi install npm:@ai-for-dev/providers

Utilisation

1. Lancez pi.
2. Tapez /login ia4dev-ilaas (ou /login ia4dev-gricad) et collez votre clé API.
3. Choisissez un modèle avec /model.

La liste des modèles est lue sur le serveur (GET /models) avec votre clé. Elle se met à jour au démarrage, à l'ouverture de /model et après /login.

Vous pouvez aussi fournir la clé par variable d'environnement : ILAAS_API_KEY ou GRICAD_API_KEY.

Changer d'URL

IA4DEV_ILAAS_BASE_URL et IA4DEV_GRICAD_BASE_URL remplacent l'URL par défaut.

Réglages des modèles

extensions/index.ts contient, pour chaque serveur, une table des modèles connus : taille du contexte, sortie maximale, lecture d'images et gestion du raisonnement. Ces valeurs ont été mesurées sur les serveurs. Le raisonnement peut être :

• réglable par niveau : Pi propose off, low, medium et high, et envoie enable_thinking et reasoning_effort dans chat_template_kwargs. La table donne la valeur à envoyer pour chaque niveau, car chaque modèle a son vocabulaire (xhigh pour Qwen 3.8, max pour DeepSeek V4.1) ;
• activable (toggle) : le modèle ne sait que réfléchir ou non. Pi propose off et high, et passe par chat_template_kwargs.enable_thinking ;
• permanent (always) : Pi ne propose que high ;
• absent (none) : Pi n'envoie aucun paramètre de raisonnement.

Seuls qwen-3.8-27b et ARES/DeepSeek-V4.1-Flash sur IA4Dev lisent un niveau d'effort dans leur modèle de chat. Ceux de Qwen 3.6 et de Gemma 4 ne connaissent que enable_thinking. Sur ILAAS, scaleway/qwen3.8-27b est le même modèle que qwen-3.8-27b, mais Scaleway ne transmet pas chat_template_kwargs : il réfléchit toujours, quel que soit le niveau demandé.

Un modèle marqué hidden: true n'apparaît pas, même si le serveur le liste. Un modèle qui n'est pas dans la table reste utilisable. Il prend la taille de contexte donnée par le serveur (128 000 tokens à défaut), 32 768 tokens de sortie, sans images ni raisonnement.

Exporter un models.json

Certains outils lisent un models.json mais ne chargent pas d'extension. C'est le cas de trysquare, qui lance pi sans extension et relaie la clé lui-même. Pour eux, le paquet écrit ses deux fournisseurs au format de ~/.pi/agent/models.json :

npm ci
npm run export-models -- chemin/vers/models.json   # sans chemin, le fichier sort sur stdout

L'export lit seulement la table de extensions/index.ts, sans appeler les serveurs : une même version du paquet écrit toujours le même fichier. Les modèles marqués hidden sont exclus, et un modèle sans contextWindow dans la table fait échouer l'export. Les clés restent des références ($ILAAS_API_KEY, $GRICAD_API_KEY) que pi lit dans l'environnement. IA4DEV_ILAAS_BASE_URL et IA4DEV_GRICAD_BASE_URL changent l'URL écrite, comme pour l'extension.

Limites

• Un fournisseur déjà défini sous le même nom dans ~/.pi/agent/models.json prend le dessus sur celui du paquet.
• La liste des modèles est mise en cache. Après un changement d'URL, elle se met à jour au prochain rafraîchissement (/model ou /login).

Développement

npm ci
npm run typecheck
npm test

Les tests tournent hors ligne : un faux pi et un fetch simulé remplacent Pi et les serveurs.

Publication

La publication reprend le fonctionnement de @ai-for-dev/combo :

1. Lancer le workflow release-please à la main. Il ouvre une pull request avec le CHANGELOG.md et la nouvelle version, calculés à partir des titres de commits (conventional commits).
2. Fusionner cette pull request, puis relancer release-please. Ce second passage crée le tag et la release GitHub.
3. La release déclenche publish, qui vérifie le code et envoie le paquet sur npm en mode « staged ».
4. Approuver la version depuis une machine qui peut répondre à la double authentification : npm stage list, puis npm stage approve <id>.

Le dépôt a besoin du secret RELEASE_PLEASE (un token GitHub qui peut écrire le contenu et les pull requests), et npm doit déclarer ce dépôt et publish.yml comme éditeur de confiance (trusted publisher) pour @ai-for-dev/providers.