@botuyo/mcp 0.3.22 → 0.4.0

package/dist/tools/__tests__/agent_families.spec.js

@@ -0,0 +1,219 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { listAgentFamiliesHandler, getAgentFamilyHandler, createAgentFamilyHandler, updateFamilyBaseHandler, addFamilyVariantHandler, updateFamilyVariantHandler, removeFamilyVariantHandler, publishAgentFamilyHandler, deleteAgentFamilyHandler, exportAgentFamilyHandler, importAgentFamilyHandler } from '../agent_families.js';
+class MockClient {
+    getResponses;
+    calls = [];
+    constructor(getResponses = {}) {
+        this.getResponses = getResponses;
+    }
+    async get(path) {
+        this.calls.push({ method: 'get', path });
+        return this.getResponses[path] ?? { success: true, data: {} };
+    }
+    async post(path, payload) {
+        this.calls.push({ method: 'post', path, payload });
+        return { success: true, data: payload };
+    }
+    async put(path, payload) {
+        this.calls.push({ method: 'put', path, payload });
+        return { success: true, data: payload };
+    }
+    async delete(path) {
+        this.calls.push({ method: 'delete', path });
+        return { success: true };
+    }
+}
+const BASE = '/api/v1/mcp/agent-families';
+const tmpDirs = [];
+function makeTmpDir() {
+    const d = mkdtempSync(join(tmpdir(), 'fam-'));
+    tmpDirs.push(d);
+    return d;
+}
+afterEach(() => {
+    while (tmpDirs.length)
+        rmSync(tmpDirs.pop(), { recursive: true, force: true });
+});
+describe('agent family tools — read', () => {
+    it('list calls GET /agent-families', async () => {
+        const client = new MockClient();
+        await listAgentFamiliesHandler(client, {});
+        expect(client.calls[0]).toEqual({ method: 'get', path: BASE });
+    });
+    it('get calls GET /agent-families/:id', async () => {
+        const client = new MockClient();
+        await getAgentFamilyHandler(client, { familyId: 'fam1' });
+        expect(client.calls[0]).toEqual({ method: 'get', path: `${BASE}/fam1` });
+    });
+});
+describe('agent family tools — create / base', () => {
+    it('create posts the full family payload', async () => {
+        const client = new MockClient();
+        const args = {
+            name: 'Ms. Ellis',
+            slug: 'ms-ellis',
+            entryVariantKey: 'nivelador',
+            base: { identity: { tone: 'cálida' } },
+            variants: [{ key: 'nivelador', label: 'Nivelador', overrides: {} }]
+        };
+        await createAgentFamilyHandler(client, args);
+        expect(client.calls[0].method).toBe('post');
+        expect(client.calls[0].path).toBe(BASE);
+        expect(client.calls[0].payload).toMatchObject({
+            name: 'Ms. Ellis',
+            slug: 'ms-ellis',
+            entryVariantKey: 'nivelador',
+            base: { identity: { tone: 'cálida' } }
+        });
+        expect(client.calls[0].payload.variants).toHaveLength(1);
+    });
+    it('create defaults base/variants when omitted', async () => {
+        const client = new MockClient();
+        await createAgentFamilyHandler(client, { name: 'X', slug: 'x', entryVariantKey: 'k' });
+        expect(client.calls[0].payload.base).toEqual({});
+        expect(client.calls[0].payload.variants).toEqual([]);
+    });
+    it('update_family_base puts { base } to /base', async () => {
+        const client = new MockClient();
+        await updateFamilyBaseHandler(client, { familyId: 'fam1', base: { enabledTools: ['save_user_memory'] } });
+        expect(client.calls[0]).toEqual({
+            method: 'put',
+            path: `${BASE}/fam1/base`,
+            payload: { base: { enabledTools: ['save_user_memory'] } }
+        });
+    });
+});
+describe('agent family tools — variants', () => {
+    it('add_family_variant posts the variant to /variants', async () => {
+        const client = new MockClient();
+        await addFamilyVariantHandler(client, {
+            familyId: 'fam1',
+            key: 'a2',
+            label: 'A2',
+            overrides: { knowledgeDocumentIds: ['d'] },
+            handoffTargets: ['nivelador'],
+            order: 3
+        });
+        expect(client.calls[0].method).toBe('post');
+        expect(client.calls[0].path).toBe(`${BASE}/fam1/variants`);
+        expect(client.calls[0].payload).toMatchObject({
+            key: 'a2',
+            label: 'A2',
+            overrides: { knowledgeDocumentIds: ['d'] },
+            handoffTargets: ['nivelador'],
+            order: 3
+        });
+    });
+    it('update_family_variant puts only provided fields to /variants/:key', async () => {
+        const client = new MockClient();
+        await updateFamilyVariantHandler(client, { familyId: 'fam1', variantKey: 'a1', label: 'A1+' });
+        expect(client.calls[0].method).toBe('put');
+        expect(client.calls[0].path).toBe(`${BASE}/fam1/variants/a1`);
+        expect(client.calls[0].payload).toEqual({ label: 'A1+' });
+    });
+    it('remove_family_variant deletes /variants/:key', async () => {
+        const client = new MockClient();
+        await removeFamilyVariantHandler(client, { familyId: 'fam1', variantKey: 'a1' });
+        expect(client.calls[0]).toEqual({ method: 'delete', path: `${BASE}/fam1/variants/a1` });
+    });
+});
+describe('agent family tools — publish / delete', () => {
+    it('publish puts to /publish', async () => {
+        const client = new MockClient();
+        await publishAgentFamilyHandler(client, { familyId: 'fam1' });
+        expect(client.calls[0]).toEqual({ method: 'put', path: `${BASE}/fam1/publish`, payload: {} });
+    });
+    it('delete refuses without confirm', async () => {
+        const client = new MockClient();
+        const res = (await deleteAgentFamilyHandler(client, { familyId: 'fam1', confirmName: 'Ms. Ellis' }));
+        expect(res.error).toBeTruthy();
+        expect(client.calls.some((c) => c.method === 'delete')).toBe(false);
+    });
+    it('delete refuses on name mismatch', async () => {
+        const client = new MockClient({ [`${BASE}/fam1`]: { success: true, data: { name: 'Ms. Ellis' } } });
+        const res = (await deleteAgentFamilyHandler(client, { familyId: 'fam1', confirm: true, confirmName: 'Wrong' }));
+        expect(res.error).toMatch(/mismatch/i);
+        expect(client.calls.some((c) => c.method === 'delete')).toBe(false);
+    });
+    it('delete proceeds when confirmed + name matches', async () => {
+        const client = new MockClient({ [`${BASE}/fam1`]: { success: true, data: { name: 'Ms. Ellis' } } });
+        const res = (await deleteAgentFamilyHandler(client, {
+            familyId: 'fam1',
+            confirm: true,
+            confirmName: 'Ms. Ellis'
+        }));
+        expect(res.success).toBe(true);
+        expect(client.calls.some((c) => c.method === 'delete' && c.path === `${BASE}/fam1`)).toBe(true);
+    });
+});
+describe('agent family tools — export / import', () => {
+    it('export GETs /export and saves a portable file', async () => {
+        const dir = makeTmpDir();
+        const client = new MockClient({
+            [`${BASE}/fam1/export`]: {
+                success: true,
+                data: {
+                    familyId: 'fam1',
+                    family: {
+                        name: 'Ms. Ellis',
+                        slug: 'ms-ellis',
+                        entryVariantKey: 'nivelador',
+                        base: {},
+                        variants: [{ key: 'nivelador', label: 'Nivelador', overrides: {} }]
+                    }
+                }
+            }
+        });
+        const res = (await exportAgentFamilyHandler(client, { familyId: 'fam1', savePath: dir }));
+        expect(client.calls[0]).toEqual({ method: 'get', path: `${BASE}/fam1/export` });
+        expect(res.savedTo).toBe(join(dir, 'ms-ellis.json'));
+        const saved = JSON.parse(readFileSync(res.savedTo, 'utf-8'));
+        expect(saved._familyId).toBe('fam1');
+        expect(saved.entryVariantKey).toBe('nivelador');
+    });
+    it('import (inline) PUTs the family to /import', async () => {
+        const client = new MockClient();
+        const family = {
+            entryVariantKey: 'nivelador',
+            base: {},
+            variants: [{ key: 'nivelador', label: 'N', overrides: {} }]
+        };
+        await importAgentFamilyHandler(client, { familyId: 'fam1', family });
+        expect(client.calls[0].method).toBe('put');
+        expect(client.calls[0].path).toBe(`${BASE}/fam1/import`);
+        expect(client.calls[0].payload).toEqual(family);
+    });
+    it('import (file) reads the file, strips metadata, and derives familyId from _familyId', async () => {
+        const dir = makeTmpDir();
+        const file = join(dir, 'ms-ellis.json');
+        writeFileSync(file, JSON.stringify({
+            _exportedAt: '2026-06-18T00:00:00.000Z',
+            _familyId: 'fam-from-file',
+            name: 'Ms. Ellis',
+            slug: 'ms-ellis',
+            entryVariantKey: 'nivelador',
+            base: {},
+            variants: [{ key: 'nivelador', label: 'N', overrides: {} }]
+        }), 'utf-8');
+        const client = new MockClient();
+        const res = (await importAgentFamilyHandler(client, { filePath: file }));
+        expect(client.calls[0].path).toBe(`${BASE}/fam-from-file/import`);
+        expect(client.calls[0].payload._exportedAt).toBeUndefined();
+        expect(client.calls[0].payload._familyId).toBeUndefined();
+        expect(client.calls[0].payload.entryVariantKey).toBe('nivelador');
+        expect(res.importedFrom).toBe(file);
+    });
+    it('import errors when neither familyId nor _familyId is available', async () => {
+        const client = new MockClient();
+        const res = (await importAgentFamilyHandler(client, {
+            family: { entryVariantKey: 'k', base: {}, variants: [] }
+        }));
+        expect(res.success).toBe(false);
+        expect(res.error).toMatch(/familyId is required/i);
+        expect(client.calls.some((c) => c.method === 'put')).toBe(false);
+    });
+});
+//# sourceMappingURL=agent_families.spec.js.map

