@juvantlabs/m365-graph-mcp-server 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * M365 Graph MCP Server — entrypoint.
+ *
+ * Two modes, dispatched on argv[2]:
+ *   - `setup`: interactive OAuth flow → caches tokens in OS keychain
+ *   - (default): stdio MCP server → reads cached tokens, serves tool
+ *     calls over JSON-RPC framing
+ *
+ * Conforms to handbook docs/repo-types/mcp-server.md.
+ *
+ * IMPORTANT: All non-protocol output must go to stderr (`console.error`).
+ * Writing to stdout corrupts the MCP stdio JSON-RPC framing. CI lint
+ * rules enforce this in `juvantlabs/*-mcp-server` repos.
+ */
+import { ALL_TOOLS } from "./tools/index.js";
+export declare const TENANT_ID_RE: RegExp;
+/**
+ * Validate the env vars the server needs at startup. Throws with a
+ * specific message on failure; main() catches + exits with stderr +
+ * code 1.
+ *
+ * Exported so tests can call directly with a fake env.
+ */
+export declare function checkEnv(env?: NodeJS.ProcessEnv): void;
+/**
+ * Execute a single tools/call request against the registered handler
+ * map. Wraps handler errors in an `isError: true` MCP response so the
+ * agent sees a structured failure instead of a thrown exception that
+ * tears down the JSON-RPC session.
+ *
+ * Exported for unit testing without spinning up the full MCP transport.
+ */
+export declare function dispatchToolCall(graph: import("@microsoft/microsoft-graph-client").Client, handlers: Map<string, (typeof ALL_TOOLS)[number]["handler"]>, request: {
+    params: {
+        name: string;
+        arguments?: unknown;
+    };
+}): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+/**
+ * Subcommand dispatcher. Exported so tests can verify routing without
+ * actually spawning the server.
+ */
+export declare function dispatch(argv: string[], handlers: {
+    setup: () => Promise<void>;
+    serve: () => Promise<void>;
+}): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AAYH,OAAO,EAAE,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,YAAY,QAC0E,CAAC;AAEpG;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAgBnE;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,mCAAmC,EAAE,MAAM,EACzD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAC5D,OAAO,EAAE;IAAE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACzD,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAmBhF;AAiCD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE;IACvD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhB"}

