@jbctechsolutions/mcp-office365 2.5.1

package/dist/tools/sharepoint.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * SharePoint Document Library MCP tools.
+ *
+ * Provides read-only tools for browsing SharePoint sites, document libraries,
+ * and downloading files from team document libraries.
+ */
+import { z } from 'zod';
+export declare const ListSitesInput: z.ZodObject<{}, z.core.$strict>;
+export declare const SearchSitesInput: z.ZodObject<{
+    query: z.ZodString;
+}, z.core.$strict>;
+export declare const GetSiteInput: z.ZodObject<{
+    site_id: z.ZodNumber;
+}, z.core.$strict>;
+export declare const ListDocumentLibrariesInput: z.ZodObject<{
+    site_id: z.ZodNumber;
+}, z.core.$strict>;
+export declare const ListLibraryItemsInput: z.ZodObject<{
+    library_id: z.ZodNumber;
+    folder_id: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const DownloadLibraryFileInput: z.ZodObject<{
+    item_id: z.ZodNumber;
+    output_path: z.ZodString;
+}, z.core.$strict>;
+export type ListSitesParams = z.infer<typeof ListSitesInput>;
+export type SearchSitesParams = z.infer<typeof SearchSitesInput>;
+export type GetSiteParams = z.infer<typeof GetSiteInput>;
+export type ListDocumentLibrariesParams = z.infer<typeof ListDocumentLibrariesInput>;
+export type ListLibraryItemsParams = z.infer<typeof ListLibraryItemsInput>;
+export type DownloadLibraryFileParams = z.infer<typeof DownloadLibraryFileInput>;
+export interface ISharePointRepository {
+    listSitesAsync(): Promise<Array<{
+        id: number;
+        name: string;
+        webUrl: string;
+        displayName: string;
+    }>>;
+    searchSitesAsync(query: string): Promise<Array<{
+        id: number;
+        name: string;
+        webUrl: string;
+        displayName: string;
+    }>>;
+    getSiteAsync(siteId: number): Promise<{
+        id: number;
+        name: string;
+        webUrl: string;
+        displayName: string;
+        description: string;
+    }>;
+    listDocumentLibrariesAsync(siteId: number): Promise<Array<{
+        id: number;
+        name: string;
+        webUrl: string;
+        driveType: string;
+    }>>;
+    listLibraryItemsAsync(libraryId: number, folderId?: number): Promise<Array<{
+        id: number;
+        name: string;
+        size: number;
+        webUrl: string;
+        lastModifiedDateTime: string;
+        isFolder: boolean;
+    }>>;
+    downloadLibraryFileAsync(itemId: number, outputPath: string): Promise<string>;
+}
+/**
+ * SharePoint document library tools for browsing sites, libraries, and files.
+ */
+export declare class SharePointTools {
+    private readonly repo;
+    constructor(repo: ISharePointRepository);
+    listSites(): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    searchSites(params: SearchSitesParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    getSite(params: GetSiteParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    listDocumentLibraries(params: ListDocumentLibrariesParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    listLibraryItems(params: ListLibraryItemsParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    downloadLibraryFile(params: DownloadLibraryFileParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=sharepoint.d.ts.map

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

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

package/dist/tools/sharepoint.js

@@ -0,0 +1,99 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * SharePoint Document Library MCP tools.
+ *
+ * Provides read-only tools for browsing SharePoint sites, document libraries,
+ * and downloading files from team document libraries.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Input Schemas
+// =============================================================================
+export const ListSitesInput = z.strictObject({});
+export const SearchSitesInput = z.strictObject({
+    query: z.string().min(1).describe('Search keyword for SharePoint sites'),
+});
+export const GetSiteInput = z.strictObject({
+    site_id: z.number().int().positive().describe('Site ID from list_sites or search_sites'),
+});
+export const ListDocumentLibrariesInput = z.strictObject({
+    site_id: z.number().int().positive().describe('Site ID from list_sites or search_sites'),
+});
+export const ListLibraryItemsInput = z.strictObject({
+    library_id: z.number().int().positive().describe('Library ID from list_document_libraries'),
+    folder_id: z.number().int().positive().optional().describe('Folder ID to browse into (from a previous list_library_items call)'),
+});
+export const DownloadLibraryFileInput = z.strictObject({
+    item_id: z.number().int().positive().describe('Item ID from list_library_items'),
+    output_path: z.string().min(1).describe('Local file path to save the downloaded file'),
+});
+// =============================================================================
+// SharePoint Tools
+// =============================================================================
+/**
+ * SharePoint document library tools for browsing sites, libraries, and files.
+ */
+export class SharePointTools {
+    repo;
+    constructor(repo) {
+        this.repo = repo;
+    }
+    async listSites() {
+        const sites = await this.repo.listSitesAsync();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ sites }, null, 2),
+                }],
+        };
+    }
+    async searchSites(params) {
+        const sites = await this.repo.searchSitesAsync(params.query);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ sites }, null, 2),
+                }],
+        };
+    }
+    async getSite(params) {
+        const site = await this.repo.getSiteAsync(params.site_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ site }, null, 2),
+                }],
+        };
+    }
+    async listDocumentLibraries(params) {
+        const libraries = await this.repo.listDocumentLibrariesAsync(params.site_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ libraries }, null, 2),
+                }],
+        };
+    }
+    async listLibraryItems(params) {
+        const items = await this.repo.listLibraryItemsAsync(params.library_id, params.folder_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ items }, null, 2),
+                }],
+        };
+    }
+    async downloadLibraryFile(params) {
+        const savedPath = await this.repo.downloadLibraryFileAsync(params.item_id, params.output_path);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, path: savedPath, message: 'File downloaded' }, null, 2),
+                }],
+        };
+    }
+}
+//# sourceMappingURL=sharepoint.js.map

