@jbctechsolutions/mcp-office365 2.5.1

package/dist/tools/checklist-items.js

@@ -0,0 +1,140 @@
+/**
+ * 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';
+// =============================================================================
+// Input Schemas
+// =============================================================================
+export const ListChecklistItemsInput = z.strictObject({
+    task_id: z.number().int().positive().describe('Task ID from list_tasks or search_tasks'),
+});
+export const CreateChecklistItemInput = z.strictObject({
+    task_id: z.number().int().positive().describe('Task ID'),
+    display_name: z.string().min(1).describe('Checklist item text'),
+    is_checked: z.boolean().optional().describe('Whether the item is checked (default: false)'),
+});
+export const UpdateChecklistItemInput = z.strictObject({
+    checklist_item_id: z.number().int().positive().describe('Checklist item ID'),
+    display_name: z.string().min(1).optional().describe('New text'),
+    is_checked: z.boolean().optional().describe('Toggle checked state'),
+});
+export const PrepareDeleteChecklistItemInput = z.strictObject({
+    checklist_item_id: z.number().int().positive().describe('Checklist item ID to delete'),
+});
+export const ConfirmDeleteChecklistItemInput = z.strictObject({
+    approval_token: z.string().describe('Approval token from prepare_delete_checklist_item'),
+});
+// =============================================================================
+// Checklist Items Tools
+// =============================================================================
+/**
+ * Checklist item tools with two-phase approval for delete operations.
+ */
+export class ChecklistItemsTools {
+    repo;
+    tokenManager;
+    constructor(repo, tokenManager) {
+        this.repo = repo;
+        this.tokenManager = tokenManager;
+    }
+    async listChecklistItems(params) {
+        const items = await this.repo.listChecklistItemsAsync(params.task_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ checklist_items: items }, null, 2),
+                }],
+        };
+    }
+    async createChecklistItem(params) {
+        const itemId = await this.repo.createChecklistItemAsync(params.task_id, params.display_name, params.is_checked);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, checklist_item_id: itemId, message: 'Checklist item created' }, null, 2),
+                }],
+        };
+    }
+    async updateChecklistItem(params) {
+        const updates = {};
+        if (params.display_name != null)
+            updates.displayName = params.display_name;
+        if (params.is_checked != null)
+            updates.isChecked = params.is_checked;
+        await this.repo.updateChecklistItemAsync(params.checklist_item_id, updates);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, message: 'Checklist item updated' }, null, 2),
+                }],
+        };
+    }
+    prepareDeleteChecklistItem(params) {
+        const token = this.tokenManager.generateToken({
+            operation: 'delete_checklist_item',
+            targetType: 'checklist_item',
+            targetId: params.checklist_item_id,
+            targetHash: String(params.checklist_item_id),
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        approval_token: token.tokenId,
+                        expires_at: new Date(token.expiresAt).toISOString(),
+                        checklist_item_id: params.checklist_item_id,
+                        action: `To confirm deleting checklist item ${params.checklist_item_id}, call confirm_delete_checklist_item with the approval_token.`,
+                    }, null, 2),
+                }],
+        };
+    }
+    async confirmDeleteChecklistItem(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_checklist_item', token.targetId);
+        if (!result.valid) {
+            const errorMessages = {
+                NOT_FOUND: 'Token not found or already used',
+                EXPIRED: 'Token has expired. Please call prepare_delete_checklist_item again.',
+                OPERATION_MISMATCH: 'Token was not generated for delete_checklist_item',
+                TARGET_MISMATCH: 'Token was generated for a different checklist item',
+                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.deleteChecklistItemAsync(result.token.targetId);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, message: 'Checklist item deleted' }, null, 2),
+                }],
+        };
+    }
+}
+//# sourceMappingURL=checklist-items.js.map

package/dist/tools/checklist-items.js.map

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

