motionmcp 1.0.1 → 2.0.0

package/dist/utils/responseFormatters.js

@@ -0,0 +1,331 @@
+"use strict";
+/**
+ * Response Formatting Utilities - MCP response formatting helpers
+ *
+ * This module provides utilities to format various types of responses
+ * consistently across all MCP handlers, reducing duplication and ensuring
+ * uniform response structures.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatListResponse = formatListResponse;
+exports.formatProjectList = formatProjectList;
+exports.formatTaskList = formatTaskList;
+exports.formatWorkspaceList = formatWorkspaceList;
+exports.formatDetailResponse = formatDetailResponse;
+exports.formatTaskDetail = formatTaskDetail;
+exports.formatSearchResults = formatSearchResults;
+exports.formatCommentList = formatCommentList;
+exports.formatCommentDetail = formatCommentDetail;
+exports.formatCustomFieldList = formatCustomFieldList;
+exports.formatCustomFieldDetail = formatCustomFieldDetail;
+exports.formatCustomFieldSuccess = formatCustomFieldSuccess;
+exports.formatRecurringTaskList = formatRecurringTaskList;
+exports.formatRecurringTaskDetail = formatRecurringTaskDetail;
+exports.formatScheduleList = formatScheduleList;
+exports.formatStatusList = formatStatusList;
+const errorHandling_1 = require("./errorHandling");
+const constants_1 = require("./constants");
+/**
+ * Format a list of items for MCP response
+ */
+function formatListResponse(items, title, formatter) {
+    if (!Array.isArray(items)) {
+        throw new Error('Items must be an array');
+    }
+    const list = items.map(formatter).join('\n');
+    const responseText = `${title}:\n${list}`;
+    return (0, errorHandling_1.formatMcpSuccess)(responseText);
+}
+/**
+ * Format project list response with workspace context
+ */
+function formatProjectList(projects, workspaceName, workspaceId = null, options = {}) {
+    const { includeWorkspaceNote = false, showIds = true } = options;
+    const projectFormatter = (project) => {
+        if (showIds) {
+            // For cross-workspace listings, show workspace info too
+            if (workspaceName === 'All Workspaces' && project.workspaceId) {
+                return `- ${project.name} (ID: ${project.id}) [Workspace: ${project.workspaceId}]`;
+            }
+            return `- ${project.name} (ID: ${project.id})`;
+        }
+        return `- ${project.name}`;
+    };
+    let responseText = `Found ${projects.length} ${projects.length === 1 ? 'project' : 'projects'} in workspace "${workspaceName}"`;
+    if (workspaceId) {
+        responseText += ` (ID: ${workspaceId})`;
+    }
+    if (projects.length > 0) {
+        const projectList = projects.map(projectFormatter).join('\n');
+        responseText += `:\n${projectList}`;
+    }
+    if (includeWorkspaceNote && !workspaceId) {
+        responseText += `\n\nNote: This shows projects from the default workspace. You can specify a different workspace using the workspaceId or workspaceName parameter, or use motion_workspaces (operation: list) to see all available workspaces.`;
+    }
+    return (0, errorHandling_1.formatMcpSuccess)(responseText);
+}
+/**
+ * Format task list response
+ */
+function formatTaskList(tasks, context = {}) {
+    const { workspaceName, projectName, status, limit, allWorkspaces } = context;
+    const taskFormatter = (task) => {
+        let line = `- ${task.name}`;
+        if (task.id)
+            line += ` (ID: ${task.id})`;
+        if (task.status)
+            line += ` [${typeof task.status === 'string' ? task.status : task.status.name}]`;
+        if (task.priority)
+            line += ` {${task.priority}}`;
+        if (task.dueDate) {
+            const dueDate = new Date(task.dueDate).toLocaleDateString();
+            line += ` (Due: ${dueDate})`;
+        }
+        return line;
+    };
+    let title = `Found ${tasks.length} ${tasks.length === 1 ? 'task' : 'tasks'}`;
+    if (allWorkspaces) {
+        title += ` across all workspaces`;
+    }
+    else {
+        if (workspaceName)
+            title += ` in workspace "${workspaceName}"`;
+    }
+    if (projectName)
+        title += ` in project "${projectName}"`;
+    if (status)
+        title += ` with status "${status}"`;
+    if (limit)
+        title += ` (limit: ${limit})`;
+    return formatListResponse(tasks, title, taskFormatter);
+}
+/**
+ * Format workspace list response
+ */
+function formatWorkspaceList(workspaces) {
+    const workspaceFormatter = (workspace) => {
+        let line = `- ${workspace.name} (ID: ${workspace.id})`;
+        if (workspace.type)
+            line += ` [${workspace.type}]`;
+        return line;
+    };
+    return formatListResponse(workspaces, `Available workspaces (${workspaces.length})`, workspaceFormatter);
+}
+/**
+ * Format detailed item response (project, task, etc.)
+ */
+function formatDetailResponse(item, itemType, fields = []) {
+    let responseText = `${itemType} Details:\n`;
+    fields.forEach(field => {
+        const value = item[field];
+        const fieldStr = String(field);
+        const displayName = fieldStr.charAt(0).toUpperCase() + fieldStr.slice(1);
+        const displayValue = value ?? 'N/A';
+        responseText += `- ${displayName}: ${displayValue}\n`;
+    });
+    return (0, errorHandling_1.formatMcpSuccess)(responseText);
+}
+/**
+ * Format single task detail response with comprehensive information
+ */
+function formatTaskDetail(task) {
+    const details = [
+        `Task: ${task.name}`,
+        `ID: ${task.id}`,
+        task.description ? `Description: ${task.description}` : null,
+        `Status: ${typeof task.status === 'string' ? task.status : task.status?.name || 'Unknown'}`,
+        `Priority: ${task.priority || 'Not set'}`,
+        `Completed: ${task.completed ? 'Yes' : 'No'}`,
+        task.dueDate ? `Due Date: ${new Date(task.dueDate).toLocaleString()}` : 'Due Date: Not set',
+        task.createdTime ? `Created: ${new Date(task.createdTime).toLocaleString()}` : null,
+        task.updatedTime ? `Last Updated: ${new Date(task.updatedTime).toLocaleString()}` : null,
+        task.completedTime ? `Completed: ${new Date(task.completedTime).toLocaleString()}` : null,
+        `Workspace: ${task.workspace?.name || 'Unknown'} (${task.workspace?.id || 'N/A'})`,
+        task.project ? `Project: ${task.project.name} (${task.project.id})` : 'Project: No project assigned',
+        task.assignees && task.assignees.length > 0
+            ? `Assignees: ${task.assignees.map(a => `${a.name} (${a.email})`).join(', ')}`
+            : 'Assignees: None',
+        task.creator ? `Creator: ${task.creator.name} (${task.creator.email})` : null,
+        (task.labels && task.labels.length > 0)
+            ? `Labels: ${task.labels.map(l => typeof l === 'string' ? l : l.name).join(', ')}`
+            : null,
+        task.duration ? `Duration: ${typeof task.duration === 'number' ? `${task.duration} minutes` : task.duration}` : null,
+        task.deadlineType ? `Deadline Type: ${task.deadlineType}` : null,
+        task.scheduledStart ? `Scheduled Start: ${new Date(task.scheduledStart).toLocaleString()}` : null,
+        task.scheduledEnd ? `Scheduled End: ${new Date(task.scheduledEnd).toLocaleString()}` : null,
+        task.parentRecurringTaskId ? `Recurring Task ID: ${task.parentRecurringTaskId}` : null,
+        task.chunks && task.chunks.length > 0
+            ? `Scheduled Chunks: ${task.chunks.length} time block(s)`
+            : null
+    ].filter(Boolean).join('\n');
+    return (0, errorHandling_1.formatMcpSuccess)(details);
+}
+/**
+ * Format search results response
+ */
+function formatSearchResults(results, query, options = {}) {
+    const { limit, searchScope } = options;
+    const resultFormatter = (result) => {
+        const type = result.projectId ? "task" : "project";
+        return `- [${type}] ${result.name} (ID: ${result.id})`;
+    };
+    let title = `Search Results for "${query}"`;
+    if (limit)
+        title += ` (Limit: ${limit})`;
+    if (searchScope)
+        title += ` (Scope: ${searchScope})`;
+    return formatListResponse(results, title, resultFormatter);
+}
+/**
+ * Format comments list response
+ */
+function formatCommentList(comments) {
+    if (comments.length === 0) {
+        return (0, errorHandling_1.formatMcpSuccess)("No comments found.");
+    }
+    const commentFormatter = (comment) => {
+        const location = `Task ${comment.taskId}`;
+        const timestamp = comment.createdAt;
+        const author = comment.creator.name || comment.creator.email || comment.creator.id;
+        // Truncate long comments for display
+        const displayContent = comment.content.length > constants_1.LIMITS.COMMENT_DISPLAY_LENGTH
+            ? comment.content.substring(0, constants_1.LIMITS.COMMENT_DISPLAY_LENGTH) + '...'
+            : comment.content;
+        // Keep as single line for proper list formatting
+        return `- [${comment.id}] ${location} | Author: ${author} | ${timestamp} | "${displayContent}"`;
+    };
+    return formatListResponse(comments, `Found ${comments.length} comment${comments.length === 1 ? '' : 's'}`, commentFormatter);
+}
+/**
+ * Format single comment response
+ */
+function formatCommentDetail(comment) {
+    const location = `Task ${comment.taskId}`;
+    const timestamp = comment.createdAt;
+    const author = comment.creator.name || comment.creator.email || comment.creator.id;
+    const details = [
+        `Comment created successfully:`,
+        `- ID: ${comment.id}`,
+        `- Location: ${location}`,
+        `- Author: ${author}`,
+        `- Created: ${timestamp}`,
+        `- Content: "${comment.content}"`
+    ].join('\n');
+    return (0, errorHandling_1.formatMcpSuccess)(details);
+}
+/**
+ * Format custom field list response
+ */
+function formatCustomFieldList(fields) {
+    if (fields.length === 0) {
+        return (0, errorHandling_1.formatMcpSuccess)("No custom fields found.");
+    }
+    const fieldFormatter = (field) => {
+        return `- ID: ${field.id} [Type: ${field.field}]`;
+    };
+    return formatListResponse(fields, `Found ${fields.length} custom field${fields.length === 1 ? '' : 's'}`, fieldFormatter);
+}
+/**
+ * Format single custom field response
+ */
+function formatCustomFieldDetail(field) {
+    const details = [
+        `Custom field created successfully:`,
+        `- ID: ${field.id}`,
+        `- Type: ${field.field}`
+    ].join('\n');
+    return (0, errorHandling_1.formatMcpSuccess)(details);
+}
+/**
+ * Format success message for custom field operations
+ */
+function formatCustomFieldSuccess(operation, entityType, entityId) {
+    let message = `Custom field ${operation} successfully`;
+    if (entityType && entityId) {
+        message += ` for ${entityType} ${entityId}`;
+    }
+    return (0, errorHandling_1.formatMcpSuccess)(message);
+}
+/**
+ * Format recurring task list response
+ */
+function formatRecurringTaskList(tasks) {
+    if (tasks.length === 0) {
+        return (0, errorHandling_1.formatMcpSuccess)("No recurring tasks found.");
+    }
+    const taskFormatter = (task) => {
+        const projectName = task.project?.name ?? 'No Project';
+        return `- ${task.name} (ID: ${task.id}) [${task.priority}] (Project: ${projectName})`;
+    };
+    return formatListResponse(tasks, `Found ${tasks.length} recurring task${tasks.length === 1 ? '' : 's'}`, taskFormatter);
+}
+/**
+ * Format single recurring task response
+ */
+function formatRecurringTaskDetail(task) {
+    const details = [
+        `Recurring task created successfully:`,
+        `- ID: ${task.id}`,
+        `- Name: ${task.name}`,
+        `- Priority: ${task.priority}`,
+        `- Creator: ${task.creator.name} (${task.creator.email})`,
+        `- Workspace: ${task.workspace.name} (${task.workspace.id})`,
+        task.project ? `- Project: ${task.project.name} (${task.project.id})` : `- Project: No project assigned`,
+        task.assignee ? `- Assignee: ${task.assignee.name} (${task.assignee.email})` : null,
+        `- Status: ${typeof task.status === 'string' ? task.status : task.status?.name || 'Unknown'}`,
+        (task.labels && task.labels.length > 0) ? `- Labels: ${task.labels.map(l => typeof l === 'string' ? l : l.name).join(', ')}` : null
+    ].filter(Boolean).join('\n');
+    return (0, errorHandling_1.formatMcpSuccess)(details);
+}
+/**
+ * Format schedule list response
+ */
+function formatScheduleList(schedules) {
+    // Add null safety check for the array itself
+    if (!schedules || !Array.isArray(schedules) || schedules.length === 0) {
+        return (0, errorHandling_1.formatMcpSuccess)("No schedules found.");
+    }
+    const scheduleFormatter = (schedule) => {
+        // Defensive programming for nested schedule object
+        if (!schedule) {
+            return '- Invalid schedule entry';
+        }
+        const name = schedule.name || 'Unnamed';
+        const timezone = schedule.timezone || 'Unknown timezone';
+        // Count working days if schedule details are available
+        let workingDays = '';
+        if (schedule.schedule && typeof schedule.schedule === 'object') {
+            const days = ['monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday', 'sunday'];
+            const activeDays = days.filter(day => Array.isArray(schedule.schedule[day]) &&
+                schedule.schedule[day].length > 0);
+            workingDays = activeDays.length > 0
+                ? ` | Working days: ${activeDays.length}/7`
+                : ' | No working hours defined';
+        }
+        else {
+            workingDays = ' | Schedule details unavailable';
+        }
+        return `- ${name} (${timezone})${workingDays}`;
+    };
+    return formatListResponse(schedules, `Found ${schedules.length} schedule${schedules.length === 1 ? '' : 's'}`, scheduleFormatter);
+}
+function formatStatusList(statuses) {
+    const statusFormatter = (status) => {
+        // Defensive programming for status object
+        if (!status) {
+            return '- Invalid status entry';
+        }
+        const name = status.name || 'Unnamed';
+        const flags = [];
+        if (status.isDefaultStatus) {
+            flags.push('Default');
+        }
+        if (status.isResolvedStatus) {
+            flags.push('Resolved');
+        }
+        const flagsStr = flags.length > 0 ? ` [${flags.join(', ')}]` : '';
+        return `- ${name}${flagsStr}`;
+    };
+    return formatListResponse(statuses, `Found ${statuses.length} status${statuses.length === 1 ? '' : 'es'}`, statusFormatter);
+}
+//# sourceMappingURL=responseFormatters.js.map

