@standardbeagle/dart-query 0.3.2

package/dist/tools/batch_update_tasks.js

@@ -0,0 +1,327 @@
+import pLimit from 'p-limit';
+import { DartClient } from '../api/dartClient.js';
+import { handleGetConfig } from './get_config.js';
+import { parseDartQLToAST, convertToFilters } from '../parsers/dartql.js';
+import { DartAPIError, ValidationError, findDartboard, findStatus, findTag, getDartboardNames, getStatusNames, getTagNames, } from '../types/index.js';
+import { createBatchOperation, completeBatchOperation, addSuccessfulItem, addFailedItem, } from '../batch/batchOperations.js';
+export async function handleBatchUpdateTasks(input) {
+    const DART_TOKEN = process.env.DART_TOKEN;
+    if (!DART_TOKEN) {
+        throw new DartAPIError('DART_TOKEN environment variable is required. Get your token from: https://app.dartai.com/?settings=account', 401);
+    }
+    if (!input || typeof input !== 'object') {
+        throw new ValidationError('input is required and must be an object', 'input');
+    }
+    if (!input.selector || typeof input.selector !== 'string' || input.selector.trim() === '') {
+        throw new ValidationError('selector is required and must be a non-empty DartQL WHERE clause (e.g., "status = \'Todo\' AND priority >= 3")', 'selector');
+    }
+    if (!input.updates || typeof input.updates !== 'object' || Object.keys(input.updates).length === 0) {
+        throw new ValidationError('updates is required and must be a non-empty object with at least one field to update', 'updates');
+    }
+    const dryRun = input.dry_run !== false;
+    let concurrency = input.concurrency ?? 5;
+    if (typeof concurrency !== 'number' || !Number.isInteger(concurrency)) {
+        throw new ValidationError('concurrency must be an integer', 'concurrency');
+    }
+    if (concurrency < 1 || concurrency > 20) {
+        throw new ValidationError('concurrency must be between 1 and 20', 'concurrency');
+    }
+    const parseResult = parseDartQLToAST(input.selector);
+    if (parseResult.errors.length > 0) {
+        throw new ValidationError(`DartQL parse errors: ${parseResult.errors.join('; ')}`, 'selector', parseResult.errors);
+    }
+    const filterResult = convertToFilters(parseResult.ast);
+    if (filterResult.errors.length > 0) {
+        throw new ValidationError(`DartQL conversion errors: ${filterResult.errors.join('; ')}`, 'selector', filterResult.errors);
+    }
+    let config;
+    try {
+        config = await handleGetConfig({ cache_bust: false });
+    }
+    catch (error) {
+        if (error instanceof DartAPIError) {
+            throw new DartAPIError(`Failed to retrieve workspace config for validation: ${error.message}`, error.statusCode, error.response);
+        }
+        throw error;
+    }
+    const validatedUpdates = await validateUpdates(input.updates, config);
+    const client = new DartClient({ token: DART_TOKEN });
+    let matchingTasks = [];
+    try {
+        const apiFilters = filterResult.apiFilters;
+        let offset = 0;
+        const limit = 500;
+        let hasMore = true;
+        while (hasMore) {
+            const response = await client.listTasks({
+                ...apiFilters,
+                limit,
+                offset,
+            });
+            matchingTasks.push(...(response.tasks || []));
+            hasMore = offset + limit < (response.total || 0);
+            offset += limit;
+            if (matchingTasks.length >= 10000) {
+                throw new ValidationError('Selector matches too many tasks (>10,000). Please narrow your selector.', 'selector');
+            }
+        }
+        if (filterResult.requiresClientSide && filterResult.clientFilter) {
+            matchingTasks = matchingTasks.filter(filterResult.clientFilter);
+        }
+    }
+    catch (error) {
+        if (error instanceof DartAPIError) {
+            throw new DartAPIError(`Failed to fetch matching tasks: ${error.message}`, error.statusCode, error.response);
+        }
+        throw error;
+    }
+    const selectorMatched = matchingTasks.length;
+    if (dryRun) {
+        const previewTasks = matchingTasks.slice(0, 10).map((task) => ({
+            dart_id: task.dart_id,
+            title: task.title,
+            current_values: extractCurrentValues(task, Object.keys(validatedUpdates)),
+            new_values: validatedUpdates,
+        }));
+        return {
+            batch_operation_id: 'dry_run',
+            selector_matched: selectorMatched,
+            dry_run: true,
+            preview_tasks: previewTasks,
+            successful_updates: 0,
+            failed_updates: 0,
+            successful_dart_ids: [],
+            failed_items: [],
+            execution_time_ms: 0,
+        };
+    }
+    const batchOperation = createBatchOperation('update', selectorMatched);
+    const batchOperationId = batchOperation.batch_operation_id;
+    const startTime = Date.now();
+    const limit = pLimit(concurrency);
+    const successfulDartIds = [];
+    const failedItems = [];
+    const updatePromises = matchingTasks.map((task) => limit(async () => {
+        try {
+            await client.updateTask({
+                dart_id: task.dart_id,
+                updates: validatedUpdates,
+            });
+            successfulDartIds.push(task.dart_id);
+            addSuccessfulItem(batchOperationId, task.dart_id);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const reason = error instanceof DartAPIError
+                ? `HTTP ${error.statusCode}: ${error.message}`
+                : errorMessage;
+            failedItems.push({
+                dart_id: task.dart_id,
+                error: errorMessage,
+                reason,
+            });
+            addFailedItem(batchOperationId, {
+                id: task.dart_id,
+                error: reason,
+            });
+        }
+    }));
+    await Promise.all(updatePromises);
+    const executionTimeMs = Date.now() - startTime;
+    const status = failedItems.length === 0 ? 'completed' : failedItems.length === selectorMatched ? 'failed' : 'completed';
+    completeBatchOperation(batchOperationId, status);
+    return {
+        batch_operation_id: batchOperationId,
+        selector_matched: selectorMatched,
+        dry_run: false,
+        successful_updates: successfulDartIds.length,
+        failed_updates: failedItems.length,
+        successful_dart_ids: successfulDartIds,
+        failed_items: failedItems,
+        execution_time_ms: executionTimeMs,
+    };
+}
+async function validateUpdates(updates, config) {
+    const validated = {};
+    if (updates.title !== undefined) {
+        if (typeof updates.title !== 'string' || updates.title.trim() === '') {
+            throw new ValidationError('title must be a non-empty string', 'title');
+        }
+        if (updates.title.length > 500) {
+            throw new ValidationError(`title exceeds maximum length of 500 characters (current: ${updates.title.length})`, 'title');
+        }
+        validated.title = updates.title;
+    }
+    if (updates.description !== undefined) {
+        validated.description = updates.description;
+    }
+    if (updates.dartboard !== undefined) {
+        if (!config.dartboards || config.dartboards.length === 0) {
+            throw new ValidationError('No dartboards found in workspace configuration. Cannot update dartboard.', 'dartboard');
+        }
+        const dartboard = findDartboard(config.dartboards, updates.dartboard);
+        if (!dartboard) {
+            const dartboardNames = getDartboardNames(config.dartboards);
+            const availableDartboards = dartboardNames.slice(0, 10).join(', ') +
+                (dartboardNames.length > 10 ? `, ... (${dartboardNames.length - 10} more)` : '');
+            throw new ValidationError(`Invalid dartboard: "${updates.dartboard}" not found in workspace. Available dartboards: ${availableDartboards}`, 'dartboard', dartboardNames);
+        }
+        validated.dartboard = dartboard.dart_id;
+    }
+    if (updates.status !== undefined) {
+        if (!config.statuses || config.statuses.length === 0) {
+            throw new ValidationError('No statuses found in workspace configuration. Cannot update status.', 'status');
+        }
+        const status = findStatus(config.statuses, updates.status);
+        if (!status) {
+            const statusNames = getStatusNames(config.statuses);
+            const availableStatuses = statusNames.join(', ');
+            throw new ValidationError(`Invalid status: "${updates.status}" not found in workspace. Available statuses: ${availableStatuses}`, 'status', statusNames);
+        }
+        validated.status = status.dart_id;
+    }
+    if (updates.priority !== undefined) {
+        if (!config.priorities || config.priorities.length === 0) {
+            throw new ValidationError('No priorities found in workspace configuration. Cannot update priority.', 'priority');
+        }
+        if (typeof updates.priority !== 'number' || updates.priority < 1 || updates.priority > 5) {
+            throw new ValidationError(`Invalid priority: ${updates.priority}. Valid range: 1-5 (1=lowest, 5=highest)`, 'priority', ['1', '2', '3', '4', '5']);
+        }
+        validated.priority = updates.priority;
+    }
+    if (updates.size !== undefined) {
+        if (!config.sizes || config.sizes.length === 0) {
+            throw new ValidationError('No sizes found in workspace configuration. Cannot update size.', 'size');
+        }
+        if (typeof updates.size !== 'number' || updates.size < 1 || updates.size > 5) {
+            throw new ValidationError(`Invalid size: ${updates.size}. Valid range: 1-5 (1=XS, 5=XL)`, 'size', ['1', '2', '3', '4', '5']);
+        }
+        validated.size = updates.size;
+    }
+    if (updates.assignees !== undefined) {
+        if (!Array.isArray(updates.assignees)) {
+            throw new ValidationError('assignees must be an array of assignee dart_ids, names, or emails', 'assignees');
+        }
+        if (updates.assignees.length > 0) {
+            if (!config.assignees || config.assignees.length === 0) {
+                throw new ValidationError('No assignees found in workspace configuration. Cannot update assignees.', 'assignees');
+            }
+            const resolvedAssignees = [];
+            for (const assigneeIdOrName of updates.assignees) {
+                if (typeof assigneeIdOrName !== 'string') {
+                    throw new ValidationError(`assignees array must contain only strings, found: ${typeof assigneeIdOrName}`, 'assignees');
+                }
+                const assignee = config.assignees.find((a) => a.email === assigneeIdOrName ||
+                    a.name === assigneeIdOrName);
+                if (!assignee) {
+                    const availableAssignees = config.assignees
+                        .map((a) => a.email ? `${a.name} <${a.email}>` : a.name)
+                        .join(', ');
+                    throw new ValidationError(`Invalid assignee: "${assigneeIdOrName}" not found in workspace. Available assignees: ${availableAssignees}`, 'assignees', config.assignees.map((a) => a.email || a.name));
+                }
+                resolvedAssignees.push(assignee.email || assignee.name);
+            }
+            validated.assignees = resolvedAssignees;
+        }
+        else {
+            validated.assignees = [];
+        }
+    }
+    if (updates.tags !== undefined) {
+        if (!Array.isArray(updates.tags)) {
+            throw new ValidationError('tags must be an array of tag dart_ids or names', 'tags');
+        }
+        if (updates.tags.length > 0) {
+            if (!config.tags || config.tags.length === 0) {
+                throw new ValidationError('No tags found in workspace configuration. Cannot update tags.', 'tags');
+            }
+            const resolvedTags = [];
+            for (const tagInput of updates.tags) {
+                if (typeof tagInput !== 'string') {
+                    throw new ValidationError(`tags array must contain only strings, found: ${typeof tagInput}`, 'tags');
+                }
+                const tag = findTag(config.tags, tagInput);
+                if (!tag) {
+                    const tagNames = getTagNames(config.tags);
+                    const availableTags = tagNames.slice(0, 20).join(', ') +
+                        (tagNames.length > 20 ? `, ... (${tagNames.length - 20} more)` : '');
+                    throw new ValidationError(`Invalid tag: "${tagInput}" not found in workspace. Available tags: ${availableTags}`, 'tags', tagNames);
+                }
+                resolvedTags.push(tag.dart_id);
+            }
+            validated.tags = resolvedTags;
+        }
+        else {
+            validated.tags = [];
+        }
+    }
+    if (updates.due_at !== undefined) {
+        const dueDate = new Date(updates.due_at);
+        if (isNaN(dueDate.getTime())) {
+            throw new ValidationError(`Invalid due_at date format: "${updates.due_at}". Expected ISO8601 format (e.g., "2026-01-17T10:00:00Z")`, 'due_at');
+        }
+        validated.due_at = updates.due_at;
+    }
+    if (updates.start_at !== undefined) {
+        const startDate = new Date(updates.start_at);
+        if (isNaN(startDate.getTime())) {
+            throw new ValidationError(`Invalid start_at date format: "${updates.start_at}". Expected ISO8601 format (e.g., "2026-01-17T10:00:00Z")`, 'start_at');
+        }
+        validated.start_at = updates.start_at;
+    }
+    if (updates.parent_task !== undefined) {
+        validated.parent_task = updates.parent_task;
+    }
+    const validateRelationshipArray = (fieldName, value) => {
+        if (value === undefined) {
+            return undefined;
+        }
+        if (!Array.isArray(value)) {
+            throw new ValidationError(`${fieldName} must be an array of task dart_ids`, fieldName);
+        }
+        if (value.length === 0) {
+            return [];
+        }
+        for (let i = 0; i < value.length; i++) {
+            const item = value[i];
+            if (typeof item !== 'string') {
+                throw new ValidationError(`${fieldName}[${i}] must be a string, found: ${typeof item}`, fieldName);
+            }
+            if (item.trim() === '') {
+                throw new ValidationError(`${fieldName}[${i}] must be a non-empty string`, fieldName);
+            }
+        }
+        return value;
+    };
+    const subtaskIds = validateRelationshipArray('subtask_ids', updates.subtask_ids);
+    if (subtaskIds !== undefined) {
+        validated.subtask_ids = subtaskIds;
+    }
+    const blockerIds = validateRelationshipArray('blocker_ids', updates.blocker_ids);
+    if (blockerIds !== undefined) {
+        validated.blocker_ids = blockerIds;
+    }
+    const blockingIds = validateRelationshipArray('blocking_ids', updates.blocking_ids);
+    if (blockingIds !== undefined) {
+        validated.blocking_ids = blockingIds;
+    }
+    const duplicateIds = validateRelationshipArray('duplicate_ids', updates.duplicate_ids);
+    if (duplicateIds !== undefined) {
+        validated.duplicate_ids = duplicateIds;
+    }
+    const relatedIds = validateRelationshipArray('related_ids', updates.related_ids);
+    if (relatedIds !== undefined) {
+        validated.related_ids = relatedIds;
+    }
+    return validated;
+}
+function extractCurrentValues(task, updatedFields) {
+    const currentValues = {};
+    for (const field of updatedFields) {
+        if (field in task) {
+            currentValues[field] = task[field];
+        }
+    }
+    return currentValues;
+}
+//# sourceMappingURL=batch_update_tasks.js.map