package/dist/index.js

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+/**
+ * M365 Graph MCP Server — entrypoint.
+ *
+ * Two modes, dispatched on argv[2]:
+ *   - `setup`: interactive OAuth flow → caches tokens in OS keychain
+ *   - (default): stdio MCP server → reads cached tokens, serves tool
+ *     calls over JSON-RPC framing
+ *
+ * Conforms to handbook docs/repo-types/mcp-server.md.
+ *
+ * IMPORTANT: All non-protocol output must go to stderr (`console.error`).
+ * Writing to stdout corrupts the MCP stdio JSON-RPC framing. CI lint
+ * rules enforce this in `juvantlabs/*-mcp-server` repos.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { makeMsalClient } from "./auth/msal.js";
+import { runSetup } from "./auth/setup.js";
+import { makeGraphClient } from "./client/graph.js";
+import { ALL_TOOLS, buildHandlerMap } from "./tools/index.js";
+export const TENANT_ID_RE = /^(common|organizations|consumers|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/;
+/**
+ * Validate the env vars the server needs at startup. Throws with a
+ * specific message on failure; main() catches + exits with stderr +
+ * code 1.
+ *
+ * Exported so tests can call directly with a fake env.
+ */
+export function checkEnv(env = process.env) {
+    const missing = [];
+    if (!env.M365_CLIENT_ID)
+        missing.push("M365_CLIENT_ID");
+    if (!env.M365_CLIENT_SECRET)
+        missing.push("M365_CLIENT_SECRET");
+    if (!env.M365_TENANT_ID)
+        missing.push("M365_TENANT_ID");
+    if (missing.length > 0) {
+        throw new Error(`missing required env var(s): ${missing.join(", ")}. See README.md § Environment variables.`);
+    }
+    if (!TENANT_ID_RE.test(env.M365_TENANT_ID)) {
+        throw new Error(`M365_TENANT_ID has invalid shape: ${env.M365_TENANT_ID}. ` +
+            `Expected: 'common' | 'organizations' | 'consumers' | <UUID>.`);
+    }
+}
+/**
+ * Execute a single tools/call request against the registered handler
+ * map. Wraps handler errors in an `isError: true` MCP response so the
+ * agent sees a structured failure instead of a thrown exception that
+ * tears down the JSON-RPC session.
+ *
+ * Exported for unit testing without spinning up the full MCP transport.
+ */
+export async function dispatchToolCall(graph, handlers, request) {
+    const { name, arguments: rawArgs } = request.params;
+    const handler = handlers.get(name);
+    if (!handler) {
+        throw new Error(`Unknown tool: ${name}`);
+    }
+    const args = (rawArgs ?? {});
+    try {
+        return (await handler(graph, args));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+}
+async function runMcpServer() {
+    const msal = makeMsalClient();
+    const graph = makeGraphClient(msal);
+    const handlers = buildHandlerMap(ALL_TOOLS);
+    const logLevel = process.env.MCP_SERVER_LOG_LEVEL ?? "info";
+    const server = new Server({
+        name: "@juvantlabs/m365-graph-mcp-server",
+        version: "0.1.0",
+    }, {
+        capabilities: { tools: {} },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: ALL_TOOLS.map((t) => t.definition),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => dispatchToolCall(graph, handlers, request));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`[m365-graph-mcp-server] running on stdio (log level: ${logLevel}, tenant: ${process.env.M365_TENANT_ID}, tools: ${ALL_TOOLS.length})`);
+}
+/**
+ * Subcommand dispatcher. Exported so tests can verify routing without
+ * actually spawning the server.
+ */
+export async function dispatch(argv, handlers) {
+    const subcommand = argv[2];
+    if (subcommand === "setup") {
+        await handlers.setup();
+        return;
+    }
+    await handlers.serve();
+}
+async function main() {
+    try {
+        checkEnv();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`[m365-graph-mcp-server] ${message}`);
+        process.exit(1);
+    }
+    await dispatch(process.argv, {
+        setup: runSetup,
+        serve: runMcpServer,
+    });
+}
+// Only run main when invoked directly. Importing the module from tests
+// or other code does NOT trigger startup.
+const invokedDirectly = import.meta.url === `file://${process.argv[1]}` ||
+    // Also handle the tsx/node ESM case where argv[1] is the original .ts
+    import.meta.url.endsWith(process.argv[1] ?? "") ||
+    process.argv[1]?.endsWith("src/index.ts") === true ||
+    process.argv[1]?.endsWith("dist/index.js") === true;
+if (invokedDirectly) {
+    main().catch((err) => {
+        console.error("[m365-graph-mcp-server] fatal:", err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/cancel_event.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tool: m365-graph:cancel_event
+ *
+ * Cancel a meeting the user organizes. Sends a cancellation notice
+ * to attendees. Two-phase spec/approval pattern (see delete_file
+ * for the rationale): preview + confirmation_token, then execute.
+ *
+ * Note: this is for events the *user* organizes. For events where
+ * the user is just an attendee, the right action is to *decline*
+ * via Outlook (different Graph endpoint, not yet wrapped here).
+ * Calling cancel_event on a non-organized event will produce a
+ * clear Graph error.
+ *
+ * Required Graph scope: `Calendars.ReadWrite` (delegated).
+ */
+import type { Tool } from "../types/tool.js";
+export declare const cancelEventTool: Tool;
+//# sourceMappingURL=cancel_event.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cancel_event.d.ts","sourceRoot":"","sources":["../../src/tools/cancel_event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH,OAAO,KAAK,EAAE,IAAI,EAA6C,MAAM,kBAAkB,CAAC;AAqGxF,eAAO,MAAM,eAAe,EAAE,IAA8B,CAAC"}

package/dist/tools/cancel_event.js

@@ -0,0 +1,95 @@
+/**
+ * Tool: m365-graph:cancel_event
+ *
+ * Cancel a meeting the user organizes. Sends a cancellation notice
+ * to attendees. Two-phase spec/approval pattern (see delete_file
+ * for the rationale): preview + confirmation_token, then execute.
+ *
+ * Note: this is for events the *user* organizes. For events where
+ * the user is just an attendee, the right action is to *decline*
+ * via Outlook (different Graph endpoint, not yet wrapped here).
+ * Calling cancel_event on a non-organized event will produce a
+ * clear Graph error.
+ *
+ * Required Graph scope: `Calendars.ReadWrite` (delegated).
+ */
+import { consumeConfirmation, issueConfirmation, } from "../auth/confirmation_tokens.js";
+import { summarizeEvent } from "./list_events.js";
+import { validateOptionalString, validateRequiredString, } from "../types/validators.js";
+const TOOL_NAME = "m365-graph:cancel_event";
+const definition = {
+    name: TOOL_NAME,
+    description: "Cancel a meeting the user organizes (sends cancellation to attendees). Two-phase: first call returns event preview + confirmation_token; second call executes. Use this only for events the user is the organizer of — for declining as an attendee, decline in Outlook (not yet wrapped as a tool here).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            event_id: { type: "string", description: "Event to cancel." },
+            comment: {
+                type: "string",
+                description: "Optional comment included in the cancellation notification sent to attendees.",
+            },
+            confirmation_token: {
+                type: "string",
+                description: "Omit on the first call (preview mode). Include the token returned by the preview call to execute the cancellation.",
+            },
+        },
+        required: ["event_id"],
+    },
+};
+const handler = async (graph, args) => {
+    const eventId = validateRequiredString(args.event_id, "event_id");
+    const comment = validateOptionalString(args.comment, "comment");
+    const confirmationToken = validateOptionalString(args.confirmation_token, "confirmation_token");
+    // Spec for confirmation includes the comment too — if the agent
+    // changes the comment between preview and execute, that's a
+    // different action and the token must be re-issued.
+    const spec = { event_id: eventId };
+    if (comment !== undefined)
+        spec.comment = comment;
+    const apiPath = `/me/events/${encodeURIComponent(eventId)}`;
+    // ---------- Phase 1: preview ----------
+    if (!confirmationToken) {
+        const event = (await graph.api(apiPath).get());
+        const summary = summarizeEvent(event);
+        const issued = issueConfirmation(TOOL_NAME, spec);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        preview: {
+                            event: summary,
+                            cancellation_comment: comment ?? null,
+                            ...issued,
+                            instructions: `Re-call ${TOOL_NAME} with the SAME args (event_id${comment ? ", comment" : ""}) ` +
+                                `plus this confirmation_token to send the cancellation notice.`,
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    // ---------- Phase 2: execute ----------
+    const verdict = consumeConfirmation(confirmationToken, TOOL_NAME, spec);
+    if (!verdict.ok) {
+        throw new Error(`Refusing to cancel: confirmation_token ${verdict.error}. ` +
+            `Re-run without confirmation_token to get a fresh preview + token.`);
+    }
+    const cancelBody = {};
+    if (comment !== undefined)
+        cancelBody.Comment = comment;
+    await graph.api(`${apiPath}/cancel`).post(cancelBody);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    cancelled: { event_id: eventId },
+                    note: "POST /events/{id}/cancel executed. Cancellation notice sent to attendees.",
+                }, null, 2),
+            },
+        ],
+    };
+};
+export const cancelEventTool = { definition, handler };
+//# sourceMappingURL=cancel_event.js.map