package/dist/tools/contacts.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.
+ */
+/**
+ * Contact-related MCP tools.
+ *
+ * Provides tools for listing and searching contacts.
+ */
+import { z } from 'zod';
+import type { IRepository } from '../database/repository.js';
+import type { ContactSummary, Contact } from '../types/index.js';
+export declare const ListContactsInput: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    folder_id: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const SearchContactsInput: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const GetContactInput: z.ZodObject<{
+    contact_id: z.ZodNumber;
+}, z.core.$strict>;
+export type ListContactsParams = z.infer<typeof ListContactsInput>;
+export type SearchContactsParams = z.infer<typeof SearchContactsInput>;
+export type GetContactParams = z.infer<typeof GetContactInput>;
+/**
+ * Interface for reading contact content from data files.
+ */
+export interface IContactContentReader {
+    /**
+     * Reads contact details from the given data file path.
+     */
+    readContactDetails(dataFilePath: string | null): ContactDetails | null;
+}
+/**
+ * Contact details from content file.
+ */
+export interface ContactDetails {
+    readonly firstName: string | null;
+    readonly lastName: string | null;
+    readonly middleName: string | null;
+    readonly nickname: string | null;
+    readonly company: string | null;
+    readonly jobTitle: string | null;
+    readonly department: string | null;
+    readonly emails: readonly {
+        type: string;
+        address: string;
+    }[];
+    readonly phones: readonly {
+        type: string;
+        number: string;
+    }[];
+    readonly addresses: readonly {
+        type: string;
+        street: string | null;
+        city: string | null;
+        state: string | null;
+        postalCode: string | null;
+        country: string | null;
+    }[];
+    readonly notes: string | null;
+}
+/**
+ * Default contact content reader that returns null.
+ */
+export declare const nullContactContentReader: IContactContentReader;
+/**
+ * Contacts tools implementation with dependency injection.
+ */
+export declare class ContactsTools {
+    private readonly repository;
+    private readonly contentReader;
+    constructor(repository: IRepository, contentReader?: IContactContentReader);
+    /**
+     * Lists contacts with pagination.
+     */
+    listContacts(params: ListContactsParams): ContactSummary[];
+    /**
+     * Searches contacts by name.
+     */
+    searchContacts(params: SearchContactsParams): ContactSummary[];
+    /**
+     * Gets a single contact by ID.
+     */
+    getContact(params: GetContactParams): Contact | null;
+}
+/**
+ * Creates contacts tools with the given repository.
+ */
+export declare function createContactsTools(repository: IRepository, contentReader?: IContactContentReader): ContactsTools;
+//# sourceMappingURL=contacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/tools/contacts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAoB,MAAM,mBAAmB,CAAC;AAMnF,eAAO,MAAM,iBAAiB;;;;kBAU5B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;kBAS9B,CAAC;AAEH,eAAO,MAAM,eAAe;;kBAE1B,CAAC;AAMH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACnE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACvE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAM/D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,GAAG,IAAI,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7D,QAAQ,CAAC,SAAS,EAAE,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,EAAE,CAAC;IACJ,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,qBAEtC,CAAC;AAoDF;;GAEG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,UAAU,EAAE,WAAW,EACvB,aAAa,GAAE,qBAAgD;IAGlF;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,EAAE;IAM1D;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,EAAE;IAM9D;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,GAAG,IAAI;CAWrD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,WAAW,EACvB,aAAa,GAAE,qBAAgD,GAC9D,aAAa,CAEf"}

package/dist/tools/contacts.js

