@clicbase/mcp 0.2.0 → 0.3.0

package/README.md

@@ -21,6 +21,9 @@ Outils :
 - `list_site_files` — liste les fichiers d'un site heberge (nom, taille, date).
 - `read_site_file` — rend le contenu d'UN fichier, en base64 cote API, decode cote outil.
 - `clicbase_conventions` — les regles de la plateforme : policies RLS, droits, PostgREST.
+- `list_sftp_accounts` — les comptes SFTP dedies d'un site (noms, jamais de mot de passe).
+- `create_sftp_account` — cree un compte SFTP DEDIE, rend ses identifiants une seule fois.
+- `delete_sftp_account` — le supprime.
 
 ## Les fichiers d'un site
 
@@ -51,6 +54,34 @@ SERVIS par le serveur web ; elle protege exactement le bon flanc.
 Plafond : 2 Mo cote API, 256 Ko cote outil. Au-dela, le telechargement du
 tableau de bord ou le SFTP.
 
+## Le SFTP, sans donner le mot de passe du site
+
+`ftpUsername` est l'IDENTITE d'un site : il ouvre tout le dossier, ne se scope
+pas, n'expire pas, ne laisse aucune trace distinguable, et ne se revoque qu'en
+le changeant partout ou il a ete colle. Le confier a un assistant, c'est lui
+donner le site.
+
+`create_sftp_account` fabrique un compte ADDITIONNEL sur le meme dossier, rend
+host, port, identifiant et mot de passe UNE SEULE FOIS, et
+`delete_sftp_account` le retire. Preter un badge, pas sa cle.
+
+```
+list_sftp_accounts(site_id)                 -> les comptes dedies existants
+create_sftp_account(site_id)                -> host, port, user, password
+delete_sftp_account(site_id, username)      -> on referme
+```
+
+⚠️ `create_sftp_account` est classe SECRET : il ne modifie aucune donnee et
+rend pourtant de quoi ouvrir tout le dossier. Il disparait donc du mode
+restreint, comme `get_credentials` et `read_site_file`.
+
+⚠️ PLAFOND DE CINQ COMPTES PAR SITE, et cinq creations par tranche de cinq
+minutes. Chaque compte est un utilisateur systeme reel : un agent qui reprend
+sur erreur en recreant au lieu de reutiliser en fabriquerait des dizaines.
+
+Pour une simple consultation, `list_site_files` et `read_site_file` suffisent
+et ne creent rien.
+
 ## Lecture seule
 
 ```bash

package/clicbase-mcp.mjs

@@ -331,6 +331,50 @@ outils.tool(
   },
 );
 
+outils.tool(
+  "list_sftp_accounts",
+  "Liste les comptes SFTP DEDIES d'un site (identifiants et dates, jamais les mots de passe). L'id du site vient de GET /sites.",
+  { site_id: z.string() },
+  async ({ site_id }) => {
+    try {
+      return out(await admin(`/sites/${encodeURIComponent(site_id)}/sftp`));
+    } catch (e) {
+      return fail(e);
+    }
+  },
+);
+
+outils.tool(
+  "create_sftp_account",
+  "Cree un compte SFTP DEDIE sur un site et rend host, port, identifiant et mot de passe UNE SEULE FOIS. Ce n'est jamais le compte principal du site. Supprime-le quand tu as fini. Plafond : 5 comptes par site.",
+  { site_id: z.string() },
+  async ({ site_id }) => {
+    try {
+      return out(await admin(`/sites/${encodeURIComponent(site_id)}/sftp`, "POST"));
+    } catch (e) {
+      return fail(e);
+    }
+  },
+);
+
+outils.tool(
+  "delete_sftp_account",
+  "Supprime un compte SFTP dedie, par son identifiant. A faire des que le transfert est termine : un compte oublie reste un acces ouvert.",
+  { site_id: z.string(), username: z.string() },
+  async ({ site_id, username }) => {
+    try {
+      return out(
+        await admin(
+          `/sites/${encodeURIComponent(site_id)}/sftp?username=${encodeURIComponent(username)}`,
+          "DELETE",
+        ),
+      );
+    } catch (e) {
+      return fail(e);
+    }
+  },
+);
+
 // ⚠️ LE MODE RESTREINT S'ANNONCE, SUR LA SORTIE D'ERREUR. Un serveur qui
 // retire des outils en silence se decouvre en pleine session : l'assistant
 // cherche une fonction qui devrait exister, ne la trouve pas, et conclut que le

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clicbase/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "bin": {
     "mcp": "clicbase-mcp.mjs",

package/portee.mjs

@@ -56,6 +56,14 @@ export const OUTILS = {
   // la maison. Les fichiers caches, eux, sont deja impossibles cote serveur.
   list_site_files: "lecture",
   read_site_file: "secret",
+  // --- comptes SFTP dedies ---
+  // ⚠️ CREER REND UN MOT DE PASSE, DONC C'EST UN SECRET. L'outil ne modifie
+  // pas de donnees, mais il rend de quoi ouvrir tout le dossier du site : meme
+  // raisonnement que get_credentials. Lister ne rend que des noms, supprimer
+  // ne rend rien mais ecrit.
+  list_sftp_accounts: "lecture",
+  create_sftp_account: "secret",
+  delete_sftp_account: "ecriture",
 };
 
 /** Ce qu'on garde en lecture seule. */

package/savoir.mjs

@@ -35,7 +35,7 @@ SIX PIÈGES QUI NE LÈVENT AUCUNE ERREUR. Ils répondent tous « 200 OK ».
 5. Une fonction Edge renvoie \`{ status, body }\`, jamais \`new Response(...)\`.
 6. Deux authentifications sans rapport coexistent. Celle du PROJET (tes utilisateurs finaux) vit dans le schéma \`auth\` de cette base et alimente \`auth.uid()\` dans les policies. Celle de la PLATEFORME (le compte Clicbase) ne s'écrit jamais dans une policy.
 
-CE QUI N'EXISTE PAS, ET QUE DEUX ASSISTANTS ONT DEJA INVENTE. Il n'y a AUCUN registre Docker : ni \`docker login\`, ni \`docker pull\`, ni \`registry.*.clicbase.com\`. Ne devine aucun nom d'hote. Les fichiers d'un site heberge se lisent par \`list_site_files\` et \`read_site_file\`, et s'ecrivent par POST /sites/<id>/files. Inutile de reclamer un mot de passe SFTP pour cela : le SFTP reste utile pour un transfert volumineux, pas pour consulter. Les fichiers CACHES sont refuses a tout niveau, \`.env\` et \`.git\` compris : ils ne peuvent ni etre deposes ni etre lus. \`read_site_file\` est absent en lecture seule, parce qu'un source peut porter des identifiants dans un fichier non cache.
+CE QUI N'EXISTE PAS, ET QUE DEUX ASSISTANTS ONT DEJA INVENTE. Il n'y a AUCUN registre Docker : ni \`docker login\`, ni \`docker pull\`, ni \`registry.*.clicbase.com\`. Ne devine aucun nom d'hote. Les fichiers d'un site heberge se lisent par \`list_site_files\` et \`read_site_file\`, et s'ecrivent par POST /sites/<id>/files. Ne reclame JAMAIS le mot de passe SFTP principal du site : c'est son identite, elle ouvre tout et ne se revoque pas. Pour un transfert volumineux, \`create_sftp_account\` fabrique un compte DEDIE, rend ses identifiants une seule fois, et \`delete_sftp_account\` le retire. Supprime-le des que tu as fini. Les fichiers CACHES sont refuses a tout niveau, \`.env\` et \`.git\` compris : ils ne peuvent ni etre deposes ni etre lus. \`read_site_file\` est absent en lecture seule, parce qu'un source peut porter des identifiants dans un fichier non cache.
 
 APPELS REST : en-têtes \`apikey\` ET \`Authorization: Bearer\`, la même clé dans les deux. Filtres dans l'URL, façon PostgREST : \`?select=id,title&status=eq.published&order=created_at.desc\`.