package/dist/tools/cancel_event.js.map

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

package/dist/tools/copy_file.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Tool: m365-graph:copy_file
+ *
+ * Copy a file or folder to a different location. Wraps Graph's async
+ * copy operation:
+ *
+ *   POST /me/drive/items/{id}/copy   → 202 + Location header
+ *   GET  <monitor URL>               → poll until completed | failed
+ *   GET  <resourceLocation>          → fetch the new item's metadata
+ *
+ * Polling: exponential backoff (1s → 2s → 4s → … capped at 30s)
+ * until completion or `wait_max_seconds` deadline. Per handbook
+ * anti-pattern S8, the tool never returns "initiated successfully" —
+ * either the copy completes (we return the new item) or we surface
+ * the failure / timeout to the agent.
+ *
+ * Required Graph scope: `Files.ReadWrite` (delegated).
+ */
+import type { Tool, ToolHandler } from "../types/tool.js";
+interface CopiedItemSummary {
+    id: string;
+    name: string;
+    size: number;
+    webUrl: string;
+    parent_id: string | null;
+}
+export declare function summarizeCopiedItem(item: Record<string, unknown>): CopiedItemSummary;
+export interface MonitorPollResult {
+    status: "completed" | "failed" | "in_progress";
+    resource_location?: string;
+    percent_complete?: number;
+    error?: unknown;
+    raw: Record<string, unknown>;
+}
+export declare function classifyMonitorStatus(payload: Record<string, unknown>): MonitorPollResult;
+declare const handler: ToolHandler;
+export declare const copyFileTool: Tool;
+export { handler as _copyFileHandler };
+//# sourceMappingURL=copy_file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy_file.d.ts","sourceRoot":"","sources":["../../src/tools/copy_file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAYH,OAAO,KAAK,EAAE,IAAI,EAAkB,WAAW,EAAgB,MAAM,kBAAkB,CAAC;AA4BxF,UAAU,iBAAiB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CASpF;AAMD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAgBzF;AAED,QAAA,MAAM,OAAO,EAAE,WA+Gd,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,IAA8B,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/tools/copy_file.js