@@ -0,0 +1,134 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Contact-related MCP tools.
+ *
+ * Provides tools for listing and searching contacts.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Input Schemas
+// =============================================================================
+export const ListContactsInput = z.strictObject({
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe('Maximum number of contacts to return (1-100)'),
+    offset: z.number().int().min(0).default(0).describe('Number of contacts to skip'),
+    folder_id: z.number().int().positive().optional().describe('Filter contacts by contact folder ID'),
+});
+export const SearchContactsInput = z.strictObject({
+    query: z.string().min(1).describe('Search query for contact names'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe('Maximum number of contacts to return (1-100)'),
+});
+export const GetContactInput = z.strictObject({
+    contact_id: z.number().int().positive().describe('The contact ID to retrieve'),
+});
+/**
+ * Default contact content reader that returns null.
+ */
+export const nullContactContentReader = {
+    readContactDetails: () => null,
+};
+// =============================================================================
+// Transformers
+// =============================================================================
+/**
+ * Transforms a database contact row to ContactSummary.
+ */
+function transformContactSummary(row) {
+    return {
+        id: row.id,
+        folderId: row.folderId,
+        displayName: row.displayName,
+        sortName: row.sortName,
+        contactType: (row.contactType ?? 0),
+    };
+}
+/**
+ * Transforms a database contact row to full Contact.
+ */
+function transformContact(row, details) {
+    const summary = transformContactSummary(row);
+    return {
+        ...summary,
+        firstName: details?.firstName ?? null,
+        lastName: details?.lastName ?? null,
+        middleName: details?.middleName ?? null,
+        nickname: details?.nickname ?? null,
+        company: details?.company ?? null,
+        jobTitle: details?.jobTitle ?? null,
+        department: details?.department ?? null,
+        emails: details?.emails?.map((e) => ({ type: e.type, address: e.address })) ?? [],
+        phones: details?.phones?.map((p) => ({ type: p.type, number: p.number })) ?? [],
+        addresses: details?.addresses?.map((a) => ({
+            type: a.type,
+            street: a.street,
+            city: a.city,
+            state: a.state,
+            postalCode: a.postalCode,
+            country: a.country,
+        })) ?? [],
+        notes: details?.notes ?? null,
+    };
+}
+// =============================================================================
+// Contacts Tools Class
+// =============================================================================
+/**
+ * Contacts tools implementation with dependency injection.
+ */
+export class ContactsTools {
+    repository;
+    contentReader;
+    constructor(repository, contentReader = nullContactContentReader) {
+        this.repository = repository;
+        this.contentReader = contentReader;
+    }
+    /**
+     * Lists contacts with pagination.
+     */
+    listContacts(params) {
+        const { limit, offset } = params;
+        const rows = this.repository.listContacts(limit, offset);
+        return rows.map(transformContactSummary);
+    }
+    /**
+     * Searches contacts by name.
+     */
+    searchContacts(params) {
+        const { query, limit } = params;
+        const rows = this.repository.searchContacts(query, limit);
+        return rows.map(transformContactSummary);
+    }
+    /**
+     * Gets a single contact by ID.
+     */
+    getContact(params) {
+        const { contact_id } = params;
+        const row = this.repository.getContact(contact_id);
+        if (row == null) {
+            return null;
+        }
+        const details = this.contentReader.readContactDetails(row.dataFilePath);
+        return transformContact(row, details);
+    }
+}
+/**
+ * Creates contacts tools with the given repository.
+ */
+export function createContactsTools(repository, contentReader = nullContactContentReader) {
+    return new ContactsTools(repository, contentReader);
+}
+//# sourceMappingURL=contacts.js.map

package/dist/tools/contacts.js.map

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

package/dist/tools/excel.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Excel Online (Workbook) MCP tools.
+ *
+ * Provides tools for reading and updating Excel workbooks stored in OneDrive
+ * or SharePoint via the Microsoft Graph API, with two-phase approval for
+ * range update operations.
+ */
+import { z } from 'zod';
+import type { ApprovalTokenManager } from '../approval/index.js';
+export declare const ListWorksheetsInput: z.ZodObject<{
+    file_id: z.ZodNumber;
+}, z.core.$strict>;
+export declare const GetWorksheetRangeInput: z.ZodObject<{
+    file_id: z.ZodNumber;
+    worksheet_name: z.ZodString;
+    range: z.ZodString;
+}, z.core.$strict>;
+export declare const GetUsedRangeInput: z.ZodObject<{
+    file_id: z.ZodNumber;
+    worksheet_name: z.ZodString;
+}, z.core.$strict>;
+export declare const PrepareUpdateRangeInput: z.ZodObject<{
+    file_id: z.ZodNumber;
+    worksheet_name: z.ZodString;
+    range: z.ZodString;
+    values: z.ZodArray<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strict>;
+export declare const ConfirmUpdateRangeInput: z.ZodObject<{
+    approval_token: z.ZodString;
+}, z.core.$strict>;
+export declare const GetTableDataInput: z.ZodObject<{
+    file_id: z.ZodNumber;
+    table_name: z.ZodString;
+}, z.core.$strict>;
+export type ListWorksheetsParams = z.infer<typeof ListWorksheetsInput>;
+export type GetWorksheetRangeParams = z.infer<typeof GetWorksheetRangeInput>;
+export type GetUsedRangeParams = z.infer<typeof GetUsedRangeInput>;
+export type PrepareUpdateRangeParams = z.infer<typeof PrepareUpdateRangeInput>;
+export type ConfirmUpdateRangeParams = z.infer<typeof ConfirmUpdateRangeInput>;
+export type GetTableDataParams = z.infer<typeof GetTableDataInput>;
+export interface IExcelRepository {
+    listWorksheetsAsync(fileId: number): Promise<Record<string, unknown>[]>;
+    getWorksheetRangeAsync(fileId: number, worksheetName: string, range: string): Promise<Record<string, unknown>>;
+    getUsedRangeAsync(fileId: number, worksheetName: string): Promise<Record<string, unknown>>;
+    updateWorksheetRangeAsync(fileId: number, worksheetName: string, range: string, values: unknown[][]): Promise<Record<string, unknown>>;
+    getTableDataAsync(fileId: number, tableName: string): Promise<Record<string, unknown>[]>;
+}
+/**
+ * Excel Online tools with two-phase approval for range updates.
+ */
+export declare class ExcelTools {
+    private readonly repo;
+    private readonly tokenManager;
+    constructor(repo: IExcelRepository, tokenManager: ApprovalTokenManager);
+    listWorksheets(params: ListWorksheetsParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    getWorksheetRange(params: GetWorksheetRangeParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    getUsedRange(params: GetUsedRangeParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    getTableData(params: GetTableDataParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+    prepareUpdateRange(params: PrepareUpdateRangeParams): {
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    };
+    confirmUpdateRange(params: ConfirmUpdateRangeParams): Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=excel.d.ts.map

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

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

package/dist/tools/excel.js

@@ -0,0 +1,165 @@
+/**
+ * Copyright (c) 2026 JBC Tech Solutions, LLC
+ * Licensed under the MIT License. See LICENSE file in the project root.
+ */
+/**
+ * Excel Online (Workbook) MCP tools.
+ *
+ * Provides tools for reading and updating Excel workbooks stored in OneDrive
+ * or SharePoint via the Microsoft Graph API, with two-phase approval for
+ * range update operations.
+ */
+import { z } from 'zod';
+// =============================================================================
+// Input Schemas
+// =============================================================================
+export const ListWorksheetsInput = z.strictObject({
+    file_id: z.number().describe('Numeric ID of the Excel file (from OneDrive or SharePoint)'),
+});
+export const GetWorksheetRangeInput = z.strictObject({
+    file_id: z.number().describe('Numeric ID of the Excel file (from OneDrive or SharePoint)'),
+    worksheet_name: z.string().describe('Name of the worksheet'),
+    range: z.string().describe('Cell range e.g. "A1:D10"'),
+});
+export const GetUsedRangeInput = z.strictObject({
+    file_id: z.number().describe('Numeric ID of the Excel file (from OneDrive or SharePoint)'),
+    worksheet_name: z.string().describe('Name of the worksheet'),
+});
+export const PrepareUpdateRangeInput = z.strictObject({
+    file_id: z.number().describe('Numeric ID of the Excel file (from OneDrive or SharePoint)'),
+    worksheet_name: z.string().describe('Name of the worksheet'),
+    range: z.string().describe('Cell range e.g. "A1:D10"'),
+    values: z.array(z.array(z.unknown())).describe('2D array of cell values'),
+});
+export const ConfirmUpdateRangeInput = z.strictObject({
+    approval_token: z.string().describe('Approval token from prepare_update_range'),
+});
+export const GetTableDataInput = z.strictObject({
+    file_id: z.number().describe('Numeric ID of the Excel file (from OneDrive or SharePoint)'),
+    table_name: z.string().describe('Name of the Excel table'),
+});
+// =============================================================================
+// Excel Tools
+// =============================================================================
+/**
+ * Excel Online tools with two-phase approval for range updates.
+ */
+export class ExcelTools {
+    repo;
+    tokenManager;
+    constructor(repo, tokenManager) {
+        this.repo = repo;
+        this.tokenManager = tokenManager;
+    }
+    async listWorksheets(params) {
+        const worksheets = await this.repo.listWorksheetsAsync(params.file_id);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ worksheets }, null, 2),
+                }],
+        };
+    }
+    async getWorksheetRange(params) {
+        const range = await this.repo.getWorksheetRangeAsync(params.file_id, params.worksheet_name, params.range);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ range }, null, 2),
+                }],
+        };
+    }
+    async getUsedRange(params) {
+        const range = await this.repo.getUsedRangeAsync(params.file_id, params.worksheet_name);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ range }, null, 2),
+                }],
+        };
+    }
+    async getTableData(params) {
+        const rows = await this.repo.getTableDataAsync(params.file_id, params.table_name);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ rows }, null, 2),
+                }],
+        };
+    }
+    prepareUpdateRange(params) {
+        const token = this.tokenManager.generateToken({
+            operation: 'update_excel_range',
+            targetType: 'excel_range',
+            targetId: params.file_id,
+            targetHash: `${params.file_id}:${params.worksheet_name}:${params.range}`,
+            metadata: {
+                worksheet_name: params.worksheet_name,
+                range: params.range,
+                values: params.values,
+            },
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        approval_token: token.tokenId,
+                        expires_at: new Date(token.expiresAt).toISOString(),
+                        file_id: params.file_id,
+                        worksheet_name: params.worksheet_name,
+                        range: params.range,
+                        cell_count: params.values.reduce((sum, row) => sum + row.length, 0),
+                        action: `To confirm updating range ${params.range} in worksheet "${params.worksheet_name}", call confirm_update_range with the approval_token.`,
+                    }, null, 2),
+                }],
+        };
+    }
+    async confirmUpdateRange(params) {
+        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, 'update_excel_range', token.targetId);
+        if (!result.valid) {
+            const errorMessages = {
+                NOT_FOUND: 'Token not found or already used',
+                EXPIRED: 'Token has expired. Please call prepare_update_range again.',
+                OPERATION_MISMATCH: 'Token was not generated for update_excel_range',
+                TARGET_MISMATCH: 'Token was generated for a different file',
+                ALREADY_CONSUMED: 'Token has already been used',
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: errorMessages[result.error ?? ''] ?? 'Invalid token',
+                        }, null, 2),
+                    }],
+            };
+        }
+        const metadata = result.token.metadata;
+        const worksheetName = metadata['worksheet_name'];
+        const range = metadata['range'];
+        const values = metadata['values'];
+        await this.repo.updateWorksheetRangeAsync(result.token.targetId, worksheetName, range, values);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: `Range ${range} in worksheet "${worksheetName}" updated successfully`,
+                    }, null, 2),
+                }],
+        };
+    }
+}
+//# sourceMappingURL=excel.js.map