@connect-xlab/mcp-server 0.3.3 → 0.3.5

package/dist/index.js

@@ -199,6 +199,14 @@ import { rejectAssistantActionTool } from './tools/rejectAssistantAction.js';
 import { correctAssistantActionTool } from './tools/correctAssistantAction.js';
 import { requestAssistantPostDraftTool } from './tools/requestAssistantPostDraft.js';
 import { getAssistantSummaryTool } from './tools/getAssistantSummary.js';
+import { listPartnerAgentsTool } from './tools/listPartnerAgents.js';
+import { getPartnerAgentTool } from './tools/getPartnerAgent.js';
+import { createPartnerAgentTool } from './tools/createPartnerAgent.js';
+import { updatePartnerAgentTool } from './tools/updatePartnerAgent.js';
+import { setPartnerAgentPublishedTool } from './tools/setPartnerAgentPublished.js';
+import { deletePartnerAgentTool } from './tools/deletePartnerAgent.js';
+import { checkPartnerAgentLinksTool } from './tools/checkPartnerAgentLinks.js';
+import { getPartnerAgentStatsTool } from './tools/getPartnerAgentStats.js';
 const tools = [
     listLabsTool,
     listMembersTool,
@@ -397,6 +405,14 @@ const tools = [
     correctAssistantActionTool,
     requestAssistantPostDraftTool,
     getAssistantSummaryTool,
+    listPartnerAgentsTool,
+    getPartnerAgentTool,
+    createPartnerAgentTool,
+    updatePartnerAgentTool,
+    setPartnerAgentPublishedTool,
+    deletePartnerAgentTool,
+    checkPartnerAgentLinksTool,
+    getPartnerAgentStatsTool,
 ];
 const server = new Server({ name: 'connectxlab', version: '0.1.0' }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({

package/dist/tools/checkPartnerAgentLinks.js

@@ -0,0 +1,40 @@
+/**
+ * Tool `check_partner_agent_links` — verifie que des liens repondent.
+ * Scope : partner_agents.read. Super admin, Lab officiel uniquement.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const checkPartnerAgentLinksTool = {
+    name: 'check_partner_agent_links',
+    description: "Verifie que le lien d'affiliation et/ou le site de l'editeur repondent avant de les enregistrer. Simple avertissement : certains sites bloquent les verifications.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab officiel XLab' },
+            affiliate: { type: 'string', description: "Lien d'affiliation (https://)" },
+            landing: { type: 'string', description: "Site de l'editeur (https://)" },
+        },
+        required: ['lab'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        affiliate: z.string().max(2000).optional(),
+        landing: z.string().max(2000).optional(),
+    }),
+    async handler(args) {
+        const { lab, affiliate, landing } = this.zodSchema.parse(args);
+        const urls = {};
+        if (affiliate)
+            urls.affiliate = affiliate;
+        if (landing)
+            urls.landing = landing;
+        try {
+            const { data } = await http.post(`/mcp/labs/${encodeURIComponent(lab)}/partner-agents/check-links`, { urls });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/createLinkInBioBlock.js

@@ -23,7 +23,7 @@ export const createLinkInBioBlockTool = {
         "- kind=lab : autre Lab de l'owner (lab_group_id requis)\n" +
         "- kind=quiz : quiz du Lab (quiz_id requis). Le bloc reste masque sur la page publique tant que le quiz n'est pas publie et le plug-in Quiz active.\n" +
         "- kind=calendar : calendrier du Lab (calendar_event_id requis, ids via get_link_in_bio_catalog ou list_calendars). La reservation s'ouvre en fenetre sur la page publique. Masque si le calendrier est inactif ; un calendrier payant doit etre vendu dans une boutique Stripe active.\n" +
-        "Les ids se trouvent via get_link_in_bio_catalog. Champs optionnels : subtitle, image_url, layout (forme du bloc : classic = petite image + bouton a droite, par defaut ; image = texte et bouton a contour a gauche, grande image a droite ; button = image + titre en haut, gros bouton pleine largeur en dessous), button_label (texte du bouton, 60 car. max ; vide = texte par defaut du type de bloc). Position en fin de liste (utiliser reorder pour changer).",
+        "Les ids se trouvent via get_link_in_bio_catalog. Champs optionnels : subtitle, image_url, layout (forme du bloc : classic = petite image + bouton a droite, par defaut ; image = texte et bouton a contour a gauche, grande image a droite ; image_left = pareil avec la grande image a gauche ; button = image + titre en haut, gros bouton pleine largeur en dessous, image a gauche ; button_right = pareil, image a droite ; button_cover = image en fond sur toute la largeur, titre ecrit dessus, bouton en dessous), button_label (texte du bouton, 60 car. max ; vide = texte par defaut du type de bloc). Position en fin de liste (utiliser reorder pour changer).",
     inputSchema: {
         type: 'object',
         properties: {
@@ -31,7 +31,7 @@ export const createLinkInBioBlockTool = {
             kind: { type: 'string', enum: [...KINDS] },
             title: { type: 'string', maxLength: 200 },
             subtitle: { type: 'string', maxLength: 300 },
-            layout: { type: 'string', enum: ['classic', 'image', 'button'] },
+            layout: { type: 'string', enum: ['classic', 'image', 'image_left', 'button', 'button_right', 'button_cover'] },
             button_label: { type: 'string', maxLength: 60 },
             url: { type: 'string', description: 'kind=external : URL du lien' },
             image_url: { type: 'string' },
@@ -49,7 +49,7 @@ export const createLinkInBioBlockTool = {
         kind: z.enum(KINDS),
         title: z.string().max(200),
         subtitle: z.string().max(300).optional(),
-        layout: z.enum(['classic', 'image', 'button']).optional(),
+        layout: z.enum(['classic', 'image', 'image_left', 'button', 'button_right', 'button_cover']).optional(),
         button_label: z.string().max(60).optional(),
         url: z.string().optional(),
         image_url: z.string().optional(),

package/dist/tools/createPartnerAgent.js

@@ -0,0 +1,45 @@
+/**
+ * Tool `create_partner_agent` — cree un agent partenaire et sa page de vente.
+ * Scope : partner_agents.write. Super admin, Lab officiel uniquement.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+import { partnerAgentProperties, partnerAgentZod } from './partnerAgentFields.js';
+export const createPartnerAgentTool = {
+    name: 'create_partner_agent',
+    description: "Cree un agent partenaire dans le Lab officiel XLab : carte marketplace + page de vente dont les boutons menent au lien d'affiliation (suivi des vues et clics). Jamais propose en tunnel de vente, sans abonnement XLab. Publie par defaut (published=false pour le garder masque). Action visible publiquement : la faire confirmer.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab officiel XLab' },
+            ...partnerAgentProperties,
+            published: { type: 'boolean', description: 'Visible sur la marketplace (defaut true)' },
+        },
+        required: ['lab', 'title', 'short_description', 'call_to_action_text', 'shop_image', 'affiliate_url'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        title: partnerAgentZod.title,
+        short_description: partnerAgentZod.short_description,
+        description: partnerAgentZod.description.optional(),
+        call_to_action_text: partnerAgentZod.call_to_action_text,
+        shop_image: partnerAgentZod.shop_image,
+        icon: partnerAgentZod.icon.optional(),
+        affiliate_url: partnerAgentZod.affiliate_url,
+        pricing_label: partnerAgentZod.pricing_label.optional(),
+        landing_template: partnerAgentZod.landing_template.optional(),
+        landing_external_url: partnerAgentZod.landing_external_url.optional(),
+        published: z.boolean().optional(),
+    }),
+    async handler(args) {
+        const { lab, ...body } = this.zodSchema.parse(args);
+        try {
+            const { data } = await http.post(`/mcp/labs/${encodeURIComponent(lab)}/partner-agents`, body);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/deletePartnerAgent.js

@@ -0,0 +1,33 @@
+/**
+ * Tool `delete_partner_agent` — supprime un agent partenaire et ses statistiques.
+ * Scope : partner_agents.write. Super admin, Lab officiel uniquement.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const deletePartnerAgentTool = {
+    name: 'delete_partner_agent',
+    description: "Supprime definitivement un agent partenaire (carte, page de vente, vues et clics). Irreversible : la faire confirmer. Pour le retirer temporairement : set_partner_agent_published false.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab officiel XLab' },
+            agent_id: { type: 'number', description: 'id de l agent partenaire (list_partner_agents)' },
+        },
+        required: ['lab', 'agent_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        agent_id: z.number().int().min(1),
+    }),
+    async handler(args) {
+        const p = this.zodSchema.parse(args);
+        try {
+            const { data } = await http.delete(`/mcp/labs/${encodeURIComponent(p.lab)}/partner-agents/${p.agent_id}`);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/getPartnerAgent.js

@@ -0,0 +1,33 @@
+/**
+ * Tool `get_partner_agent` — detail d'un agent partenaire (page de vente complete).
+ * Scope : partner_agents.read. Super admin, Lab officiel uniquement.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const getPartnerAgentTool = {
+    name: 'get_partner_agent',
+    description: "Detail d'un agent partenaire du Lab officiel : textes de la page de vente (description HTML comprise), image, lien d'affiliation, texte du bouton, prix affiche, publication et liens suivis (page de vente, affiliation).",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab officiel XLab' },
+            agent_id: { type: 'number', description: 'id de l agent partenaire (list_partner_agents)' },
+        },
+        required: ['lab', 'agent_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        agent_id: z.number().int().min(1),
+    }),
+    async handler(args) {
+        const p = this.zodSchema.parse(args);
+        try {
+            const { data } = await http.get(`/mcp/labs/${encodeURIComponent(p.lab)}/partner-agents/${p.agent_id}`);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/getPartnerAgentStats.js

@@ -0,0 +1,39 @@
+/**
+ * Tool `get_partner_agent_stats` — vues et clics d'un agent partenaire, jour par jour.
+ * Scope : partner_agents.read. Super admin, Lab officiel uniquement.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const getPartnerAgentStatsTool = {
+    name: 'get_partner_agent_stats',
+    description: "Vues de la page de vente et clics vers le lien d'affiliation d'un agent partenaire, jour par jour. period : today, 7d, 30d (defaut) ou custom avec from / to (YYYY-MM-DD, 366 jours max).",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab officiel XLab' },
+            agent_id: { type: 'number', description: 'id de l agent partenaire (list_partner_agents)' },
+            period: { type: 'string', enum: ['today', '7d', '30d', 'custom'] },
+            from: { type: 'string', description: 'YYYY-MM-DD (period=custom)' },
+            to: { type: 'string', description: 'YYYY-MM-DD (period=custom)' },
+        },
+        required: ['lab', 'agent_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        agent_id: z.number().int().min(1),
+        period: z.enum(['today', '7d', '30d', 'custom']).optional(),
+        from: z.string().optional(),
+        to: z.string().optional(),
+    }),
+    async handler(args) {
+        const { lab, agent_id, ...params } = this.zodSchema.parse(args);
+        try {
+            const { data } = await http.get(`/mcp/labs/${encodeURIComponent(lab)}/partner-agents/${agent_id}/stats`, { params });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/listPartnerAgents.js

@@ -0,0 +1,31 @@
+/**
+ * Tool `list_partner_agents` — agents partenaires du Lab officiel XLab.
+ * Scope : partner_agents.read. Super admin, Lab officiel uniquement.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const listPartnerAgentsTool = {
+    name: 'list_partner_agents',
+    description: "Liste les agents partenaires (agents IA d'autres editeurs vendus via un lien d'affiliation) du Lab officiel XLab : titre, image, lien d'affiliation, prix affiche, publication, vues et clics sur 30 jours. Reserve au super admin, uniquement dans le Lab officiel.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab officiel XLab' },
+        },
+        required: ['lab'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+    }),
+    async handler(args) {
+        const p = this.zodSchema.parse(args);
+        try {
+            const { data } = await http.get(`/mcp/labs/${encodeURIComponent(p.lab)}/partner-agents`);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/partnerAgentFields.js

@@ -0,0 +1,29 @@
+/**
+ * Champs de la page de vente d'un agent partenaire, partages par
+ * create_partner_agent et update_partner_agent.
+ */
+import { z } from 'zod';
+export const partnerAgentProperties = {
+    title: { type: 'string', maxLength: 255, description: "Nom de l'agent" },
+    short_description: { type: 'string', maxLength: 500, description: 'Phrase courte de la carte marketplace' },
+    description: { type: 'string', description: 'Description de la page de vente (HTML simple accepte)' },
+    call_to_action_text: { type: 'string', maxLength: 120, description: 'Texte du bouton de la page de vente (ex. "Essayer l\'agent")' },
+    shop_image: { type: 'string', description: "Image de la carte : URL https ou image encodee (data:image/...;base64,...)" },
+    icon: { type: 'string', description: 'Logo (URL https ou data URI), optionnel' },
+    affiliate_url: { type: 'string', maxLength: 2000, description: "Lien d'affiliation chez l'editeur, en https:// (les boutons de la page y menent)" },
+    pricing_label: { type: 'string', maxLength: 80, description: 'Prix affiche, texte libre (ex. "Des 29 euros/mois")' },
+    landing_template: { type: 'string', enum: ['', 'external_url'], description: '"" = page de vente XLab ; "external_url" = la carte mene au site de l editeur' },
+    landing_external_url: { type: 'string', maxLength: 2000, description: "Site de l'editeur en https:// (obligatoire si landing_template = external_url)" },
+};
+export const partnerAgentZod = {
+    title: z.string().max(255),
+    short_description: z.string().max(500),
+    description: z.string(),
+    call_to_action_text: z.string().max(120),
+    shop_image: z.string(),
+    icon: z.string().nullable(),
+    affiliate_url: z.string().max(2000),
+    pricing_label: z.string().max(80).nullable(),
+    landing_template: z.enum(['', 'external_url']),
+    landing_external_url: z.string().max(2000).nullable(),
+};

package/dist/tools/setPartnerAgentPublished.js

@@ -0,0 +1,35 @@
+/**
+ * Tool `set_partner_agent_published` — publie ou masque un agent partenaire.
+ * Scope : partner_agents.write. Super admin, Lab officiel uniquement.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+export const setPartnerAgentPublishedTool = {
+    name: 'set_partner_agent_published',
+    description: "Publie (published=true) ou masque (false) un agent partenaire sur la marketplace. Action visible publiquement : la faire confirmer.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab officiel XLab' },
+            agent_id: { type: 'number', description: 'id de l agent partenaire (list_partner_agents)' },
+            published: { type: 'boolean' },
+        },
+        required: ['lab', 'agent_id', 'published'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        agent_id: z.number().int().min(1),
+        published: z.boolean(),
+    }),
+    async handler(args) {
+        const p = this.zodSchema.parse(args);
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(p.lab)}/partner-agents/${p.agent_id}/published`, { published: p.published });
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/dist/tools/updateLinkInBioBlock.js

@@ -7,7 +7,7 @@ import { z } from 'zod';
 import { http, formatApiError } from '../http.js';
 export const updateLinkInBioBlockTool = {
     name: 'update_link_in_bio_block',
-    description: "Modifie un bloc existant (identifie par block_id, entier renvoye par get_link_in_bio ou create_link_in_bio_block). Seuls les champs fournis changent : title, subtitle, url (bloc externe), image_url, layout (forme du bloc : classic = petite image + bouton a droite, par defaut ; image = texte et bouton a contour a gauche, grande image a droite ; button = image + titre en haut, gros bouton pleine largeur en dessous), button_label (texte du bouton, 60 car. max ; vide = texte par defaut du type de bloc), quiz_id (bloc quiz), calendar_event_id (bloc calendrier), lab_group_id (bloc Lab), is_active (afficher/masquer sans supprimer). Le type (kind) d'un bloc ne change pas.",
+    description: "Modifie un bloc existant (identifie par block_id, entier renvoye par get_link_in_bio ou create_link_in_bio_block). Seuls les champs fournis changent : title, subtitle, url (bloc externe), image_url, layout (forme du bloc : classic = petite image + bouton a droite, par defaut ; image = texte et bouton a contour a gauche, grande image a droite ; image_left = pareil avec la grande image a gauche ; button = image + titre en haut, gros bouton pleine largeur en dessous, image a gauche ; button_right = pareil, image a droite ; button_cover = image en fond sur toute la largeur, titre ecrit dessus, bouton en dessous), button_label (texte du bouton, 60 car. max ; vide = texte par defaut du type de bloc), quiz_id (bloc quiz), calendar_event_id (bloc calendrier), lab_group_id (bloc Lab), is_active (afficher/masquer sans supprimer). Le type (kind) d'un bloc ne change pas.",
     inputSchema: {
         type: 'object',
         properties: {
@@ -15,7 +15,7 @@ export const updateLinkInBioBlockTool = {
             block_id: { type: 'number', minimum: 1 },
             title: { type: 'string', maxLength: 200 },
             subtitle: { type: 'string', maxLength: 300 },
-            layout: { type: 'string', enum: ['classic', 'image', 'button'] },
+            layout: { type: 'string', enum: ['classic', 'image', 'image_left', 'button', 'button_right', 'button_cover'] },
             button_label: { type: 'string', maxLength: 60 },
             url: { type: 'string' },
             image_url: { type: 'string' },
@@ -32,7 +32,7 @@ export const updateLinkInBioBlockTool = {
         block_id: z.number().int().positive(),
         title: z.string().max(200).optional(),
         subtitle: z.string().max(300).optional(),
-        layout: z.enum(['classic', 'image', 'button']).optional(),
+        layout: z.enum(['classic', 'image', 'image_left', 'button', 'button_right', 'button_cover']).optional(),
         button_label: z.string().max(60).optional(),
         url: z.string().optional(),
         image_url: z.string().optional(),

package/dist/tools/updatePartnerAgent.js

@@ -0,0 +1,45 @@
+/**
+ * Tool `update_partner_agent` — modifie la page de vente d'un agent partenaire.
+ * Scope : partner_agents.write. Super admin, Lab officiel uniquement.
+ */
+import { z } from 'zod';
+import { http, formatApiError } from '../http.js';
+import { partnerAgentProperties, partnerAgentZod } from './partnerAgentFields.js';
+export const updatePartnerAgentTool = {
+    name: 'update_partner_agent',
+    description: "Modifie un agent partenaire du Lab officiel : n'envoyer que les champs a changer, les autres gardent leur valeur (textes, image, lien d'affiliation, texte du bouton, prix affiche, type de page). Pour publier ou masquer : set_partner_agent_published.",
+    inputSchema: {
+        type: 'object',
+        properties: {
+            lab: { type: 'string', description: 'group_url ou id du Lab officiel XLab' },
+            agent_id: { type: 'number', description: 'id de l agent partenaire (list_partner_agents)' },
+            ...partnerAgentProperties,
+        },
+        required: ['lab', 'agent_id'],
+        additionalProperties: false,
+    },
+    zodSchema: z.object({
+        lab: z.string(),
+        agent_id: z.number().int().min(1),
+        title: partnerAgentZod.title.optional(),
+        short_description: partnerAgentZod.short_description.optional(),
+        description: partnerAgentZod.description.optional(),
+        call_to_action_text: partnerAgentZod.call_to_action_text.optional(),
+        shop_image: partnerAgentZod.shop_image.optional(),
+        icon: partnerAgentZod.icon.optional(),
+        affiliate_url: partnerAgentZod.affiliate_url.optional(),
+        pricing_label: partnerAgentZod.pricing_label.optional(),
+        landing_template: partnerAgentZod.landing_template.optional(),
+        landing_external_url: partnerAgentZod.landing_external_url.optional(),
+    }),
+    async handler(args) {
+        const { lab, agent_id, ...body } = this.zodSchema.parse(args);
+        try {
+            const { data } = await http.put(`/mcp/labs/${encodeURIComponent(lab)}/partner-agents/${agent_id}`, body);
+            return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { isError: true, content: [{ type: 'text', text: formatApiError(err) }] };
+        }
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@connect-xlab/mcp-server",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Serveur MCP pour piloter ton Lab ConnectXLab depuis Claude Desktop / Cursor / n'importe quel client MCP.",
   "type": "module",
   "main": "dist/index.js",