@@ -0,0 +1,168 @@
+/**
+ * Tool: m365-graph:copy_file
+ *
+ * Copy a file or folder to a different location. Wraps Graph's async
+ * copy operation:
+ *
+ *   POST /me/drive/items/{id}/copy   → 202 + Location header
+ *   GET  <monitor URL>               → poll until completed | failed
+ *   GET  <resourceLocation>          → fetch the new item's metadata
+ *
+ * Polling: exponential backoff (1s → 2s → 4s → … capped at 30s)
+ * until completion or `wait_max_seconds` deadline. Per handbook
+ * anti-pattern S8, the tool never returns "initiated successfully" —
+ * either the copy completes (we return the new item) or we surface
+ * the failure / timeout to the agent.
+ *
+ * Required Graph scope: `Files.ReadWrite` (delegated).
+ */
+import { ResponseType, } from "@microsoft/microsoft-graph-client";
+import { validateOptionalInteger, validateOptionalString, validateRequiredString, } from "../types/validators.js";
+const POLL_INITIAL_MS = 1_000;
+const POLL_MAX_MS = 30_000;
+const definition = {
+    name: "m365-graph:copy_file",
+    description: "Copy a file or folder to a different location in a drive (or across drives). Wraps Graph's async copy: the tool polls the monitor URL until the copy completes — never returns 'initiated successfully'. Default wait is 300 seconds; configurable via wait_max_seconds.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            item_id: { type: "string", description: "Source item ID (file or folder)." },
+            target_parent_id: { type: "string", description: "Destination folder ID." },
+            source_drive_id: { type: "string", description: "Optional source drive ID. Defaults to /me/drive." },
+            target_drive_id: { type: "string", description: "Optional target drive ID. Defaults to the source drive." },
+            new_name: { type: "string", description: "Optional rename during copy." },
+            wait_max_seconds: {
+                type: "integer",
+                minimum: 1,
+                maximum: 1800,
+                description: "Maximum seconds to poll the monitor URL before timing out (default 300).",
+            },
+        },
+        required: ["item_id", "target_parent_id"],
+    },
+};
+export function summarizeCopiedItem(item) {
+    const parent = item.parentReference;
+    return {
+        id: String(item.id ?? ""),
+        name: String(item.name ?? ""),
+        size: Number(item.size ?? 0),
+        webUrl: String(item.webUrl ?? ""),
+        parent_id: parent?.id ?? null,
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function classifyMonitorStatus(payload) {
+    const status = String(payload.status ?? "").toLowerCase();
+    const result = {
+        status: status === "completed" ? "completed" : status === "failed" ? "failed" : "in_progress",
+        raw: payload,
+    };
+    if (typeof payload.resourceLocation === "string") {
+        result.resource_location = payload.resourceLocation;
+    }
+    if (typeof payload.percentageComplete === "number") {
+        result.percent_complete = payload.percentageComplete;
+    }
+    if (payload.error !== undefined) {
+        result.error = payload.error;
+    }
+    return result;
+}
+const handler = async (graph, args) => {
+    const itemId = validateRequiredString(args.item_id, "item_id");
+    const targetParentId = validateRequiredString(args.target_parent_id, "target_parent_id");
+    const sourceDriveId = validateOptionalString(args.source_drive_id, "source_drive_id");
+    const targetDriveId = validateOptionalString(args.target_drive_id, "target_drive_id");
+    const newName = validateOptionalString(args.new_name, "new_name");
+    const waitMaxSeconds = validateOptionalInteger(args.wait_max_seconds, "wait_max_seconds", {
+        min: 1,
+        max: 1800,
+        default: 300,
+    });
+    const sourcePath = sourceDriveId
+        ? `/drives/${encodeURIComponent(sourceDriveId)}/items/${encodeURIComponent(itemId)}`
+        : `/me/drive/items/${encodeURIComponent(itemId)}`;
+    // Fetch source metadata up-front so we know the source name (needed
+    // for the post-completion fallback if the monitor URL doesn't return
+    // resourceLocation).
+    const sourceItem = (await graph.api(sourcePath).get());
+    const effectiveName = newName ?? String(sourceItem.name ?? "");
+    const body = {
+        parentReference: targetDriveId
+            ? { driveId: targetDriveId, id: targetParentId }
+            : { id: targetParentId },
+    };
+    if (newName !== undefined)
+        body.name = newName;
+    // POST → raw response to read the Location header for the monitor URL
+    const raw = (await graph
+        .api(`${sourcePath}/copy`)
+        .responseType(ResponseType.RAW)
+        .post(body));
+    if (raw.status !== 202) {
+        throw new Error(`copy: expected 202 Accepted, got ${raw.status} ${raw.statusText}`);
+    }
+    const monitorUrl = raw.headers.get("location") ?? raw.headers.get("Location");
+    if (!monitorUrl) {
+        throw new Error("copy: 202 response missing Location header (monitor URL)");
+    }
+    const deadline = Date.now() + waitMaxSeconds * 1000;
+    let pollInterval = POLL_INITIAL_MS;
+    let last = null;
+    while (Date.now() < deadline) {
+        await sleep(pollInterval);
+        pollInterval = Math.min(pollInterval * 2, POLL_MAX_MS);
+        const payload = (await graph.api(monitorUrl).get());
+        last = classifyMonitorStatus(payload);
+        if (last.status === "completed") {
+            let copied = null;
+            if (last.resource_location) {
+                // Happy path: monitor URL returned a fetchable resourceLocation.
+                const newItem = (await graph
+                    .api(last.resource_location)
+                    .get());
+                copied = summarizeCopiedItem(newItem);
+            }
+            else {
+                // Graph quirk: completed responses sometimes omit resourceLocation.
+                // Fall back to listing the target parent and matching by name.
+                const targetDriveBase = targetDriveId
+                    ? `/drives/${encodeURIComponent(targetDriveId)}`
+                    : sourceDriveId
+                        ? `/drives/${encodeURIComponent(sourceDriveId)}`
+                        : "/me/drive";
+                const childrenPath = `${targetDriveBase}/items/${encodeURIComponent(targetParentId)}/children`;
+                const listing = (await graph
+                    .api(childrenPath)
+                    .filter(`name eq '${effectiveName.replace(/'/g, "''")}'`)
+                    .get());
+                const matches = Array.isArray(listing?.value) ? listing.value : [];
+                if (matches.length > 0) {
+                    copied = summarizeCopiedItem(matches[0]);
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "completed",
+                            copied,
+                            source: { item_id: itemId, drive_id: sourceDriveId ?? null },
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        if (last.status === "failed") {
+            throw new Error(`copy operation failed: ${JSON.stringify(last.error ?? "(no detail)")}`);
+        }
+    }
+    throw new Error(`copy did not complete within ${waitMaxSeconds}s. Last status: ${JSON.stringify(last?.raw ?? "(no poll yet)")}`);
+};
+export const copyFileTool = { definition, handler };
+export { handler as _copyFileHandler };
+//# sourceMappingURL=copy_file.js.map

package/dist/tools/copy_file.js.map

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

package/dist/tools/create_event.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tool: m365-graph:create_event
+ *
+ * Create a new event on the user's primary calendar (or a specified
+ * calendar). Wraps Graph `POST /me/events` (or
+ * `POST /me/calendars/{id}/events`).
+ *
+ * Required Graph scope: `Calendars.ReadWrite` (delegated).
+ *
+ * Send-invitations behavior: by default Graph DOES send meeting
+ * invitations to attendees on event creation. To create an event
+ * without sending invites, set `send_invitations: false` (we set
+ * `responseStatus.response: "organizer"` and don't add the user as
+ * attendee — but Graph still notifies the *other* attendees unless
+ * the calendar is configured otherwise).
+ *
+ * Defaults:
+ *   - timezone: "UTC" if not specified (Graph requires explicit TZ)
+ *   - body_content_type: "text"
+ *   - is_all_day: false
+ *   - attendee.type: "required" (when type omitted in input)
+ *
+ * No spec/approval pattern here — creation is non-destructive (worst
+ * case: clutter on the calendar; the agent can call cancel_event or
+ * the user can delete via Outlook UI).
+ */
+import type { Tool } from "../types/tool.js";
+export declare const createEventTool: Tool;
+//# sourceMappingURL=create_event.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create_event.d.ts","sourceRoot":"","sources":["../../src/tools/create_event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAWH,OAAO,KAAK,EAAE,IAAI,EAA6C,MAAM,kBAAkB,CAAC;AAmJxF,eAAO,MAAM,eAAe,EAAE,IAA8B,CAAC"}