@arbium/enterprise-agent-connect 0.0.0-stage → 0.1.2-dev.d2aa5ca

package/dist/connectors/outlook-calendar/tools.js

@@ -0,0 +1,398 @@
+import { z } from "zod";
+import { audited, Denied, json, } from "../../packages/connector-kit/src/common.js";
+import { mailboxPath, nextPage, ok, pageParam } from "../outlook-mail/tools.js";
+// The calendar of the mailbox in the agent's grant. No tool takes a mailbox argument, and
+// event ids are only ever looked up under that mailbox, where Exchange finds no other
+// mailbox's events.
+export const MAX_RANGE_DAYS = 62;
+const EVENT_ID = /^[A-Za-z0-9_=-]{1,1024}$/;
+// A moment with its offset, so the window means the same thing to the service and Microsoft.
+const INSTANT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,7})?)?(Z|[+-]\d{2}:\d{2})$/;
+// A wall-clock time read in `time_zone`, as Microsoft's events take it.
+const LOCAL = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?$/;
+const TIME_ZONE = /^[A-Za-z0-9_/+ .()-]{1,100}$/;
+const DATE = /^\d{4}-\d{2}-\d{2}$/;
+const FIELDS = "id,subject,start,end,location,organizer,attendees,isAllDay,isCancelled,showAs,bodyPreview," +
+    "type,seriesMasterId,recurrence,isOrganizer,responseStatus";
+export const MAX_OCCURRENCES = 999;
+const DAYS = [
+    "sunday",
+    "monday",
+    "tuesday",
+    "wednesday",
+    "thursday",
+    "friday",
+    "saturday",
+];
+// The tool's names for Microsoft's response actions.
+const RESPONSES = {
+    accept: "accept",
+    tentatively_accept: "tentativelyAccept",
+    decline: "decline",
+};
+function eventPath(ctx, id) {
+    if (!EVENT_ID.test(id))
+        throw new Denied("Give an event id from calendar_list_events");
+    return `${mailboxPath(ctx)}/events/${encodeURIComponent(id)}`;
+}
+// Date.parse rolls a day that does not exist (February 31, 24:00) into the next one; reading it
+// back shows whether it did.
+const exists = (value, iso) => {
+    const ms = Date.parse(iso);
+    return Number.isFinite(ms) && new Date(ms).toISOString().startsWith(value);
+};
+const isDate = (value) => DATE.test(value) && exists(value, `${value}T00:00:00Z`);
+/** The listing window as UTC instants; refused when unbounded, reversed or too long. */
+export function eventWindow(start, end) {
+    if (!INSTANT.test(start) || !INSTANT.test(end))
+        throw new Denied("Give start and end as date-times with an offset, e.g. 2026-10-21T09:00:00Z");
+    const from = Date.parse(start);
+    const to = Date.parse(end);
+    const real = (v) => isDate(v.slice(0, 10)) && Number(v.slice(11, 13)) < 24;
+    if (!Number.isFinite(from) || !Number.isFinite(to) || !real(start) || !real(end))
+        throw new Denied("start or end is not a date");
+    if (to <= from)
+        throw new Denied("end must be after start");
+    if (to - from > MAX_RANGE_DAYS * 86_400_000)
+        throw new Denied(`List at most ${MAX_RANGE_DAYS} days at a time`);
+    return { start: new Date(from).toISOString(), end: new Date(to).toISOString() };
+}
+function when(value, timeZone) {
+    if (!LOCAL.test(value) || !exists(value, `${value}Z`))
+        throw new Denied(`${value} is not a date-time such as 2026-10-21T09:00`);
+    if (!TIME_ZONE.test(timeZone))
+        throw new Denied(`${timeZone} is not a time zone name`);
+    return { dateTime: value, timeZone };
+}
+function checkOrder(start, end) {
+    if (Date.parse(`${end.dateTime}Z`) <= Date.parse(`${start.dateTime}Z`))
+        throw new Denied("end must be after start");
+}
+/**
+ * Microsoft's patternedRecurrence for a series whose first event starts on `startDate`
+ * (YYYY-MM-DD, read in `timeZone`). Monthly and yearly repeat on the start's day (and month);
+ * weekly defaults to the start's weekday. Every series ends, by date or by count.
+ * https://learn.microsoft.com/graph/outlook-schedule-recurring-events
+ */
+export function recurrence(r, startDate, timeZone) {
+    if (!isDate(startDate))
+        throw new Denied(`${startDate} is not a date`);
+    if (!TIME_ZONE.test(timeZone))
+        throw new Denied(`${timeZone} is not a time zone name`);
+    if ((r.end_date === undefined) === (r.count === undefined))
+        throw new Denied("Give the series either an end_date or a count, not both");
+    if (r.days_of_week && r.pattern !== "weekly")
+        throw new Denied("days_of_week is only for a weekly pattern");
+    const start = new Date(`${startDate}T00:00:00Z`);
+    const pattern = r.pattern === "daily"
+        ? { type: "daily", interval: r.interval }
+        : r.pattern === "weekly"
+            ? {
+                type: "weekly",
+                interval: r.interval,
+                daysOfWeek: [...new Set(r.days_of_week ?? [DAYS[start.getUTCDay()]])],
+            }
+            : r.pattern === "monthly"
+                ? { type: "absoluteMonthly", interval: r.interval, dayOfMonth: start.getUTCDate() }
+                : {
+                    type: "absoluteYearly",
+                    interval: r.interval,
+                    dayOfMonth: start.getUTCDate(),
+                    month: start.getUTCMonth() + 1,
+                };
+    if (r.end_date !== undefined) {
+        if (!isDate(r.end_date))
+            throw new Denied(`${r.end_date} is not a date such as 2026-12-31`);
+        if (r.end_date < startDate)
+            throw new Denied("end_date must not be before the first event");
+    }
+    const range = r.end_date !== undefined
+        ? { type: "endDate", startDate, endDate: r.end_date, recurrenceTimeZone: timeZone }
+        : {
+            type: "numbered",
+            startDate,
+            numberOfOccurrences: r.count,
+            recurrenceTimeZone: timeZone,
+        };
+    return { pattern, range };
+}
+// The event a change applies to. An occurrence's id changes that occurrence only; with
+// `series`, the change goes to its series master, so every occurrence follows. A master's own
+// id needs `series`, so a whole series is never changed or deleted by accident.
+async function target(ctx, mark, id, series) {
+    const e = await ok(ctx, mark, {
+        method: "GET",
+        path: `${eventPath(ctx, id)}?$select=id,type,seriesMasterId,recurrence`,
+    });
+    if (e.type === "seriesMaster") {
+        if (!series)
+            throw new Denied("This id is a whole series. Pass series: true to change every occurrence, or give one occurrence's id from calendar_list_events");
+        return { id, recurrence: e.recurrence };
+    }
+    if (!series)
+        return { id };
+    if (!e.seriesMasterId)
+        throw new Denied("This event is not part of a series");
+    const master = await ok(ctx, mark, {
+        method: "GET",
+        path: `${eventPath(ctx, e.seriesMasterId)}?$select=id,recurrence`,
+    });
+    return { id: e.seriesMasterId, recurrence: master.recurrence };
+}
+// Microsoft answers a create or update in the zone it was sent in, whatever the Prefer header
+// says; reading the event back gives UTC, as the list and get tools do.
+async function inUtc(ctx, mark, id) {
+    return ok(ctx, mark, {
+        method: "GET",
+        path: `${eventPath(ctx, id)}?$select=${FIELDS}`,
+        headers: { prefer: 'outlook.timezone="UTC"' },
+    });
+}
+const address = (a) => a?.emailAddress?.address ?? null;
+const attendees = (list) => list.map((address) => ({ emailAddress: { address }, type: "required" }));
+function summary(e) {
+    return {
+        id: e.id,
+        subject: e.subject ?? "",
+        start: e.start ?? null,
+        end: e.end ?? null,
+        all_day: e.isAllDay ?? false,
+        cancelled: e.isCancelled ?? false,
+        show_as: e.showAs ?? null,
+        location: e.location?.displayName ?? "",
+        organizer: address(e.organizer),
+        attendees: (e.attendees ?? []).map((a) => ({
+            email: address(a),
+            response: a.status?.response ?? null,
+        })),
+        preview: e.bodyPreview ?? "",
+        // singleInstance, occurrence, exception (a changed occurrence) or seriesMaster.
+        type: e.type ?? null,
+        series_id: e.seriesMasterId ?? null,
+        recurrence: e.recurrence ?? null,
+        is_organizer: e.isOrganizer ?? null,
+        my_response: e.responseStatus?.response ?? null,
+    };
+}
+export const calendarTools = {
+    names: [
+        "calendar_list_events",
+        "calendar_get_event",
+        "calendar_create_event",
+        "calendar_update_event",
+        "calendar_delete_event",
+        "calendar_respond_to_event",
+    ],
+    register(server, ctx, allowed) {
+        const readOnly = { readOnlyHint: true, openWorldHint: true };
+        const writes = { readOnlyHint: false, destructiveHint: false, openWorldHint: true };
+        const eventId = z.string().max(1100).describe("Id from calendar_list_events.");
+        const emails = z.array(z.email()).max(50);
+        const timeZone = z
+            .string()
+            .max(100)
+            .describe("Time zone of start and end, e.g. UTC or Europe/London.");
+        // Text and wall-clock times are checked inside audited(), so a refusal is logged.
+        const local = z.string().max(40);
+        const repeat = z
+            .object({
+            pattern: z.enum(["daily", "weekly", "monthly", "yearly"]),
+            interval: z
+                .number()
+                .int()
+                .min(1)
+                .max(99)
+                .default(1)
+                .describe("Every this many days, weeks, months or years."),
+            days_of_week: z
+                .array(z.enum(DAYS))
+                .min(1)
+                .max(7)
+                .optional()
+                .describe("Weekly only. Defaults to the start's weekday."),
+            end_date: z
+                .string()
+                .max(10)
+                .optional()
+                .describe("Last date the series may fall on, e.g. 2026-12-31. Give this or count."),
+            count: z.number().int().min(1).max(MAX_OCCURRENCES).optional(),
+        })
+            .describe("Repeat the event. Monthly and yearly repeat on the start's date. Needs end_date or count.");
+        const series = z
+            .boolean()
+            .default(false)
+            .describe("true to apply this to the whole series the event belongs to; false for this one occurrence only.");
+        if (allowed.has("calendar_list_events"))
+            server.registerTool("calendar_list_events", {
+                description: `List events in this agent's calendar between two date-times (at most ${MAX_RANGE_DAYS} days apart), earliest first. Each occurrence of a repeating event is listed on its own. Times come back in UTC. When \`more\` is true, call again with \`cursor\` set to \`next\`.`,
+                inputSchema: z.object({
+                    start: z.string().max(40).describe("e.g. 2026-10-21T00:00:00Z"),
+                    end: z.string().max(40).describe("e.g. 2026-10-28T00:00:00Z"),
+                    max_results: z.number().int().min(1).max(100).default(50),
+                    cursor: z
+                        .string()
+                        .max(4000)
+                        .optional()
+                        .describe("The `next` value from the previous call with the same window: the following page."),
+                }),
+                annotations: readOnly,
+            }, ({ start, end, max_results, cursor }) => audited(ctx, "calendar_list_events", `${start} → ${end}`, async (mark) => {
+                const window = eventWindow(start, end);
+                const query = [
+                    `startDateTime=${encodeURIComponent(window.start)}`,
+                    `endDateTime=${encodeURIComponent(window.end)}`,
+                    `$top=${max_results}`,
+                    `$select=${FIELDS}`,
+                    "$orderby=start/dateTime",
+                    ...pageParam(cursor),
+                ].join("&");
+                const data = await ok(ctx, mark, {
+                    method: "GET",
+                    path: `${mailboxPath(ctx)}/calendarView?${query}`,
+                    headers: { prefer: 'outlook.timezone="UTC"' },
+                });
+                return json({
+                    events: data.value.map(summary),
+                    more: Boolean(data["@odata.nextLink"]),
+                    next: nextPage(data),
+                });
+            }));
+        if (allowed.has("calendar_get_event"))
+            server.registerTool("calendar_get_event", {
+                description: "Read one event in this agent's calendar, with its description as text.",
+                inputSchema: z.object({ event_id: eventId }),
+                annotations: readOnly,
+            }, ({ event_id }) => audited(ctx, "calendar_get_event", event_id, async (mark) => {
+                const e = await ok(ctx, mark, {
+                    method: "GET",
+                    path: `${eventPath(ctx, event_id)}?$select=${FIELDS},body`,
+                    headers: {
+                        prefer: 'outlook.timezone="UTC", outlook.body-content-type="text"',
+                    },
+                });
+                return json({ ...summary(e), body: e.body?.content ?? "" });
+            }));
+        if (allowed.has("calendar_create_event"))
+            server.registerTool("calendar_create_event", {
+                description: "Add an event to this agent's calendar. Attendees are sent an invitation from this agent's mailbox.",
+                inputSchema: z.object({
+                    subject: z.string().min(1).max(255),
+                    start: local.describe("Wall-clock start, e.g. 2026-10-21T09:00"),
+                    end: local.describe("Wall-clock end, e.g. 2026-10-21T09:30"),
+                    time_zone: timeZone.default("UTC"),
+                    location: z.string().max(255).optional(),
+                    body: z.string().max(100000).optional(),
+                    attendees: emails.default([]),
+                    recurrence: repeat.optional(),
+                }),
+                annotations: writes,
+            }, ({ subject, start, end, time_zone, location, body, attendees: invited, recurrence: r }) => audited(ctx, "calendar_create_event", subject, async (mark, retarget) => {
+                const from = when(start, time_zone);
+                const to = when(end, time_zone);
+                checkOrder(from, to);
+                const repeats = r ? { recurrence: recurrence(r, start.slice(0, 10), time_zone) } : {};
+                const created = await ok(ctx, mark, {
+                    method: "POST",
+                    path: `${mailboxPath(ctx)}/events`,
+                    body: {
+                        subject,
+                        start: from,
+                        end: to,
+                        ...(location ? { location: { displayName: location } } : {}),
+                        ...(body ? { body: { contentType: "Text", content: body } } : {}),
+                        attendees: attendees(invited),
+                        ...repeats,
+                    },
+                });
+                retarget(created.id);
+                return json(summary(await inUtc(ctx, mark, created.id)));
+            }));
+        if (allowed.has("calendar_update_event"))
+            server.registerTool("calendar_update_event", {
+                description: "Change an event in this agent's calendar. Only the fields given change; attendees, when given, replace the list and are sent an update. An occurrence's id changes that occurrence only; pass series: true to change the whole series.",
+                inputSchema: z.object({
+                    event_id: eventId,
+                    subject: z.string().min(1).max(255).optional(),
+                    start: local.optional(),
+                    end: local.optional(),
+                    time_zone: timeZone
+                        .optional()
+                        .describe("Time zone of start and end, e.g. Europe/London. Needed with start or end."),
+                    location: z.string().max(255).optional(),
+                    body: z.string().max(100000).optional(),
+                    attendees: emails.optional(),
+                    series,
+                    recurrence: repeat
+                        .optional()
+                        .describe("A new repeat pattern for the series. Needs series: true."),
+                }),
+                annotations: writes,
+            }, ({ event_id, subject, start, end, time_zone, location, body, attendees: invited, series: whole, recurrence: r, }) => audited(ctx, "calendar_update_event", event_id, async (mark, retarget) => {
+                if (r && !whole)
+                    throw new Denied("Give series: true to change how a series repeats");
+                // No default: a time read in the wrong zone would move the event silently.
+                if ((start !== undefined || end !== undefined) === (time_zone === undefined))
+                    throw new Denied("Give time_zone together with start or end, e.g. Europe/London, and not on its own");
+                const from = start === undefined ? undefined : when(start, time_zone);
+                const to = end === undefined ? undefined : when(end, time_zone);
+                if (from && to)
+                    checkOrder(from, to);
+                const patch = {
+                    ...(subject !== undefined ? { subject } : {}),
+                    ...(from ? { start: from } : {}),
+                    ...(to ? { end: to } : {}),
+                    ...(location !== undefined ? { location: { displayName: location } } : {}),
+                    ...(body !== undefined ? { body: { contentType: "Text", content: body } } : {}),
+                    ...(invited !== undefined ? { attendees: attendees(invited) } : {}),
+                };
+                if (Object.keys(patch).length === 0 && !r)
+                    throw new Denied("Give at least one field to change");
+                const t = await target(ctx, mark, event_id, whole);
+                retarget(t.id);
+                if (r) {
+                    // The series' first date and zone stay unless a new start (in time_zone) moves them.
+                    const range = t.recurrence?.range ?? {};
+                    const startDate = start?.slice(0, 10) ?? range.startDate;
+                    const zone = start !== undefined ? time_zone : range.recurrenceTimeZone;
+                    if (!startDate || !zone)
+                        throw new Denied("Give start and time_zone with recurrence");
+                    patch.recurrence = recurrence(r, startDate, zone);
+                }
+                await ok(ctx, mark, { method: "PATCH", path: eventPath(ctx, t.id), body: patch });
+                return json(summary(await inUtc(ctx, mark, t.id)));
+            }));
+        if (allowed.has("calendar_delete_event"))
+            server.registerTool("calendar_delete_event", {
+                description: "Delete an event from this agent's calendar. An occurrence's id deletes that occurrence only; pass series: true to delete every occurrence. Attendees are sent a cancellation when this agent organized it.",
+                inputSchema: z.object({ event_id: eventId, series }),
+                annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+            }, ({ event_id, series: whole }) => audited(ctx, "calendar_delete_event", event_id, async (mark, retarget) => {
+                const t = await target(ctx, mark, event_id, whole);
+                retarget(t.id);
+                await ok(ctx, mark, { method: "DELETE", path: eventPath(ctx, t.id) });
+                return json({ deleted: true, series: whole });
+            }));
+        if (allowed.has("calendar_respond_to_event"))
+            server.registerTool("calendar_respond_to_event", {
+                description: "Accept, tentatively accept or decline an invitation in this agent's calendar. An occurrence's id answers that occurrence only; a series id answers the whole series. A declined event leaves the calendar.",
+                inputSchema: z.object({
+                    event_id: eventId,
+                    response: z.enum(["accept", "tentatively_accept", "decline"]),
+                    comment: z.string().max(10000).optional().describe("Text sent with the answer."),
+                    send_response: z
+                        .boolean()
+                        .default(true)
+                        .describe("false to answer without emailing the organizer."),
+                }),
+                annotations: writes,
+            }, ({ event_id, response, comment, send_response }) => audited(ctx, "calendar_respond_to_event", event_id, async (mark) => {
+                await ok(ctx, mark, {
+                    method: "POST",
+                    path: `${eventPath(ctx, event_id)}/${RESPONSES[response]}`,
+                    body: { ...(comment ? { comment } : {}), sendResponse: send_response },
+                });
+                return json({ response, sent: send_response });
+            }));
+    },
+};
+//# sourceMappingURL=tools.js.map

