@jbctechsolutions/mcp-office365 2.5.1

package/dist/tools/calendar.js

@@ -0,0 +1,247 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Calendar-related MCP tools.
+ *
+ * Provides tools for listing calendars, events, and searching.
+ */
+import { z } from 'zod';
+import { appleTimestampToIso, isoToAppleTimestamp } from '../utils/dates.js';
+// =============================================================================
+// Input Schemas
+// =============================================================================
+export const ListCalendarsInput = z.strictObject({});
+export const ListEventsInput = z.strictObject({
+    calendar_id: z.number().int().positive().optional().describe('Optional calendar folder ID'),
+    start_date: z.string().optional().describe('Start date filter (ISO 8601 format)'),
+    end_date: z.string().optional().describe('End date filter (ISO 8601 format)'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe('Maximum number of events to return (1-100)'),
+});
+export const GetEventInput = z.strictObject({
+    event_id: z.number().int().positive().describe('The event ID to retrieve'),
+});
+export const SearchEventsInput = z.strictObject({
+    query: z.string().min(1).optional().describe('Search query for event titles'),
+    start_date: z.string().optional().describe('Start date filter (ISO 8601 format) - events starting on or after this date'),
+    end_date: z.string().optional().describe('End date filter (ISO 8601 format) - events ending on or before this date'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe('Maximum number of events to return (1-100)'),
+}).refine((data) => data.query != null || data.start_date != null || data.end_date != null, { message: 'At least one of query, start_date, or end_date must be provided' });
+export const RespondToEventInput = z.strictObject({
+    event_id: z.number().int().positive().describe('The event ID to respond to'),
+    response: z.enum(['accept', 'decline', 'tentative']).describe('Your response to the invitation'),
+    send_response: z.boolean().default(true).describe('Whether to send response to organizer'),
+    comment: z.string().optional().describe('Optional comment to include with response'),
+});
+const DayOfWeek = z.enum([
+    'sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday',
+]);
+const RecurrenceEndInput = z.discriminatedUnion('type', [
+    z.strictObject({ type: z.literal('no_end') }),
+    z.strictObject({
+        type: z.literal('end_date'),
+        date: z.string().describe('End date in ISO 8601 format'),
+    }),
+    z.strictObject({
+        type: z.literal('end_after_count'),
+        count: z.number().int().min(1).max(999).describe('Number of occurrences'),
+    }),
+]);
+export const RecurrenceInput = z.strictObject({
+    frequency: z.enum(['daily', 'weekly', 'monthly', 'yearly']).describe('How often the event repeats'),
+    interval: z.number().int().min(1).max(999).default(1).describe('Number of frequency units between occurrences (e.g., 2 for every 2 weeks)'),
+    days_of_week: z.array(DayOfWeek).min(1).optional().describe('Days of the week for weekly recurrence (e.g., ["monday", "wednesday"])'),
+    day_of_month: z.number().int().min(1).max(31).optional().describe('Day of the month for monthly recurrence (e.g., 15 for the 15th)'),
+    week_of_month: z.enum(['first', 'second', 'third', 'fourth', 'last']).optional().describe('Week of the month for ordinal monthly recurrence (e.g., "third" for 3rd Thursday)'),
+    day_of_week_monthly: DayOfWeek.optional().describe('Day of week for ordinal monthly recurrence (used with week_of_month)'),
+    end: RecurrenceEndInput.default({ type: 'no_end' }).describe('When the recurrence ends'),
+}).superRefine((data, ctx) => {
+    if (data.frequency === 'weekly' && (data.days_of_week == null || data.days_of_week.length === 0)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'days_of_week is required for weekly recurrence',
+            path: ['days_of_week'],
+        });
+    }
+    if (data.frequency === 'monthly') {
+        const hasOrdinal = data.week_of_month != null;
+        const hasDayOfWeekMonthly = data.day_of_week_monthly != null;
+        if (hasOrdinal !== hasDayOfWeekMonthly) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'week_of_month and day_of_week_monthly must both be provided for ordinal monthly recurrence',
+                path: ['week_of_month'],
+            });
+        }
+    }
+    if (data.frequency !== 'monthly') {
+        if (data.day_of_month != null || data.week_of_month != null || data.day_of_week_monthly != null) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'day_of_month, week_of_month, and day_of_week_monthly are only valid for monthly recurrence',
+                path: ['frequency'],
+            });
+        }
+    }
+    if (data.frequency !== 'weekly' && data.days_of_week != null) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'days_of_week is only valid for weekly recurrence',
+            path: ['days_of_week'],
+        });
+    }
+});
+const isoDateString = z
+    .string()
+    .refine((s) => !isNaN(Date.parse(s)), { message: 'Must be a valid ISO 8601 date string' });
+export const CreateEventInput = z.strictObject({
+    title: z.string().min(1).describe('Event title/subject'),
+    start_date: isoDateString.describe('Start date in ISO 8601 UTC format'),
+    end_date: isoDateString.describe('End date in ISO 8601 UTC format'),
+    calendar_id: z.number().int().positive().optional().describe('Optional calendar ID to create the event in'),
+    location: z.string().optional().describe('Event location'),
+    description: z.string().optional().describe('Event description/body text'),
+    is_all_day: z.boolean().optional().default(false).describe('Whether this is an all-day event'),
+    recurrence: RecurrenceInput.optional().describe('Recurrence pattern to make this a repeating event'),
+}).refine((data) => new Date(data.start_date).getTime() < new Date(data.end_date).getTime(), { message: 'start_date must be before end_date', path: ['start_date'] });
+/**
+ * Default event content reader that returns null.
+ */
+export const nullEventContentReader = {
+    readEventDetails: () => null,
+};
+// =============================================================================
+// Transformers
+// =============================================================================
+/**
+ * Transforms a database folder row to CalendarFolder.
+ */
+function transformCalendar(row) {
+    return {
+        id: row.id,
+        name: row.name ?? 'Unnamed',
+        accountId: row.accountId,
+    };
+}
+/**
+ * Transforms a database event row to EventSummary.
+ */
+function transformEventSummary(row, title = null) {
+    return {
+        id: row.id,
+        folderId: row.folderId,
+        title: title,
+        startDate: appleTimestampToIso(row.startDate),
+        endDate: appleTimestampToIso(row.endDate),
+        isRecurring: row.isRecurring === 1,
+        hasReminder: row.hasReminder === 1,
+        attendeeCount: row.attendeeCount,
+        uid: row.uid,
+    };
+}
+/**
+ * Transforms a database event row to full Event.
+ */
+function transformEvent(row, details) {
+    const summary = transformEventSummary(row, details?.title ?? null);
+    return {
+        ...summary,
+        location: details?.location ?? null,
+        description: details?.description ?? null,
+        organizer: details?.organizer ?? null,
+        attendees: details?.attendees ?? [],
+        masterRecordId: row.masterRecordId ?? null,
+        recurrenceId: row.recurrenceId ?? null,
+    };
+}
+// =============================================================================
+// Calendar Tools Class
+// =============================================================================
+/**
+ * Calendar tools implementation with dependency injection.
+ */
+export class CalendarTools {
+    repository;
+    contentReader;
+    constructor(repository, contentReader = nullEventContentReader) {
+        this.repository = repository;
+        this.contentReader = contentReader;
+    }
+    /**
+     * Lists all calendar folders.
+     */
+    listCalendars(_params) {
+        const rows = this.repository.listCalendars();
+        return rows.map(transformCalendar);
+    }
+    /**
+     * Lists events with optional filtering.
+     */
+    listEvents(params) {
+        const { calendar_id, start_date, end_date, limit } = params;
+        let rows;
+        if (start_date != null && end_date != null) {
+            const startTimestamp = isoToAppleTimestamp(start_date);
+            const endTimestamp = isoToAppleTimestamp(end_date);
+            if (startTimestamp != null && endTimestamp != null) {
+                rows = this.repository.listEventsByDateRange(startTimestamp, endTimestamp, limit);
+            }
+            else {
+                rows = this.repository.listEvents(limit);
+            }
+        }
+        else if (calendar_id != null) {
+            rows = this.repository.listEventsByFolder(calendar_id, limit);
+        }
+        else {
+            rows = this.repository.listEvents(limit);
+        }
+        return rows.map((row) => {
+            const details = this.contentReader.readEventDetails(row.dataFilePath);
+            return transformEventSummary(row, details?.title ?? null);
+        });
+    }
+    /**
+     * Gets a single event by ID.
+     */
+    getEvent(params) {
+        const { event_id } = params;
+        const row = this.repository.getEvent(event_id);
+        if (row == null) {
+            return null;
+        }
+        const details = this.contentReader.readEventDetails(row.dataFilePath);
+        return transformEvent(row, details);
+    }
+    /**
+     * Searches events by title and/or date range.
+     */
+    searchEvents(params) {
+        const { query, start_date, end_date, limit } = params;
+        const rows = this.repository.searchEvents(query ?? null, start_date ?? null, end_date ?? null, limit);
+        return rows.map((row) => {
+            const details = this.contentReader.readEventDetails(row.dataFilePath);
+            return transformEventSummary(row, details?.title ?? null);
+        });
+    }
+}
+/**
+ * Creates calendar tools with the given repository.
+ */
+export function createCalendarTools(repository, contentReader = nullEventContentReader) {
+    return new CalendarTools(repository, contentReader);
+}
+//# sourceMappingURL=calendar.js.map

