@assemblyline-agents/notion 1.0.0 → 3.0.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 Notion connection plugin.
 
-It connects agents to Notion, exposing workspace page and database tools through Notion's MCP server. The package exports `defineNotionConnection(options)` to declare the connection in an agent definition and an `assemblyLinePlugin` module so the Assembly Line CLI and compiler can discover the plugin's connection metadata. A bundled skill under `skills/` teaches agents how to use the connection's tools.
+It connects agents to Notion, exposing workspace page and database tools through Notion's MCP server. The package exports `defineNotionConnection(options)` to declare the connection in an agent definition and an `assemblyLinePlugin` module so the Assembly Line CLI and compiler can discover the plugin's connection metadata.
 
 ## Install
 

package/dist/events.d.ts

@@ -0,0 +1,3 @@
+import { type ConnectionPluginEventAdapter } from "@assemblyline-agents/core";
+export declare const notionEvents: 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,EAML,KAAK,4BAA4B,EAElC,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,YAAY,EAAE,4BAkC1B,CAAC"}

package/dist/events.js

@@ -0,0 +1,38 @@
+import { ConnectionEventError, headerValue, parseConnectionEventJson, stringField, verifyHmacSha256 } from "@assemblyline-agents/core";
+export const notionEvents = {
+    reconcile(context) {
+        const verificationToken = stringField(context.state ?? {}, "verificationToken");
+        return {
+            status: "needs_setup",
+            ...(context.state ? { state: context.state } : {}),
+            instructions: verificationToken
+                ? "Paste the received verification token shown by `assembly-line connections check` into the Notion connection's Webhooks tab."
+                : `In the Notion connection's Webhooks tab, create a subscription for ${context.callbackUrl}. Assembly Line will capture its verification token.`,
+            detail: verificationToken ? "Notion verification token has been received; finish verification in Notion." : "Create the Notion webhook subscription to begin verification."
+        };
+    },
+    check(context) {
+        const verificationToken = stringField(context.state ?? {}, "verificationToken");
+        return verificationToken
+            ? { status: "needs_setup", detail: `Notion verification token: ${verificationToken}` }
+            : { status: "needs_setup", detail: "Waiting for Notion to send its verification token." };
+    },
+    ingress(request, context) {
+        const payload = parseConnectionEventJson(request.body);
+        const challengeToken = stringField(payload, "verification_token");
+        if (challengeToken) {
+            return { events: [], state: { ...(context.state ?? {}), verificationToken: challengeToken }, response: { status: 200, body: { ok: true } }, audit: { challenge: true } };
+        }
+        const verificationToken = stringField(context.state ?? {}, "verificationToken");
+        if (!verificationToken || !verifyHmacSha256({ secret: verificationToken, body: request.body, signature: headerValue(request.headers, "x-notion-signature"), prefix: "sha256=" })) {
+            throw new ConnectionEventError("Notion webhook signature is invalid.", 401);
+        }
+        const event = stringField(payload, "type");
+        const eventId = stringField(payload, "id");
+        if (!event || !eventId)
+            throw new ConnectionEventError("Notion webhook omitted type or id.");
+        const occurredAt = stringField(payload, "timestamp");
+        return { events: [{ event, eventId, payload: payload, ...(occurredAt ? { occurredAt } : {}) }], response: { status: 200, body: { ok: true } }, audit: { event } };
+    }
+};
+//# 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.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqE,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE/I,MAAM,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AACjE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,yEAAwD;AAC/H,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmG,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAG7K,MAAM,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AACjE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,yEAAkN;AACzR,eAAO,MAAM,kBAAkB,kDAA0C,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
-import { connectionPluginMetadata, defineMcpPluginConnection, definePlugin } from "@assemblyline-agents/core";
+import { connectionPluginMetadata, defineConnectionPluginEvents, defineMcpPluginConnection, definePlugin } from "@assemblyline-agents/core";
+import { notionEvents } from "./events.js";
 const PLUGIN = connectionPluginMetadata("notion");
-export function defineNotionConnection(options) { return defineMcpPluginConnection(PLUGIN, options); }
+export function defineNotionConnection(options) { const definition = defineMcpPluginConnection(PLUGIN, options); const events = defineConnectionPluginEvents(PLUGIN, options.events, notionEvents); 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,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,YAAY,EAAmC,MAAM,2BAA2B,CAAC;AAC/I,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,CAAE,CAAC;AAEnD,MAAM,UAAU,sBAAsB,CAAC,OAAgC,IAAI,OAAO,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAC/H,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,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,YAAY,EAAmC,MAAM,2BAA2B,CAAC;AAC7K,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,MAAM,MAAM,GAAG,wBAAwB,CAAC,QAAQ,CAAE,CAAC;AAEnD,MAAM,UAAU,sBAAsB,CAAC,OAAgC,IAAI,MAAM,UAAU,GAAG,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,GAAG,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,MAAM;IAAE,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;AACzR,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/package.json

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

package/skills/notion/SKILL.md

@@ -1,8 +0,0 @@
----
-name: notion
-description: Use configured Notion tools for pages, databases, comments, users, and search.
----
-# Notion
-Search the workspace first, then fetch only the pages or data sources needed. Preserve page and database structure when summarizing.
-
-The deployment owner configures Notion authorization. The scaffold is read-only; page, database, comment, or property mutations require writes to be enabled with the configured approval gate.