package/dist/connectors/outlook-calendar/tools.js.map

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

package/dist/connectors/outlook-mail/connector.json

@@ -0,0 +1,154 @@
+{
+  "id": "outlook-mail",
+  "name": "Outlook mail",
+  "description": "Let each agent read and work on mail in its own mailbox.",
+  "logo": "/brand/outlook.svg",
+  "identity": "Your Microsoft app registration, through the Microsoft connection. Exchange lets it open only the mailboxes you choose for agents, and it uses no Microsoft 365 license.",
+  "provider": "microsoft",
+  "order": 1,
+  "accountKey": "tenantId",
+  "connectionKind": "guided",
+  "setup": [
+    {
+      "title": "Make sure the app cannot open every mailbox",
+      "body": "Outlook mail needs no Microsoft Graph permission on the app. Do not add Mail.Read, Mail.Send or Mail.ReadWrite under API permissions: they open every mailbox in your organization.",
+      "click": [
+        "In the Microsoft Entra admin center, go to Entra ID, then App registrations, open {brand.microsoft.appName} and select API permissions.",
+        "Check that no Mail permission is listed. Remove any that is."
+      ],
+      "copy": ["az ad app permission list --id {clientId} -o table"],
+      "shell": "bash"
+    },
+    {
+      "title": "Create the {brand.microsoft.mailboxGroup} group",
+      "body": "Agents can only reach mailboxes in this mail-enabled security group. Outlook calendar uses the same group, so you create it once. Each agent's mailbox is added to it when you make the agent's API key, on the Integrations tab.",
+      "link": {
+        "label": "Open the Exchange admin center",
+        "href": "https://admin.exchange.microsoft.com/#/groups"
+      },
+      "click": [
+        "In the Exchange admin center, go to Recipients, then Groups, then Mail-enabled security, and select Add a group.",
+        "Choose Mail-enabled security and select Next. Name it {brand.microsoft.mailboxGroup}, then Next.",
+        "Assign yourself as owner, skip members (you add each agent's mailbox later), then Next.",
+        "On Edit settings, enter a group email address such as {brand.microsoft.mailboxGroupAlias}@your-domain, then Next and Create group."
+      ],
+      "copy": [
+        "# Needs the ExchangeOnlineManagement module: Install-Module ExchangeOnlineManagement -Scope CurrentUser",
+        "Connect-ExchangeOnline",
+        "if (-not (Get-DistributionGroup -Identity '{brand.microsoft.mailboxGroup}' -ErrorAction SilentlyContinue)) { New-DistributionGroup -Name '{brand.microsoft.mailboxGroup}' -Type Security }"
+      ],
+      "shell": "powershell",
+      "confirm": "mailbox-group"
+    },
+    {
+      "title": "Limit the app to the mailboxes in that group",
+      "body": "This is the only mail access the app gets. Exchange enforces it, so the app cannot open any other mailbox. The role lines follow what you ticked in step 1; if you tick more later, run the matching New-ManagementRoleAssignment line again. Lines for what already exists (from Outlook calendar) are skipped. Exchange can take up to 2 hours to apply this before Check access passes.",
+      "link": {
+        "label": "Connect to Exchange Online PowerShell",
+        "href": "https://learn.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell"
+      },
+      "clickUnavailable": true,
+      "copy": [
+        "# Needs the ExchangeOnlineManagement module: Install-Module ExchangeOnlineManagement -Scope CurrentUser",
+        "Connect-ExchangeOnline",
+        "if (-not (Get-ServicePrincipal -Identity {clientId} -ErrorAction SilentlyContinue)) { New-ServicePrincipal -AppId {clientId} -ObjectId {servicePrincipalId} -DisplayName \"{brand.microsoft.appName}\" }",
+        "if (-not (Get-ManagementScope -Identity \"{brand.microsoft.mailboxGroup}\" -ErrorAction SilentlyContinue)) { New-ManagementScope -Name \"{brand.microsoft.mailboxGroup}\" -RecipientRestrictionFilter \"MemberOfGroup -eq '$((Get-DistributionGroup '{brand.microsoft.mailboxGroup}').DistinguishedName)'\" }",
+        "New-ManagementRoleAssignment -Role \"{scope}\" -App {clientId} -CustomResourceScope \"{brand.microsoft.mailboxGroup}\""
+      ],
+      "shell": "powershell",
+      "confirm": "mail-roles"
+    }
+  ],
+  "afterConnect": [],
+  "fields": [],
+  "capabilities": [
+    {
+      "id": "read",
+      "label": "Read mail",
+      "description": "List and read messages in the agent's own mailbox.",
+      "required": true,
+      "scopes": ["Application Mail.Read"],
+      "roles": [],
+      "permissions": [],
+      "tools": ["mail_list_messages", "mail_get_message"],
+      "forbidden": "Microsoft refused this. The app needs the Exchange role {scopes} on the {brand.microsoft.mailboxGroup} scope, and this mailbox must be in that group. A role added in the last hour may not apply yet."
+    },
+    {
+      "id": "send",
+      "label": "Send mail",
+      "description": "Send new messages and reply from the agent's own mailbox.",
+      "scopes": ["Application Mail.Send"],
+      "roles": [],
+      "permissions": [],
+      "tools": ["mail_send", "mail_reply"],
+      "forbidden": "Microsoft refused this. The app needs the Exchange role {scopes} on the {brand.microsoft.mailboxGroup} scope, and this mailbox must be in that group. A role added in the last hour may not apply yet."
+    },
+    {
+      "id": "organize",
+      "label": "Organize mail",
+      "description": "Move messages between folders, flag them and mark them read or unread.",
+      "scopes": ["Application Mail.ReadWrite"],
+      "roles": [],
+      "permissions": [],
+      "tools": ["mail_move", "mail_flag", "mail_mark_read"],
+      "forbidden": "Microsoft refused this. The app needs the Exchange role {scopes} on the {brand.microsoft.mailboxGroup} scope, and this mailbox must be in that group. A role added in the last hour may not apply yet."
+    },
+    {
+      "id": "delete",
+      "label": "Delete mail",
+      "description": "Delete messages. They go to Deleted Items, where Microsoft 365 removes them after a while.",
+      "destructive": true,
+      "scopes": ["Application Mail.ReadWrite"],
+      "roles": [],
+      "permissions": [],
+      "tools": ["mail_delete"],
+      "forbidden": "Microsoft refused this. The app needs the Exchange role {scopes} on the {brand.microsoft.mailboxGroup} scope, and this mailbox must be in that group. A role added in the last hour may not apply yet."
+    }
+  ],
+  "limits": [
+    {
+      "id": "mailbox",
+      "label": "Mailbox",
+      "help": "The agent's own mailbox, a member of {brand.microsoft.mailboxGroup}. The agent can use no other.",
+      "kind": "text",
+      "required": true,
+      "pattern": "^[A-Za-z0-9._+-]+@[A-Za-z0-9-]+(\\.[A-Za-z0-9-]+)+$"
+    }
+  ],
+  "verify": {
+    "label": "Microsoft Graph permissions on the app (Outlook mail needs none: Exchange limits it to the {brand.microsoft.mailboxGroup} group)",
+    "check": "permissions"
+  },
+  "revoke": "In Exchange Online PowerShell, remove the app's mailbox access with Get-ManagementRoleAssignment -RoleAssignee {clientId} | Remove-ManagementRoleAssignment. To stop every Microsoft app at once, remove the app registration (see the Microsoft connection).",
+  "agentAccess": {
+    "limit": "mailbox",
+    "label": "Exchange lets the app open an agent's mailbox",
+    "path": "/v1.0/users/{value}/mailFolders/inbox?$select=id",
+    "granted": "The app can open this mailbox.",
+    "notGranted": "Exchange does not let the app open this mailbox yet. Check that it is in {brand.microsoft.mailboxGroup}. Also check that the app's mailbox access was given (step 3 on the Outlook mail page), and run Test-ServicePrincipalAuthorization to see which roles apply. Microsoft can take up to about 2 hours to apply a change.",
+    "notFound": "Exchange shows the app no mailbox at this address. Either there is none yet (check the address, or wait a few minutes if you just created it), or it is not in {brand.microsoft.mailboxGroup} yet: Exchange answers the same for a mailbox the app may not open. Microsoft can take up to about 2 hours to apply a change.",
+    "probes": {
+      "send": {
+        "method": "POST",
+        "path": "/v1.0/users/{value}/sendMail",
+        "body": {
+          "message": {}
+        },
+        "allowed": [400]
+      },
+      "organize": {
+        "method": "PATCH",
+        "path": "/v1.0/users/{value}/mailFolders/inbox",
+        "body": {},
+        "allowed": [200]
+      },
+      "delete": {
+        "method": "PATCH",
+        "path": "/v1.0/users/{value}/mailFolders/inbox",
+        "body": {},
+        "allowed": [200]
+      }
+    },
+    "missing": "The app can open this mailbox but Exchange does not let it do this yet: {missing}. Give that role (the step Limit the app to the mailboxes in that group, on the Outlook mail page) and check again. Microsoft can take up to about 2 hours to apply a change."
+  }
+}

package/dist/connectors/outlook-mail/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../../packages/connector-kit/src/connector.js").ConnectorModule;
+export default _default;

package/dist/connectors/outlook-mail/index.js

@@ -0,0 +1,4 @@
+import { microsoftApp } from "../microsoft/client.js";
+import { microsoftTools } from "./tools.js";
+export default microsoftApp("outlook-mail", microsoftTools);
+//# sourceMappingURL=index.js.map

package/dist/connectors/outlook-mail/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../connectors/outlook-mail/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAe,YAAY,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC"}

package/dist/connectors/outlook-mail/tools.d.ts

@@ -0,0 +1,8 @@
+import { type ToolContext, type Toolset } from "../../packages/connector-kit/src/common.js";
+export declare function nextPage(data: {
+    "@odata.nextLink"?: string;
+}): string | null;
+export declare function pageParam(cursor: string | undefined): string[];
+export declare function mailboxPath(ctx: ToolContext): string;
+export declare function ok(ctx: ToolContext, mark: (s: number) => void, req: Parameters<ToolContext["call"]>[0]): Promise<any>;
+export declare const microsoftTools: Toolset;