package/dist/tools/batch_update_tasks.js.map

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

package/dist/tools/create_doc.d.ts

@@ -0,0 +1,3 @@
+import { CreateDocInput, CreateDocOutput } from '../types/index.js';
+export declare function handleCreateDoc(input: CreateDocInput): Promise<CreateDocOutput>;
+//# sourceMappingURL=create_doc.d.ts.map

package/dist/tools/create_doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_doc.d.ts","sourceRoot":"","sources":["../../src/tools/create_doc.ts"],"names":[],"mappings":"AASA,OAAO,EACL,cAAc,EACd,eAAe,EAMhB,MAAM,mBAAmB,CAAC;AAiB3B,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CA+GrF"}

package/dist/tools/create_doc.js

@@ -0,0 +1,65 @@
+import { DartClient } from '../api/dartClient.js';
+import { handleGetConfig } from './get_config.js';
+import { DartAPIError, ValidationError, findFolder, getFolderNames, } from '../types/index.js';
+export async function handleCreateDoc(input) {
+    const DART_TOKEN = process.env.DART_TOKEN;
+    if (!DART_TOKEN) {
+        throw new DartAPIError('DART_TOKEN environment variable is required. Get your token from: https://app.dartai.com/?settings=account', 401);
+    }
+    if (!input.title || typeof input.title !== 'string' || input.title.trim() === '') {
+        throw new ValidationError('title is required and must be a non-empty string', 'title');
+    }
+    if (!input.text || typeof input.text !== 'string') {
+        throw new ValidationError('text is required and must be a string (markdown supported)', 'text');
+    }
+    let resolvedFolder;
+    if (input.folder) {
+        let config;
+        try {
+            config = await handleGetConfig({ cache_bust: false });
+        }
+        catch (error) {
+            if (error instanceof DartAPIError) {
+                throw new DartAPIError(`Failed to retrieve workspace config for folder validation: ${error.message}`, error.statusCode, error.response);
+            }
+            throw error;
+        }
+        if (!config.folders || config.folders.length === 0) {
+            throw new ValidationError('No folders found in workspace configuration. Create a folder first in Dart AI.', 'folder');
+        }
+        const folder = findFolder(config.folders, input.folder);
+        if (!folder) {
+            const folderNames = getFolderNames(config.folders);
+            const availableFolders = folderNames.join(', ');
+            throw new ValidationError(`Invalid folder: "${input.folder}" not found in workspace. Available folders: ${availableFolders}`, 'folder', folderNames);
+        }
+        resolvedFolder = folder.dart_id;
+    }
+    const client = new DartClient({ token: DART_TOKEN });
+    const docInput = {
+        title: input.title,
+        text: input.text,
+    };
+    if (resolvedFolder) {
+        docInput.folder = resolvedFolder;
+    }
+    let createdDoc;
+    try {
+        createdDoc = await client.createDoc(docInput);
+    }
+    catch (error) {
+        if (error instanceof DartAPIError) {
+            throw new DartAPIError(`Failed to create document: ${error.message}`, error.statusCode, error.response);
+        }
+        throw error;
+    }
+    const deepLinkUrl = `https://app.dartai.com/doc/${createdDoc.doc_id}`;
+    return {
+        doc_id: createdDoc.doc_id,
+        title: createdDoc.title,
+        url: deepLinkUrl,
+        created_at: createdDoc.created_at,
+        all_fields: createdDoc,
+    };
+}
+//# sourceMappingURL=create_doc.js.map

