@assemblyline-agents/gmail 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenEve 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
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @assemblyline-agents/gmail
+
+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/`.
+
+## Install
+
+```sh
+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.
+
+## Part of Assembly Line
+
+This package is part of [Assembly Line](https://github.com/jasonbadeaux/openeve). See the [developer documentation](https://github.com/jasonbadeaux/openeve/tree/main/docs/developers) for setup, agent authoring, and deployment guides.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { type McpPluginConnectionOptions } from "@assemblyline-agents/core";
+export type GmailConnectionOptions = McpPluginConnectionOptions;
+export declare function defineGmailConnection(options: GmailConnectionOptions): import("@assemblyline-agents/core").McpHttpClientConnectionDefinition;
+export declare const openevePlugin: import("@assemblyline-agents/core").PluginModule;
+//# 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":"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,aAAa,kDAA0C,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+import { connectionPluginMetadata, defineMcpPluginConnection, definePlugin } from "@assemblyline-agents/core";
+const PLUGIN = connectionPluginMetadata("gmail");
+export function defineGmailConnection(options) {
+    return defineMcpPluginConnection(PLUGIN, options);
+}
+export const openevePlugin = definePlugin({ connections: [PLUGIN] });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,aAAa,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@assemblyline-agents/gmail",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@assemblyline-agents/core": "0.1.0"
+  },
+  "description": "Official OpenEve Gmail connection plugin.",
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jasonbadeaux/openeve.git",
+    "directory": "packages/gmail"
+  },
+  "bugs": {
+    "url": "https://github.com/jasonbadeaux/openeve/issues"
+  },
+  "homepage": "https://github.com/jasonbadeaux/openeve#readme",
+  "author": "OpenEve contributors",
+  "keywords": [
+    "openeve",
+    "ai",
+    "agents",
+    "gmail",
+    "email",
+    "connection",
+    "plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/skills/gmail/SKILL.md

@@ -0,0 +1,13 @@
+---
+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

@@ -0,0 +1,41 @@
+# 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.