@quantyapp/quanty-mcp-server 1.0.0 → 1.0.2

package/dist/core/budgetService.d.ts

@@ -81,4 +81,8 @@ export declare function prepareDeleteItem(budgetId: string, itemId: string, item
  * Executes item deletion
  */
 export declare function executeDeleteItem(auth: AuthContext, data: any): Promise<void>;
+/**
+ * Gets composition details (inputs/children) for a specific item in a budget
+ */
+export declare function getCompositionDetails(auth: AuthContext, budgetId: string, itemId: string): Promise<any[]>;
 //# sourceMappingURL=budgetService.d.ts.map

package/dist/core/budgetService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"budgetService.d.ts","sourceRoot":"","sources":["../../src/core/budgetService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC;CAC1C;AAED,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA0BjG;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyB3F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAMpH;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCvF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAOhD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAM3I;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAenF"}
+{"version":3,"file":"budgetService.d.ts","sourceRoot":"","sources":["../../src/core/budgetService.ts"],"names":[],"mappings":"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"}

package/dist/core/budgetService.js

@@ -168,3 +168,38 @@ export async function executeDeleteItem(auth, data) {
     if (error)
         throw new Error(`Failed to delete item: ${error.message}`);
 }
+/**
+ * Gets composition details (inputs/children) for a specific item in a budget
+ */
+export async function getCompositionDetails(auth, budgetId, itemId) {
+    const budget = await getBudget(auth, budgetId);
+    if (!budget)
+        throw new Error('Budget not found');
+    // Find the item in the rows
+    // Note: getBudget returns a simplified BudgetRow structure. 
+    // We need to access the raw data structure which might contain 'children' for compositions
+    const { data, error } = await supabase
+        .from('budgets')
+        .select('data')
+        .eq('id', budgetId)
+        .single();
+    if (error || !data)
+        throw new Error('Failed to fetch budget data');
+    const rows = data.data?.rows || [];
+    const item = rows.find((r) => r.id === itemId);
+    if (!item)
+        throw new Error('Item not found in budget');
+    if (!item.children || item.children.length === 0) {
+        return [];
+    }
+    return item.children.map((child) => ({
+        id: child.id,
+        code: child.code,
+        description: child.description,
+        unit: child.unit,
+        quantity: child.quantity,
+        unitCost: child.unitCost, // Custo unitário do insumo
+        total: (child.quantity || 0) * (child.unitCost || 0),
+        type: child.itemType || 'INSUMO'
+    }));
+}

package/dist/mcp/index.js

@@ -86,6 +86,12 @@ Itens podem ser organizados em níveis hierárquicos:
 `;
 // Tool definitions with detailed descriptions
 const TOOLS = [
+    // === DOCUMENTATION TOOLS ===
+    {
+        name: 'quanty_ler_manual',
+        description: 'Lê o manual completo do Quanty com conceitos de engenharia e instruções de uso.',
+        inputSchema: { type: 'object', properties: {} }
+    },
     // === READ TOOLS ===
     {
         name: 'quanty_listar_orcamentos',
@@ -115,6 +121,19 @@ Use quanty_ver_composicao para ver os insumos de uma composição específica.`,
             required: ['id']
         }
     },
+    {
+        name: 'quanty_ver_composicao',
+        description: `Mostra os INSUMOS que compõem um item do tipo COMPOSIÇÃO.
+Uso obrigatório quando um item tiver 'is_composicao: true' para entender seus custos internos.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                orcamento_id: { type: 'string', description: 'ID do orçamento onde está o item' },
+                item_id: { type: 'string', description: 'ID do item (composição) a ser detalhado' }
+            },
+            required: ['orcamento_id', 'item_id']
+        }
+    },
     {
         name: 'quanty_listar_bancos',
         description: `Lista os bancos de composição disponíveis para buscar preços de referência.
@@ -225,6 +244,13 @@ Retorna média, mínimo, máximo e percentil 90 (para detecção de outliers).`,
 ];
 async function handleToolCall(auth, name, args) {
     switch (name) {
+        // === DOCUMENTATION ===
+        case 'quanty_ler_manual': {
+            return {
+                conteudo: QUANTY_MANUAL,
+                _info: 'Este manual contém tudo sobre BDI, Composições e estrutura do Quanty.'
+            };
+        }
         // === READ ===
         case 'quanty_listar_orcamentos': {
             const budgets = await budgetService.listBudgets(auth, args.limite || 10);
@@ -269,6 +295,27 @@ async function handleToolCall(auth, name, args) {
                 }))
             };
         }
+        case 'quanty_ver_composicao': {
+            const insumos = await budgetService.getCompositionDetails(auth, args.orcamento_id, args.item_id);
+            if (!insumos || insumos.length === 0) {
+                return {
+                    mensagem: 'Esta composição não possui insumos listados ou não é uma composição válida.'
+                };
+            }
+            const totalComposicao = insumos.reduce((sum, i) => sum + i.total, 0);
+            return {
+                _info: 'Lista de insumos/filhos desta composição',
+                qtd_insumos: insumos.length,
+                custo_total_calculado: `R$ ${totalComposicao.toFixed(2)}`,
+                insumos: insumos.map(i => ({
+                    descricao: i.description,
+                    unidade: i.unit,
+                    coeficiente: i.quantity, // Na composição, quantidade é o coeficiente
+                    custo_unitario_insumo: i.unitCost,
+                    custo_total_insumo: i.total
+                }))
+            };
+        }
         case 'quanty_listar_bancos': {
             const banks = await bankService.listBanks(auth);
             return {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@quantyapp/quanty-mcp-server",
-    "version": "1.0.0",
+    "version": "1.0.2",
     "description": "MCP Server para conectar Claude Desktop ao Quanty - Sistema de Orçamentos de Engenharia",
     "type": "module",
     "main": "dist/mcp/index.js",