package/dist/tools/create_doc.js.map

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

package/dist/tools/create_task.d.ts

@@ -0,0 +1,3 @@
+import { CreateTaskInput, CreateTaskOutput } from '../types/index.js';
+export declare function handleCreateTask(input: CreateTaskInput): Promise<CreateTaskOutput>;
+//# sourceMappingURL=create_task.d.ts.map

package/dist/tools/create_task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_task.d.ts","sourceRoot":"","sources":["../../src/tools/create_task.ts"],"names":[],"mappings":"AASA,OAAO,EACL,eAAe,EACf,gBAAgB,EAUjB,MAAM,mBAAmB,CAAC;AAuB3B,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6QxF"}

package/dist/tools/create_task.js

@@ -0,0 +1,143 @@
+import { DartClient } from '../api/dartClient.js';
+import { handleGetConfig } from './get_config.js';
+import { DartAPIError, ValidationError, findDartboard, findTag, findStatus, getDartboardNames, getTagNames, getStatusNames, } from '../types/index.js';
+export async function handleCreateTask(input) {
+    const DART_TOKEN = process.env.DART_TOKEN;
+    if (!DART_TOKEN) {
+        throw new DartAPIError('DART_TOKEN environment variable is required. Get your token from: https://app.dartai.com/?settings=account', 401);
+    }
+    if (!input.title || typeof input.title !== 'string' || input.title.trim() === '') {
+        throw new ValidationError('title is required and must be a non-empty string', 'title');
+    }
+    if (input.title.length > 500) {
+        throw new ValidationError(`title exceeds maximum length of 500 characters (current: ${input.title.length})`, 'title');
+    }
+    if (!input.dartboard || typeof input.dartboard !== 'string' || input.dartboard.trim() === '') {
+        throw new ValidationError('dartboard is required and must be a non-empty string (dartboard name)', 'dartboard');
+    }
+    let config;
+    try {
+        config = await handleGetConfig({ cache_bust: false });
+    }
+    catch (error) {
+        if (error instanceof DartAPIError) {
+            throw new DartAPIError(`Failed to retrieve workspace config for validation: ${error.message}`, error.statusCode, error.response);
+        }
+        throw error;
+    }
+    if (!config.dartboards || config.dartboards.length === 0) {
+        throw new ValidationError('No dartboards found in workspace configuration. Create a dartboard first in Dart AI.', 'dartboard');
+    }
+    const dartboard = findDartboard(config.dartboards, input.dartboard);
+    if (!dartboard) {
+        const dartboardNames = getDartboardNames(config.dartboards);
+        const availableDartboards = dartboardNames.slice(0, 10).join(', ') +
+            (dartboardNames.length > 10 ? `, ... (${dartboardNames.length - 10} more)` : '');
+        throw new ValidationError(`Invalid dartboard: "${input.dartboard}" not found in workspace. Available dartboards: ${availableDartboards}`, 'dartboard', dartboardNames);
+    }
+    if (input.assignees && Array.isArray(input.assignees) && input.assignees.length > 0) {
+        const invalidAssignees = [];
+        for (const assignee of input.assignees) {
+            const assigneeExists = config.assignees.some((a) => a.email === assignee || a.name === assignee);
+            if (!assigneeExists) {
+                invalidAssignees.push(assignee);
+            }
+        }
+        if (invalidAssignees.length > 0) {
+            const availableAssignees = config.assignees
+                .map((a) => a.email ? `${a.name} <${a.email}>` : a.name)
+                .join(', ');
+            throw new ValidationError(`Invalid assignee(s): ${invalidAssignees.join(', ')} not found in workspace. Available assignees: ${availableAssignees}`, 'assignees', config.assignees.map((a) => a.email || a.name));
+        }
+    }
+    if (input.tags && Array.isArray(input.tags) && input.tags.length > 0) {
+        const invalidTags = [];
+        for (const tagInput of input.tags) {
+            if (!findTag(config.tags, tagInput)) {
+                invalidTags.push(tagInput);
+            }
+        }
+        if (invalidTags.length > 0) {
+            const tagNames = getTagNames(config.tags);
+            const availableTags = tagNames.slice(0, 20).join(', ') +
+                (tagNames.length > 20 ? `, ... (${tagNames.length - 20} more)` : '');
+            throw new ValidationError(`Invalid tag(s): ${invalidTags.join(', ')} not found in workspace. Available tags: ${availableTags}`, 'tags', tagNames);
+        }
+    }
+    if (input.status && typeof input.status === 'string') {
+        if (!findStatus(config.statuses, input.status)) {
+            const statusNames = getStatusNames(config.statuses);
+            const availableStatuses = statusNames.join(', ');
+            throw new ValidationError(`Invalid status: "${input.status}" not found in workspace. Available statuses: ${availableStatuses}`, 'status', statusNames);
+        }
+    }
+    if (input.priority !== undefined && input.priority !== null) {
+    }
+    if (input.size !== undefined && input.size !== null) {
+    }
+    const validateDartIdFormat = (id) => {
+        return typeof id === 'string' && id.trim().length > 0;
+    };
+    const validateRelationshipIds = (ids, fieldName) => {
+        if (!ids || !Array.isArray(ids)) {
+            return;
+        }
+        const invalidIds = [];
+        for (const id of ids) {
+            if (!validateDartIdFormat(id)) {
+                invalidIds.push(id === '' ? '(empty string)' : String(id));
+            }
+        }
+        if (invalidIds.length > 0) {
+            throw new ValidationError(`Invalid dart_id format in ${fieldName}: ${invalidIds.join(', ')}. Each ID must be a non-empty string.`, fieldName);
+        }
+    };
+    validateRelationshipIds(input.subtask_ids, 'subtask_ids');
+    validateRelationshipIds(input.blocker_ids, 'blocker_ids');
+    validateRelationshipIds(input.blocking_ids, 'blocking_ids');
+    validateRelationshipIds(input.duplicate_ids, 'duplicate_ids');
+    validateRelationshipIds(input.related_ids, 'related_ids');
+    const validateDate = (dateStr, fieldName) => {
+        try {
+            const date = new Date(dateStr);
+            if (isNaN(date.getTime())) {
+                throw new ValidationError(`Invalid ${fieldName}: "${dateStr}" is not a valid ISO8601 date`, fieldName);
+            }
+        }
+        catch {
+            throw new ValidationError(`Invalid ${fieldName}: "${dateStr}" is not a valid ISO8601 date`, fieldName);
+        }
+    };
+    if (input.due_at) {
+        validateDate(input.due_at, 'due_at');
+    }
+    if (input.start_at) {
+        validateDate(input.start_at, 'start_at');
+    }
+    const client = new DartClient({ token: DART_TOKEN });
+    let createdTask;
+    try {
+        createdTask = await client.createTask(input);
+    }
+    catch (error) {
+        if (error instanceof DartAPIError) {
+            throw new DartAPIError(`Failed to create task: ${error.message}`, error.statusCode, error.response);
+        }
+        throw error;
+    }
+    const taskWithDartId = {
+        ...createdTask,
+        dart_id: createdTask.id || createdTask.dart_id,
+        created_at: createdTask.createdAt || createdTask.created_at,
+        updated_at: createdTask.updatedAt || createdTask.updated_at,
+    };
+    const url = createdTask.htmlUrl || `https://app.dartai.com/task/${taskWithDartId.dart_id}`;
+    return {
+        dart_id: taskWithDartId.dart_id,
+        title: taskWithDartId.title,
+        url,
+        created_at: taskWithDartId.created_at,
+        all_fields: taskWithDartId,
+    };
+}
+//# sourceMappingURL=create_task.js.map