package/dist/tools/calendar.js.map

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

package/dist/tools/categories.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Master category management MCP tools.
+ *
+ * Provides tools for managing Outlook master categories with a two-phase
+ * approval pattern for destructive delete operations.
+ */
+import { z } from 'zod';
+import type { ApprovalTokenManager } from '../approval/index.js';
+export declare const CreateCategoryInput: z.ZodObject<{
+    name: z.ZodString;
+    color: z.ZodEnum<{
+        none: "none";
+        preset0: "preset0";
+        preset1: "preset1";
+        preset2: "preset2";
+        preset3: "preset3";
+        preset4: "preset4";
+        preset5: "preset5";
+        preset6: "preset6";
+        preset7: "preset7";
+        preset8: "preset8";
+        preset9: "preset9";
+        preset10: "preset10";
+        preset11: "preset11";
+        preset12: "preset12";
+        preset13: "preset13";
+        preset14: "preset14";
+        preset15: "preset15";
+        preset16: "preset16";
+        preset17: "preset17";
+        preset18: "preset18";
+        preset19: "preset19";
+        preset20: "preset20";
+        preset21: "preset21";
+        preset22: "preset22";
+        preset23: "preset23";
+        preset24: "preset24";
+    }>;
+}, z.core.$strict>;
+export declare const PrepareDeleteCategoryInput: z.ZodObject<{
+    category_id: z.ZodNumber;
+}, z.core.$strict>;
+export declare const ConfirmDeleteCategoryInput: z.ZodObject<{
+    approval_token: z.ZodString;
+}, z.core.$strict>;
+export type CreateCategoryParams = z.infer<typeof CreateCategoryInput>;
+export type PrepareDeleteCategoryParams = z.infer<typeof PrepareDeleteCategoryInput>;
+export type ConfirmDeleteCategoryParams = z.infer<typeof ConfirmDeleteCategoryInput>;
+export interface ICategoriesRepository {
+    listCategoriesAsync(): Promise<Array<{
+        id: number;
+        name: string;
+        color: string;
+    }>>;
+    createCategoryAsync(name: string, color: string): Promise<number>;
+    deleteCategoryAsync(categoryId: number): Promise<void>;
+}
+/**
+ * Master category tools with two-phase approval for delete operations.
+ */
+export declare class CategoriesTools {
+    private readonly repo;
+    private readonly tokenManager;
+    constructor(repo: ICategoriesRepository, tokenManager: ApprovalTokenManager);
+    listCategories(): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    createCategory(params: CreateCategoryParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    prepareDeleteCategory(params: PrepareDeleteCategoryParams): {
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    };
+    confirmDeleteCategory(params: ConfirmDeleteCategoryParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=categories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/tools/categories.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,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAG9B,CAAC;AAEH,eAAO,MAAM,0BAA0B;;kBAErC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;kBAErC,CAAC;AAMH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACvE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AACrF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAMrF,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACnF,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAMD;;GAEG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,IAAI,EAAE,qBAAqB,EAC3B,YAAY,EAAE,oBAAoB;IAG/C,cAAc,IAAI,OAAO,CAAC;QAC9B,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC;IAUI,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAC1D,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC;IAUF,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG;QAC1D,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD;IAqBK,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC;QACxE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC;CA2CH"}

package/dist/tools/categories.js

@@ -0,0 +1,117 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Master category management MCP tools.
+ *
+ * Provides tools for managing Outlook master categories with a two-phase
+ * approval pattern for destructive delete operations.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Input Schemas
+// =============================================================================
+export const CreateCategoryInput = z.strictObject({
+    name: z.string().min(1).describe('Category name'),
+    color: z.enum(['preset0', 'preset1', 'preset2', 'preset3', 'preset4', 'preset5', 'preset6', 'preset7', 'preset8', 'preset9', 'preset10', 'preset11', 'preset12', 'preset13', 'preset14', 'preset15', 'preset16', 'preset17', 'preset18', 'preset19', 'preset20', 'preset21', 'preset22', 'preset23', 'preset24', 'none']).describe('Category color preset'),
+});
+export const PrepareDeleteCategoryInput = z.strictObject({
+    category_id: z.number().int().positive().describe('Category ID to delete'),
+});
+export const ConfirmDeleteCategoryInput = z.strictObject({
+    approval_token: z.string().describe('Approval token from prepare_delete_category'),
+});
+// =============================================================================
+// Categories Tools
+// =============================================================================
+/**
+ * Master category tools with two-phase approval for delete operations.
+ */
+export class CategoriesTools {
+    repo;
+    tokenManager;
+    constructor(repo, tokenManager) {
+        this.repo = repo;
+        this.tokenManager = tokenManager;
+    }
+    async listCategories() {
+        const categories = await this.repo.listCategoriesAsync();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ categories }, null, 2),
+                }],
+        };
+    }
+    async createCategory(params) {
+        const categoryId = await this.repo.createCategoryAsync(params.name, params.color);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, category_id: categoryId, message: 'Category created' }, null, 2),
+                }],
+        };
+    }
+    prepareDeleteCategory(params) {
+        const token = this.tokenManager.generateToken({
+            operation: 'delete_category',
+            targetType: 'category',
+            targetId: params.category_id,
+            targetHash: String(params.category_id),
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        approval_token: token.tokenId,
+                        expires_at: new Date(token.expiresAt).toISOString(),
+                        category_id: params.category_id,
+                        action: `To confirm deleting category ${params.category_id}, call confirm_delete_category with the approval_token.`,
+                    }, null, 2),
+                }],
+        };
+    }
+    async confirmDeleteCategory(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_category', token.targetId);
+        if (!result.valid) {
+            const errorMessages = {
+                NOT_FOUND: 'Token not found or already used',
+                EXPIRED: 'Token has expired. Please call prepare_delete_category again.',
+                OPERATION_MISMATCH: 'Token was not generated for delete_category',
+                TARGET_MISMATCH: 'Token was generated for a different category',
+                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.deleteCategoryAsync(result.token.targetId);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, message: 'Category deleted' }, null, 2),
+                }],
+        };
+    }
+}
+//# sourceMappingURL=categories.js.map