package/dist/utils/responseFormatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseFormatters.js","sourceRoot":"","sources":["../../src/utils/responseFormatters.ts"],"names":[],"mappings":"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"}

package/dist/utils/responseWrapper.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Motion API Response Wrapper Utility
+ *
+ * Handles the inconsistent response patterns across Motion API endpoints:
+ * - Some return wrapped responses: { meta: {...}, [resource]: [...] }
+ * - Others return direct arrays: [...]
+ *
+ * This utility provides type-safe unwrapping with proper pagination support.
+ */
+import { MotionPaginationMeta } from '../types/motion';
+/**
+ * Standard unwrapped response structure for consistent internal handling
+ */
+export interface UnwrappedResponse<T> {
+    data: T[];
+    meta?: MotionPaginationMeta;
+}
+/**
+ * Unwraps a Motion API response based on the known patterns
+ *
+ * @param response - The raw API response data
+ * @param apiEndpoint - The API endpoint name (e.g., 'tasks', 'projects', 'comments')
+ * @returns Standardized unwrapped response with data array and optional meta
+ */
+export declare function unwrapApiResponse<T = unknown>(response: unknown, apiEndpoint: string): UnwrappedResponse<T>;
+/**
+ * Checks if an API endpoint supports pagination based on known patterns
+ */
+export declare function supportsPagination(apiEndpoint: string): boolean;
+/**
+ * Gets the expected resource key for a wrapped API response
+ */
+export declare function getResourceKey(apiEndpoint: string): string | undefined;
+/**
+ * Updates the known pattern for an API endpoint (for runtime discovery)
+ */
+export declare function updateApiPattern(apiEndpoint: string, isWrapped: boolean, resourceKey?: string): void;
+//# sourceMappingURL=responseWrapper.d.ts.map

