@hailer/mcp 1.2.1 → 1.3.10

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

@@ -18,24 +18,24 @@ export declare class HailerApiClient {
     private logger;
     constructor(clients: HailerClient);
     /**
-     * Get the underlying HailerClient for direct access (e.g., SignalHandler)
-     */
+   * Get the underlying HailerClient for direct access (e.g., SignalHandler)
+   */
     getClient(): HailerClient;
     /**
-     * Makes a socket API call - thin wrapper around clients.socket.request
-     */
+   * Makes a socket API call - thin wrapper around clients.socket.request
+   */
     request<T>(method: string, args?: any[]): Promise<T>;
     /**
-     * Makes a REST API call
-     */
+   * Makes a REST API call
+   */
     callRest<T>(config: RestCallConfig): Promise<T>;
     /**
-     * Get workflow schema - uses Socket API to get field definitions
-     */
+   * Get workflow schema - uses Socket API to get field definitions
+   */
     getWorkflowSchema(workflowId: string, phaseId: string): Promise<any>;
     /**
-     * Fetch activity list - uses v3 Socket API with enhanced pagination and filtering
-     */
+   * Fetch activity list - uses v3 Socket API with enhanced pagination and filtering
+   */
     fetchActivityList(workflowId: string, phaseId?: string, limit?: number, options?: {
         page?: number;
         search?: string;
@@ -47,115 +47,115 @@ export declare class HailerApiClient {
         fields?: string[];
     }): Promise<any>;
     /**
-     * Create activities - uses Socket API
-     */
+   * Create activities - uses Socket API
+   */
     createActivities(workflowId: string, activities: any[], options?: any): Promise<any>;
     /**
-     * Update activities - uses Socket API
-     */
+   * Update activities - uses Socket API
+   */
     updateActivities(updates: any[], options?: any): Promise<any>;
     /**
-     * Fetch discussion messages - uses Socket API, load messages from specified discussion
-     * @param discussionId - The discussion ID to fetch messages from
-     * @param limit - Number of messages to fetch (client-side limiting if API doesn't support it)
-     */
+   * Fetch discussion messages - uses Socket API, load messages from specified discussion
+   * @param discussionId - The discussion ID to fetch messages from
+   * @param limit - Number of messages to fetch (client-side limiting if API doesn't support it)
+   */
     fetchDiscussionMessages(discussionId: string, limit?: number): Promise<any>;
     /**
-     * Fetch previous discussion messages - uses Socket API for pagination
-     * @param oldestMessageId - The ID of the oldest message from previous fetch
-     * @param batches - Number of previous batches to fetch (default: 1)
-     */
+   * Fetch previous discussion messages - uses Socket API for pagination
+   * @param oldestMessageId - The ID of the oldest message from previous fetch
+   * @param batches - Number of previous batches to fetch (default: 1)
+   */
     fetchPreviousDiscussionMessages(oldestMessageId: string, batches?: number): Promise<any>;
     /**
-     * Fetch activity by ID - uses Socket API
-     * WARNING: This uses activities.load which evaluates function fields and may fail
-     * For bot config, prefer fetchActivityByIdSafe()
-     */
+   * Fetch activity by ID - uses Socket API
+   * WARNING: This uses activities.load which evaluates function fields and may fail
+   * For bot config, prefer fetchActivityByIdSafe()
+   */
     fetchActivityById(activityId: string): Promise<any>;
     /**
-     * Fetch activity by ID safely using v3.activity.list API
-     * This doesn't evaluate function fields so it works even when function fields are broken
-     */
+   * Fetch activity by ID safely using v3.activity.list API
+   * This doesn't evaluate function fields so it works even when function fields are broken
+   */
     fetchActivityByIdSafe(activityId: string, workflowId?: string, phaseId?: string): Promise<any>;
     /**
-     * Send discussion message - uses Socket API
-     */
+   * Send discussion message - uses Socket API
+   */
     sendDiscussionMessage(discussionId: string, content: string, fileIds?: string[]): Promise<any>;
     /**
-     * Join an activity's discussion by following the activity - uses Socket API
-     * This is the recommended way to join activity discussions.
-     * Returns true if now following.
-     * IMPORTANT: activities.follow is a toggle, so if we accidentally toggle OFF, we toggle back ON.
-     */
+   * Join an activity's discussion by following the activity - uses Socket API
+   * This is the recommended way to join activity discussions.
+   * Returns true if now following.
+   * IMPORTANT: activities.follow is a toggle, so if we accidentally toggle OFF, we toggle back ON.
+   */
     joinActivityDiscussion(activityId: string): Promise<boolean>;
     /**
-     * Leave an activity's discussion by unfollowing the activity - uses Socket API
-     * Returns true if successfully unfollowed.
-     * IMPORTANT: activities.follow is a toggle, so if we accidentally toggle ON, we toggle back OFF.
-     */
+   * Leave an activity's discussion by unfollowing the activity - uses Socket API
+   * Returns true if successfully unfollowed.
+   * IMPORTANT: activities.follow is a toggle, so if we accidentally toggle ON, we toggle back OFF.
+   */
     leaveActivityDiscussion(activityId: string): Promise<boolean>;
     /**
-     * Leave a discussion directly - uses Socket API
-     * This works for any discussion type. For activity discussions, prefer leaveActivityDiscussion().
-     */
+   * Leave a discussion directly - uses Socket API
+   * This works for any discussion type. For activity discussions, prefer leaveActivityDiscussion().
+   */
     leaveDiscussion(discussionId: string): Promise<void>;
     /**
-     * Join a discussion directly - uses Socket API
-     * Note: There's no generic join endpoint. For activity discussions, use joinActivityDiscussion().
-     * For other discussion types, you may need to use invite mechanisms.
-     * This method attempts to fetch the discussion to check if user needs to join.
-     */
+   * Join a discussion directly - uses Socket API
+   * Note: There's no generic join endpoint. For activity discussions, use joinActivityDiscussion().
+   * For other discussion types, you may need to use invite mechanisms.
+   * This method attempts to fetch the discussion to check if user needs to join.
+   */
     joinDiscussion(discussionId: string): Promise<{
         success: boolean;
         message: string;
         method?: string;
     }>;
     /**
-     * Fetch workspace initialization data - uses Socket API
-     * @param include - What to include: 'users', 'network', 'networks', 'teams', etc.
-     */
+   * Fetch workspace initialization data - uses Socket API
+   * @param include - What to include: 'users', 'network', 'networks', 'teams', etc.
+   */
     fetchInit(include?: string[]): Promise<any>;
     /**
-     * Update current user's profile info (firstname, lastname, etc.)
-     * Only works for the currently authenticated user
-     * @param key - Field to update: firstname, lastname, email, status, etc.
-     * @param value - New value as string
-     */
+   * Update current user's profile info (firstname, lastname, etc.)
+   * Only works for the currently authenticated user
+   * @param key - Field to update: firstname, lastname, email, status, etc.
+   * @param value - New value as string
+   */
     setUserInfo(key: 'firstname' | 'lastname' | 'email' | 'status' | 'default_company' | 'lastLocation' | 'preferredLanguages', value: string): Promise<void>;
     /**
-     * Update current user's display name (firstname + lastname)
-     * Parses a full name into first/last parts
-     * @param fullName - Full display name like "HAL 9000"
-     */
+   * Update current user's display name (firstname + lastname)
+   * Parses a full name into first/last parts
+   * @param fullName - Full display name like "HAL 9000"
+   */
     setUserDisplayName(fullName: string): Promise<void>;
     /**
-     * Find user by name - searches init data for firstname/lastname match
-     * @param name - Full name to search for (firstname lastname)
-     * @returns User ID if found, null otherwise
-     */
+   * Find user by name - searches init data for firstname/lastname match
+   * @param name - Full name to search for (firstname lastname)
+   * @returns User ID if found, null otherwise
+   */
     findUserByName(name: string): Promise<string | null>;
     /**
-     * List all workflows in the workspace - extracts from init data
-     * @param workspaceId - Optional workspace ID to filter workflows (uses CID field)
-     */
+   * List all workflows in the workspace - extracts from init data
+   * @param workspaceId - Optional workspace ID to filter workflows (uses CID field)
+   */
     listWorkflows(workspaceId?: string): Promise<any[]>;
     /**
-     * Get workflow details including phases and fields
-     */
+   * Get workflow details including phases and fields
+   */
     getWorkflow(workflowId: string): Promise<any>;
     /**
-     * Global search across workspace - uses Socket API
-     */
+   * Global search across workspace - uses Socket API
+   */
     globalSearch(query: string, sections?: string[]): Promise<any>;
     /**
-     * Upload a file from URL or filesystem path
-     */
+   * 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)
-     */
+   * 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;
@@ -165,12 +165,12 @@ export declare class HailerApiClient {
         encoding: 'utf8' | 'base64';
     }>;
     /**
-     * Helper method to create MCP tool responses
-     */
+   * Helper method to create MCP tool responses
+   */
     createMcpResponse(data: any, operation: string, summary?: string): any;
     /**
-     * Helper method to create MCP error responses
-     */
+   * Helper method to create MCP error responses
+   */
     createMcpError(error: unknown, operation: string): any;
 }
 //# sourceMappingURL=hailer-api-client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hailer-api-client.d.ts","sourceRoot":"","sources":["../../../src/mcp/utils/hailer-api-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hailer-api-client.d.ts","sourceRoot":"","sources":["../../../src/mcp/utils/hailer-api-client.ts"],"names":[],"mappings":"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"}

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

@@ -16,14 +16,14 @@ class HailerApiClient {
         this.clients = clients;
     }
     /**
-     * Get the underlying HailerClient for direct access (e.g., SignalHandler)
-     */
+   * Get the underlying HailerClient for direct access (e.g., SignalHandler)
+   */
     getClient() {
         return this.clients;
     }
     /**
-     * Makes a socket API call - thin wrapper around clients.socket.request
-     */
+   * Makes a socket API call - thin wrapper around clients.socket.request
+   */
     async request(method, args) {
         if (!this.clients.socket) {
             throw new Error(`Socket client not available for method: ${method}`);
@@ -47,11 +47,11 @@ class HailerApiClient {
         }
     }
     /**
-     * Makes a REST API call
-     */
+   * Makes a REST API call
+   */
     async callRest(config) {
         const url = `${this.clients.socket.host}${config.endpoint}`;
-        return await (0, api_errors_1.makeApiCall)(url, {
+        return (0, api_errors_1.makeApiCall)(url, {
             operation: config.operation,
             endpoint: config.endpoint,
             method: config.method || 'POST',
@@ -59,32 +59,41 @@ class HailerApiClient {
             timeout: config.timeout,
             context: config.context,
             headers: {
-                'hlrkey': this.clients.sessionKey,
+                hlrkey: this.clients.sessionKey,
             },
         });
     }
     /**
-     * Get workflow schema - uses Socket API to get field definitions
-     */
+   * Get workflow schema - uses Socket API to get field definitions
+   */
     async getWorkflowSchema(workflowId, phaseId) {
-        return await this.request('v3.activity.template.create', [workflowId, phaseId]);
+        return this.request('v3.activity.template.create', [workflowId, phaseId]);
     }
     /**
-     * Fetch activity list - uses v3 Socket API with enhanced pagination and filtering
-     */
+   * Fetch activity list - uses v3 Socket API with enhanced pagination and filtering
+   */
     async fetchActivityList(workflowId, phaseId, limit = 50, options) {
         // V3 API uses processId and phaseId (not process/phase)
         const workflowFilter = { processId: workflowId };
-        if (phaseId)
+        if (phaseId) {
             workflowFilter.phaseId = phaseId;
+        }
         const requestOptions = {
             filters: options?.filters,
             limit,
             search: options?.search || null,
-            page: options?.page ? options.page + 1 : 1, // v3 uses 1-based page numbering
-            sortBy: options?.sortBy || "updated",
-            sortOrder: options?.sortOrder || "desc",
-            includeStats: options?.includeStats !== undefined ? options?.includeStats : true,
+            // The backend declares 'page' in its schema but never reads it — only
+            // 'skip' paginates (v3 activity-list aggregation uses $skip/$limit).
+            skip: (options?.page || 0) * limit,
+            sortBy: options?.sortBy || 'updated',
+            sortOrder: options?.sortOrder || 'desc',
+            includeStats: options?.includeStats ?? false,
+            // metadata.totalCount always comes back; users/teams/activity-link maps
+            // are unused here (we resolve names from the cached core.init) and only
+            // add backend queries + payload per call.
+            includeUsers: false,
+            includeTeams: false,
+            includeActivityLinks: false,
             returnFlat: options?.returnFlat !== undefined ? options?.returnFlat : true,
             fields: options?.fields || undefined,
         };
@@ -97,11 +106,11 @@ class HailerApiClient {
             filterCount: options?.filters?.and?.length || 0,
         });
         // Use Format B (simple array) - confirmed working
-        return await this.request('v3.activity.list', [workflowFilter, requestOptions]);
+        return this.request('v3.activity.list', [workflowFilter, requestOptions]);
     }
     /**
-     * Create activities - uses Socket API
-     */
+   * Create activities - uses Socket API
+   */
     async createActivities(workflowId, activities, options) {
         try {
             const result = await this.request('v3.activity.createMany', [workflowId, activities, options || {}]);
@@ -118,17 +127,17 @@ class HailerApiClient {
         }
     }
     /**
-     * Update activities - uses Socket API
-     */
+   * Update activities - uses Socket API
+   */
     async updateActivities(updates, options) {
         const args = options ? [updates, options] : [updates];
-        return await this.request('v3.activity.updateMany', args);
+        return this.request('v3.activity.updateMany', args);
     }
     /**
-     * Fetch discussion messages - uses Socket API, load messages from specified discussion
-     * @param discussionId - The discussion ID to fetch messages from
-     * @param limit - Number of messages to fetch (client-side limiting if API doesn't support it)
-     */
+   * Fetch discussion messages - uses Socket API, load messages from specified discussion
+   * @param discussionId - The discussion ID to fetch messages from
+   * @param limit - Number of messages to fetch (client-side limiting if API doesn't support it)
+   */
     async fetchDiscussionMessages(discussionId, limit = 50) {
         const result = await this.request('v3.discussion.message.latest', [discussionId]);
         // If API returned messages and we need to limit them, slice the array
@@ -145,10 +154,10 @@ class HailerApiClient {
         return result;
     }
     /**
-     * Fetch previous discussion messages - uses Socket API for pagination
-     * @param oldestMessageId - The ID of the oldest message from previous fetch
-     * @param batches - Number of previous batches to fetch (default: 1)
-     */
+   * Fetch previous discussion messages - uses Socket API for pagination
+   * @param oldestMessageId - The ID of the oldest message from previous fetch
+   * @param batches - Number of previous batches to fetch (default: 1)
+   */
     async fetchPreviousDiscussionMessages(oldestMessageId, batches = 1) {
         const allMessages = [];
         let currentMessageId = oldestMessageId;
@@ -214,17 +223,17 @@ class HailerApiClient {
         return finalResult;
     }
     /**
-     * Fetch activity by ID - uses Socket API
-     * WARNING: This uses activities.load which evaluates function fields and may fail
-     * For bot config, prefer fetchActivityByIdSafe()
-     */
+   * Fetch activity by ID - uses Socket API
+   * WARNING: This uses activities.load which evaluates function fields and may fail
+   * For bot config, prefer fetchActivityByIdSafe()
+   */
     async fetchActivityById(activityId) {
-        return await this.request('activities.load', [activityId]);
+        return this.request('activities.load', [activityId]);
     }
     /**
-     * Fetch activity by ID safely using v3.activity.list API
-     * This doesn't evaluate function fields so it works even when function fields are broken
-     */
+   * Fetch activity by ID safely using v3.activity.list API
+   * This doesn't evaluate function fields so it works even when function fields are broken
+   */
     async fetchActivityByIdSafe(activityId, workflowId, phaseId) {
         // v3.activity.list doesn't support filtering by _id, so we list and filter client-side
         if (!workflowId || !phaseId) {
@@ -245,21 +254,21 @@ class HailerApiClient {
         return activities.find((a) => a._id === activityId) || null;
     }
     /**
-     * Send discussion message - uses Socket API
-     */
+   * Send discussion message - uses Socket API
+   */
     async sendDiscussionMessage(discussionId, content, fileIds) {
         const messageData = { msg: content };
         if (fileIds && fileIds.length > 0) {
             messageData.files = fileIds;
         }
-        return await this.request('messenger.send', [messageData, discussionId]);
+        return this.request('messenger.send', [messageData, discussionId]);
     }
     /**
-     * Join an activity's discussion by following the activity - uses Socket API
-     * This is the recommended way to join activity discussions.
-     * Returns true if now following.
-     * IMPORTANT: activities.follow is a toggle, so if we accidentally toggle OFF, we toggle back ON.
-     */
+   * Join an activity's discussion by following the activity - uses Socket API
+   * This is the recommended way to join activity discussions.
+   * Returns true if now following.
+   * IMPORTANT: activities.follow is a toggle, so if we accidentally toggle OFF, we toggle back ON.
+   */
     async joinActivityDiscussion(activityId) {
         // activities.follow TOGGLES the state:
         // - returns true = now following (joined)
@@ -274,10 +283,10 @@ class HailerApiClient {
         return true; // We're now following either way
     }
     /**
-     * Leave an activity's discussion by unfollowing the activity - uses Socket API
-     * Returns true if successfully unfollowed.
-     * IMPORTANT: activities.follow is a toggle, so if we accidentally toggle ON, we toggle back OFF.
-     */
+   * Leave an activity's discussion by unfollowing the activity - uses Socket API
+   * Returns true if successfully unfollowed.
+   * IMPORTANT: activities.follow is a toggle, so if we accidentally toggle ON, we toggle back OFF.
+   */
     async leaveActivityDiscussion(activityId) {
         // activities.follow TOGGLES the state:
         // - returns true = now following (joined)
@@ -292,18 +301,18 @@ class HailerApiClient {
         return true; // We're now NOT following either way
     }
     /**
-     * Leave a discussion directly - uses Socket API
-     * This works for any discussion type. For activity discussions, prefer leaveActivityDiscussion().
-     */
+   * Leave a discussion directly - uses Socket API
+   * This works for any discussion type. For activity discussions, prefer leaveActivityDiscussion().
+   */
     async leaveDiscussion(discussionId) {
-        return await this.request('messenger.leave_discussion', [discussionId]);
+        return this.request('messenger.leave_discussion', [discussionId]);
     }
     /**
-     * Join a discussion directly - uses Socket API
-     * Note: There's no generic join endpoint. For activity discussions, use joinActivityDiscussion().
-     * For other discussion types, you may need to use invite mechanisms.
-     * This method attempts to fetch the discussion to check if user needs to join.
-     */
+   * Join a discussion directly - uses Socket API
+   * Note: There's no generic join endpoint. For activity discussions, use joinActivityDiscussion().
+   * For other discussion types, you may need to use invite mechanisms.
+   * This method attempts to fetch the discussion to check if user needs to join.
+   */
     async joinDiscussion(discussionId) {
         // Try to fetch messages to check if already a member
         try {
@@ -329,27 +338,27 @@ class HailerApiClient {
         }
     }
     /**
-     * Fetch workspace initialization data - uses Socket API
-     * @param include - What to include: 'users', 'network', 'networks', 'teams', etc.
-     */
+   * Fetch workspace initialization data - uses Socket API
+   * @param include - What to include: 'users', 'network', 'networks', 'teams', etc.
+   */
     async fetchInit(include = ['users', 'network']) {
-        return await this.request('v2.core.init', [include]);
+        return this.request('v2.core.init', [include]);
     }
     /**
-     * Update current user's profile info (firstname, lastname, etc.)
-     * Only works for the currently authenticated user
-     * @param key - Field to update: firstname, lastname, email, status, etc.
-     * @param value - New value as string
-     */
+   * Update current user's profile info (firstname, lastname, etc.)
+   * Only works for the currently authenticated user
+   * @param key - Field to update: firstname, lastname, email, status, etc.
+   * @param value - New value as string
+   */
     async setUserInfo(key, value) {
         await this.request('user.set_user_info', [key, [value]]);
         this.logger.debug('User info updated', { key, value });
     }
     /**
-     * Update current user's display name (firstname + lastname)
-     * Parses a full name into first/last parts
-     * @param fullName - Full display name like "HAL 9000"
-     */
+   * Update current user's display name (firstname + lastname)
+   * Parses a full name into first/last parts
+   * @param fullName - Full display name like "HAL 9000"
+   */
     async setUserDisplayName(fullName) {
         const parts = fullName.trim().split(/\s+/);
         const firstname = parts[0] || fullName;
@@ -361,10 +370,10 @@ class HailerApiClient {
         this.logger.debug('User display name updated', { fullName, firstname, lastname });
     }
     /**
-     * Find user by name - searches init data for firstname/lastname match
-     * @param name - Full name to search for (firstname lastname)
-     * @returns User ID if found, null otherwise
-     */
+   * Find user by name - searches init data for firstname/lastname match
+   * @param name - Full name to search for (firstname lastname)
+   * @returns User ID if found, null otherwise
+   */
     async findUserByName(name) {
         try {
             const init = await this.fetchInit(['users']);
@@ -387,9 +396,9 @@ class HailerApiClient {
         }
     }
     /**
-     * List all workflows in the workspace - extracts from init data
-     * @param workspaceId - Optional workspace ID to filter workflows (uses CID field)
-     */
+   * List all workflows in the workspace - extracts from init data
+   * @param workspaceId - Optional workspace ID to filter workflows (uses CID field)
+   */
     async listWorkflows(workspaceId) {
         // Must include 'processes' to get workflows
         const init = await this.fetchInit(['users', 'network', 'processes']);
@@ -413,8 +422,8 @@ class HailerApiClient {
         return [];
     }
     /**
-     * Get workflow details including phases and fields
-     */
+   * Get workflow details including phases and fields
+   */
     async getWorkflow(workflowId) {
         // Must include 'processes' to get workflow data
         const init = await this.fetchInit(['processes']);
@@ -429,26 +438,26 @@ class HailerApiClient {
         throw new Error(`Workflow ${workflowId} not found`);
     }
     /**
-     * Global search across workspace - uses Socket API
-     */
+   * Global search across workspace - uses Socket API
+   */
     async globalSearch(query, sections) {
         const searchOptions = { search: query };
         if (sections) {
             searchOptions.sections = sections;
         }
-        return await this.request('v2.search.global', [searchOptions]);
+        return this.request('v2.search.global', [searchOptions]);
     }
     /**
-     * Upload a file from URL or filesystem path
-     */
+   * Upload a file from URL or filesystem path
+   */
     async uploadFile(fileSpec) {
-        return await (0, file_upload_1.uploadSingleFile)(fileSpec, this.clients);
+        return (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)
-     */
+   * 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 });
@@ -456,7 +465,7 @@ class HailerApiClient {
             const response = await fetch(url, {
                 method: 'GET',
                 headers: {
-                    'hlrkey': this.clients.sessionKey,
+                    hlrkey: this.clients.sessionKey,
                 },
             });
             if (!response.ok) {
@@ -470,11 +479,12 @@ class HailerApiClient {
             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');
+            // Determine if content is text or binary. Use word-boundary checks so
+            // binary MIME types that happen to contain "xml"/"json" (e.g.
+            // application/vnd.openxmlformats-officedocument.spreadsheetml.sheet)
+            // are not misclassified as text.
+            const isText = /^text\//.test(contentType) ||
+                /^application\/(json|xml|xhtml\+xml|javascript|ld\+json)\b/.test(contentType);
             const buffer = await response.arrayBuffer();
             const size = buffer.byteLength;
             let content;
@@ -511,14 +521,14 @@ class HailerApiClient {
         }
     }
     /**
-     * Helper method to create MCP tool responses
-     */
+   * Helper method to create MCP tool responses
+   */
     createMcpResponse(data, operation, summary) {
         return (0, api_errors_1.createSuccessResponse)(data, operation, summary);
     }
     /**
-     * Helper method to create MCP error responses
-     */
+   * Helper method to create MCP error responses
+   */
     createMcpError(error, operation) {
         return (0, api_errors_1.createErrorResponse)(error, operation);
     }