@hailer/mcp 0.1.17 → 0.2.2

package/dist/mcp/tools/bug-fixer-tools.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Bug Fixer MCP Tools
+ *
+ * Bug-fixing tools for Bug Fixer specialist daemon.
+ * These tools handle file operations, git, and build commands.
+ */
+import { Tool } from "../tool-registry";
+export declare const bugFixerFindAppTool: Tool;
+export declare const bugFixerListFilesTool: Tool;
+export declare const bugFixerReadFileTool: Tool;
+export declare const bugFixerWriteFileTool: Tool;
+export declare const bugFixerApplyFixTool: Tool;
+export declare const bugFixerRunBuildTool: Tool;
+export declare const bugFixerGitStatusTool: Tool;
+export declare const bugFixerGitPullTool: Tool;
+export declare const bugFixerGitCommitTool: Tool;
+export declare const bugFixerGitPushTool: Tool;
+export declare const bugFixerGitRevertTool: Tool;
+export declare const bugFixerPublishAppTool: Tool;
+export declare const bugFixerTools: Tool[];
+//# sourceMappingURL=bug-fixer-tools.d.ts.map

package/dist/mcp/tools/{giuseppe-tools.js → bug-fixer-tools.js}

@@ -1,8 +1,8 @@
 "use strict";
 /**
- * Giuseppe MCP Tools
+ * Bug Fixer MCP Tools
  *
- * Bug-fixing tools for Giuseppe specialist daemon.
+ * Bug-fixing tools for Bug Fixer specialist daemon.
  * These tools handle file operations, git, and build commands.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
@@ -39,7 +39,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.giuseppeTools = exports.giuseppePublishAppTool = exports.giuseppeGitRevertTool = exports.giuseppeGitPushTool = exports.giuseppeGitCommitTool = exports.giuseppeGitPullTool = exports.giuseppeGitStatusTool = exports.giuseppeRunBuildTool = exports.giuseppeApplyFixTool = exports.giuseppeWriteFileTool = exports.giuseppeReadFileTool = exports.giuseppeListFilesTool = exports.giuseppeFindAppTool = void 0;
+exports.bugFixerTools = exports.bugFixerPublishAppTool = exports.bugFixerGitRevertTool = exports.bugFixerGitPushTool = exports.bugFixerGitCommitTool = exports.bugFixerGitPullTool = exports.bugFixerGitStatusTool = exports.bugFixerRunBuildTool = exports.bugFixerApplyFixTool = exports.bugFixerWriteFileTool = exports.bugFixerReadFileTool = exports.bugFixerListFilesTool = exports.bugFixerFindAppTool = void 0;
 const zod_1 = require("zod");
 const child_process_1 = require("child_process");
 const fs = __importStar(require("fs/promises"));
@@ -47,7 +47,7 @@ const path = __importStar(require("path"));
 const tool_registry_1 = require("../tool-registry");
 const logger_1 = require("../../lib/logger");
 const config_1 = require("../../config");
-const logger = (0, logger_1.createLogger)({ component: "giuseppe-tools" });
+const logger = (0, logger_1.createLogger)({ component: "bug-fixer-tools" });
 const appsBasePath = config_1.environment.DEV_APPS_PATH || process.cwd();
 // Helper to scan for apps
 async function scanApps() {
@@ -80,9 +80,9 @@ async function scanApps() {
     return apps;
 }
 // Find App Tool
-exports.giuseppeFindAppTool = {
-    name: "giuseppe_find_app",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerFindAppTool = {
+    name: "bug_fixer_find_app",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: "Find a Hailer app project by name or from bug title",
     schema: zod_1.z.object({
         searchTerm: zod_1.z.string().describe("App name or bug title to search for").optional(),
@@ -108,9 +108,9 @@ exports.giuseppeFindAppTool = {
     }
 };
 // List Files Tool
-exports.giuseppeListFilesTool = {
-    name: "giuseppe_list_files",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerListFilesTool = {
+    name: "bug_fixer_list_files",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: "List source files in a Hailer app project",
     schema: zod_1.z.object({
         appPath: zod_1.z.string().describe("Path to the app project")
@@ -148,9 +148,9 @@ exports.giuseppeListFilesTool = {
     }
 };
 // Read File Tool
-exports.giuseppeReadFileTool = {
-    name: "giuseppe_read_file",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerReadFileTool = {
+    name: "bug_fixer_read_file",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: "Read a source file from the app",
     schema: zod_1.z.object({
         appPath: zod_1.z.string().describe("Path to the app project"),
@@ -172,9 +172,9 @@ exports.giuseppeReadFileTool = {
     }
 };
 // Write File Tool
-exports.giuseppeWriteFileTool = {
-    name: "giuseppe_write_file",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerWriteFileTool = {
+    name: "bug_fixer_write_file",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: "Write/update a source file in the app",
     schema: zod_1.z.object({
         appPath: zod_1.z.string().describe("Path to the app project"),
@@ -186,7 +186,7 @@ exports.giuseppeWriteFileTool = {
             const fullPath = path.join(args.appPath, args.filePath);
             await fs.mkdir(path.dirname(fullPath), { recursive: true });
             await fs.writeFile(fullPath, args.content, "utf-8");
-            logger.info("Giuseppe wrote file", { filePath: args.filePath });
+            logger.info("Bug Fixer wrote file", { filePath: args.filePath });
             return {
                 content: [{ type: "text", text: JSON.stringify({ success: true, path: args.filePath }) }]
             };
@@ -206,9 +206,9 @@ const fixFileSchema = zod_1.z.object({
     replace: zod_1.z.string().optional().describe("For 'edit': the code to replace it with"),
     content: zod_1.z.string().optional().describe("For 'create': the full file content")
 });
-exports.giuseppeApplyFixTool = {
-    name: "giuseppe_apply_fix",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerApplyFixTool = {
+    name: "bug_fixer_apply_fix",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: `Apply code fixes using search/replace pattern. More token-efficient than rewriting entire files.
 
 **For 'edit' action:** Provide search (code to find) and replace (code to replace with).
@@ -263,7 +263,7 @@ Example:
                             const newContent = content.replace(fix.search, fix.replace);
                             await fs.writeFile(filePath, newContent, 'utf-8');
                             modifiedFiles.push(fix.path);
-                            logger.info("Giuseppe applied fix (exact match)", { path: fix.path });
+                            logger.info("Bug Fixer applied fix (exact match)", { path: fix.path });
                         }
                         else {
                             // Try normalized whitespace match
@@ -285,7 +285,7 @@ Example:
                                         await fs.writeFile(filePath, newContent, 'utf-8');
                                         modifiedFiles.push(fix.path);
                                         found = true;
-                                        logger.info("Giuseppe applied fix (normalized match)", { path: fix.path });
+                                        logger.info("Bug Fixer applied fix (normalized match)", { path: fix.path });
                                         break;
                                     }
                                 }
@@ -302,12 +302,12 @@ Example:
                         await fs.mkdir(path.dirname(filePath), { recursive: true });
                         await fs.writeFile(filePath, fix.content, 'utf-8');
                         modifiedFiles.push(fix.path);
-                        logger.info("Giuseppe created file", { path: fix.path });
+                        logger.info("Bug Fixer created file", { path: fix.path });
                     }
                     else if (fix.action === 'delete') {
                         await fs.unlink(filePath);
                         modifiedFiles.push(fix.path);
-                        logger.info("Giuseppe deleted file", { path: fix.path });
+                        logger.info("Bug Fixer deleted file", { path: fix.path });
                     }
                     else {
                         errors.push(`${fix.path}: Invalid action or missing required fields`);
@@ -331,7 +331,7 @@ Example:
                 content: [{ type: "text", text: JSON.stringify({
                             success: true,
                             modifiedFiles,
-                            message: `Applied ${modifiedFiles.length} fix(es). Run giuseppe_run_build to verify.`
+                            message: `Applied ${modifiedFiles.length} fix(es). Run bug_fixer_run_build to verify.`
                         }) }]
             };
         }
@@ -343,9 +343,9 @@ Example:
     }
 };
 // Run Build Tool
-exports.giuseppeRunBuildTool = {
-    name: "giuseppe_run_build",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerRunBuildTool = {
+    name: "bug_fixer_run_build",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: "Run TypeScript build to check for errors",
     schema: zod_1.z.object({
         appPath: zod_1.z.string().describe("Path to the app project")
@@ -365,9 +365,9 @@ exports.giuseppeRunBuildTool = {
     }
 };
 // Git Status Tool
-exports.giuseppeGitStatusTool = {
-    name: "giuseppe_git_status",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerGitStatusTool = {
+    name: "bug_fixer_git_status",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: "Check git status - branch, changes, sync with remote",
     schema: zod_1.z.object({
         appPath: zod_1.z.string().describe("Path to the app project")
@@ -395,9 +395,9 @@ exports.giuseppeGitStatusTool = {
     }
 };
 // Git Pull Tool
-exports.giuseppeGitPullTool = {
-    name: "giuseppe_git_pull",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerGitPullTool = {
+    name: "bug_fixer_git_pull",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: "Pull latest changes from remote",
     schema: zod_1.z.object({
         appPath: zod_1.z.string().describe("Path to the app project")
@@ -417,9 +417,9 @@ exports.giuseppeGitPullTool = {
     }
 };
 // Git Commit Tool
-exports.giuseppeGitCommitTool = {
-    name: "giuseppe_git_commit",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerGitCommitTool = {
+    name: "bug_fixer_git_commit",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: "Stage all changes and commit",
     schema: zod_1.z.object({
         appPath: zod_1.z.string().describe("Path to the app project"),
@@ -430,7 +430,7 @@ exports.giuseppeGitCommitTool = {
             (0, child_process_1.execSync)("git add -A", { cwd: args.appPath });
             (0, child_process_1.execSync)(`git commit -m "${args.message.replace(/"/g, '\\"')}"`, { cwd: args.appPath });
             const hash = (0, child_process_1.execSync)("git rev-parse --short HEAD", { cwd: args.appPath, encoding: "utf-8" }).trim();
-            logger.info("Giuseppe committed", { hash, message: args.message });
+            logger.info("Bug Fixer committed", { hash, message: args.message });
             return {
                 content: [{ type: "text", text: JSON.stringify({ success: true, hash }) }]
             };
@@ -443,9 +443,9 @@ exports.giuseppeGitCommitTool = {
     }
 };
 // Git Push Tool
-exports.giuseppeGitPushTool = {
-    name: "giuseppe_git_push",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerGitPushTool = {
+    name: "bug_fixer_git_push",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: "Push commits to remote",
     schema: zod_1.z.object({
         appPath: zod_1.z.string().describe("Path to the app project")
@@ -465,9 +465,9 @@ exports.giuseppeGitPushTool = {
     }
 };
 // Git Revert Tool
-exports.giuseppeGitRevertTool = {
-    name: "giuseppe_git_revert",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerGitRevertTool = {
+    name: "bug_fixer_git_revert",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: "Discard all uncommitted changes",
     schema: zod_1.z.object({
         appPath: zod_1.z.string().describe("Path to the app project")
@@ -487,9 +487,9 @@ exports.giuseppeGitRevertTool = {
     }
 };
 // Publish App Tool
-exports.giuseppePublishAppTool = {
-    name: "giuseppe_publish_app",
-    group: tool_registry_1.ToolGroup.PLAYGROUND,
+exports.bugFixerPublishAppTool = {
+    name: "bug_fixer_publish_app",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
     description: "Publish app to Hailer production - ALWAYS ASK USER FIRST",
     schema: zod_1.z.object({
         appPath: zod_1.z.string().describe("Path to the app project")
@@ -508,18 +508,18 @@ exports.giuseppePublishAppTool = {
     }
 };
 // Export all tools
-exports.giuseppeTools = [
-    exports.giuseppeFindAppTool,
-    exports.giuseppeListFilesTool,
-    exports.giuseppeReadFileTool,
-    exports.giuseppeWriteFileTool,
-    exports.giuseppeApplyFixTool, // New: search/replace (preferred)
-    exports.giuseppeRunBuildTool,
-    exports.giuseppeGitStatusTool,
-    exports.giuseppeGitPullTool,
-    exports.giuseppeGitCommitTool,
-    exports.giuseppeGitPushTool,
-    exports.giuseppeGitRevertTool,
-    exports.giuseppePublishAppTool,
+exports.bugFixerTools = [
+    exports.bugFixerFindAppTool,
+    exports.bugFixerListFilesTool,
+    exports.bugFixerReadFileTool,
+    exports.bugFixerWriteFileTool,
+    exports.bugFixerApplyFixTool, // New: search/replace (preferred)
+    exports.bugFixerRunBuildTool,
+    exports.bugFixerGitStatusTool,
+    exports.bugFixerGitPullTool,
+    exports.bugFixerGitCommitTool,
+    exports.bugFixerGitPushTool,
+    exports.bugFixerGitRevertTool,
+    exports.bugFixerPublishAppTool,
 ];
-//# sourceMappingURL=giuseppe-tools.js.map
+//# sourceMappingURL=bug-fixer-tools.js.map

package/dist/mcp/tools/user.js

@@ -57,15 +57,9 @@ exports.searchWorkspaceUsersTool = {
                 }
             });
             if (matchingUsers.length === 0) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `❌ No users found matching "${args.query}" in the current workspace.\n\n` +
-                                `💡 Available users:\n${context.workspaceCache.users.map((u) => `- ${u.fullName} (${u.id})`).join("\n")}`,
-                        },
-                    ],
-                };
+                const availableUsers = context.workspaceCache.users.map((u) => `- ${u.fullName} (${u.id})`).join("\n");
+                return (0, index_1.textResponse)(`❌ No users found matching "${args.query}" in the current workspace.\n\n` +
+                    `💡 Available users:\n${availableUsers}`);
             }
             const userList = matchingUsers.map((user) => ({
                 id: user.id,
@@ -73,29 +67,16 @@ exports.searchWorkspaceUsersTool = {
                 firstName: user.firstname,
                 lastName: user.lastname,
             }));
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `✅ Found ${matchingUsers.length} user(s) matching "${args.query}":\n\n` +
-                            userList
-                                .map((user) => `• **${user.name}**\n  - ID: \`${user.id}\`\n  - Use this ID for assignment or followers`)
-                                .join("\n\n") +
-                            `\n\n💡 Use these IDs in create_activity fields or followerIds parameters.`,
-                    },
-                ],
-            };
+            const formattedUsers = userList
+                .map((user) => `• **${user.name}**\n  - ID: \`${user.id}\`\n  - Use this ID for assignment or followers`)
+                .join("\n\n");
+            return (0, index_1.textResponse)(`✅ Found ${matchingUsers.length} user(s) matching "${args.query}":\n\n` +
+                formattedUsers +
+                `\n\n💡 Use these IDs in create_activity fields or followerIds parameters.`);
         }
         catch (error) {
             logger.error("Error searching workspace users", error);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `❌ Error searching users: ${(0, tool_helpers_1.extractErrorMessage)(error)}`,
-                    },
-                ],
-            };
+            return (0, index_1.errorResponse)(`Error searching users: ${(0, index_1.getErrorMessage)(error)}`);
         }
     },
 };

package/dist/mcp/tools/workflow.js

@@ -64,6 +64,15 @@ exports.getWorkflowSchemaTool = {
     }),
     async execute(args, context) {
         try {
+            // Validate phaseId format early - must be 24-char MongoDB ID, not a simple number
+            if (args.phaseId && args.phaseId.length !== 24) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Invalid phaseId "${args.phaseId}" - must be a 24-character ID.\n\n**How to get valid phase IDs:**\n1. Call \`list_workflow_phases\` with the workflowId first\n2. Use the returned phase IDs (24 characters like "691ffdf84217e9e8434e56a5")\n\n**Example:**\n\`\`\`\nlist_workflow_phases({ workflowId: "${args.workflowId}" })\n\`\`\``,
+                        }],
+                };
+            }
             // Use cached workflow data from context.init (already fetched during initialization)
             const workflow = context.init.processes?.find(p => p._id === args.workflowId);
             if (!workflow) {
@@ -352,7 +361,9 @@ exports.listWorkflowsTool = {
 // ============================================================================
 // TOOL 1: INSTALL WORKFLOW
 // ============================================================================
-const installWorkflowDescription = `Install workflow from template`;
+const installWorkflowDescription = `Install workflow from template
+
+**Field types:** text, textarea, numeric, numericunit, date, datetime, textpredefinedoptions (for dropdowns - NOT 'select'!), activitylink, users, teams, country, subheader`;
 const installWorkflowSchema = zod_1.z.object({
     workspaceId: zod_1.z
         .string()
@@ -377,7 +388,7 @@ const installWorkflowSchema = zod_1.z.object({
             ]).describe("Field type"),
             key: zod_1.z.string().optional().describe("Readable field name (like SQL column name) - RECOMMENDED"),
             required: zod_1.z.boolean().optional().describe("Whether field is required"),
-            data: zod_1.z.array(zod_1.z.string()).optional().describe("For activitylink: workflow IDs to link to. For textpredefinedoptions: allowed option values"),
+            data: zod_1.z.array(zod_1.z.string()).optional().describe("For textpredefinedoptions: string array like [\"Low\", \"Medium\", \"High\"]. For activitylink: target workflow IDs"),
             placeholder: zod_1.z.string().optional().describe("Placeholder text"),
             unit: zod_1.z.string().optional().describe("Unit for numeric/textunit fields"),
             description: zod_1.z.string().optional().describe("Field description"),
@@ -440,6 +451,20 @@ exports.installWorkflowTool = {
                 args.workflowTemplates
             ]);
             logger.debug('Workflow installation successful', { result });
+            // Refresh context.init.processes cache so new workflows are immediately available
+            try {
+                const freshInit = await context.client.socket.request('v2.core.init', [['processes']]);
+                if (freshInit.processes) {
+                    context.init.processes = freshInit.processes;
+                    logger.info('Refreshed workflow cache after installation', {
+                        workflowCount: freshInit.processes.length
+                    });
+                }
+            }
+            catch (refreshError) {
+                logger.warn('Failed to refresh workflow cache after installation', { error: refreshError });
+                // Non-fatal - the workflow was created, just cache is stale
+            }
             // Build success response
             let responseText = `✅ **Workflow Installation Successful**\n\n`;
             responseText += `**Workspace:** ${workspaceId}\n`;
@@ -1217,6 +1242,15 @@ exports.updateWorkflowPhaseTool = {
             apiKey: context.apiKey.substring(0, 8) + '...'
         });
         try {
+            // Validate phaseId format early - must be 24-char MongoDB ID, not a simple number
+            if (args.phaseId && args.phaseId.length !== 24) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Invalid phaseId "${args.phaseId}" - must be a 24-character ID.\n\n**How to get valid phase IDs:**\n1. Call \`list_workflow_phases\` with the workflowId first\n2. Use the returned phase IDs (24 characters like "691ffdf84217e9e8434e56a5")\n\n**Example:**\n\`\`\`\nlist_workflow_phases({ workflowId: "${args.workflowId}" })\n\`\`\``,
+                        }],
+                };
+            }
             // Get current workspace from cached init data
             let workspaceId = args.workspaceId;
             if (!workspaceId) {

package/dist/mcp/utils/data-transformers.d.ts

@@ -87,16 +87,8 @@ export declare function formatTimestamp(timestamp: number | string | Date): stri
  * Formats user name from user info
  */
 export declare function formatUserName(user: UserInfo | undefined, fallbackId: string): string;
