@assemblyline-agents/agentmail 5.0.9 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/README.md +15 -39
  2. package/ai.assemblyline/connections/agentmail.json +111 -0
  3. package/ai.assemblyline/index.cjs +9 -0
  4. package/dist/index.d.ts.map +1 -1
  5. package/dist/index.js +3 -2
  6. package/dist/index.js.map +1 -1
  7. package/package.json +5 -3
  8. package/plugin.json +11 -0
package/README.md CHANGED
@@ -18,47 +18,23 @@ Set `AGENTMAIL_API_KEY` on the Assembly Line runtime host. Override the hosted
18
18
  endpoint with `AGENTMAIL_MCP_URL` only when intentionally using another
19
19
  AgentMail-compatible server.
20
20
 
21
- The generated connection enables every reviewed AgentMail tool. Reads and
22
- writes run without requiring an approval surface. To require approval for every
23
- write:
24
-
25
- ```ts
26
- import { defineAgentMailConnection } from "@assemblyline-agents/agentmail";
27
-
28
- export default defineAgentMailConnection({
29
- access: "approval-required"
30
- });
31
- ```
32
-
33
- To choose approval behavior tool by tool:
34
-
35
- ```ts
36
- import { defineAgentMailConnection } from "@assemblyline-agents/agentmail";
37
-
38
- export default defineAgentMailConnection({
39
- access: {
40
- read: true,
41
- write: {
42
- approval: "never",
43
- approvalOverrides: [
44
- {
45
- tools: [
46
- "send_message",
47
- "reply_to_message",
48
- "forward_message",
49
- "send_draft",
50
- "delete_*"
51
- ],
52
- approval: "always"
53
- }
54
- ]
55
- }
56
- }
57
- });
21
+ The selected plugin enables every reviewed AgentMail tool. Narrow or gate
22
+ specific actions in `agent.md`:
23
+
24
+ ```yaml
25
+ capabilities:
26
+ agentmail:
27
+ connections:
28
+ agentmail:
29
+ approval:
30
+ send_message: always
31
+ reply_to_message: always
32
+ forward_message: always
33
+ send_draft: always
58
34
  ```
59
35
 
60
- The developer can also narrow the reviewed tool set with the connection's
61
- `tools` option. A local filter cannot expose unreviewed tools.
36
+ Use `disable` under the same connection to remove named actions. Exceptions can
37
+ only reduce or gate the plugin's reviewed surface.
62
38
 
63
39
  See the [AgentMail MCP documentation](https://docs.agentmail.to/integrations/mcp)
64
40
  for the provider's current tool contracts.
package/ai.assemblyline/connections/agentmail.json ADDED
@@ -0,0 +1,111 @@
1
+ {
2
+ "kind": "agentmail",
3
+ "role": "connection",
4
+ "packageName": "@assemblyline-agents/agentmail",
5
+ "helper": "defineAgentMailConnection",
6
+ "protocol": "mcp",
7
+ "transport": "http",
8
+ "provider": "agentmail",
9
+ "description": "AgentMail inboxes, threads, messages, drafts, and attachments through the official hosted MCP server.",
10
+ "defaultUrl": "https://mcp.agentmail.to/mcp",
11
+ "urlEnv": "AGENTMAIL_MCP_URL",
12
+ "tokenEnv": "AGENTMAIL_API_KEY",
13
+ "tokenRequired": true,
14
+ "tokenHeader": "x-api-key",
15
+ "capabilities": [
16
+ "mcp",
17
+ "live-tools",
18
+ "streamable-http"
19
+ ],
20
+ "scopes": [],
21
+ "subject": "environment",
22
+ "tools": {
23
+ "allow": [
24
+ "list_inboxes",
25
+ "get_inbox",
26
+ "create_inbox",
27
+ "update_inbox",
28
+ "delete_inbox",
29
+ "list_threads",
30
+ "search_threads",
31
+ "get_thread",
32
+ "update_thread",
33
+ "delete_thread",
34
+ "list_messages",
35
+ "search_messages",
36
+ "send_message",
37
+ "reply_to_message",
38
+ "forward_message",
39
+ "update_message",
40
+ "create_draft",
41
+ "list_drafts",
42
+ "get_draft",
43
+ "update_draft",
44
+ "send_draft",
45
+ "delete_draft",
46
+ "get_attachment",
47
+ "auth_me"
48
+ ]
49
+ },
50
+ "readToolPatterns": [
51
+ "list_inboxes",
52
+ "get_inbox",
53
+ "list_threads",
54
+ "search_threads",
55
+ "get_thread",
56
+ "list_messages",
57
+ "search_messages",
58
+ "list_drafts",
59
+ "get_draft",
60
+ "get_attachment",
61
+ "auth_me"
62
+ ],
63
+ "writeToolPatterns": [
64
+ "create_inbox",
65
+ "update_inbox",
66
+ "delete_inbox",
67
+ "update_thread",
68
+ "delete_thread",
69
+ "send_message",
70
+ "reply_to_message",
71
+ "forward_message",
72
+ "update_message",
73
+ "create_draft",
74
+ "update_draft",
75
+ "send_draft",
76
+ "delete_draft"
77
+ ],
78
+ "eventCatalog": [
79
+ "message.received",
80
+ "message.received.spam",
81
+ "message.received.blocked",
82
+ "message.received.unauthenticated",
83
+ "message.sent",
84
+ "message.delivered",
85
+ "message.bounced",
86
+ "message.complained",
87
+ "message.rejected",
88
+ "domain.verified"
89
+ ],
90
+ "defaultEvents": [
91
+ "message.received"
92
+ ],
93
+ "eventMode": "api",
94
+ "eventScope": "connection",
95
+ "setup": [
96
+ {
97
+ "kind": "connection",
98
+ "name": "agentmail-developer-configuration",
99
+ "required": true,
100
+ "message": "Create an AgentMail API key, set AGENTMAIL_API_KEY on the Assembly Line runtime host, and keep inbox and sender scope owned by the provider account."
101
+ }
102
+ ],
103
+ "requiredConfig": [],
104
+ "optionalConfig": [
105
+ "AGENTMAIL_MCP_URL"
106
+ ],
107
+ "requiredCredentials": [
108
+ "AGENTMAIL_API_KEY"
109
+ ],
110
+ "optionalCredentials": []
111
+ }
package/ai.assemblyline/index.cjs ADDED
@@ -0,0 +1,9 @@
1
+ module.exports = {
2
+ "connections": {
3
+ "agentmail": {
4
+ "contract": "./ai.assemblyline/connections/agentmail.json",
5
+ "definition": "@assemblyline-agents/agentmail",
6
+ "factory": "defineAgentMailConnection"
7
+ }
8
+ }
9
+ };
package/dist/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AAKnC,MAAM,MAAM,0BAA0B,GAAG,0BAA0B,CAAC;AAEpE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,0IAK5E;AAED,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,0BAA0B,EAChC,MAAM,2BAA2B,CAAC;AAKnC,MAAM,MAAM,0BAA0B,GAAG,0BAA0B,CAAC;AAEpE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,0IAK5E;AAED,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}
package/dist/index.js CHANGED
@@ -1,6 +1,7 @@
1
- import { connectionPluginMetadata, defineConnectionPluginEvents, defineMcpPluginConnection, definePlugin } from "@assemblyline-agents/core";
1
+ import connectionContract_agentmail from "../ai.assemblyline/connections/agentmail.json" with { type: "json" };
2
+ import { defineConnectionPluginEvents, defineMcpPluginConnection, definePlugin } from "@assemblyline-agents/core";
2
3
  import { agentMailEvents } from "./events.js";
3
- const PLUGIN = connectionPluginMetadata("agentmail");
4
+ const PLUGIN = connectionContract_agentmail;
4
5
  export function defineAgentMailConnection(options) {
5
6
  const definition = defineMcpPluginConnection(PLUGIN, options);
6
7
  const events = defineConnectionPluginEvents(PLUGIN, options.events, agentMailEvents);
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,YAAY,EAEb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,GAAG,wBAAwB,CAAC,WAAW,CAAE,CAAC;AAItD,MAAM,UAAU,yBAAyB,CAAC,OAAmC;IAC3E,MAAM,UAAU,GAAG,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACrF,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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,4BAA4B,MAAM,+CAA+C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC/G,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,EACzB,YAAY,EAEb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,GAAG,4BAAmE,CAAC;AAInF,MAAM,UAAU,yBAAyB,CAAC,OAAmC;IAC3E,MAAM,UAAU,GAAG,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACrF,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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@assemblyline-agents/agentmail",
3
- "version": "5.0.9",
3
+ "version": "6.0.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {
@@ -9,11 +9,13 @@
9
9
  }
10
10
  },
11
11
  "dependencies": {
12
- "@assemblyline-agents/core": "5.0.9"
12
+ "@assemblyline-agents/core": "6.0.0"
13
13
  },
14
14
  "description": "Official Assembly Line AgentMail hosted MCP connection plugin.",
15
15
  "files": [
16
- "dist"
16
+ "dist",
17
+ "plugin.json",
18
+ "ai.assemblyline"
17
19
  ],
18
20
  "engines": {
19
21
  "node": ">=22.19.0"
package/plugin.json ADDED
@@ -0,0 +1,11 @@
1
+ {
2
+ "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
3
+ "name": "agentmail",
4
+ "version": "6.0.0",
5
+ "description": "Official Assembly Line AgentMail hosted MCP connection plugin.",
6
+ "extensions": {
7
+ "ai.assemblyline": {
8
+ "entry": "./ai.assemblyline/index.cjs"
9
+ }
10
+ }
11
+ }