package/dist/tools/sharepoint.js.map

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

package/dist/tools/task-attachments.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Task Attachment MCP tools for Microsoft To Do.
+ *
+ * Provides tools for managing attachments on To Do tasks with a two-phase
+ * approval pattern for destructive delete operations.
+ */
+import { z } from 'zod';
+import type { ApprovalTokenManager } from '../approval/index.js';
+export declare const ListTaskAttachmentsInput: z.ZodObject<{
+    task_id: z.ZodNumber;
+}, z.core.$strict>;
+export declare const CreateTaskAttachmentInput: z.ZodObject<{
+    task_id: z.ZodNumber;
+    name: z.ZodString;
+    content_bytes: z.ZodString;
+    content_type: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const PrepareDeleteTaskAttachmentInput: z.ZodObject<{
+    task_attachment_id: z.ZodNumber;
+}, z.core.$strict>;
+export declare const ConfirmDeleteTaskAttachmentInput: z.ZodObject<{
+    approval_token: z.ZodString;
+}, z.core.$strict>;
+export type ListTaskAttachmentsParams = z.infer<typeof ListTaskAttachmentsInput>;
+export type CreateTaskAttachmentParams = z.infer<typeof CreateTaskAttachmentInput>;
+export type PrepareDeleteTaskAttachmentParams = z.infer<typeof PrepareDeleteTaskAttachmentInput>;
+export type ConfirmDeleteTaskAttachmentParams = z.infer<typeof ConfirmDeleteTaskAttachmentInput>;
+export interface ITaskAttachmentsRepository {
+    listTaskAttachmentsAsync(taskId: number): Promise<Array<{
+        id: number;
+        name: string;
+        size: number;
+        contentType: string;
+    }>>;
+    createTaskAttachmentAsync(taskId: number, name: string, contentBytes: string, contentType?: string): Promise<number>;
+    deleteTaskAttachmentAsync(taskAttachmentId: number): Promise<void>;
+}
+/**
+ * Task attachment tools with two-phase approval for delete operations.
+ */
+export declare class TaskAttachmentsTools {
+    private readonly repo;
+    private readonly tokenManager;
+    constructor(repo: ITaskAttachmentsRepository, tokenManager: ApprovalTokenManager);
+    listTaskAttachments(params: ListTaskAttachmentsParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    createTaskAttachment(params: CreateTaskAttachmentParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    prepareDeleteTaskAttachment(params: PrepareDeleteTaskAttachmentParams): {
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    };
+    confirmDeleteTaskAttachment(params: ConfirmDeleteTaskAttachmentParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=task-attachments.d.ts.map

package/dist/tools/task-attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-attachments.d.ts","sourceRoot":"","sources":["../../src/tools/task-attachments.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAMjE,eAAO,MAAM,wBAAwB;;kBAEnC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;kBAKpC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;kBAE3C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;kBAE3C,CAAC;AAMH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AACjF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACnF,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AACjG,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAMjG,MAAM,WAAW,0BAA0B;IACzC,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC1H,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrH,yBAAyB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAMD;;GAEG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,IAAI,EAAE,0BAA0B,EAChC,YAAY,EAAE,oBAAoB;IAG/C,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC;QACpE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC;IAUI,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,GAAG,OAAO,CAAC;QACtE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC;IAUF,2BAA2B,CAAC,MAAM,EAAE,iCAAiC,GAAG;QACtE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD;IAqBK,2BAA2B,CAAC,MAAM,EAAE,iCAAiC,GAAG,OAAO,CAAC;QACpF,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC;CA2CH"}

package/dist/tools/task-attachments.js

@@ -0,0 +1,122 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Task Attachment MCP tools for Microsoft To Do.
+ *
+ * Provides tools for managing attachments on To Do tasks with a two-phase
+ * approval pattern for destructive delete operations.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Input Schemas
+// =============================================================================
+export const ListTaskAttachmentsInput = z.strictObject({
+    task_id: z.number().int().positive().describe('Task ID from list_tasks or search_tasks'),
+});
+export const CreateTaskAttachmentInput = z.strictObject({
+    task_id: z.number().int().positive().describe('Task ID'),
+    name: z.string().min(1).describe('File name of the attachment'),
+    content_bytes: z.string().min(1).describe('Base64-encoded file content'),
+    content_type: z.string().optional().describe('MIME type (default: application/octet-stream)'),
+});
+export const PrepareDeleteTaskAttachmentInput = z.strictObject({
+    task_attachment_id: z.number().int().positive().describe('Task attachment ID to delete'),
+});
+export const ConfirmDeleteTaskAttachmentInput = z.strictObject({
+    approval_token: z.string().describe('Approval token from prepare_delete_task_attachment'),
+});
+// =============================================================================
+// Task Attachments Tools
+// =============================================================================
+/**
+ * Task attachment tools with two-phase approval for delete operations.
+ */
+export class TaskAttachmentsTools {
+    repo;
+    tokenManager;
+    constructor(repo, tokenManager) {
+        this.repo = repo;
+        this.tokenManager = tokenManager;
+    }
+    async listTaskAttachments(params) {
+        const items = await this.repo.listTaskAttachmentsAsync(params.task_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ task_attachments: items }, null, 2),
+                }],
+        };
+    }
+    async createTaskAttachment(params) {
+        const itemId = await this.repo.createTaskAttachmentAsync(params.task_id, params.name, params.content_bytes, params.content_type);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, task_attachment_id: itemId, message: 'Task attachment created' }, null, 2),
+                }],
+        };
+    }
+    prepareDeleteTaskAttachment(params) {
+        const token = this.tokenManager.generateToken({
+            operation: 'delete_task_attachment',
+            targetType: 'task_attachment',
+            targetId: params.task_attachment_id,
+            targetHash: String(params.task_attachment_id),
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        approval_token: token.tokenId,
+                        expires_at: new Date(token.expiresAt).toISOString(),
+                        task_attachment_id: params.task_attachment_id,
+                        action: `To confirm deleting task attachment ${params.task_attachment_id}, call confirm_delete_task_attachment with the approval_token.`,
+                    }, null, 2),
+                }],
+        };
+    }
+    async confirmDeleteTaskAttachment(params) {
+        // Look up the token to get the targetId, then consume it
+        const token = this.tokenManager.lookupToken(params.approval_token);
+        if (token == null) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: 'Token not found or already used',
+                        }, null, 2),
+                    }],
+            };
+        }
+        const result = this.tokenManager.consumeToken(params.approval_token, 'delete_task_attachment', token.targetId);
+        if (!result.valid) {
+            const errorMessages = {
+                NOT_FOUND: 'Token not found or already used',
+                EXPIRED: 'Token has expired. Please call prepare_delete_task_attachment again.',
+                OPERATION_MISMATCH: 'Token was not generated for delete_task_attachment',
+                TARGET_MISMATCH: 'Token was generated for a different task attachment',
+                ALREADY_CONSUMED: 'Token has already been used',
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: errorMessages[result.error ?? ''] ?? 'Invalid token',
+                        }, null, 2),
+                    }],
+            };
+        }
+        await this.repo.deleteTaskAttachmentAsync(result.token.targetId);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, message: 'Task attachment deleted' }, null, 2),
+                }],
+        };
+    }
+}
+//# sourceMappingURL=task-attachments.js.map

