@assemblyline-agents/gmail 2.0.0 → 3.1.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 OpenEve contributors
+Copyright (c) 2026 Assembly Line contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -2,7 +2,7 @@
 
 Official Assembly Line Gmail connection plugin.
 
-It exposes Gmail threads, messages, attachments, drafts, and sends through a dedicated MCP connection. Gmail authorization stays independent from Google Calendar and Google Drive. The package exports `defineGmailConnection(options)` and bundles focused Gmail guidance under `skills/`.
+It exposes Gmail threads, messages, attachments, drafts, and sends through a reviewed direct Gmail REST API connection. Gmail authorization is stored independently from Google Calendar and Google Drive. The package exports `defineGmailConnection(options)`.
 
 ## Install
 
@@ -10,7 +10,26 @@ It exposes Gmail threads, messages, attachments, drafts, and sends through a ded
 npm install @assemblyline-agents/gmail
 ```
 
-Configure `GMAIL_MCP_URL` and `GMAIL_MCP_TOKEN`, or pass the connection URL and authentication resolver directly. New connections scaffold read-only; drafts and sends require explicit write access and the configured approval policy.
+Create a Google OAuth web client, enable the Gmail API, and set `GOOGLE_CLIENT_ID` and `GOOGLE_CLIENT_SECRET`. Optionally set `GOOGLE_REDIRECT_URI` or `GMAIL_API_BASE_URL`. Assembly Line runs Authorization Code + PKCE, requests offline access, and stores the refreshable grant host-side. New connections enable reviewed Gmail tools without requiring an approval surface. Set `access: "approval-required"` if drafts and sends should pause for approval, or `access: "read-only"` to request only `gmail.readonly`.
+
+Gmail connections also expose the reviewed `email.received` event. Enable the
+Gmail API and Pub/Sub API, then set `GOOGLE_CLOUD_PROJECT`,
+`GMAIL_PUBSUB_TOPIC`, and a stable random
+`GMAIL_PUBSUB_VERIFICATION_TOKEN`. The operator owns the Pub/Sub resources:
+
+1. Create the topic in `GOOGLE_CLOUD_PROJECT`.
+2. Grant `serviceAccount:gmail-api-push@system.gserviceaccount.com` the
+   `roles/pubsub.publisher` role on that topic.
+3. Run `assembly-line connections wire` after deployment and create a Pub/Sub
+   push subscription for the reported callback URL. Append
+   `?token=<GMAIL_PUBSUB_VERIFICATION_TOKEN>` using the actual secret value.
+
+Assembly Line uses the user's existing Gmail OAuth grant only to create and
+renew `users.watch`; it never needs a Google Cloud service-account key and does
+not create or delete operator-owned Pub/Sub resources. Notifications are
+expanded through Gmail History into one stable event per newly received
+message; sent mail, drafts, spam, and trash are excluded. Add an explicit
+`automations/*.ts` event automation to start agent work.
 
 ## Part of Assembly Line
 

package/dist/auth.d.ts

@@ -0,0 +1,3 @@
+import { type ConnectionAuthDefinition, type ConnectionPluginAccessSelection } from "@assemblyline-agents/core";
+export declare function gmailOAuth(access: ConnectionPluginAccessSelection | undefined): ConnectionAuthDefinition;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACrC,MAAM,2BAA2B,CAAC;AAQnC,wBAAgB,UAAU,CAAC,MAAM,EAAE,+BAA+B,GAAG,SAAS,GAAG,wBAAwB,CAoBxG"}

package/dist/auth.js

@@ -0,0 +1,33 @@
+import { defineOAuthAuthorization } from "@assemblyline-agents/core";
+const READ_SCOPES = ["https://www.googleapis.com/auth/gmail.readonly"];
+const WRITE_SCOPES = [
+    "https://www.googleapis.com/auth/gmail.compose",
+    "https://www.googleapis.com/auth/gmail.send"
+];
+export function gmailOAuth(access) {
+    return ({ env }) => {
+        const clientId = env.GOOGLE_CLIENT_ID?.trim();
+        const clientSecret = env.GOOGLE_CLIENT_SECRET?.trim();
+        const redirectUri = env.GOOGLE_REDIRECT_URI?.trim();
+        if (!clientId || !clientSecret) {
+            throw new Error("Gmail OAuth requires GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET.");
+        }
+        return defineOAuthAuthorization({
+            displayName: "Gmail",
+            authorizeUrl: "https://accounts.google.com/o/oauth2/v2/auth",
+            tokenUrl: "https://oauth2.googleapis.com/token",
+            clientId,
+            clientSecret,
+            scopes: writesEnabled(access) ? [...READ_SCOPES, ...WRITE_SCOPES] : [...READ_SCOPES],
+            ...(redirectUri ? { redirectUri } : {}),
+            authorizationParams: { access_type: "offline", prompt: "consent" },
+            pkce: true
+        });
+    };
+}
+function writesEnabled(access) {
+    if (access === "read-only")
+        return false;
+    return typeof access !== "object" || access.write !== false;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EAGzB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,GAAG,CAAC,gDAAgD,CAAU,CAAC;AAChF,MAAM,YAAY,GAAG;IACnB,+CAA+C;IAC/C,4CAA4C;CACpC,CAAC;AAEX,MAAM,UAAU,UAAU,CAAC,MAAmD;IAC5E,OAAO,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC;QACtD,MAAM,WAAW,GAAG,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;QACpD,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,wBAAwB,CAAC;YAC9B,WAAW,EAAE,OAAO;YACpB,YAAY,EAAE,8CAA8C;YAC5D,QAAQ,EAAE,qCAAqC;YAC/C,QAAQ;YACR,YAAY;YACZ,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;YACpF,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,mBAAmB,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE;YAClE,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,MAAmD;IACxE,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC;AAC9D,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,3 @@
+import { type ConnectionPluginEventAdapter } from "@assemblyline-agents/core";
+export declare const gmailEvents: ConnectionPluginEventAdapter;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,4BAA4B,EAElC,MAAM,2BAA2B,CAAC;AAInC,eAAO,MAAM,WAAW,EAAE,4BAoFzB,CAAC"}

package/dist/events.js

@@ -0,0 +1,149 @@
+import { ConnectionEventError, parseConnectionEventJson, providerJson, recordField, requireEnvironmentValue, stringField } from "@assemblyline-agents/core";
+const GMAIL = "https://gmail.googleapis.com/gmail/v1/users/me";
+export const gmailEvents = {
+    async reconcile(context) {
+        const gmailToken = (await context.getToken()).token;
+        const project = requireEnvironmentValue(context.env, "GOOGLE_CLOUD_PROJECT");
+        const configuredTopic = requireEnvironmentValue(context.env, "GMAIL_PUBSUB_TOPIC");
+        const topic = configuredTopic.startsWith("projects/") ? configuredTopic : `projects/${project}/topics/${configuredTopic}`;
+        requireEnvironmentValue(context.env, "GMAIL_PUBSUB_VERIFICATION_TOKEN");
+        const labels = selectedLabels(context.resources);
+        const watched = await providerJson(context.fetch, `${GMAIL}/watch`, {
+            method: "POST",
+            headers: auth(gmailToken),
+            body: JSON.stringify({ topicName: topic, ...(labels.length ? { labelIds: labels, labelFilterBehavior: "include" } : {}) })
+        });
+        const expirationMs = Number(watched.expiration);
+        const expiresAt = Number.isFinite(expirationMs) ? new Date(expirationMs).toISOString() : undefined;
+        const historyId = stringField(context.state ?? {}, "historyId") ?? stringField(watched, "historyId");
+        return {
+            status: "active",
+            externalId: topic,
+            state: { topic, ...(historyId ? { historyId } : {}) },
+            ...(expiresAt ? { expiresAt } : {}),
+            instructions: `Create an externally managed Pub/Sub push subscription for ${topic}. Its endpoint must be ${context.callbackUrl}?token=<GMAIL_PUBSUB_VERIFICATION_TOKEN>, and serviceAccount:gmail-api-push@system.gserviceaccount.com must have roles/pubsub.publisher on the topic.`,
+            detail: "The Gmail watch is active and uses the externally managed Pub/Sub topic."
+        };
+    },
+    async remove(context) {
+        const gmailToken = (await context.getToken()).token;
+        await providerJson(context.fetch, `${GMAIL}/stop`, { method: "POST", headers: auth(gmailToken), body: "{}" }, [200, 204, 404]);
+    },
+    check(context) {
+        const topic = stringField(context.state ?? {}, "topic");
+        return topic
+            ? { status: "active", detail: "The Gmail watch is active and uses the externally managed Pub/Sub topic." }
+            : { status: "needs_setup", detail: "The Gmail watch has not been configured." };
+    },
+    async ingress(request, context) {
+        if (request.query.token !== requireEnvironmentValue(context.env, "GMAIL_PUBSUB_VERIFICATION_TOKEN")) {
+            throw new ConnectionEventError("Gmail Pub/Sub verification token is invalid.", 401);
+        }
+        const envelope = parseConnectionEventJson(request.body);
+        const message = recordField(envelope, "message");
+        const data = message && stringField(message, "data");
+        const messageId = message && stringField(message, "messageId", "message_id");
+        if (!data || !messageId)
+            throw new ConnectionEventError("Gmail Pub/Sub message is incomplete.");
+        let payload;
+        try {
+            payload = JSON.parse(Buffer.from(data, "base64").toString("utf8"));
+        }
+        catch {
+            throw new ConnectionEventError("Gmail Pub/Sub data is invalid.");
+        }
+        const currentHistoryId = stringField(payload, "historyId");
+        if (!currentHistoryId)
+            throw new ConnectionEventError("Gmail Pub/Sub data omitted historyId.");
+        const previousHistoryId = stringField(context.state ?? {}, "historyId");
+        const state = { ...(context.state ?? {}), historyId: currentHistoryId };
+        if (!previousHistoryId) {
+            return { events: [], state, response: { status: 200, body: { ok: true } }, audit: { event: "email.received", received: 0 } };
+        }
+        if (historyIdAtOrBefore(currentHistoryId, previousHistoryId)) {
+            return { events: [], state: { ...(context.state ?? {}), historyId: previousHistoryId }, response: { status: 200, body: { ok: true } }, audit: { event: "email.received", received: 0, stale: true } };
+        }
+        const token = (await context.getToken()).token;
+        let received;
+        try {
+            received = await receivedMessagesSince(context.fetch, token, previousHistoryId);
+        }
+        catch (error) {
+            if (!isExpiredHistoryId(error))
+                throw error;
+            return { events: [], state, response: { status: 200, body: { ok: true } }, audit: { event: "email.received", received: 0, watermarkReset: true } };
+        }
+        const occurredAt = message && stringField(message, "publishTime", "publish_time");
+        return {
+            events: received.map((item) => ({
+                event: "email.received",
+                eventId: item.id,
+                payload: {
+                    emailAddress: stringField(payload, "emailAddress") ?? "",
+                    historyId: currentHistoryId,
+                    messageId: item.id,
+                    ...(item.threadId ? { threadId: item.threadId } : {}),
+                    labelIds: item.labelIds
+                },
+                ...(occurredAt ? { occurredAt } : {})
+            })),
+            state,
+            response: { status: 200, body: { ok: true } },
+            audit: { event: "email.received", received: received.length }
+        };
+    }
+};
+async function receivedMessagesSince(fetchImpl, token, startHistoryId) {
+    const messages = new Map();
+    let pageToken;
+    do {
+        const url = new URL(`${GMAIL}/history`);
+        url.searchParams.set("startHistoryId", startHistoryId);
+        url.searchParams.set("historyTypes", "messageAdded");
+        url.searchParams.set("maxResults", "500");
+        if (pageToken)
+            url.searchParams.set("pageToken", pageToken);
+        const value = await providerJson(fetchImpl, url.toString(), { method: "GET", headers: auth(token) });
+        for (const history of records(value.history)) {
+            for (const addition of records(history.messagesAdded)) {
+                const message = recordField(addition, "message");
+                const id = message && stringField(message, "id");
+                if (!id)
+                    continue;
+                const labelIds = stringArray(message.labelIds);
+                if (labelIds.some((label) => IGNORED_MESSAGE_LABELS.has(label)))
+                    continue;
+                messages.set(id, {
+                    id,
+                    ...(stringField(message, "threadId") ? { threadId: stringField(message, "threadId") } : {}),
+                    labelIds
+                });
+            }
+        }
+        pageToken = stringField(value, "nextPageToken");
+    } while (pageToken);
+    return [...messages.values()];
+}
+const IGNORED_MESSAGE_LABELS = new Set(["SENT", "DRAFT", "SPAM", "TRASH"]);
+function records(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item))
+        : [];
+}
+function stringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function historyIdAtOrBefore(candidate, watermark) {
+    try {
+        return BigInt(candidate) <= BigInt(watermark);
+    }
+    catch {
+        throw new ConnectionEventError("Gmail Pub/Sub data contains an invalid historyId.");
+    }
+}
+function isExpiredHistoryId(error) {
+    return error instanceof Error && /Provider event API returned HTTP 404(?:\D|$)/u.test(error.message);
+}
+function auth(token) { return { authorization: `Bearer ${token}`, "content-type": "application/json" }; }
+function selectedLabels(resources) { return resources.flatMap((resource) => Array.isArray(resource.labelIds) ? resource.labelIds.filter((value) => typeof value === "string") : []); }
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-import { type McpPluginConnectionOptions } from "@assemblyline-agents/core";
-export type GmailConnectionOptions = McpPluginConnectionOptions;
-export declare function defineGmailConnection(options: GmailConnectionOptions): import("@assemblyline-agents/core").McpHttpClientConnectionDefinition;
+import { type ConnectionAuthDefinition, type HttpApiPluginConnectionOptions } from "@assemblyline-agents/core";
+export interface GmailConnectionOptions extends Omit<HttpApiPluginConnectionOptions, "auth" | "operations"> {
+    auth?: ConnectionAuthDefinition | false;
+}
+export declare function defineGmailConnection(options?: GmailConnectionOptions): import("@assemblyline-agents/core").HttpApiConnectionDefinition;
 export declare const assemblyLinePlugin: import("@assemblyline-agents/core").PluginModule;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AAInC,MAAM,MAAM,sBAAsB,GAAG,0BAA0B,CAAC;AAEhE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,yEAEpE;AAED,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,wBAAwB,EAC7B,KAAK,8BAA8B,EACpC,MAAM,2BAA2B,CAAC;AAOnC,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,8BAA8B,EAAE,MAAM,GAAG,YAAY,CAAC;IACzG,IAAI,CAAC,EAAE,wBAAwB,GAAG,KAAK,CAAC;CACzC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,mEAUzE;AAED,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}

package/dist/index.js

@@ -1,7 +1,19 @@
-import { connectionPluginMetadata, defineMcpPluginConnection, definePlugin } from "@assemblyline-agents/core";
+import { connectionPluginMetadata, defineConnectionPluginEvents, defineHttpApiPluginConnection, definePlugin } from "@assemblyline-agents/core";
+import { gmailOAuth } from "./auth.js";
+import { gmailEvents } from "./events.js";
+import { GMAIL_OPERATIONS } from "./operations.js";
 const PLUGIN = connectionPluginMetadata("gmail");
-export function defineGmailConnection(options) {
-    return defineMcpPluginConnection(PLUGIN, options);
+export function defineGmailConnection(options = {}) {
+    const { auth, ...connection } = options;
+    const definition = defineHttpApiPluginConnection(PLUGIN, {
+        ...connection,
+        operations: GMAIL_OPERATIONS,
+        auth: auth === false ? false : auth ?? gmailOAuth(options.access)
+    });
+    const events = defineConnectionPluginEvents(PLUGIN, options.events, gmailEvents);
+    if (events)
+        definition.events = events;
+    return definition;
 }
 export const assemblyLinePlugin = definePlugin({ connections: [PLUGIN] });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EAEb,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,CAAE,CAAC;AAIlD,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,OAAO,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,6BAA6B,EAC7B,YAAY,EAGb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,CAAE,CAAC;AAMlD,MAAM,UAAU,qBAAqB,CAAC,UAAkC,EAAE;IACxE,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IACxC,MAAM,UAAU,GAAG,6BAA6B,CAAC,MAAM,EAAE;QACvD,GAAG,UAAU;QACb,UAAU,EAAE,gBAAgB;QAC5B,IAAI,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;KAClE,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjF,IAAI,MAAM;QAAE,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC;IACvC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/dist/operations.d.ts

@@ -0,0 +1,3 @@
+import type { HttpApiOperationDefinition } from "@assemblyline-agents/core";
+export declare const GMAIL_OPERATIONS: HttpApiOperationDefinition[];
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAc,MAAM,2BAA2B,CAAC;AAYxF,eAAO,MAAM,gBAAgB,EAAE,0BAA0B,EAsCxD,CAAC"}

package/dist/operations.js

@@ -0,0 +1,58 @@
+const id = (description) => ({ type: "string", minLength: 1, description });
+const query = (name, schema, required = false) => ({ name, in: "query", schema, required });
+const path = (name, description) => ({ name, in: "path", schema: id(description), required: true });
+const pageSize = { type: "integer", minimum: 1, maximum: 500 };
+const pageToken = id("Opaque next-page token returned by Gmail.");
+const rawMessage = objectSchema({
+    raw: id("RFC 2822 message bytes encoded as base64url."),
+    threadId: id("Existing Gmail thread id when sending a reply in that thread.")
+}, ["raw"]);
+export const GMAIL_OPERATIONS = [
+    read("gmail_get_profile", "Get the connected Gmail account profile and mailbox history id.", "/users/me/profile"),
+    read("gmail_list_messages", "Search or list Gmail messages. Continue with pageToken when nextPageToken is returned.", "/users/me/messages", [
+        query("q", id("Gmail search query, such as from:alice@example.com newer_than:7d.")),
+        query("labelIds", { type: "array", items: id("Gmail label id.") }),
+        query("includeSpamTrash", { type: "boolean" }), query("maxResults", pageSize), query("pageToken", pageToken)
+    ]),
+    read("gmail_get_message", "Get one Gmail message by id, including headers and MIME parts according to format.", "/users/me/messages/{id}", [
+        path("id", "Gmail message id."),
+        query("format", { type: "string", enum: ["minimal", "full", "raw", "metadata"] }),
+        query("metadataHeaders", { type: "array", items: { type: "string" } })
+    ]),
+    read("gmail_get_attachment", "Get one Gmail attachment as base64url data.", "/users/me/messages/{messageId}/attachments/{id}", [
+        path("messageId", "Gmail message id."), path("id", "Attachment body id from the message MIME part.")
+    ]),
+    read("gmail_list_threads", "Search or list Gmail threads. Continue with pageToken when nextPageToken is returned.", "/users/me/threads", [
+        query("q", id("Gmail search query.")), query("labelIds", { type: "array", items: id("Gmail label id.") }),
+        query("includeSpamTrash", { type: "boolean" }), query("maxResults", pageSize), query("pageToken", pageToken)
+    ]),
+    read("gmail_get_thread", "Get a Gmail thread and its messages by thread id.", "/users/me/threads/{id}", [
+        path("id", "Gmail thread id."),
+        query("format", { type: "string", enum: ["minimal", "full", "metadata"] }),
+        query("metadataHeaders", { type: "array", items: { type: "string" } })
+    ]),
+    read("gmail_list_labels", "List labels in the connected Gmail mailbox.", "/users/me/labels"),
+    read("gmail_get_label", "Get one Gmail label and its message and thread counts.", "/users/me/labels/{id}", [path("id", "Gmail label id.")]),
+    read("gmail_list_drafts", "List Gmail drafts. Continue with pageToken when nextPageToken is returned.", "/users/me/drafts", [
+        query("q", id("Gmail search query used to filter drafts.")), query("includeSpamTrash", { type: "boolean" }),
+        query("maxResults", pageSize), query("pageToken", pageToken)
+    ]),
+    read("gmail_get_draft", "Get one Gmail draft and its message.", "/users/me/drafts/{id}", [
+        path("id", "Gmail draft id."), query("format", { type: "string", enum: ["minimal", "full", "raw", "metadata"] })
+    ]),
+    write("gmail_create_draft", "Create a Gmail draft from a base64url RFC 2822 message.", "POST", "/users/me/drafts", objectSchema({ message: rawMessage }, ["message"])),
+    write("gmail_update_draft", "Replace an existing Gmail draft with a base64url RFC 2822 message.", "PUT", "/users/me/drafts/{id}", objectSchema({ message: rawMessage }, ["message"]), [path("id", "Gmail draft id.")]),
+    { name: "gmail_delete_draft", description: "Permanently delete one Gmail draft.", method: "DELETE", path: "/users/me/drafts/{id}", parameters: [path("id", "Gmail draft id.")] },
+    write("gmail_send_draft", "Send an existing Gmail draft to the recipients in its message headers.", "POST", "/users/me/drafts/send", objectSchema({ id: id("Gmail draft id.") }, ["id"])),
+    write("gmail_send_message", "Send a base64url RFC 2822 message through Gmail.", "POST", "/users/me/messages/send", rawMessage)
+];
+function read(name, description, operationPath, parameters) {
+    return { name, description, method: "GET", path: operationPath, ...(parameters ? { parameters } : {}) };
+}
+function write(name, description, method, operationPath, schema, parameters) {
+    return { name, description, method, path: operationPath, ...(parameters ? { parameters } : {}), body: { contentType: "application/json", field: "body", schema, required: true } };
+}
+function objectSchema(properties, required = []) {
+    return { type: "object", properties, ...(required.length ? { required } : {}), additionalProperties: false };
+}
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assemblyline-agents/gmail",
-  "version": "2.0.0",
+  "version": "3.1.0",
   "type": "module",
   "exports": {
     ".": {
@@ -9,12 +9,11 @@
     }
   },
   "dependencies": {
-    "@assemblyline-agents/core": "2.0.0"
+    "@assemblyline-agents/core": "3.1.0"
   },
-  "description": "Official Assembly Line Gmail connection plugin.",
+  "description": "Official Assembly Line direct Gmail API connection plugin.",
   "files": [
-    "dist",
-    "skills"
+    "dist"
   ],
   "engines": {
     "node": ">=22.19.0"

package/skills/gmail/SKILL.md

@@ -1,13 +0,0 @@
----
-name: gmail
-description: Use a configured, independently authorized Gmail connection for mail search, threads, messages, attachments, drafts, and sends.
----
-# Gmail
-
-Use the `gmail` connection only for Gmail work. Its authorization is independent from Google Calendar and Google Drive; never assume either service is connected because Gmail is connected.
-
-Read narrowly before requesting broader data. Prefer a targeted Gmail query, then inspect the exact thread or message needed. The deployment owner configures the Gmail OAuth grant or MCP bridge. Never request, print, or store access tokens, refresh tokens, client secrets, API keys, or cookies.
-
-The scaffold is read-only. Draft creation or changes, sends, label changes, and other mailbox mutations require explicit write access and the configured approval gate. Approval for a send must cover the exact recipients, subject, body, thread, and attachments; request new approval if any of them changes.
-
-Read `references/gmail.md` when the task needs Gmail query syntax, thread behavior, attachments, drafts, or send safety.

package/skills/gmail/references/gmail.md

@@ -1,41 +0,0 @@
-# Gmail
-
-Use the configured `gmail` connection for Gmail search, threads, messages, attachments, drafts, and sends.
-
-Official documentation:
-
-- https://developers.google.com/workspace/gmail/api/reference/rest
-- https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/send
-- https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.history/list
-
-## Source Selection
-
-Use a bounded search for normal recall, then fetch the exact thread or message when freshness or complete context matters. Useful Gmail searches include:
-
-```text
-in:inbox category:primary from:person@example.com
-in:inbox category:primary subject:(invoice)
-in:inbox category:primary newer_than:7d
-in:inbox category:primary has:attachment
-```
-
-Gmail's Primary tab is the system label `CATEGORY_PERSONAL`; there is no `CATEGORY_PRIMARY`. Do not describe a Primary Inbox mirror or query as all Gmail. Keep pagination bounded rather than traversing a large mailbox in a foreground turn.
-
-## Drafts And Sends
-
-Draft creation is a write. Sending mail is a high-impact write. Both require the configured write approval path.
-
-Common Gmail REST endpoints are:
-
-- `POST /gmail/v1/users/me/drafts`
-- `PUT /gmail/v1/users/me/drafts/{id}`
-- `POST /gmail/v1/users/me/drafts/send`
-- `POST /gmail/v1/users/me/messages/send`
-
-Resolve the exact MIME/RFC 2822 body before requesting approval. Approval must cover recipients, subject, body, thread id, attachments, method, path, and raw message hash where applicable. If the message changes, request approval again.
-
-Never claim mail was sent until the provider confirms the approved send.
-
-## Attachments
-
-When answering from an attachment, identify the supporting filename. Keep binary handling bounded and avoid dumping private attachment content when a concise answer will do.