@griffinwork40/clickup-mcp-server 1.1.0 → 1.1.2

package/dist/utils.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared utility functions for ClickUp MCP server.
  */
-import type { ClickUpTask, ClickUpList, ClickUpSpace, ClickUpFolder, ClickUpComment, ClickUpTimeEntry, PaginationInfo, TruncationInfo } from "./types.js";
+import type { ClickUpTask, ClickUpList, ClickUpSpace, ClickUpFolder, ClickUpComment, ClickUpTimeEntry, PaginationInfo, TruncationInfo, ClickUpCustomField } from "./types.js";
 /**
  * Get ClickUp API token from environment
  */
@@ -63,6 +63,7 @@ export declare function getPagination(total: number | undefined, count: number,
 export declare function generateTaskSummary(tasks: ClickUpTask[]): string;
 /**
  * Truncate response if it exceeds character limit with smart boundary detection
+ * Detects format and uses appropriate truncation strategy
  */
 export declare function truncateResponse(content: string, itemCount: number, itemType?: string): {
     content: string;
@@ -72,4 +73,69 @@ export declare function truncateResponse(content: string, itemCount: number, ite
  * Format truncation information as text
  */
 export declare function formatTruncationInfo(truncation: TruncationInfo | null): string;
+/**
+ * Filter tasks by status names (client-side filtering)
+ */
+export declare function filterTasksByStatus(tasks: ClickUpTask[], statuses: string[]): ClickUpTask[];
+/**
+ * Options for counting tasks by status
+ */
+export interface CountTasksOptions {
+    archived?: boolean;
+    include_closed?: boolean;
+    statuses?: string[];
+}
+/**
+ * Result of counting tasks by status
+ */
+export interface CountTasksResult {
+    total: number;
+    by_status: Record<string, number>;
+}
+/**
+ * Count tasks in a list by status, handling pagination internally
+ */
+export declare function countTasksByStatus(listId: string, options?: CountTasksOptions): Promise<CountTasksResult>;
+/**
+ * Options for exporting tasks to CSV
+ */
+export interface ExportCSVOptions {
+    archived?: boolean;
+    include_closed?: boolean;
+    statuses?: string[];
+    custom_fields?: string[];
+    include_standard_fields?: boolean;
+    add_phone_number_column?: boolean;
+}
+/**
+ * Escape CSV fields to handle commas, quotes, and newlines
+ */
+export declare function escapeCSV(value: any): string;
+/**
+ * Normalize phone number to E.164 format
+ * E.164 format: ^\+?[1-9]\d{1,14}$
+ * Rules:
+ * - Optional + at the start
+ * - Must start with digit 1-9 (not 0)
+ * - Followed by 1-14 digits only
+ * - NO spaces, dashes, parentheses, dots, or other characters
+ * - NO extensions
+ */
+export declare function normalizePhoneToE164(phone: string | null | undefined): string;
+/**
+ * Extract value from a custom field based on its type
+ */
+export declare function extractCustomFieldValue(field: ClickUpCustomField): string;
+/**
+ * Get custom field value by name (prefers field with value if multiple exist)
+ */
+export declare function getCustomField(task: ClickUpTask, fieldName: string, preferredType?: string): string;
+/**
+ * Convert task to CSV row array
+ */
+export declare function taskToCSVRow(task: ClickUpTask, fieldOrder: string[]): string[];
+/**
+ * Export tasks to CSV format
+ */
+export declare function exportTasksToCSV(listId: string, options?: ExportCSVOptions): Promise<string>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAgB,EACjD,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,GAAG,GACX,OAAO,CAAC,CAAC,CAAC,CAmBZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgCrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAKzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGrF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAkC5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAM3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAwB5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAkB/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAqBlE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAWrE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CA2BvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,cAAc,CAUhB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAqDhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAgB,GACzB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,CA0CxD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,GAAG,MAAM,CAI9E"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/dist/utils.js

@@ -2,7 +2,7 @@
  * Shared utility functions for ClickUp MCP server.
  */
 import axios, { AxiosError } from "axios";
-import { API_BASE_URL, CHARACTER_LIMIT, DEFAULT_TIMEOUT } from "./constants.js";
+import { API_BASE_URL, CHARACTER_LIMIT, DEFAULT_TIMEOUT, MAX_LIMIT } from "./constants.js";
 /**
  * Get ClickUp API token from environment
  */
@@ -293,9 +293,71 @@ export function generateTaskSummary(tasks) {
     return lines.join("\n");
 }
 /**
- * Truncate response if it exceeds character limit with smart boundary detection
+ * Truncate JSON response by removing items from arrays
  */
-export function truncateResponse(content, itemCount, itemType = "items") {
+function truncateJsonResponse(content, itemCount, itemType = "items") {
+    try {
+        const data = JSON.parse(content);
+        // Find the main array (tasks, conversations, etc.)
+        const arrayKey = Object.keys(data).find(key => Array.isArray(data[key]));
+        if (!arrayKey || !Array.isArray(data[arrayKey])) {
+            // If no array found, fall back to string truncation
+            throw new Error('No array found in JSON');
+        }
+        const items = data[arrayKey];
+        let keptItems = items.length;
+        // Remove items one by one until we're under the limit
+        while (JSON.stringify(data).length > CHARACTER_LIMIT && data[arrayKey].length > 1) {
+            data[arrayKey].pop();
+            keptItems = data[arrayKey].length;
+        }
+        const finalContent = JSON.stringify(data, null, 2);
+        // Check if even a single item exceeds the limit
+        if (finalContent.length > CHARACTER_LIMIT) {
+            // Single item is too large - truncate the item's description/content fields
+            if (data[arrayKey].length === 1 && typeof data[arrayKey][0] === 'object') {
+                const item = data[arrayKey][0];
+                // Truncate large text fields
+                for (const key of Object.keys(item)) {
+                    if (typeof item[key] === 'string' && item[key].length > 10000) {
+                        item[key] = item[key].substring(0, 10000) + '... [truncated]';
+                    }
+                }
+                // Retry serialization
+                const compactContent = JSON.stringify(data, null, 2);
+                if (compactContent.length <= CHARACTER_LIMIT) {
+                    const truncation = {
+                        truncated: true,
+                        original_count: itemCount,
+                        returned_count: 1,
+                        truncation_message: `Large ${itemType} fields were truncated to fit size limits (${CHARACTER_LIMIT.toLocaleString()} chars).`
+                    };
+                    return { content: compactContent, truncation };
+                }
+            }
+            // Still too large - fall back to markdown truncation
+            return truncateMarkdownResponse(content, itemCount, itemType);
+        }
+        if (keptItems < items.length) {
+            const truncation = {
+                truncated: true,
+                original_count: items.length,
+                returned_count: keptItems,
+                truncation_message: `Response truncated from ${items.length} to ${keptItems} ${itemType} due to size limits (${CHARACTER_LIMIT.toLocaleString()} chars). Use pagination (offset/limit), add filters, or use response_mode='compact' to see more results.`
+            };
+            return { content: finalContent, truncation };
+        }
+        return { content: finalContent, truncation: null };
+    }
+    catch {
+        // If JSON parsing fails, fall back to string truncation
+        return truncateMarkdownResponse(content, itemCount, itemType);
+    }
+}
+/**
+ * Truncate markdown response if it exceeds character limit with smart boundary detection
+ */
+function truncateMarkdownResponse(content, itemCount, itemType = "items") {
     if (content.length <= CHARACTER_LIMIT) {
         return { content, truncation: null };
     }
@@ -332,6 +394,21 @@ export function truncateResponse(content, itemCount, itemType = "items") {
     };
     return { content: finalContent, truncation };
 }
+/**
+ * Truncate response if it exceeds character limit with smart boundary detection
+ * Detects format and uses appropriate truncation strategy
+ */
+export function truncateResponse(content, itemCount, itemType = "items") {
+    if (content.length <= CHARACTER_LIMIT) {
+        return { content, truncation: null };
+    }
+    // Detect if content is JSON by checking first non-whitespace character
+    const trimmed = content.trimStart();
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        return truncateJsonResponse(content, itemCount, itemType);
+    }
+    return truncateMarkdownResponse(content, itemCount, itemType);
+}
 /**
  * Format truncation information as text
  */
@@ -340,4 +417,380 @@ export function formatTruncationInfo(truncation) {
         return "";
     return `\n\n---\n⚠️ ${truncation.truncation_message}`;
 }
+/**
+ * Filter tasks by status names (client-side filtering)
+ */
+export function filterTasksByStatus(tasks, statuses) {
+    if (!statuses || statuses.length === 0) {
+        return tasks;
+    }
+    return tasks.filter(task => {
+        const taskStatus = task.status?.status;
+        return taskStatus && statuses.includes(taskStatus);
+    });
+}
+/**
+ * Count tasks in a list by status, handling pagination internally
+ */
+export async function countTasksByStatus(listId, options = {}) {
+    const { archived = false, include_closed = false, statuses } = options;
+    const limit = 100; // Use max limit for efficiency
+    let offset = 0;
+    let allTasks = [];
+    let hasMore = true;
+    // Fetch all tasks with pagination
+    while (hasMore) {
+        const queryParams = {
+            archived,
+            include_closed,
+            page: Math.floor(offset / limit)
+        };
+        try {
+            const data = await makeApiRequest(`list/${listId}/task`, "GET", undefined, queryParams);
+            const tasks = data.tasks || [];
+            allTasks.push(...tasks);
+            hasMore = tasks.length === limit;
+            offset += limit;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    // Filter by status if specified
+    let filteredTasks = allTasks;
+    if (statuses && statuses.length > 0) {
+        filteredTasks = filterTasksByStatus(allTasks, statuses);
+    }
+    // Count by status
+    const byStatus = {};
+    for (const task of filteredTasks) {
+        const status = task.status?.status || "Unknown";
+        byStatus[status] = (byStatus[status] || 0) + 1;
+    }
+    return {
+        total: filteredTasks.length,
+        by_status: byStatus
+    };
+}
+/**
+ * Escape CSV fields to handle commas, quotes, and newlines
+ */
+export function escapeCSV(value) {
+    if (value === null || value === undefined)
+        return '';
+    const stringValue = String(value);
+    // If contains comma, quote, or newline, wrap in quotes and escape quotes
+    if (stringValue.includes(',') || stringValue.includes('"') || stringValue.includes('\n')) {
+        return `"${stringValue.replace(/"/g, '""')}"`;
+    }
+    return stringValue;
+}
+/**
+ * Normalize phone number to E.164 format
+ * E.164 format: ^\+?[1-9]\d{1,14}$
+ * Rules:
+ * - Optional + at the start
+ * - Must start with digit 1-9 (not 0)
+ * - Followed by 1-14 digits only
+ * - NO spaces, dashes, parentheses, dots, or other characters
+ * - NO extensions
+ */
+export function normalizePhoneToE164(phone) {
+    if (!phone)
+        return '';
+    let normalized = String(phone).trim();
+    if (!normalized)
+        return '';
+    // Remove extensions (x206, ext 123, extension 456, etc.)
+    // Match: x, ext, extension followed by optional space and digits
+    normalized = normalized.replace(/\s*(?:x|ext|extension)\s*\d+/i, '');
+    // Check if it starts with + (preserve it)
+    const hasPlus = normalized.startsWith('+');
+    if (hasPlus) {
+        normalized = normalized.substring(1);
+    }
+    // Remove all non-digit characters
+    normalized = normalized.replace(/\D/g, '');
+    // If empty after cleaning, return empty
+    if (!normalized)
+        return '';
+    // If number starts with 0, it's invalid for E.164 (must start with 1-9)
+    if (normalized.startsWith('0')) {
+        return '';
+    }
+    // Check if it already has a country code (starts with 1-9 and has 10+ digits)
+    // If it's 10 digits and starts with 1, assume it's US/Canada with country code
+    // If it's 10 digits and doesn't start with 1, assume it's missing country code
+    // If it's 11 digits and starts with 1, it already has country code
+    // If it's more than 11 digits, assume it already has country code
+    if (normalized.length === 10) {
+        // 10 digits without country code - add +1 for US/Canada
+        normalized = '1' + normalized;
+    }
+    else if (normalized.length === 11 && normalized.startsWith('1')) {
+        // Already has US/Canada country code
+        // Keep as is
+    }
+    else if (normalized.length < 10) {
+        // Too short to be a valid phone number
+        return '';
+    }
+    else if (normalized.length > 15) {
+        // Too long for E.164 (max 15 digits after country code)
+        return '';
+    }
+    // Add + prefix
+    normalized = '+' + normalized;
+    // Validate E.164 format: ^\+?[1-9]\d{1,14}$
+    // We already have the +, so check: [1-9]\d{1,14}
+    const e164Regex = /^\+[1-9]\d{1,14}$/;
+    if (!e164Regex.test(normalized)) {
+        return '';
+    }
+    return normalized;
+}
+/**
+ * Extract value from a custom field based on its type
+ */
+export function extractCustomFieldValue(field) {
+    if (!field || field.value === null || field.value === undefined || field.value === '')
+        return '';
+    // Check if this is a phone number field (by type or name)
+    const isPhoneField = field.type === 'phone' ||
+        field.type === 'phone_number' ||
+        (typeof field.name === 'string' && /phone/i.test(field.name));
+    // Handle different field types
+    if (field.type === 'email' || field.type === 'url' || field.type === 'text' || field.type === 'short_text') {
+        const value = String(field.value).trim();
+        // Normalize if it's a phone field
+        return isPhoneField ? normalizePhoneToE164(value) : value;
+    }
+    else if (field.type === 'phone' || field.type === 'phone_number') {
+        return normalizePhoneToE164(field.value);
+    }
+    else if (field.type === 'number' || field.type === 'currency') {
+        return String(field.value);
+    }
+    else if (field.type === 'date') {
+        return new Date(parseInt(field.value)).toISOString().split('T')[0];
+    }
+    else if (field.type === 'dropdown') {
+        return field.value?.label || field.value?.name || String(field.value || '');
+    }
+    else if (field.type === 'labels') {
+        return Array.isArray(field.value) ? field.value.map((v) => v.label || v.name || v).join('; ') : '';
+    }
+    else if (field.type === 'checklist') {
+        return Array.isArray(field.value) ? field.value.map((item) => item.name).join('; ') : '';
+    }
+    else if (field.type === 'checkbox') {
+        return field.value ? 'Yes' : 'No';
+    }
+    // Default: return trimmed string, normalize if it's a phone field
+    const value = String(field.value || '').trim();
+    return isPhoneField ? normalizePhoneToE164(value) : value;
+}
+/**
+ * Get custom field value by name (prefers field with value if multiple exist)
+ */
+export function getCustomField(task, fieldName, preferredType) {
+    if (!task.custom_fields)
+        return '';
+    // Find all fields with matching name
+    const matchingFields = task.custom_fields.filter(f => f.name === fieldName);
+    if (matchingFields.length === 0)
+        return '';
+    // If preferred type specified, try that first
+    if (preferredType) {
+        const typedField = matchingFields.find(f => f.type === preferredType && f.value);
+        if (typedField) {
+            return extractCustomFieldValue(typedField);
+        }
+    }
+    // Prefer field with a value
+    const fieldWithValue = matchingFields.find(f => f.value !== null && f.value !== undefined && f.value !== '');
+    const field = fieldWithValue || matchingFields[0];
+    return extractCustomFieldValue(field);
+}
+/**
+ * Convert task to CSV row array
+ */
+export function taskToCSVRow(task, fieldOrder) {
+    const row = [];
+    for (const fieldName of fieldOrder) {
+        let value = '';
+        // Standard fields
+        if (fieldName === 'Task ID') {
+            value = task.id;
+        }
+        else if (fieldName === 'Name') {
+            value = task.name;
+        }
+        else if (fieldName === 'Status') {
+            value = task.status?.status || '';
+        }
+        else if (fieldName === 'Date Created') {
+            value = task.date_created ? new Date(parseInt(task.date_created)).toISOString() : '';
+        }
+        else if (fieldName === 'Date Updated') {
+            value = task.date_updated ? new Date(parseInt(task.date_updated)).toISOString() : '';
+        }
+        else if (fieldName === 'URL') {
+            value = task.url || '';
+        }
+        else if (fieldName === 'Assignees') {
+            value = task.assignees?.map(a => a.username || a.email).join('; ') || '';
+        }
+        else if (fieldName === 'Creator') {
+            value = task.creator?.username || task.creator?.email || '';
+        }
+        else if (fieldName === 'Due Date') {
+            value = task.due_date ? new Date(parseInt(task.due_date)).toISOString() : '';
+        }
+        else if (fieldName === 'Priority') {
+            value = task.priority?.priority || '';
+        }
+        else if (fieldName === 'Description') {
+            value = task.description || task.text_content || '';
+        }
+        else if (fieldName === 'Tags') {
+            value = task.tags?.map(t => t.name).join('; ') || '';
+        }
+        else if (fieldName === 'phone_number') {
+            // Combined phone number field for ElevenLabs compatibility
+            // First check if a real phone_number custom field exists
+            const realPhoneNumberField = task.custom_fields?.find(f => f.name === 'phone_number');
+            if (realPhoneNumberField && (realPhoneNumberField.value !== null && realPhoneNumberField.value !== undefined && realPhoneNumberField.value !== '')) {
+                // Use the real phone_number field value (already normalized)
+                value = extractCustomFieldValue(realPhoneNumberField);
+            }
+            else {
+                // No real phone_number field, use synthetic logic
+                // Priority: Personal Phone > Biz Phone number > first phone field found
+                const personalPhone = getCustomField(task, 'Personal Phone');
+                const bizPhone = getCustomField(task, 'Biz Phone number');
+                if (personalPhone) {
+                    value = personalPhone;
+                }
+                else if (bizPhone) {
+                    value = bizPhone;
+                }
+                else {
+                    // Try to find any phone field
+                    const phoneFields = task.custom_fields?.filter(f => f.type === 'phone' ||
+                        f.type === 'phone_number' ||
+                        (typeof f.name === 'string' && /phone/i.test(f.name))) || [];
+                    if (phoneFields.length > 0) {
+                        value = extractCustomFieldValue(phoneFields[0]);
+                    }
+                }
+            }
+        }
+        else {
+            // Custom field
+            value = getCustomField(task, fieldName);
+        }
+        row.push(escapeCSV(value));
+    }
+    return row;
+}
+/**
+ * Export tasks to CSV format
+ */
+export async function exportTasksToCSV(listId, options = {}) {
+    const { archived = false, include_closed = false, statuses, custom_fields, include_standard_fields = true, add_phone_number_column = false } = options;
+    const limit = MAX_LIMIT;
+    let offset = 0;
+    let allTasks = [];
+    let hasMore = true;
+    // Step 1: Fetch all tasks with pagination
+    while (hasMore) {
+        const queryParams = {
+            archived,
+            include_closed,
+            page: Math.floor(offset / limit)
+        };
+        try {
+            const data = await makeApiRequest(`list/${listId}/task`, "GET", undefined, queryParams);
+            const tasks = data.tasks || [];
+            allTasks.push(...tasks);
+            hasMore = tasks.length === limit;
+            offset += limit;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    // Step 2: Filter by status if specified
+    if (statuses && statuses.length > 0) {
+        allTasks = filterTasksByStatus(allTasks, statuses);
+    }
+    if (allTasks.length === 0) {
+        return ''; // Return empty CSV if no tasks
+    }
+    // Note: The list endpoint already returns custom fields with values,
+    // so we don't need to fetch individual task details!
+    // Step 3: Build field order and headers
+    const standardFields = [
+        'Task ID',
+        'Name',
+        'Status',
+        'Date Created',
+        'Date Updated',
+        'URL',
+        'Assignees',
+        'Creator',
+        'Due Date',
+        'Priority',
+        'Description',
+        'Tags'
+    ];
+    // Collect all custom field names from tasks
+    const allCustomFieldNames = new Set();
+    for (const task of allTasks) {
+        if (task.custom_fields) {
+            for (const field of task.custom_fields) {
+                allCustomFieldNames.add(field.name);
+            }
+        }
+    }
+    // Determine which custom fields to include
+    const customFieldsToInclude = custom_fields && custom_fields.length > 0
+        ? custom_fields.filter(name => allCustomFieldNames.has(name))
+        : Array.from(allCustomFieldNames);
+    // Build field order
+    const fieldOrder = [];
+    if (include_standard_fields) {
+        fieldOrder.push(...standardFields);
+    }
+    fieldOrder.push(...customFieldsToInclude);
+    // Add phone_number column if requested (for ElevenLabs compatibility)
+    if (add_phone_number_column) {
+        // Check if phone_number already exists (e.g., as a real custom field)
+        const phoneNumberIdx = fieldOrder.indexOf('phone_number');
+        if (phoneNumberIdx === -1) {
+            // phone_number doesn't exist, add our synthetic one
+            // Find Email index to insert after it
+            const emailIdx = fieldOrder.indexOf('Email');
+            if (emailIdx >= 0) {
+                fieldOrder.splice(emailIdx + 1, 0, 'phone_number');
+            }
+            else {
+                // If no Email field, add at the end
+                fieldOrder.push('phone_number');
+            }
+        }
+        // If phone_number already exists, use the existing one (no duplicate needed)
+    }
+    // Step 4: Build CSV
+    const csvRows = [];
+    // Headers
+    csvRows.push(fieldOrder.map(escapeCSV).join(','));
+    // Data rows
+    for (const task of allTasks) {
+        const row = taskToCSVRow(task, fieldOrder);
+        csvRows.push(row.join(','));
+    }
+    return csvRows.join('\n');
+}
 //# sourceMappingURL=utils.js.map