Feat : Add Notion Assistant AgentKit

.gitignore

@@ -1 +1,21 @@
-**/.DS_Store
+# Node modules
+node_modules/
+
+# Environment variables
+.env
+
+# Build / output folders
+dist/
+build/
+
+# Logs
+npm-debug.log
+*.log
+
+# Windows system files
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# VS Code workspace settings
+.vscode/

package.json

@@ -0,0 +1,9 @@
+{
+  "dependencies": {
+    "@notionhq/client": "^5.3.0",
+    "dotenv": "^17.2.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.8.1"
+  }
+}

templates/notionassistant/README.md

@@ -0,0 +1,91 @@
+# Notion Assistant AgentKit
+
+A Notion Assistant AgentKit to query and manage your Notion workspace.
+
+---
+
+## Folder Structure
+
+/actions                  # Orchestrator / agent actions
+/templates/notionassistant # This agent's folder
+/lamatic-config.json       # Agent configuration
+/package.json              # Scripts & dependencies
+/README.md                 # This documentation
+
+---
+
+## Setup
+
+### 1. Configure Environment Variables
+
+Create a `.env` file in the **project root** (`AgentKit/.env`) with your configuration:
+
+NOTION_API_KEY=your_notion_secret_key
+DATABASE_ID=your_database_id
+
+> Make sure the Notion integration has access to the database you want to use.
+
+---
+
+### 2. Install Dependencies
+
+```bash
+cd templates/notionassistant
+npm install
+```
+
+---
+
+### 3. Run Locally
+
+```bash
+npm run dev
+```
+
+You should see:
+
+✅ Connected to Notion DB: Tasks
+
+---
+
+## Example Queries
+
+**List databases**
+
+```javascript
+await handleQuery("list databases");
+```
+
+**Create a new page**
+
+```javascript
+await handleQuery("create page");
+```
+
+Pages are created in the database specified in your `.env`.
+
+---
+
+## Dependencies
+
+- `@notionhq/client` → Notion SDK  
+- `dotenv` → Load environment variables  
+- `lamatic` → Lamatic AgentKit support  
+- `ts-node` → Run TypeScript files directly  
+- `typescript` → TypeScript support  
+
+---
+
+## Contributing
+
+Follow `CONTRIBUTING.md` guidelines. Make sure:
+
+- `.env` is never committed  
+- All changes are tested locally  
+- Pull request includes updated `README.md` and `lamatic-config.json`
+
+---
+
+## Author
+
+Meghana-2124

templates/notionassistant/actions/orchestrate.ts

@@ -0,0 +1,83 @@
+import dotenv from "dotenv";
+import { Client } from "@notionhq/client";
+
+dotenv.config();
+
+// ✅ Load environment variables (matching your .env exactly)
+const NOTION_API_KEY = process.env.NOTION_API_KEY;
+let DATABASE_ID = process.env.DATABASE_ID;
+
+if (!NOTION_API_KEY) {
+  throw new Error("❌ NOTION_API_KEY is missing in your .env file!");
+}
+if (!DATABASE_ID) {
+  throw new Error("❌ DATABASE_ID is missing in your .env file!");
+}
+
+// ✅ Clean DATABASE_ID (remove dashes if present)
+DATABASE_ID = DATABASE_ID.replace(/-/g, '');
+
+// Optional: check ID length (Notion database IDs are 32 chars)
+if (DATABASE_ID.length !== 32) {
+  throw new Error(
+    "❌ Database_Id seems invalid. It should be a 32-character Notion database ID (no dashes)."
+  );
+}
+
+// ✅ Initialize Notion client
+const notion = new Client({ auth: NOTION_API_KEY });
+
+// ✅ Step 1: Test connection to your Notion database
+async function testNotionConnection() {
+  try {
+    // Use non-null assertion directly to satisfy TypeScript
+    const res: any = await notion.databases.retrieve({
+      database_id: DATABASE_ID!,
+    });
+
+    const dbTitle = res?.title?.[0]?.plain_text || "Untitled Database";
+    console.log("✅ Connected to Notion DB:", dbTitle);
+  } catch (err: any) {
+    console.error("❌ Notion connection failed:", err.message);
+    if (err.code === "unauthorized") {
+      console.error(
+        "⚠️ Your Notion_Api_Key might be invalid or the integration does not have access to the database."
+      );
+    }
+  }
+}
+
+// Run the test immediately
+testNotionConnection();
+
+// ✅ Step 2: Handle queries dynamically
+export async function handleQuery(query: string) {
+  if (query.toLowerCase().includes("list databases")) {
+    const res = await notion.search({
+      filter: { property: "object", value: "database" } as any,
+    });
+
+    return res.results.map((db: any) => ({
+      name: db?.title?.[0]?.plain_text || "Untitled DB",
+      id: db.id,
+    }));
+  }
+
+  if (query.toLowerCase().includes("create page")) {
+    // Use non-null assertion directly for TypeScript
+    const res = await notion.pages.create({
+      parent: { database_id: DATABASE_ID! },
+      properties: {
+        // Cast to any to satisfy strict TypeScript types
+        Name: {
+          title: [{ text: { content: "New Task from Assistant AgentKit" } }],
+        } as any,
+        Priority: { select: { name: "High" } } as any,
+      },
+    });
+
+    return { success: true, pageId: res.id };
+  }
+
+  return { message: "Command not recognized." };
+}

templates/notionassistant/lamatic-config.json

@@ -0,0 +1,6 @@
+{
+  "name": "notionassistant",
+  "description": "A Notion Assistant AgentKit to query and manage your Notion workspace.",
+  "api_keys_required": ["NOTION_API_KEY"],
+  "author": "Meghana-2124"
+}