package/dist/tools/create_task.js.map

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

package/dist/tools/delete_doc.d.ts

@@ -0,0 +1,3 @@
+import { DeleteDocInput, DeleteDocOutput } from '../types/index.js';
+export declare function handleDeleteDoc(input: DeleteDocInput): Promise<DeleteDocOutput>;
+//# sourceMappingURL=delete_doc.d.ts.map

package/dist/tools/delete_doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete_doc.d.ts","sourceRoot":"","sources":["../../src/tools/delete_doc.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,cAAc,EACd,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAc3B,wBAAsB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAgErF"}

package/dist/tools/delete_doc.js

@@ -0,0 +1,35 @@
+import { DartClient } from '../api/dartClient.js';
+import { DartAPIError, } from '../types/index.js';
+export async function handleDeleteDoc(input) {
+    const DART_TOKEN = process.env.DART_TOKEN;
+    if (!DART_TOKEN) {
+        throw new DartAPIError('DART_TOKEN environment variable is required. Get your token from: https://app.dartai.com/?settings=account', 401);
+    }
+    if (!input || typeof input !== 'object') {
+        throw new DartAPIError('input is required and must be an object', 400);
+    }
+    if (!input.doc_id || typeof input.doc_id !== 'string' || input.doc_id.trim() === '') {
+        throw new DartAPIError('doc_id is required and must be a non-empty string', 400);
+    }
+    const client = new DartClient({ token: DART_TOKEN });
+    let result;
+    try {
+        result = await client.deleteDoc(input.doc_id);
+    }
+    catch (error) {
+        if (error instanceof DartAPIError && error.statusCode === 404) {
+            throw new DartAPIError(`Document not found: No document with doc_id "${input.doc_id}" exists in workspace`, 404, error.response);
+        }
+        if (error instanceof DartAPIError) {
+            throw new DartAPIError(`Failed to delete document: ${error.message}`, error.statusCode, error.response);
+        }
+        throw error;
+    }
+    return {
+        doc_id: result.doc_id,
+        deleted: result.success,
+        recoverable: true,
+        message: `Document "${result.doc_id}" moved to trash. Recoverable via Dart web UI: https://app.dartai.com/trash`,
+    };
+}
+//# sourceMappingURL=delete_doc.js.map