-/**
- * Gets the first phase ID from workflow (for defaults)
- */
-export declare function getFirstPhaseId(workflow: WorkflowInfo): string | null;
 /**
  * Formats activity data for MCP response
  */
 export declare function formatActivityListResponse(activities: CleanActivity[], workflow: WorkflowInfo, phaseName?: string): string;
-/**
- * Creates a simplified activity format for search results
- */
-export declare function transformActivityForSearch(activity: any): any;
 //# sourceMappingURL=data-transformers.d.ts.map

package/dist/mcp/utils/data-transformers.js

@@ -14,9 +14,7 @@ exports.transformPhases = transformPhases;
 exports.transformWorkflowFields = transformWorkflowFields;
 exports.formatTimestamp = formatTimestamp;
 exports.formatUserName = formatUserName;
-exports.getFirstPhaseId = getFirstPhaseId;
 exports.formatActivityListResponse = formatActivityListResponse;
-exports.transformActivityForSearch = transformActivityForSearch;
 /**
  * Transforms raw activity data into clean, structured format
  */
@@ -157,13 +155,6 @@ function formatUserName(user, fallbackId) {
     const fullName = `${user.firstname || ''} ${user.lastname || ''}`.trim();
     return fullName || user.email || `User ${fallbackId}`;
 }