package/dist/utils/responseWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseWrapper.d.ts","sourceRoot":"","sources":["../../src/utils/responseWrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAIvD;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC7B;AA6DD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,QAAQ,EAAE,OAAO,EACjB,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAAC,CAAC,CAAC,CAiBtB;AAyGD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,OAAO,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAYN"}

package/dist/utils/responseWrapper.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * Motion API Response Wrapper Utility
+ *
+ * Handles the inconsistent response patterns across Motion API endpoints:
+ * - Some return wrapped responses: { meta: {...}, [resource]: [...] }
+ * - Others return direct arrays: [...]
+ *
+ * This utility provides type-safe unwrapping with proper pagination support.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unwrapApiResponse = unwrapApiResponse;
+exports.supportsPagination = supportsPagination;
+exports.getResourceKey = getResourceKey;
+exports.updateApiPattern = updateApiPattern;
+const logger_1 = require("./logger");
+const constants_1 = require("./constants");
+/**
+ * Known API response patterns based on current codebase evidence and task documentation
+ */
+const API_RESPONSE_PATTERNS = {
+    // Wrapped responses (with meta pagination)
+    tasks: {
+        isWrapped: true,
+        resourceKey: 'tasks',
+        apiName: 'Tasks'
+    },
+    projects: {
+        isWrapped: true,
+        resourceKey: 'projects',
+        apiName: 'Projects'
+    },
+    comments: {
+        isWrapped: true,
+        resourceKey: 'comments',
+        apiName: 'Comments'
+    },
+    'recurring-tasks': {
+        isWrapped: true,
+        resourceKey: 'tasks', // Note: recurring tasks API returns { meta, tasks } not { meta, recurringTasks }
+        apiName: 'Recurring Tasks'
+    },
+    'custom-fields': {
+        isWrapped: true,
+        resourceKey: 'customFields',
+        apiName: 'Custom Fields'
+    },
+    // Direct array responses (no wrapper)
+    schedules: {
+        isWrapped: false,
+        apiName: 'Schedules'
+    },
+    statuses: {
+        isWrapped: false,
+        apiName: 'Statuses'
+    },
+    workspaces: {
+        isWrapped: false,
+        apiName: 'Workspaces'
+    },
+    users: {
+        isWrapped: false, // TODO: Verify this - may be wrapped with 'users' key
+        apiName: 'Users'
+    }
+};
+/**
+ * Unwraps a Motion API response based on the known patterns
+ *
+ * @param response - The raw API response data
+ * @param apiEndpoint - The API endpoint name (e.g., 'tasks', 'projects', 'comments')
+ * @returns Standardized unwrapped response with data array and optional meta
+ */
+function unwrapApiResponse(response, apiEndpoint) {
+    const config = API_RESPONSE_PATTERNS[apiEndpoint];
+    if (!config) {
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, `Unknown API endpoint pattern: ${apiEndpoint}`, {
+            endpoint: apiEndpoint,
+            availablePatterns: Object.keys(API_RESPONSE_PATTERNS)
+        });
+        // Fallback: try to extract array from common patterns
+        return fallbackUnwrap(response, apiEndpoint);
+    }
+    if (config.isWrapped) {
+        return unwrapWrappedResponse(response, config);
+    }
+    else {
+        return unwrapDirectResponse(response, config);
+    }
+}
+/**
+ * Unwraps a wrapped response: { meta: {...}, [resourceKey]: [...] }
+ */
+function unwrapWrappedResponse(response, config) {
+    if (!response || typeof response !== 'object') {
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, `Expected wrapped response object for ${config.apiName}`, {
+            receivedType: typeof response,
+            response
+        });
+        return { data: [] };
+    }
+    const responseObj = response;
+    const resourceKey = config.resourceKey;
+    const data = responseObj[resourceKey];
+    const meta = responseObj.meta;
+    if (!Array.isArray(data)) {
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, `Expected array for ${resourceKey} in ${config.apiName} response`, {
+            resourceKey,
+            receivedType: typeof data,
+            hasMetaField: !!meta,
+            responseKeys: Object.keys(responseObj)
+        });
+        return { data: [] };
+    }
+    return {
+        data,
+        meta: meta && typeof meta === 'object' ? meta : undefined
+    };
+}
+/**
+ * Unwraps a direct array response: [...]
+ */
+function unwrapDirectResponse(response, config) {
+    if (!Array.isArray(response)) {
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, `Expected direct array response for ${config.apiName}`, {
+            receivedType: typeof response,
+            response
+        });
+        return { data: [] };
+    }
+    return { data: response };
+}
+/**
+ * Fallback unwrapping logic for unknown endpoints
+ * Attempts to handle both wrapped and direct patterns
+ */
+function fallbackUnwrap(response, apiEndpoint) {
+    // Case 1: Direct array
+    if (Array.isArray(response)) {
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, `Fallback: treating ${apiEndpoint} as direct array`, {
+            itemCount: response.length
+        });
+        return { data: response };
+    }
+    // Case 2: Wrapped response - try common resource keys
+    if (response && typeof response === 'object') {
+        const responseObj = response;
+        const possibleKeys = ['items', 'tasks', 'projects', 'comments', 'users', 'workspaces', 'schedules', 'statuses', 'customFields'];
+        for (const key of possibleKeys) {
+            if (Array.isArray(responseObj[key])) {
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, `Fallback: found array at ${key} for ${apiEndpoint}`, {
+                    key,
+                    itemCount: responseObj[key].length,
+                    hasMeta: !!responseObj.meta
+                });
+                return {
+                    data: responseObj[key],
+                    meta: responseObj.meta
+                };
+            }
+        }
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, `Fallback: no array found in object response for ${apiEndpoint}`, {
+            responseKeys: Object.keys(responseObj)
+        });
+    }
+    // Case 3: Unexpected response
+    (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.ERROR, `Fallback: unexpected response format for ${apiEndpoint}`, {
+        responseType: typeof response,
+        response
+    });
+    return { data: [] };
+}
+/**
+ * Checks if an API endpoint supports pagination based on known patterns
+ */
+function supportsPagination(apiEndpoint) {
+    const config = API_RESPONSE_PATTERNS[apiEndpoint];
+    return config?.isWrapped || false;
+}
+/**
+ * Gets the expected resource key for a wrapped API response
+ */
+function getResourceKey(apiEndpoint) {
+    const config = API_RESPONSE_PATTERNS[apiEndpoint];
+    return config?.resourceKey;
+}
+/**
+ * Updates the known pattern for an API endpoint (for runtime discovery)
+ */
+function updateApiPattern(apiEndpoint, isWrapped, resourceKey) {
+    API_RESPONSE_PATTERNS[apiEndpoint] = {
+        isWrapped,
+        resourceKey,
+        apiName: apiEndpoint
+    };
+    (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.INFO, `Updated API pattern for ${apiEndpoint}`, {
+        endpoint: apiEndpoint,
+        isWrapped,
+        resourceKey
+    });
+}
+//# sourceMappingURL=responseWrapper.js.map

