innov-mcp-tasks 1.2.0 → 1.3.0

package/README.md

@@ -57,6 +57,7 @@ Na raiz do repo existe [`.cursor/mcp.json`](../.cursor/mcp.json) com **dois** se
 - `projects_list` — lista projetos visíveis (`GET /api/v1/projects`)
 - `project_create` — cria projeto (`POST /api/v1/projects`)
 - `task_get`, `task_create`, `task_update_status`, `task_assign`, `task_assign_to_me`
+- `task_attachment_download` — baixa anexo por `attachment_id` (conteúdo em base64; ids em `task_get` → `attachments`)
 
 ### Anotações / documentação
 

package/index.mjs

@@ -50,6 +50,43 @@ async function apiFetch(path, init = {}) {
   return data;
 }
 
+async function apiFetchBinary(path) {
+  if (!base || !token) {
+    throw new Error(
+      'Defina INNOV_API_BASE_URL e INNOV_API_TOKEN no ambiente ou num .env.',
+    );
+  }
+  const url = `${base}${path.startsWith('/') ? path : `/${path}`}`;
+  const res = await fetch(url, {
+    headers: {
+      Authorization: `Bearer ${token}`,
+    },
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    let msg = text.slice(0, 800);
+    try {
+      const data = text ? JSON.parse(text) : null;
+      if (data && (data.message || data.error)) {
+        msg = String(data.message || data.error);
+      }
+    } catch {
+      /* texto bruto */
+    }
+    throw new Error(`HTTP ${res.status}: ${msg}`);
+  }
+  const buffer = Buffer.from(await res.arrayBuffer());
+  const disposition = res.headers.get('content-disposition') || '';
+  const filenameMatch = disposition.match(/filename="?([^";\n]+)"?/i);
+  const filename = filenameMatch?.[1]?.trim() || 'attachment';
+  return {
+    buffer,
+    contentType: res.headers.get('content-type') || 'application/octet-stream',
+    filename,
+    size: buffer.length,
+  };
+}
+
 const server = new McpServer({ name: 'innov-tasks', version: '1.0.0' });
 
 server.registerTool(
@@ -105,6 +142,34 @@ server.registerTool(
   },
 );
 
+server.registerTool(
+  'task_attachment_download',
+  {
+    description:
+      'Baixa anexo de tarefa (GET /task-attachments/{id}/download). Requer Bearer Sanctum. ' +
+      'Retorna metadados e conteúdo em base64 (útil para zip, pdf, docx, txt, srt, etc.). ' +
+      'Use task_get para listar attachments[].id da tarefa.',
+    inputSchema: { attachment_id: z.number().int().positive() },
+  },
+  async (args) => {
+    try {
+      const file = await apiFetchBinary(
+        `/api/v1/task-attachments/${args.attachment_id}/download`,
+      );
+      return jsonText({
+        attachment_id: args.attachment_id,
+        filename: file.filename,
+        content_type: file.contentType,
+        size_bytes: file.size,
+        content_base64: file.buffer.toString('base64'),
+        hint: 'Decodifique content_base64 para gravar o ficheiro localmente.',
+      });
+    } catch (e) {
+      return jsonError(e instanceof Error ? e.message : String(e));
+    }
+  },
+);
+
 server.registerTool(
   'projects_list',
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "innov-mcp-tasks",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "MCP stdio — tarefas e anotações Innov (INNOV_API_BASE_URL + token Sanctum)",
   "type": "module",
   "main": "index.mjs",