package/dist/tools/__tests__/agent_families.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent_families.spec.js","sourceRoot":"","sources":["../../../src/tools/__tests__/agent_families.spec.ts"],"names":[],"mappings":"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"}

package/dist/tools/__tests__/list_agents.spec.js

@@ -3,14 +3,33 @@ import { listAgentsHandler } from '../list_agents.js';
 class MockClient {
     async get(path) {
         expect(path).toBe('/api/v1/mcp/agents');
-        return { success: true, data: [{ id: '1', name: 'A1' }] };
+        return {
+            success: true,
+            data: [
+                { id: '6988e1877a3c2a943468b9e2', name: 'Nivelador', status: 'published', enabledToolsCount: 3 }
+            ]
+        };
     }
 }
 describe('listAgentsHandler', () => {
-    it('should call GET /api/v1/mcp/agents', async () => {
+    it('should call GET /api/v1/mcp/agents and keep a data array', async () => {
         const client = new MockClient();
-        const res = await listAgentsHandler(client, {});
+        const res = (await listAgentsHandler(client, {}));
         expect(Array.isArray(res.data)).toBe(true);
+        expect(res.count).toBe(1);
+    });
+    it('adds a shortId to each agent without losing the full id', async () => {
+        const client = new MockClient();
+        const res = (await listAgentsHandler(client, {}));
+        expect(res.data[0].id).toBe('6988e1877a3c2a943468b9e2');
+        expect(res.data[0].shortId).toBe('6988e187…b9e2');
+    });
+    it('returns a name-first text summary', async () => {
+        const client = new MockClient();
+        const res = (await listAgentsHandler(client, {}));
+        expect(res.text).toContain('Nivelador');
+        expect(res.text).toContain('6988e187…b9e2');
+        expect(res.text).toContain('published');
     });
 });
 //# sourceMappingURL=list_agents.spec.js.map

package/dist/tools/__tests__/list_agents.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"list_agents.spec.js","sourceRoot":"","sources":["../../../src/tools/__tests__/list_agents.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,UAAU;IACd,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;QACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IAC3D,CAAC;CACF;AAED,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,MAAM,GAAG,IAAI,UAAU,EAAS,CAAA;QACtC,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAC/C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAE,GAAW,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"list_agents.spec.js","sourceRoot":"","sources":["../../../src/tools/__tests__/list_agents.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,UAAU;IACd,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;QACvC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE;gBACJ,EAAE,EAAE,EAAE,0BAA0B,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,EAAE;aACjG;SACF,CAAA;IACH,CAAC;CACF;AAED,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,MAAM,GAAG,IAAI,UAAU,EAAS,CAAA;QACtC,MAAM,GAAG,GAAG,CAAC,MAAM,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAQ,CAAA;QACxD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1C,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,MAAM,GAAG,IAAI,UAAU,EAAS,CAAA;QACtC,MAAM,GAAG,GAAG,CAAC,MAAM,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAQ,CAAA;QACxD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;QACvD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,MAAM,GAAG,IAAI,UAAU,EAAS,CAAA;QACtC,MAAM,GAAG,GAAG,CAAC,MAAM,iBAAiB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAQ,CAAA;QACxD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;QACvC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAA;QAC3C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/tools/agent_families.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Agent Family MCP tools — manage "one logical agent with many variants".
+ *
+ * A family holds a shared `base` agent config once; each `variant` stores only
+ * its `overrides` (deep-merged over the base when materialized into a real agent).
+ * All tools call the MCP namespace `/api/v1/mcp/agent-families`.
+ *
+ * Write tools (create/update/add/remove/publish/delete/import) require role:
+ * owner, admin, or developer (enforced server-side).
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { BotuyoApiClient } from '../client.js';
+export declare const LIST_AGENT_FAMILIES_TOOL: Tool;
+export declare function listAgentFamiliesHandler(client: BotuyoApiClient, _args: Record<string, unknown>): Promise<any>;
+export declare const GET_AGENT_FAMILY_TOOL: Tool;
+export declare function getAgentFamilyHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;
+export declare const CREATE_AGENT_FAMILY_TOOL: Tool;
+export declare function createAgentFamilyHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;
+export declare const UPDATE_FAMILY_BASE_TOOL: Tool;
+export declare function updateFamilyBaseHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;
+export declare const ADD_FAMILY_VARIANT_TOOL: Tool;
+export declare function addFamilyVariantHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;
+export declare const UPDATE_FAMILY_VARIANT_TOOL: Tool;
+export declare function updateFamilyVariantHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;
+export declare const REMOVE_FAMILY_VARIANT_TOOL: Tool;
+export declare function removeFamilyVariantHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;
+export declare const PUBLISH_AGENT_FAMILY_TOOL: Tool;
+export declare function publishAgentFamilyHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<any>;
+export declare const DELETE_AGENT_FAMILY_TOOL: Tool;
+export declare function deleteAgentFamilyHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<{
+    error: string;
+} | {
+    success: boolean;
+    message: string;
+    error?: undefined;
+}>;
+export declare const EXPORT_AGENT_FAMILY_TOOL: Tool;
+export declare function exportAgentFamilyHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<{
+    success?: boolean;
+    data?: {
+        familyId?: string;
+        family?: {
+            slug?: string;
+        };
+    };
+    message?: string;
+    savedTo?: string;
+    fileSaveError?: string;
+}>;
+export declare const IMPORT_AGENT_FAMILY_TOOL: Tool;
+export declare function importAgentFamilyHandler(client: BotuyoApiClient, args: Record<string, unknown>): Promise<{
+    success: boolean;
+    error: string;
+    hint: string;
+    path?: undefined;
+    importedFrom?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    path: string;
+    hint?: undefined;
+    importedFrom?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    hint?: undefined;
+    path?: undefined;
+    importedFrom?: undefined;
+} | {
+    importedFrom: string;
+    success?: undefined;
+    error?: undefined;
+    hint?: undefined;
+    path?: undefined;
+}>;