package/dist/utils/responseWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseWrapper.js","sourceRoot":"","sources":["../../src/utils/responseWrapper.ts"],"names":[],"mappings":"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"}

package/dist/utils/sanitize.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Input Sanitization Utilities
+ *
+ * Provides secure sanitization functions for user-provided content
+ * to prevent injection attacks and ensure data integrity.
+ */
+/**
+ * Sanitize user-provided text content for safe storage and transmission
+ * Removes dangerous HTML tags, script content, and other potentially harmful input
+ *
+ * @param input - The user input to sanitize
+ * @returns Sanitized string safe for storage/transmission
+ */
+export declare function sanitizeTextContent(input: string | undefined | null): string;
+/**
+ * Validate that sanitized content is not empty after sanitization
+ *
+ * @param original - Original user input
+ * @param sanitized - Sanitized version
+ * @returns True if content is valid after sanitization
+ */
+export declare function isValidSanitizedContent(original: string | undefined | null, sanitized: string): boolean;
+/**
+ * Sanitize and validate comment content
+ *
+ * @param content - Comment content to sanitize
+ * @returns Object with sanitized content and validation result
+ */
+export declare function sanitizeCommentContent(content: string | undefined | null): {
+    sanitized: string;
+    isValid: boolean;
+    error?: string;
+};
+/**
+ * Sanitize task/project description content
+ * Similar to comment content but allows empty descriptions
+ *
+ * @param description - Task or project description to sanitize
+ * @returns Sanitized description or undefined if empty/invalid
+ */
+export declare function sanitizeDescription(description: string | undefined | null): string | undefined;
+/**
+ * Sanitize task/project name content
+ * Names are required and must be non-empty after sanitization
+ *
+ * @param name - Task or project name to sanitize
+ * @returns Sanitized name
+ * @throws Error if name is empty or contains invalid content
+ */
+export declare function sanitizeName(name: string | undefined | null): string;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/utils/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAiC5E;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAQvG;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAwBA;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAgB9F;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAgBpE"}