motionmcp 1.0.1 → 2.0.0

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/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"}

package/dist/utils/parameterUtils.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseWorkspaceArgs = parseWorkspaceArgs;
+exports.parseSearchArgs = parseSearchArgs;
+exports.parseTaskArgs = parseTaskArgs;
+exports.parseProjectArgs = parseProjectArgs;
+exports.setDefaults = setDefaults;
+exports.validateRequiredParams = validateRequiredParams;
+exports.validateParameterTypes = validateParameterTypes;
+exports.sanitizeStringParams = sanitizeStringParams;
+exports.parseAndValidateWorkspace = parseAndValidateWorkspace;
+const constants_1 = require("./constants");
+const errorHandling_1 = require("./errorHandling");
+const sanitize_1 = require("./sanitize");
+/**
+ * Parse workspace-related arguments from MCP request
+ */
+function parseWorkspaceArgs(args = {}) {
+    return {
+        workspaceId: args.workspaceId || undefined,
+        workspaceName: args.workspaceName ? (0, sanitize_1.sanitizeName)(args.workspaceName) : undefined
+    };
+}
+/**
+ * Parse search-related arguments from MCP request
+ */
+function parseSearchArgs(args = {}) {
+    return {
+        query: args.query ? (0, sanitize_1.sanitizeName)(args.query) : '',
+        searchScope: args.searchScope || constants_1.DEFAULTS.SEARCH_SCOPE,
+        limit: args.limit || constants_1.DEFAULTS.SEARCH_LIMIT,
+        ...parseWorkspaceArgs(args)
+    };
+}
+/**
+ * Parse autoScheduled parameter to handle various input formats
+ * @param value - The autoScheduled value from MCP request
+ * @returns Proper autoScheduled value for Motion API
+ */
+function parseAutoScheduledParam(value) {
+    // If undefined, leave as undefined (field not provided)
+    if (value === undefined) {
+        return undefined;
+    }
+    // If null, keep as null (explicitly disable auto-scheduling)
+    if (value === null) {
+        return null;
+    }
+    // If it's already an object, use it as-is
+    if (typeof value === 'object' && value !== null) {
+        return value;
+    }
+    // If it's a non-empty string, treat as schedule name
+    if (typeof value === 'string' && value.trim()) {
+        const trimmed = value.trim();
+        // If it's 'false', disable auto-scheduling
+        if (trimmed === 'false') {
+            return null;
+        }
+        // If it's 'true' or empty string, enable with no schedule (will trigger validation error)
+        if (trimmed === 'true' || trimmed === '') {
+            return {}; // Empty object enables auto-scheduling but will require schedule validation
+        }
+        // Otherwise, treat as schedule name
+        return { schedule: trimmed };
+    }
+    // If it's 'true' or true, enable auto-scheduling (will trigger validation for schedule)
+    if (value === 'true' || value === true) {
+        return {}; // Empty object enables auto-scheduling but will require schedule validation
+    }
+    // If it's 'false' or false, disable auto-scheduling
+    if (value === 'false' || value === false) {
+        return null;
+    }
+    // For any other value, treat as undefined (not provided)
+    return undefined;
+}
+/**
+ * Parse task creation/update arguments from MCP request
+ */
+function parseTaskArgs(args = {}) {
+    return {
+        name: args.name ? (0, sanitize_1.sanitizeName)(args.name) : undefined,
+        description: (0, sanitize_1.sanitizeDescription)(args.description),
+        projectId: args.projectId || undefined,
+        projectName: args.projectName ? (0, sanitize_1.sanitizeName)(args.projectName) : undefined,
+        status: args.status || undefined,
+        priority: args.priority || undefined,
+        dueDate: args.dueDate || undefined,
+        duration: args.duration !== undefined ? args.duration : undefined,
+        labels: Array.isArray(args.labels) ? args.labels : undefined,
+        assigneeId: args.assigneeId || undefined,
+        autoScheduled: parseAutoScheduledParam(args.autoScheduled),
+        ...parseWorkspaceArgs(args)
+    };
+}
+/**
+ * Parse project creation/update arguments from MCP request
+ */
+function parseProjectArgs(args = {}) {
+    return {
+        name: args.name ? (0, sanitize_1.sanitizeName)(args.name) : undefined,
+        description: (0, sanitize_1.sanitizeDescription)(args.description),
+        color: args.color || undefined,
+        status: args.status || undefined,
+        ...parseWorkspaceArgs(args)
+    };
+}
+/**
+ * Set default values for parameters
+ */
+function setDefaults(args = {}, defaults = {}) {
+    return { ...defaults, ...args };
+}
+/**
+ * Validate that required parameters are present
+ * @throws {ValidationError} If required parameters are missing
+ */
+function validateRequiredParams(args = {}, required = []) {
+    const missing = [];
+    for (const param of required) {
+        if (args[param] === null || args[param] === undefined || args[param] === '') {
+            missing.push(param);
+        }
+    }
+    if (missing.length > 0) {
+        throw new errorHandling_1.ValidationError(`Missing required parameters: ${missing.join(', ')}`, missing[0], { missing, provided: Object.keys(args) });
+    }
+}
+/**
+ * Validate parameter types
+ * @throws {ValidationError} If parameters have wrong types
+ */
+function validateParameterTypes(args = {}, types = {}) {
+    const errors = [];
+    for (const [param, expectedType] of Object.entries(types)) {
+        if (args[param] !== null && args[param] !== undefined) {
+            const actualType = typeof args[param];
+            if (actualType !== expectedType) {
+                errors.push(`${param} should be ${expectedType}, got ${actualType}`);
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new errorHandling_1.ValidationError(`Type validation failed: ${errors.join('; ')}`, null, { errors, args });
+    }
+}
+/**
+ * Sanitize string parameters (trim whitespace, handle empty strings)
+ * Following NULL_UNDEFINED_POLICY: empty strings become undefined (deleted)
+ */
+function sanitizeStringParams(args = {}, stringParams = []) {
+    const sanitized = { ...args };
+    for (const param of stringParams) {
+        const value = sanitized[param];
+        if (typeof value === 'string') {
+            const trimmed = value.trim();
+            // Delete empty strings (makes them undefined) per policy
+            if (trimmed === '') {
+                delete sanitized[param];
+            }
+            else {
+                // Type-safe assignment: we've verified it's a string at runtime
+                // and we're only processing declared string parameters
+                Object.assign(sanitized, { [param]: trimmed });
+            }
+        }
+    }
+    return sanitized;
+}
+/**
+ * Parse and validate workspace parameters with common validation
+ */
+function parseAndValidateWorkspace(args = {}, options = {}) {
+    const { requireWorkspace = false } = options;
+    const workspaceParams = parseWorkspaceArgs(args);
+    if (requireWorkspace && !workspaceParams.workspaceId && !workspaceParams.workspaceName) {
+        throw new errorHandling_1.ValidationError('Either workspaceId or workspaceName is required', 'workspace', { provided: workspaceParams });
+    }
+    return workspaceParams;
+}
+//# sourceMappingURL=parameterUtils.js.map

package/dist/utils/parameterUtils.js.map

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

package/dist/utils/responseFormatters.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 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.
+ */
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { MotionProject, MotionTask, MotionWorkspace, MotionComment, MotionCustomField, MotionRecurringTask, MotionSchedule, MotionStatus } from '../types/motion';
+/**
+ * Format a list of items for MCP response
+ */
+export declare function formatListResponse<T>(items: T[], title: string, formatter: (item: T) => string): CallToolResult;
+interface ProjectListOptions {
+    includeWorkspaceNote?: boolean;
+    showIds?: boolean;
+}
+/**
+ * Format project list response with workspace context
+ */
+export declare function formatProjectList(projects: MotionProject[], workspaceName: string, workspaceId?: string | null, options?: ProjectListOptions): CallToolResult;
+interface TaskListContext {
+    workspaceName?: string;
+    projectName?: string;
+    status?: string;
+    limit?: number;
+    allWorkspaces?: boolean;
+}
+/**
+ * Format task list response
+ */
+export declare function formatTaskList(tasks: MotionTask[], context?: TaskListContext): CallToolResult;
+/**
+ * Format workspace list response
+ */
+export declare function formatWorkspaceList(workspaces: MotionWorkspace[]): CallToolResult;
+/**
+ * Format detailed item response (project, task, etc.)
+ */
+export declare function formatDetailResponse<T extends Record<string, any>>(item: T, itemType: string, fields?: (keyof T)[]): CallToolResult;
+/**
+ * Format single task detail response with comprehensive information
+ */
+export declare function formatTaskDetail(task: MotionTask): CallToolResult;
+interface SearchOptions {
+    limit?: number;
+    searchScope?: string;
+}
+interface SearchResult {
+    id: string;
+    name: string;
+    projectId?: string;
+}
+/**
+ * Format search results response
+ */
+export declare function formatSearchResults(results: SearchResult[], query: string, options?: SearchOptions): CallToolResult;
+/**
+ * Format comments list response
+ */
+export declare function formatCommentList(comments: MotionComment[]): CallToolResult;
+/**
+ * Format single comment response
+ */
+export declare function formatCommentDetail(comment: MotionComment): CallToolResult;
+/**
+ * Format custom field list response
+ */
+export declare function formatCustomFieldList(fields: MotionCustomField[]): CallToolResult;
+/**
+ * Format single custom field response
+ */
+export declare function formatCustomFieldDetail(field: MotionCustomField): CallToolResult;
+/**
+ * Format success message for custom field operations
+ */
+export declare function formatCustomFieldSuccess(operation: string, entityType?: string, entityId?: string): CallToolResult;
+/**
+ * Format recurring task list response
+ */
+export declare function formatRecurringTaskList(tasks: MotionRecurringTask[]): CallToolResult;
+/**
+ * Format single recurring task response
+ */
+export declare function formatRecurringTaskDetail(task: MotionRecurringTask): CallToolResult;
+/**
+ * Format schedule list response
+ */
+export declare function formatScheduleList(schedules: MotionSchedule[]): CallToolResult;
+export declare function formatStatusList(statuses: MotionStatus[]): CallToolResult;
+export {};
+//# sourceMappingURL=responseFormatters.d.ts.map

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

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