@assemblyline-agents/google-drive 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/google-drive
+
+Official Assembly Line Google Drive connection plugin.
+
+It exposes file search, downloads, uploads, organization, and sharing through a dedicated MCP connection. Drive authorization stays independent from Gmail and Google Calendar. The package exports `defineGoogleDriveConnection(options)` and bundles focused Drive guidance under `skills/`.
+
+## Install
+
+```sh
+npm install @assemblyline-agents/google-drive
+```
+
+Configure `GOOGLE_DRIVE_MCP_URL` and `GOOGLE_DRIVE_MCP_TOKEN`, or pass the connection URL and authentication resolver directly. New connections scaffold read-only; uploads, moves, renames, sharing, and deletes 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 GoogleDriveConnectionOptions = McpPluginConnectionOptions;
+export declare function defineGoogleDriveConnection(options: GoogleDriveConnectionOptions): 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,4BAA4B,GAAG,0BAA0B,CAAC;AAEtE,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,yEAEhF;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("google-drive");
+export function defineGoogleDriveConnection(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,cAAc,CAAE,CAAC;AAIzD,MAAM,UAAU,2BAA2B,CAAC,OAAqC;IAC/E,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/google-drive",
+  "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 Google Drive 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/google-drive"
+  },
+  "bugs": {
+    "url": "https://github.com/jasonbadeaux/openeve/issues"
+  },
+  "homepage": "https://github.com/jasonbadeaux/openeve#readme",
+  "author": "OpenEve contributors",
+  "keywords": [
+    "openeve",
+    "ai",
+    "agents",
+    "google-drive",
+    "files",
+    "connection",
+    "plugin"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/skills/google-drive/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: google-drive
+description: Use a configured, independently authorized Google Drive connection for file search, downloads, uploads, organization, and sharing.
+---
+# Google Drive
+
+Use the `google-drive` connection only for Drive work. Its authorization is independent from Gmail and Google Calendar; never assume either service is connected because Drive is connected.
+
+Search narrowly, resolve the exact file or folder id, and inspect current metadata before proposing a change. Prefer an open link for browser access and the provider's supported export path for Google-native files. The deployment owner configures the Drive OAuth grant or MCP bridge. Never request, print, or store tokens or client secrets.
+
+The scaffold is read-only. Uploads, creates, moves, renames, sharing or permission changes, trashing, and deletion require explicit write access and the configured approval gate. Do not mutate a file while multiple plausible search results remain.
+
+Read `references/drive.md` when the task needs Drive query syntax, native-file exports, shared-drive handling, or mutation safety.

package/skills/google-drive/references/drive.md

@@ -0,0 +1,40 @@
+# Google Drive
+
+Use the configured `google-drive` connection for file search, open, download, upload, create, move, rename, share, and delete operations.
+
+Official documentation:
+
+- https://developers.google.com/workspace/drive/api/reference/rest/v3/files
+- https://developers.google.com/workspace/drive/api/guides/manage-uploads
+
+## Search And Open
+
+Request only the fields needed to identify and use a file. Useful Drive query patterns include:
+
+```text
+name contains 'proposal'
+'{folderId}' in parents
+trashed = false
+fullText contains 'contract'
+modifiedTime > '2026-05-01T00:00:00'
+```
+
+Keep searches bounded. If several plausible files match, ask which file. Prefer `webViewLink` for browser access. For downloadable files, use the provider's content/download operation. Google-native files require export to a supported format.
+
+## Writes
+
+Before a write, resolve the exact file or folder id and inspect current metadata. Approval must cover the exact target and operation, including content, destination, recipients, or permissions where applicable.
+
+Writes include:
+
+- file and folder creation
+- uploads
+- renames and moves
+- permission and sharing changes
+- trash and deletion
+
+Never overwrite, move, share, trash, or delete when multiple search results remain plausible.
+
+## Shared Drives
+
+Include shared drives and provider-specific shared-drive options when needed. A missing shared-drive file can mean the account lacks access or the search omitted shared-drive support.