-/**
- * Gets the first phase ID from workflow (for defaults)
- */
-function getFirstPhaseId(workflow) {
-    const phases = Object.values(workflow.phases);
-    return phases.length > 0 ? phases[0]._id : null;
-}
 /**
  * Formats activity data for MCP response
  */
@@ -172,23 +163,4 @@ function formatActivityListResponse(activities, workflow, phaseName) {
     const phaseInfo = phaseName ? ` (phase: ${phaseName})` : '';
     return `✅ Found ${count} activities in workflow "${workflow.name}"${phaseInfo}\n\n${JSON.stringify(activities, null, 2)}`;
 }
-/**
- * Creates a simplified activity format for search results
- */
-function transformActivityForSearch(activity) {
-    return {
-        _id: activity._id,
-        name: activity.name,
-        workflow: {
-            _id: activity.process?._id,
-            name: activity.process?.name,
-        },
-        currentPhase: {
-            _id: activity.currentPhase?._id,
-            name: activity.currentPhase?.name,
-        },
-        created: activity.created?.humanReadable,
-        updated: activity.updated?.humanReadable,
-    };
-}
 //# sourceMappingURL=data-transformers.js.map

package/dist/mcp/utils/index.d.ts

@@ -8,6 +8,9 @@ export { HailerApiError, makeApiCall, handleApiResponse, createErrorResponse, cr
 export type { ApiCallOptions } from './api-errors';
 export { HailerApiClient } from './hailer-api-client';
 export type { RestCallConfig } from './hailer-api-client';
-export { transformActivity, transformActivities, transformFields, transformFieldValue, findFieldByKey, transformWorkflow, transformPhases, transformWorkflowFields, formatTimestamp, formatUserName, getFirstPhaseId, formatActivityListResponse, transformActivityForSearch, } from './data-transformers';
+export { transformActivity, transformActivities, transformFields, transformFieldValue, findFieldByKey, transformWorkflow, transformPhases, transformWorkflowFields, formatTimestamp, formatUserName, formatActivityListResponse, } from './data-transformers';
+export { textResponse, errorResponse, successResponse, jsonResponse, paginatedResponse, listResponse, getErrorMessage, withErrorHandling, isErrorResponse } from './response-builder';
+export { normalizePagination, calculatePaginationMeta, formatPaginationText } from './pagination';
+export type { PaginationMeta, PaginationOptions } from './pagination';
 export type * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/utils/index.js

@@ -4,7 +4,7 @@
  * Provides centralized access to all utility functions and types
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.transformActivityForSearch = exports.formatActivityListResponse = exports.getFirstPhaseId = exports.formatUserName = exports.formatTimestamp = exports.transformWorkflowFields = exports.transformPhases = exports.transformWorkflow = exports.findFieldByKey = exports.transformFieldValue = exports.transformFields = exports.transformActivities = exports.transformActivity = exports.HailerApiClient = exports.createSuccessResponse = exports.createErrorResponse = exports.handleApiResponse = exports.makeApiCall = exports.HailerApiError = exports.LogTag = exports.LogLevel = exports.logger = exports.createLogger = void 0;
+exports.formatPaginationText = exports.calculatePaginationMeta = exports.normalizePagination = exports.isErrorResponse = exports.withErrorHandling = exports.getErrorMessage = exports.listResponse = exports.paginatedResponse = exports.jsonResponse = exports.successResponse = exports.errorResponse = exports.textResponse = exports.formatActivityListResponse = exports.formatUserName = exports.formatTimestamp = exports.transformWorkflowFields = exports.transformPhases = exports.transformWorkflow = exports.findFieldByKey = exports.transformFieldValue = exports.transformFields = exports.transformActivities = exports.transformActivity = exports.HailerApiClient = exports.createSuccessResponse = exports.createErrorResponse = exports.handleApiResponse = exports.makeApiCall = exports.HailerApiError = exports.LogTag = exports.LogLevel = exports.logger = exports.createLogger = void 0;
 // Logging utilities
 var logger_1 = require("../../lib/logger");
 Object.defineProperty(exports, "createLogger", { enumerable: true, get: function () { return logger_1.createLogger; } });
@@ -33,7 +33,21 @@ Object.defineProperty(exports, "transformPhases", { enumerable: true, get: funct
 Object.defineProperty(exports, "transformWorkflowFields", { enumerable: true, get: function () { return data_transformers_1.transformWorkflowFields; } });
 Object.defineProperty(exports, "formatTimestamp", { enumerable: true, get: function () { return data_transformers_1.formatTimestamp; } });
 Object.defineProperty(exports, "formatUserName", { enumerable: true, get: function () { return data_transformers_1.formatUserName; } });
-Object.defineProperty(exports, "getFirstPhaseId", { enumerable: true, get: function () { return data_transformers_1.getFirstPhaseId; } });
 Object.defineProperty(exports, "formatActivityListResponse", { enumerable: true, get: function () { return data_transformers_1.formatActivityListResponse; } });
-Object.defineProperty(exports, "transformActivityForSearch", { enumerable: true, get: function () { return data_transformers_1.transformActivityForSearch; } });
+// Response builders
+var response_builder_1 = require("./response-builder");
+Object.defineProperty(exports, "textResponse", { enumerable: true, get: function () { return response_builder_1.textResponse; } });
+Object.defineProperty(exports, "errorResponse", { enumerable: true, get: function () { return response_builder_1.errorResponse; } });
+Object.defineProperty(exports, "successResponse", { enumerable: true, get: function () { return response_builder_1.successResponse; } });
+Object.defineProperty(exports, "jsonResponse", { enumerable: true, get: function () { return response_builder_1.jsonResponse; } });
+Object.defineProperty(exports, "paginatedResponse", { enumerable: true, get: function () { return response_builder_1.paginatedResponse; } });
+Object.defineProperty(exports, "listResponse", { enumerable: true, get: function () { return response_builder_1.listResponse; } });
+Object.defineProperty(exports, "getErrorMessage", { enumerable: true, get: function () { return response_builder_1.getErrorMessage; } });
+Object.defineProperty(exports, "withErrorHandling", { enumerable: true, get: function () { return response_builder_1.withErrorHandling; } });
+Object.defineProperty(exports, "isErrorResponse", { enumerable: true, get: function () { return response_builder_1.isErrorResponse; } });
+// Pagination utilities
+var pagination_1 = require("./pagination");
+Object.defineProperty(exports, "normalizePagination", { enumerable: true, get: function () { return pagination_1.normalizePagination; } });
+Object.defineProperty(exports, "calculatePaginationMeta", { enumerable: true, get: function () { return pagination_1.calculatePaginationMeta; } });
+Object.defineProperty(exports, "formatPaginationText", { enumerable: true, get: function () { return pagination_1.formatPaginationText; } });
 //# sourceMappingURL=index.js.map

package/dist/mcp/utils/pagination.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pagination Helper Utility
+ *
+ * Centralized pagination logic for MCP tools.
+ */
+export interface PaginationMeta {
+    currentPage: number;
+    pageSize: number;
+    totalItems?: number;
+    totalPages?: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+}
+export interface PaginationOptions {
+    page?: number;
+    limit?: number;
+    defaultLimit?: number;
+    maxLimit?: number;
+}
+/**
+ * Normalize pagination options with defaults
+ */
+export declare function normalizePagination(options?: PaginationOptions): {
+    page: number;
+    limit: number;
+    offset: number;
+};
+/**
+ * Calculate pagination metadata from results
+ */
+export declare function calculatePaginationMeta(itemCount: number, options: {
+    page: number;
+    limit: number;
+    totalCount?: number;
+}): PaginationMeta;
+/**
+ * Format pagination info as markdown text
+ */
+export declare function formatPaginationText(meta: PaginationMeta): string;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/mcp/utils/pagination.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Pagination Helper Utility
+ *
+ * Centralized pagination logic for MCP tools.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePagination = normalizePagination;
+exports.calculatePaginationMeta = calculatePaginationMeta;
+exports.formatPaginationText = formatPaginationText;
+/**
+ * Normalize pagination options with defaults
+ */
+function normalizePagination(options = {}) {
+    const { page = 0, limit, defaultLimit = 50, maxLimit = 1000 } = options;
+    const normalizedLimit = Math.min(limit ?? defaultLimit, maxLimit);
+    const normalizedPage = Math.max(0, page);
+    return {
+        page: normalizedPage,
+        limit: normalizedLimit,
+        offset: normalizedPage * normalizedLimit
+    };
+}
+/**
+ * Calculate pagination metadata from results
+ */
+function calculatePaginationMeta(itemCount, options) {
+    const { page, limit, totalCount } = options;
+    const totalPages = totalCount !== undefined
+        ? Math.ceil(totalCount / limit)
+        : undefined;
+    return {
+        currentPage: page,
+        pageSize: limit,
+        totalItems: totalCount,
+        totalPages,
+        hasNextPage: itemCount === limit,
+        hasPrevPage: page > 0
+    };
+}
+/**
+ * Format pagination info as markdown text
+ */
+function formatPaginationText(meta) {
+    const lines = [
+        `📊 **Page ${meta.currentPage + 1}${meta.totalPages ? ` of ${meta.totalPages}` : ''}**`,
+        `- Items on page: ${meta.pageSize}`,
+    ];
+    if (meta.totalItems !== undefined) {
+        lines.push(`- Total items: ${meta.totalItems}`);
+    }
+    lines.push(`- Has more: ${meta.hasNextPage ? 'Yes (increase page number)' : 'No'}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=pagination.js.map