motionmcp 1.0.2 → 2.1.0

package/dist/utils/logger.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Centralized MCP-compliant logger
+ * Outputs structured JSON logs to stderr as required by MCP protocol
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcpLog = void 0;
+const SENSITIVE_FIELDS = ['apiKey', 'password', 'token', 'secret', 'authorization'];
+/**
+ * Sanitizes sensitive information from log data
+ */
+function sanitizeLogData(data) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(data)) {
+        // Check if key contains sensitive field names
+        if (SENSITIVE_FIELDS.some(field => key.toLowerCase().includes(field))) {
+            sanitized[key] = '[REDACTED]';
+        }
+        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            // Recursively sanitize nested objects
+            sanitized[key] = sanitizeLogData(value);
+        }
+        else {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+/**
+ * MCP-compliant logger that outputs to stderr in JSON format
+ * @param level - Log level (ERROR, WARN, INFO, DEBUG)
+ * @param message - Log message
+ * @param extra - Additional context data
+ */
+const mcpLog = (level, message, extra = {}) => {
+    const sanitizedExtra = sanitizeLogData(extra);
+    const logEntry = {
+        level,
+        msg: message,
+        time: new Date().toISOString(),
+        ...sanitizedExtra
+    };
+    // MCP servers should log to stderr in JSON format
+    console.error(JSON.stringify(logEntry));
+};
+exports.mcpLog = mcpLog;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;AAEpF;;GAEG;AACH,SAAS,eAAe,CAAC,IAAyB;IAChD,MAAM,SAAS,GAAwB,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,8CAA8C;QAC9C,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACtE,SAAS,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;QAChC,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChF,sCAAsC;YACtC,SAAS,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACI,MAAM,MAAM,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,QAA6B,EAAE,EAAQ,EAAE;IAChG,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAE9C,MAAM,QAAQ,GAAG;QACf,KAAK;QACL,GAAG,EAAE,OAAO;QACZ,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC9B,GAAG,cAAc;KAClB,CAAC;IAEF,kDAAkD;IAClD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC;AAZW,QAAA,MAAM,UAYjB"}

package/dist/utils/pagination.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Pagination Utilities - Shared pagination logic for Motion API calls
+ *
+ * Provides utilities to handle cursor-based and offset-based pagination
+ * consistently across all API endpoints.
+ */
+import { AxiosResponse } from 'axios';
+export interface PaginatedResponse<T> {
+    items: T[];
+    nextCursor?: string;
+    hasMore: boolean;
+    totalFetched: number;
+}
+export interface PaginationMeta {
+    nextCursor?: string;
+    hasMore?: boolean;
+    total?: number;
+    page?: number;
+    limit?: number;
+}
+export interface CursorPaginationOptions {
+    maxPages?: number;
+    pageSize?: number;
+    logProgress?: boolean;
+}
+export interface PaginatedApiResponse<T> {
+    meta?: PaginationMeta;
+    items?: T[];
+    tasks?: T[];
+    projects?: T[];
+    users?: T[];
+    comments?: T[];
+    customFields?: T[];
+    recurringTasks?: T[];
+    schedules?: T[];
+    statuses?: T[];
+}
+/**
+ * Generic cursor-based pagination handler
+ * Automatically fetches all pages or up to maxPages limit
+ */
+export declare function fetchAllPages<T>(fetchPage: (cursor?: string) => Promise<AxiosResponse<PaginatedApiResponse<T>>>, options?: CursorPaginationOptions): Promise<PaginatedResponse<T>>;
+/**
+ * Simple pagination for APIs that might not have explicit pagination
+ * but could benefit from batching large requests
+ */
+export interface BatchOptions {
+    batchSize?: number;
+    maxBatches?: number;
+    delayMs?: number;
+}
+export declare function fetchInBatches<T, TParams>(fetchBatch: (params: TParams, offset: number, limit: number) => Promise<T[]>, params: TParams, options?: BatchOptions): Promise<T[]>;
+/**
+ * Check if a response indicates more pages are available
+ */
+export declare function hasMorePages<T>(response: PaginatedApiResponse<T>): boolean;
+/**
+ * Get pagination info from response
+ */
+export declare function getPaginationInfo<T>(response: PaginatedApiResponse<T>): PaginationMeta | null;
+//# sourceMappingURL=pagination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAItC,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,EAC/E,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAqF/B;AAyBD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,cAAc,CAAC,CAAC,EAAE,OAAO,EAC7C,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,EAC5E,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,EAAE,CAAC,CAuCd;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,OAAO,CAE1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,cAAc,GAAG,IAAI,CAE7F"}

package/dist/utils/pagination.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Pagination Utilities - Shared pagination logic for Motion API calls
+ *
+ * Provides utilities to handle cursor-based and offset-based pagination
+ * consistently across all API endpoints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchAllPages = fetchAllPages;
+exports.fetchInBatches = fetchInBatches;
+exports.hasMorePages = hasMorePages;
+exports.getPaginationInfo = getPaginationInfo;
+const logger_1 = require("./logger");
+const constants_1 = require("./constants");
+/**
+ * Generic cursor-based pagination handler
+ * Automatically fetches all pages or up to maxPages limit
+ */
+async function fetchAllPages(fetchPage, options = {}) {
+    const { maxPages = 10, logProgress = true } = options;
+    let allItems = [];
+    let cursor;
+    let pageCount = 0;
+    let hasMore = true;
+    // Infinite loop protection - ensure we never fetch more than absolute max pages
+    const absoluteMaxPages = Math.min(maxPages, 50); // Hard limit to prevent infinite loops
+    while (hasMore && pageCount < absoluteMaxPages) {
+        try {
+            if (logProgress && pageCount > 0) {
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, `Fetching page ${pageCount + 1}`, { cursor });
+            }
+            const response = await fetchPage(cursor);
+            const data = response.data;
+            // Extract items from various possible response structures
+            const pageItems = extractItemsFromResponse(data);
+            // Enforce page size limit to prevent memory exhaustion
+            if (pageItems.length > constants_1.LIMITS.MAX_PAGE_SIZE) {
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, `Page size ${pageItems.length} exceeds maximum allowed ${constants_1.LIMITS.MAX_PAGE_SIZE}, truncating`, {
+                    pageNumber: pageCount + 1,
+                    originalSize: pageItems.length,
+                    truncatedSize: constants_1.LIMITS.MAX_PAGE_SIZE
+                });
+                pageItems.splice(constants_1.LIMITS.MAX_PAGE_SIZE); // Truncate to limit
+            }
+            allItems = allItems.concat(pageItems);
+            // Update pagination state
+            const newCursor = data.meta?.nextCursor;
+            // Infinite loop protection: If cursor doesn't change, break
+            if (cursor && newCursor === cursor) {
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, 'Pagination cursor not advancing - breaking to prevent infinite loop', {
+                    cursor,
+                    pageCount,
+                    itemsCount: pageItems.length
+                });
+                break;
+            }
+            cursor = newCursor;
+            hasMore = !!cursor && pageItems.length > 0;
+            pageCount++;
+            if (logProgress) {
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, `Page ${pageCount} fetched`, {
+                    pageItems: pageItems.length,
+                    totalItems: allItems.length,
+                    hasMore,
+                    nextCursor: cursor
+                });
+            }
+        }
+        catch (error) {
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.ERROR, `Pagination failed on page ${pageCount + 1}`, {
+                error: error instanceof Error ? error.message : String(error),
+                cursor
+            });
+            // Return what we have so far
+            break;
+        }
+    }
+    if (pageCount >= absoluteMaxPages && hasMore) {
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, `Reached maximum page limit (${absoluteMaxPages})`, {
+            totalFetched: allItems.length,
+            finalCursor: cursor
+        });
+    }
+    return {
+        items: allItems,
+        nextCursor: cursor,
+        hasMore,
+        totalFetched: allItems.length
+    };
+}
+/**
+ * Extract items from various API response structures
+ * Handles the different ways Motion API can structure responses
+ */
+function extractItemsFromResponse(data) {
+    // Try different possible array locations
+    if (data.tasks && Array.isArray(data.tasks))
+        return data.tasks;
+    if (data.projects && Array.isArray(data.projects))
+        return data.projects;
+    if (data.users && Array.isArray(data.users))
+        return data.users;
+    if (data.comments && Array.isArray(data.comments))
+        return data.comments;
+    if (data.customFields && Array.isArray(data.customFields))
+        return data.customFields;
+    if (data.recurringTasks && Array.isArray(data.recurringTasks))
+        return data.recurringTasks;
+    if (data.schedules && Array.isArray(data.schedules))
+        return data.schedules;
+    if (data.statuses && Array.isArray(data.statuses))
+        return data.statuses;
+    if (data.items && Array.isArray(data.items))
+        return data.items;
+    // Fallback: if data itself is an array
+    if (Array.isArray(data))
+        return data;
+    // No items found
+    return [];
+}
+async function fetchInBatches(fetchBatch, params, options = {}) {
+    const { batchSize = 100, maxBatches = 10, delayMs = 100 } = options;
+    let allItems = [];
+    let offset = 0;
+    let batchCount = 0;
+    let hasMore = true;
+    while (hasMore && batchCount < maxBatches) {
+        try {
+            const batchItems = await fetchBatch(params, offset, batchSize);
+            if (batchItems.length === 0) {
+                hasMore = false;
+            }
+            else {
+                allItems = allItems.concat(batchItems);
+                offset += batchSize;
+                batchCount++;
+                // Small delay to be API-friendly
+                if (delayMs > 0 && hasMore) {
+                    await new Promise(resolve => setTimeout(resolve, delayMs));
+                }
+                // If we got fewer items than batch size, we've reached the end
+                if (batchItems.length < batchSize) {
+                    hasMore = false;
+                }
+            }
+        }
+        catch (error) {
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.ERROR, `Batch fetch failed at offset ${offset}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            break;
+        }
+    }
+    return allItems;
+}
+/**
+ * Check if a response indicates more pages are available
+ */
+function hasMorePages(response) {
+    return !!(response.meta?.nextCursor || response.meta?.hasMore);
+}
+/**
+ * Get pagination info from response
+ */
+function getPaginationInfo(response) {
+    return response.meta || null;
+}
+//# sourceMappingURL=pagination.js.map

package/dist/utils/pagination.js.map

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

package/dist/utils/paginationNew.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Enhanced Pagination Utilities with Proper Response Wrapper Support
+ *
+ * This replaces the old pagination utility with proper handling of Motion API's
+ * inconsistent response patterns using the ResponseWrapper utility.
+ */
+import { AxiosResponse } from 'axios';
+import { UnwrappedResponse } from './responseWrapper';
+export interface PaginatedResponse<T> {
+    items: T[];
+    nextCursor?: string;
+    hasMore: boolean;
+    totalFetched: number;
+}
+export interface CursorPaginationOptions {
+    maxPages?: number;
+    pageSize?: number;
+    logProgress?: boolean;
+    maxItems?: number;
+}
+/**
+ * Enhanced pagination handler that properly uses response wrapper
+ *
+ * @param fetchPage - Function that fetches a single page of data
+ * @param apiEndpoint - The API endpoint name for proper response unwrapping
+ * @param options - Pagination options
+ * @returns All items from all pages with pagination metadata
+ */
+export declare function fetchAllPages<T>(fetchPage: (cursor?: string) => Promise<AxiosResponse<any>>, apiEndpoint: string, options?: CursorPaginationOptions): Promise<PaginatedResponse<T>>;
+/**
+ * Fetches a single page with proper response unwrapping
+ *
+ * @param fetchPage - Function that fetches a single page
+ * @param apiEndpoint - The API endpoint name for proper response unwrapping
+ * @param cursor - Optional cursor for the specific page
+ * @returns Single page of data with pagination metadata
+ */
+export declare function fetchSinglePage<T>(fetchPage: (cursor?: string) => Promise<AxiosResponse<any>>, apiEndpoint: string, cursor?: string): Promise<UnwrappedResponse<T>>;
+/**
+ * Check if an endpoint supports pagination
+ */
+export declare function endpointSupportsPagination(apiEndpoint: string): boolean;
+export { UnwrappedResponse } from './responseWrapper';
+//# sourceMappingURL=paginationNew.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paginationNew.d.ts","sourceRoot":"","sources":["../../src/utils/paginationNew.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC,OAAO,EAAyC,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG7F,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAC3D,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAuH/B;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAC3D,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAG/B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEvE;AAGD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/utils/paginationNew.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Enhanced Pagination Utilities with Proper Response Wrapper Support
+ *
+ * This replaces the old pagination utility with proper handling of Motion API's
+ * inconsistent response patterns using the ResponseWrapper utility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchAllPages = fetchAllPages;
+exports.fetchSinglePage = fetchSinglePage;
+exports.endpointSupportsPagination = endpointSupportsPagination;
+const logger_1 = require("./logger");
+const constants_1 = require("./constants");
+const responseWrapper_1 = require("./responseWrapper");
+/**
+ * Enhanced pagination handler that properly uses response wrapper
+ *
+ * @param fetchPage - Function that fetches a single page of data
+ * @param apiEndpoint - The API endpoint name for proper response unwrapping
+ * @param options - Pagination options
+ * @returns All items from all pages with pagination metadata
+ */
+async function fetchAllPages(fetchPage, apiEndpoint, options = {}) {
+    const { maxPages = constants_1.LIMITS.MAX_PAGES, logProgress = true, maxItems = constants_1.LIMITS.MAX_PAGE_SIZE * 10 } = options;
+    let allItems = [];
+    let cursor;
+    let pageCount = 0;
+    let hasMore = true;
+    // Infinite loop protection - ensure we never fetch more than absolute max pages
+    const absoluteMaxPages = Math.min(maxPages, constants_1.LIMITS.ABSOLUTE_MAX_PAGES); // Hard limit to prevent infinite loops
+    while (hasMore && pageCount < absoluteMaxPages) {
+        try {
+            if (logProgress && pageCount > 0) {
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, `Fetching page ${pageCount + 1} for ${apiEndpoint}`, {
+                    cursor,
+                    pageCount,
+                    itemsSoFar: allItems.length
+                });
+            }
+            const response = await fetchPage(cursor);
+            const unwrapped = (0, responseWrapper_1.unwrapApiResponse)(response.data, apiEndpoint);
+            // Enforce page size limit to prevent memory exhaustion
+            if (unwrapped.data.length > constants_1.LIMITS.MAX_PAGE_SIZE) {
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, `Page size ${unwrapped.data.length} exceeds maximum allowed ${constants_1.LIMITS.MAX_PAGE_SIZE}, truncating`, {
+                    pageNumber: pageCount + 1,
+                    endpoint: apiEndpoint,
+                    originalSize: unwrapped.data.length,
+                    truncatedSize: constants_1.LIMITS.MAX_PAGE_SIZE
+                });
+                unwrapped.data = unwrapped.data.slice(0, constants_1.LIMITS.MAX_PAGE_SIZE);
+            }
+            // Add items to our collection, but check memory limits first
+            const itemsToAdd = unwrapped.data;
+            if (allItems.length + itemsToAdd.length > maxItems) {
+                // Limit reached - add only what fits
+                const remainingSlots = maxItems - allItems.length;
+                if (remainingSlots > 0) {
+                    allItems.push(...itemsToAdd.slice(0, remainingSlots));
+                }
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, `Memory limit reached for ${apiEndpoint}, stopping pagination`, {
+                    totalItems: allItems.length,
+                    maxItems,
+                    pageCount: pageCount + 1,
+                    endpoint: apiEndpoint
+                });
+                hasMore = false;
+            }
+            else {
+                allItems.push(...itemsToAdd);
+            }
+            pageCount++;
+            // Determine if there are more pages
+            if (unwrapped.meta?.nextCursor) {
+                const newCursor = unwrapped.meta.nextCursor;
+                // Additional safety: detect cursor not advancing (API bug protection)
+                if (pageCount > 1 && cursor === newCursor) {
+                    (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, `Cursor not advancing for ${apiEndpoint}, stopping pagination`, {
+                        oldCursor: cursor,
+                        newCursor,
+                        pageCount,
+                        endpoint: apiEndpoint
+                    });
+                    hasMore = false;
+                }
+                else {
+                    cursor = newCursor;
+                }
+            }
+            else {
+                hasMore = false;
+            }
+            // If we got no items on this page, stop
+            if (unwrapped.data.length === 0) {
+                hasMore = false;
+            }
+            if (logProgress) {
+                (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.DEBUG, `Page ${pageCount} fetched for ${apiEndpoint}`, {
+                    pageItems: unwrapped.data.length,
+                    totalItems: allItems.length,
+                    hasMore,
+                    nextCursor: cursor,
+                    endpoint: apiEndpoint
+                });
+            }
+        }
+        catch (error) {
+            (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.ERROR, `Failed to fetch page ${pageCount + 1} for ${apiEndpoint}`, {
+                error: error instanceof Error ? error.message : String(error),
+                pageCount,
+                cursor,
+                endpoint: apiEndpoint
+            });
+            // Don't completely fail - return what we have so far
+            hasMore = false;
+        }
+    }
+    if (pageCount >= absoluteMaxPages && hasMore) {
+        (0, logger_1.mcpLog)(constants_1.LOG_LEVELS.WARN, `Reached maximum page limit for ${apiEndpoint}`, {
+            maxPages: absoluteMaxPages,
+            totalItems: allItems.length,
+            endpoint: apiEndpoint
+        });
+    }
+    return {
+        items: allItems,
+        nextCursor: cursor,
+        hasMore: hasMore && pageCount < absoluteMaxPages,
+        totalFetched: allItems.length
+    };
+}
+/**
+ * Fetches a single page with proper response unwrapping
+ *
+ * @param fetchPage - Function that fetches a single page
+ * @param apiEndpoint - The API endpoint name for proper response unwrapping
+ * @param cursor - Optional cursor for the specific page
+ * @returns Single page of data with pagination metadata
+ */
+async function fetchSinglePage(fetchPage, apiEndpoint, cursor) {
+    const response = await fetchPage(cursor);
+    return (0, responseWrapper_1.unwrapApiResponse)(response.data, apiEndpoint);
+}
+/**
+ * Check if an endpoint supports pagination
+ */
+function endpointSupportsPagination(apiEndpoint) {
+    return (0, responseWrapper_1.supportsPagination)(apiEndpoint);
+}
+//# sourceMappingURL=paginationNew.js.map

package/dist/utils/paginationNew.js.map

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

package/dist/utils/parameterUtils.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Parameter Utilities - Parameter parsing and validation helpers
+ *
+ * This module provides utilities for parsing, validating, and setting
+ * default values for MCP handler parameters, reducing duplication and
+ * ensuring consistent parameter handling.
+ */
+interface WorkspaceArgs {
+    workspaceId?: string;
+    workspaceName?: string;
+}
+interface SearchArgs extends WorkspaceArgs {
+    query?: string;
+    searchScope?: 'both' | 'tasks' | 'projects';
+    limit?: number;
+}
+interface TaskArgs extends WorkspaceArgs {
+    name?: string;
+    description?: string;
+    projectId?: string;
+    projectName?: string;
+    status?: string;
+    priority?: 'ASAP' | 'HIGH' | 'MEDIUM' | 'LOW';
+    dueDate?: string;
+    duration?: string | number;
+    labels?: string[];
+    assigneeId?: string;
+    autoScheduled?: Record<string, unknown> | null;
+}
+interface ProjectArgs extends WorkspaceArgs {
+    name?: string;
+    description?: string;
+    color?: string;
+    status?: string;
+}
+/**
+ * Parse workspace-related arguments from MCP request
+ */
+export declare function parseWorkspaceArgs(args?: Record<string, unknown>): WorkspaceArgs;
+/**
+ * Parse search-related arguments from MCP request
+ */
+export declare function parseSearchArgs(args?: Record<string, unknown>): SearchArgs;
+/**
+ * Parse task creation/update arguments from MCP request
+ */
+export declare function parseTaskArgs(args?: Record<string, unknown>): TaskArgs;
+/**
+ * Parse project creation/update arguments from MCP request
+ */
+export declare function parseProjectArgs(args?: Record<string, unknown>): ProjectArgs;
+/**
+ * Set default values for parameters
+ */
+export declare function setDefaults<T extends object, D extends Partial<T>>(args?: T, defaults?: D): T & D;
+/**
+ * Validate that required parameters are present
+ * @throws {ValidationError} If required parameters are missing
+ */
+export declare function validateRequiredParams(args?: Record<string, unknown>, required?: string[]): void;
+/**
+ * Validate parameter types
+ * @throws {ValidationError} If parameters have wrong types
+ */
+export declare function validateParameterTypes(args?: Record<string, unknown>, types?: Record<string, string>): void;
+/**
+ * Sanitize string parameters (trim whitespace, handle empty strings)
+ * Following NULL_UNDEFINED_POLICY: empty strings become undefined (deleted)
+ */
+export declare function sanitizeStringParams<T extends Record<string, any>>(args?: T, stringParams?: (keyof T)[]): T;
+interface ValidationOptions {
+    requireWorkspace?: boolean;
+}
+/**
+ * Parse and validate workspace parameters with common validation
+ */
+export declare function parseAndValidateWorkspace(args?: Record<string, unknown>, options?: ValidationOptions): WorkspaceArgs;
+export {};
+//# sourceMappingURL=parameterUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parameterUtils.d.ts","sourceRoot":"","sources":["../../src/utils/parameterUtils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,UAAU,aAAa;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,UAAW,SAAQ,aAAa;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,QAAS,SAAQ,aAAa;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAChD;AAED,UAAU,WAAY,SAAQ,aAAa;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,aAAa,CAKpF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,UAAU,CAO9E;AAoDD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,QAAQ,CAe1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,WAAW,CAQhF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EAChE,IAAI,GAAE,CAAW,EACjB,QAAQ,GAAE,CAAW,GACpB,CAAC,GAAG,CAAC,CAEP;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,QAAQ,GAAE,MAAM,EAAO,GACtB,IAAI,CAgBN;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACjC,IAAI,CAmBN;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChE,IAAI,GAAE,CAAW,EACjB,YAAY,GAAE,CAAC,MAAM,CAAC,CAAC,EAAO,GAC7B,CAAC,CAoBH;AAED,UAAU,iBAAiB;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,OAAO,GAAE,iBAAsB,GAC9B,aAAa,CAcf"}