package/dist/tools/task-attachments.js.map

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

package/dist/tools/tasks.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Task-related MCP tools.
+ *
+ * Provides tools for listing, searching, and getting tasks.
+ */
+import { z } from 'zod';
+import type { IRepository } from '../database/repository.js';
+import type { TaskSummary, Task } from '../types/index.js';
+export declare const ListTasksInput: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    include_completed: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const SearchTasksInput: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const GetTaskInput: z.ZodObject<{
+    task_id: z.ZodNumber;
+}, z.core.$strict>;
+export type ListTasksParams = z.infer<typeof ListTasksInput>;
+export type SearchTasksParams = z.infer<typeof SearchTasksInput>;
+export type GetTaskParams = z.infer<typeof GetTaskInput>;
+/**
+ * Interface for reading task content from data files.
+ */
+export interface ITaskContentReader {
+    /**
+     * Reads task details from the given data file path.
+     */
+    readTaskDetails(dataFilePath: string | null): TaskDetails | null;
+}
+/**
+ * Task details from content file.
+ */
+export interface TaskDetails {
+    readonly body: string | null;
+    readonly completedDate: string | null;
+    readonly reminderDate: string | null;
+    readonly categories: readonly string[];
+}
+/**
+ * Default task content reader that returns null.
+ */
+export declare const nullTaskContentReader: ITaskContentReader;
+/**
+ * Tasks tools implementation with dependency injection.
+ */
+export declare class TasksTools {
+    private readonly repository;
+    private readonly contentReader;
+    constructor(repository: IRepository, contentReader?: ITaskContentReader);
+    /**
+     * Lists tasks with pagination and filtering.
+     */
+    listTasks(params: ListTasksParams): TaskSummary[];
+    /**
+     * Searches tasks by name.
+     */
+    searchTasks(params: SearchTasksParams): TaskSummary[];
+    /**
+     * Gets a single task by ID.
+     */
+    getTask(params: GetTaskParams): Task | null;
+}
+/**
+ * Creates tasks tools with the given repository.
+ */
+export declare function createTasksTools(repository: IRepository, contentReader?: ITaskContentReader): TasksTools;
+//# sourceMappingURL=tasks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAiB,MAAM,mBAAmB,CAAC;AAO1E,eAAO,MAAM,cAAc;;;;kBAUzB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;kBAS3B,CAAC;AAEH,eAAO,MAAM,YAAY;;kBAEvB,CAAC;AAMH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAMzD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,kBAEnC,CAAC;AAyCF;;GAEG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,UAAU,EAAE,WAAW,EACvB,aAAa,GAAE,kBAA0C;IAG5E;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,EAAE;IAUjD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,EAAE;IAMrD;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;CAW5C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,WAAW,EACvB,aAAa,GAAE,kBAA0C,GACxD,UAAU,CAEZ"}