package/dist/tools/categories.js.map

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

package/dist/tools/checklist-items.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Checklist Item (subtask) MCP tools for Microsoft To Do.
+ *
+ * Provides tools for managing checklist items 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 ListChecklistItemsInput: z.ZodObject<{
+    task_id: z.ZodNumber;
+}, z.core.$strict>;
+export declare const CreateChecklistItemInput: z.ZodObject<{
+    task_id: z.ZodNumber;
+    display_name: z.ZodString;
+    is_checked: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const UpdateChecklistItemInput: z.ZodObject<{
+    checklist_item_id: z.ZodNumber;
+    display_name: z.ZodOptional<z.ZodString>;
+    is_checked: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const PrepareDeleteChecklistItemInput: z.ZodObject<{
+    checklist_item_id: z.ZodNumber;
+}, z.core.$strict>;
+export declare const ConfirmDeleteChecklistItemInput: z.ZodObject<{
+    approval_token: z.ZodString;
+}, z.core.$strict>;
+export type ListChecklistItemsParams = z.infer<typeof ListChecklistItemsInput>;
+export type CreateChecklistItemParams = z.infer<typeof CreateChecklistItemInput>;
+export type UpdateChecklistItemParams = z.infer<typeof UpdateChecklistItemInput>;
+export type PrepareDeleteChecklistItemParams = z.infer<typeof PrepareDeleteChecklistItemInput>;
+export type ConfirmDeleteChecklistItemParams = z.infer<typeof ConfirmDeleteChecklistItemInput>;
+export interface IChecklistItemsRepository {
+    listChecklistItemsAsync(taskId: number): Promise<Array<{
+        id: number;
+        displayName: string;
+        isChecked: boolean;
+        createdDateTime: string;
+    }>>;
+    createChecklistItemAsync(taskId: number, displayName: string, isChecked?: boolean): Promise<number>;
+    updateChecklistItemAsync(checklistItemId: number, updates: {
+        displayName?: string;
+        isChecked?: boolean;
+    }): Promise<void>;
+    deleteChecklistItemAsync(checklistItemId: number): Promise<void>;
+}
+/**
+ * Checklist item tools with two-phase approval for delete operations.
+ */
+export declare class ChecklistItemsTools {
+    private readonly repo;
+    private readonly tokenManager;
+    constructor(repo: IChecklistItemsRepository, tokenManager: ApprovalTokenManager);
+    listChecklistItems(params: ListChecklistItemsParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    createChecklistItem(params: CreateChecklistItemParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    updateChecklistItem(params: UpdateChecklistItemParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    prepareDeleteChecklistItem(params: PrepareDeleteChecklistItemParams): {
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    };
+    confirmDeleteChecklistItem(params: ConfirmDeleteChecklistItemParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=checklist-items.d.ts.map

package/dist/tools/checklist-items.d.ts.map

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