@hailer/mcp 0.2.3 → 0.2.5

package/dist/mcp/tools/file.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Upload Files Tool - Clean Architecture Implementation
+ * File Tools - Clean Architecture Implementation
  *
  * Demonstrates the new tool architecture pattern:
  * - Direct Tool<TSchema> interface implementation
@@ -8,12 +8,47 @@
  * - No static class wrapper needed
  * - Type-safe with Zod schema inference
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.uploadFilesTool = void 0;
+exports.downloadFileTool = exports.uploadFilesTool = void 0;
 const zod_1 = require("zod");
 const tool_registry_1 = require("../tool-registry");
 const logger_1 = require("../../lib/logger");
-const logger = (0, logger_1.createLogger)({ component: 'upload-files-tool' });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger = (0, logger_1.createLogger)({ component: 'file-tools' });
 /**
  * Tool description - extracted for clarity
  */
@@ -25,7 +60,7 @@ Max 100MB per file. Returns file IDs for activities.`;
  */
 exports.uploadFilesTool = {
     name: 'upload_files',
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+    group: tool_registry_1.ToolGroup.WRITE,
     description: uploadFilesDescription,
     schema: zod_1.z.object({
         files: zod_1.z.union([
@@ -116,4 +151,87 @@ exports.uploadFilesTool = {
         }
     }
 };
+/**
+ * Download File Tool Description
+ */
+const downloadFileDescription = `🧪 [PLAYGROUND] Download file: \`{ "fileId": "abc123" }\` or save to disk: \`{ "fileId": "abc123", "savePath": "/path/to/save.pdf" }\`.
+
+Returns file metadata and content (text for text files, base64 for binary).`;
+/**
+ * Download File Tool - Clean implementation
+ */
+exports.downloadFileTool = {
+    name: 'download_file',
+    group: tool_registry_1.ToolGroup.READ,
+    description: downloadFileDescription,
+    schema: zod_1.z.object({
+        fileId: zod_1.z.string().describe("File ID to download"),
+        savePath: zod_1.z.string().optional().describe("Optional: local path to save file to disk")
+    }),
+    async execute(args, context) {
+        const { fileId, savePath } = args;
+        logger.debug('Downloading file', { fileId, savePath });
+        try {
+            const result = await context.hailer.downloadFile(fileId);
+            // If savePath provided, write to disk
+            if (savePath) {
+                try {
+                    const dir = path.dirname(savePath);
+                    if (!fs.existsSync(dir)) {
+                        fs.mkdirSync(dir, { recursive: true });
+                    }
+                    const buffer = result.encoding === 'base64'
+                        ? Buffer.from(result.content, 'base64')
+                        : Buffer.from(result.content, 'utf8');
+                    fs.writeFileSync(savePath, buffer);
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `📥 File downloaded and saved\n\n` +
+                                    `**File:** ${result.filename}\n` +
+                                    `**Type:** ${result.contentType}\n` +
+                                    `**Size:** ${(result.size / 1024).toFixed(2)} KB\n` +
+                                    `**Saved to:** ${savePath}\n` +
+                                    `**File ID:** ${result.fileId}`
+                            }]
+                    };
+                }
+                catch (error) {
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `❌ Failed to save file: ${error instanceof Error ? error.message : String(error)}`
+                            }]
+                    };
+                }
+            }
+            // Otherwise return content in response
+            const sizeKB = (result.size / 1024).toFixed(2);
+            const contentPreview = result.encoding === 'utf8'
+                ? (result.content.length > 1000 ? result.content.substring(0, 1000) + '...' : result.content)
+                : `[Binary content - ${sizeKB} KB base64 encoded]`;
+            return {
+                content: [{
+                        type: "text",
+                        text: `📥 File downloaded\n\n` +
+                            `**File:** ${result.filename}\n` +
+                            `**Type:** ${result.contentType}\n` +
+                            `**Size:** ${sizeKB} KB\n` +
+                            `**Encoding:** ${result.encoding}\n` +
+                            `**File ID:** ${result.fileId}\n\n` +
+                            `**Content:**\n\`\`\`\n${contentPreview}\n\`\`\``
+                    }]
+            };
+        }
+        catch (error) {
+            logger.error('Download failed', error);
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ Download failed: ${error instanceof Error ? error.message : String(error)}`
+                    }]
+            };
+        }
+    }
+};
 //# sourceMappingURL=file.js.map

package/dist/mcp/utils/hailer-api-client.d.ts

@@ -151,6 +151,19 @@ export declare class HailerApiClient {
      * Upload a file from URL or filesystem path
      */
     uploadFile(fileSpec: FileSpec): Promise<UploadResult>;
+    /**
+     * Download a file by file ID
+     * @param fileId - The file ID to download
+     * @returns File metadata and content (base64 for binary, text for text files)
+     */
+    downloadFile(fileId: string): Promise<{
+        fileId: string;
+        filename: string;
+        contentType: string;
+        size: number;
+        content: string;
+        encoding: 'utf8' | 'base64';
+    }>;
     /**
      * Helper method to create MCP tool responses
      */

package/dist/mcp/utils/hailer-api-client.js

@@ -437,6 +437,70 @@ class HailerApiClient {
     async uploadFile(fileSpec) {
         return await (0, file_upload_1.uploadSingleFile)(fileSpec, this.clients);
     }
+    /**
+     * Download a file by file ID
+     * @param fileId - The file ID to download
+     * @returns File metadata and content (base64 for binary, text for text files)
+     */
+    async downloadFile(fileId) {
+        const url = `${this.clients.socket.host}/file/${fileId}`;
+        this.logger.debug('Downloading file', { fileId, url });
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    'hlrkey': this.clients.sessionKey,
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`File download failed: ${response.status} ${response.statusText}`);
+            }
+            const contentType = response.headers.get('content-type') || 'application/octet-stream';
+            const contentDisposition = response.headers.get('content-disposition') || '';
+            // Extract filename from content-disposition header
+            let filename = fileId;
+            const filenameMatch = contentDisposition.match(/filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/);
+            if (filenameMatch && filenameMatch[1]) {
+                filename = filenameMatch[1].replace(/['"]/g, '');
+            }
+            // Determine if content is text or binary
+            const isText = contentType.startsWith('text/') ||
+                contentType.includes('json') ||
+                contentType.includes('xml') ||
+                contentType.includes('javascript');
+            const buffer = await response.arrayBuffer();
+            const size = buffer.byteLength;
+            let content;
+            let encoding;
+            if (isText) {
+                content = new TextDecoder('utf-8').decode(buffer);
+                encoding = 'utf8';
+            }
+            else {
+                content = Buffer.from(buffer).toString('base64');
+                encoding = 'base64';
+            }
+            this.logger.debug('File downloaded successfully', {
+                fileId,
+                filename,
+                contentType,
+                size,
+                encoding
+            });
+            return {
+                fileId,
+                filename,
+                contentType,
+                size,
+                content,
+                encoding
+            };
+        }
+        catch (error) {
+            this.logger.error('File download failed', error, { fileId });
+            throw error;
+        }
+    }
     /**
      * Helper method to create MCP tool responses
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hailer/mcp",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "config": {
     "docker": {
       "registry": "registry.gitlab.com/hailer-repos/hailer-mcp"

package/mcp-system-prompt.txt

@@ -1,127 +0,0 @@
-You are the MCP Assistant for Hailer MCP Server. Help users understand what MCP agents can do and guide them to the right agent for their task.
-
-# What is Hailer MCP?
-
-Hailer MCP is a Model Context Protocol server that connects Claude Code to Hailer workspaces. It provides 34+ tools for managing workflows, activities, insights, apps, and discussions.
-
-Hailer is a SaaS platform for business process management with:
-- Workspaces (organizations)
-- Workflows (kanban-style process boards with phases)
-- Activities (data records within workflows)
-- Discussions (chat threads attached to activities)
-- Insights (SQL-like reports over workflow data)
-- Apps (custom React applications)
-
-# Available Agents
-
-## Fast Agents (haiku model)
-
-### kenji - Data Reader
-- Reads schema, fields, phases from local workspace/ files
-- Falls back to API for activity data and counts
-- Use for: "What fields does X have?", "List workflows", "Show phases"
-
-### dmitri - Data Writer
-- Creates and updates activities (single or bulk)
-- Use for: "Create customer", "Update 50 records", "Move to phase"
-- Needs: workflow_id, phase_id, field values from kenji first
-
-### yevgeni - Discussion Handler
-- Reads/posts messages, manages discussion membership
-- Use for: "Post message", "Read chat history", "Invite user to discussion"
-
-### bjorn - Config Auditor
-- Audits CLAUDE.md, agents, hooks, settings.json
-- Use for: "Check if config is correct", "Find orphaned files"
-
-## Reasoning Agents (sonnet model)
-
-### helga - Workspace Config
-- Manages workflows, fields, phases via TypeScript SDK files
-- Use for: "Add field to workflow", "Create new workflow", "Rename phase"
-- Returns commands for orchestrator to run (npm run push)
-
-### viktor - SQL Insights
-- Creates SQL-like reports over workflow data
-- Use for: "Report of high priority tasks", "Sales by month", "Join customers with orders"
-- Always previews before creating
-
-### giuseppe - App Builder
-- Builds Hailer apps with React/TypeScript/Chakra
-- Use for: "Build dashboard showing customers", "Create kanban app"
-- Needs: workflow_id, phase_id, field_ids from kenji first
-
-### alejandro - Function Fields
-- Creates calculated/formula fields in workflows
-- Use for: "Add Total Cost = qty * price", "Concatenate first + last name"
-- Always tests formulas before enabling
-
-### gunther - MCP Tool Builder
-- Creates new MCP tools for the server itself
-- Use for: "Add tool to count activities", "Create new API endpoint"
-
-### svetlana - Code Reviewer
-- Reviews code for bugs, security, best practices (READ-ONLY)
-- Use for: "Review my changes", "Check for security issues"
-
-### ada - Skill Creator
-- Creates skills when agents fail repeatedly
-- Use for: "Viktor keeps getting JOINs wrong", "Document this pattern"
-
-### ingrid - Document Templates
-- Creates PDF/CSV document templates
-- Use for: "Create invoice template", "Add report template"
-
-### agent-builder - Agent Creator
-- Creates new lean agents (<50 lines)
-- Use for: "I need an agent for X"
-
-# How Agents Work
-
-1. User asks the orchestrator (main Claude)
-2. Orchestrator delegates to appropriate agent
-3. Agent returns JSON with result
-4. Orchestrator interprets and reports back
-
-Agents output JSON only:
-{ "status": "success|error", "result": {...}, "summary": "..." }
-
-# Common Workflows
-
-## Read data
-kenji → list workflows, get schema, get fields
-
-## Create/update data
-kenji (get IDs) → dmitri (create/update)
-
-## Build report
-kenji (get schema) → viktor (create insight)
-
-## Build app
-kenji (get IDs) → giuseppe (scaffold + build)
-
-## Configure workspace
-helga (edit files) → orchestrator runs push commands
-
-# Current Version: 0.0.5
-
-Recent changes:
-- Hailer app builder improvements
-- Marketplace template publishing
-- Safety hooks for destructive operations
-- 34+ MCP tools available
-
-# Limitations
-
-- Agents run via Claude Code CLI, not standalone
-- Workspace-scoped (cannot access external systems)
-- Orchestrator must provide IDs to write agents
-- Some operations require npm run commands
-
-# Guidelines
-
-- Be concise (1-3 sentences per response)
-- Match user's language
-- If unsure which agent, ask clarifying question
-- You guide users, you cannot execute actions yourself
-- Recommend kenji first for any data lookup