package/dist/tools/tasks.js

@@ -0,0 +1,126 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Task-related MCP tools.
+ *
+ * Provides tools for listing, searching, and getting tasks.
+ */
+import { z } from 'zod';
+import { appleTimestampToIso } from '../utils/dates.js';
+// =============================================================================
+// Input Schemas
+// =============================================================================
+export const ListTasksInput = z.strictObject({
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe('Maximum number of tasks to return (1-100)'),
+    offset: z.number().int().min(0).default(0).describe('Number of tasks to skip'),
+    include_completed: z.boolean().default(true).describe('Include completed tasks'),
+});
+export const SearchTasksInput = z.strictObject({
+    query: z.string().min(1).describe('Search query for task names'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe('Maximum number of tasks to return (1-100)'),
+});
+export const GetTaskInput = z.strictObject({
+    task_id: z.number().int().positive().describe('The task ID to retrieve'),
+});
+/**
+ * Default task content reader that returns null.
+ */
+export const nullTaskContentReader = {
+    readTaskDetails: () => null,
+};
+// =============================================================================
+// Transformers
+// =============================================================================
+/**
+ * Transforms a database task row to TaskSummary.
+ */
+function transformTaskSummary(row) {
+    return {
+        id: row.id,
+        folderId: row.folderId,
+        name: row.name,
+        isCompleted: row.isCompleted === 1,
+        dueDate: appleTimestampToIso(row.dueDate),
+        priority: row.priority,
+    };
+}
+/**
+ * Transforms a database task row to full Task.
+ */
+function transformTask(row, details) {
+    const summary = transformTaskSummary(row);
+    return {
+        ...summary,
+        startDate: appleTimestampToIso(row.startDate),
+        completedDate: details?.completedDate ?? null,
+        hasReminder: row.hasReminder === 1,
+        reminderDate: details?.reminderDate ?? null,
+        body: details?.body ?? null,
+        categories: details?.categories ?? [],
+    };
+}
+// =============================================================================
+// Tasks Tools Class
+// =============================================================================
+/**
+ * Tasks tools implementation with dependency injection.
+ */
+export class TasksTools {
+    repository;
+    contentReader;
+    constructor(repository, contentReader = nullTaskContentReader) {
+        this.repository = repository;
+        this.contentReader = contentReader;
+    }
+    /**
+     * Lists tasks with pagination and filtering.
+     */
+    listTasks(params) {
+        const { limit, offset, include_completed } = params;
+        const rows = include_completed
+            ? this.repository.listTasks(limit, offset)
+            : this.repository.listIncompleteTasks(limit, offset);
+        return rows.map(transformTaskSummary);
+    }
+    /**
+     * Searches tasks by name.
+     */
+    searchTasks(params) {
+        const { query, limit } = params;
+        const rows = this.repository.searchTasks(query, limit);
+        return rows.map(transformTaskSummary);
+    }
+    /**
+     * Gets a single task by ID.
+     */
+    getTask(params) {
+        const { task_id } = params;
+        const row = this.repository.getTask(task_id);
+        if (row == null) {
+            return null;
+        }
+        const details = this.contentReader.readTaskDetails(row.dataFilePath);
+        return transformTask(row, details);
+    }
+}
+/**
+ * Creates tasks tools with the given repository.
+ */
+export function createTasksTools(repository, contentReader = nullTaskContentReader) {
+    return new TasksTools(repository, contentReader);
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tools/tasks.js.map

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